使用说明

本文档介绍如何在 OpenCode 和 Claude Code 中集成使用 360 Cloud Disk Skill。

两种 Skill 与打包命令

类型	说明	在项目仓库中的命令	zip 产物（均在 packages/）
CLI Skill	Shell 调用 360disk，见下文步骤	npm run skill-cli:package / npm run skill-cli:package:no-version	360-ai-cloud-disk-cli-skill-v<version>.zip 或 360-ai-cloud-disk-cli-skill.zip 或 360-ai-cloud-disk-mcp-skill.zip
MCP Skill	Python executor.py 调 MCP	先 npm run skill:convert，再 npm run skill:package 或 npm run skill:package:no-version	360-ai-cloud-disk-cli-skill-v<version>.zip 或 360-ai-cloud-disk-cli-skill.zip 或 360-ai-cloud-disk-mcp-skill.zip

CLI Skill 的打包 zip 在解压后会包含最外层目录，目录名与 zip 文件名（去掉 .zip）一致（例如 360-ai-cloud-disk-cli-skill-v0.8.6/ 或 360-ai-cloud-disk-cli-skill/）。 本文以下章节默认使用 CLI Skill（解压后为 360-ai-cloud-disk-cli-skill-v<version> 目录）。若你使用 MCP Skill，请从源码生成 skill-output/ 或解压 MCP Skill 的 zip，并按 Skills 配置说明 配置 .env 后再拷贝到各客户端 Skills 目录（目录名建议与 Skill 名称保持一致，例如 360-ai-cloud-disk-cli-skill）。 MCP Skill 的打包 zip 在解压后会包含最外层目录，目录名与 zip 文件名（去掉 .zip）一致。 例如：360-ai-cloud-disk-cli-skill-v0.8.6.zip 解压后目录为 360-ai-cloud-disk-cli-skill-v0.8.6/，360-ai-cloud-disk-cli-skill.zip 或 360-ai-cloud-disk-mcp-skill.zip 解压后目录为 360-ai-cloud-disk-cli-skill/。 若通过仓库脚本 skill:deploy / skill:deploy:manual 部署到独立 skills 仓库，目标目录同样为 360-ai-cloud-disk-cli-skill/。

OpenCode 集成

1. 获取 Skill

使用本地打包产物进行分发（推荐，CLI Skill）：

• 在项目仓库执行：npm run skill-cli:package（带版本）或 npm run skill-cli:package:no-version（固定文件名）
• 产物位于：packages/360-ai-cloud-disk-cli-skill-v<version>.zip 或 360-ai-cloud-disk-mcp-skill-v<version>.zip 或 packages/360-ai-cloud-disk-cli-skill.zip 或 360-ai-cloud-disk-mcp-skill.zip
• 解压到对应平台的 ~/skills 目录下：

# macOS/Linux
cd ~ && mkdir -p skills
cd skills
unzip ~/Downloads/360-ai-cloud-disk-cli-skill-v<version>.zip 或 360-ai-cloud-disk-mcp-skill-v<version>.zip
# 或：unzip ~/Downloads/360-ai-cloud-disk-cli-skill.zip 或 360-ai-cloud-disk-mcp-skill.zip

# Windows
# 解压到 C:\Users\你的用户名\skills 目录

2. 配置环境变量

编辑 ~/skills/skill-xxx/.env 文件：

# 必需的 API 密钥
API_KEY=your-api-key-here

# 环境配置
ECS_ENV=prod    # 或 test
SUB_CHANNEL=open

# 连接模式（推荐 HTTP）
MCP_MODE=http
MCP_HTTP_URL=https://mcp.yunpan.com/mcp

3. 部署到 OpenCode

OpenCode 的 Skills 目录通常位于：

• macOS: ~/Library/Application Support/OpenCode/skills/
• Linux: ~/.config/OpenCode/skills/
• Windows: %APPDATA%\OpenCode\skills\

# 创建 Skills 目录（如果不存在）
mkdir -p ~/Library/Application\ Support/OpenCode/skills/

# 复制 Skill 到 OpenCode Skills 目录（按实际解压目录）
cp -r ~/skills/360-ai-cloud-disk-cli-skill-v<version> ~/Library/Application\ Support/OpenCode/skills/360-ai-cloud-disk-cli-skill
# 或：cp -r ~/skills/360-ai-cloud-disk-cli-skill ~/Library/Application\ Support/OpenCode/skills/360-ai-cloud-disk-cli-skill

4. 重启 OpenCode

重启 OpenCode 以加载新的 Skill。

5. 验证集成

在 OpenCode 中打开聊天窗口，输入：

请帮我查看云盘根目录的文件列表

如果集成成功，OpenCode 会调用 360 Cloud Disk Skill 并返回文件列表。

Claude Code 集成

1. 获取 Skill

使用本地打包产物进行分发（推荐，CLI Skill）：

1. 在项目仓库执行：npm run skill-cli:package（带版本）或 npm run skill-cli:package:no-version（固定文件名）
2. 解压 packages/360-ai-cloud-disk-cli-skill-v<version>.zip 或 360-ai-cloud-disk-mcp-skill-v<version>.zip 或 packages/360-ai-cloud-disk-cli-skill.zip 或 360-ai-cloud-disk-mcp-skill.zip 到对应平台的 ~/skills 目录下：

# macOS/Linux
cd ~ && mkdir -p skills
cd skills
unzip ~/Downloads/360-ai-cloud-disk-cli-skill-v<version>.zip 或 360-ai-cloud-disk-mcp-skill-v<version>.zip
# 或：unzip ~/Downloads/360-ai-cloud-disk-cli-skill.zip 或 360-ai-cloud-disk-mcp-skill.zip

# Windows
# 解压到 C:\Users\你的用户名\skills 目录

2. 配置环境变量

编辑 ~/skills/skill-xxx/.env 文件：

# 必需的 API 密钥
API_KEY=your-api-key-here

# 环境配置
ECS_ENV=prod    # 或 test
SUB_CHANNEL=open

# 连接模式（推荐 HTTP）
MCP_MODE=http
MCP_HTTP_URL=https://mcp.yunpan.com/mcp

3. 部署到 Claude Code

Claude Code 的 Skills 目录通常位于：

• macOS: ~/.claude/skills/
• Linux: ~/.claude/skills/
• Windows: %USERPROFILE%\.claude\skills\

# 创建 Skills 目录（如果不存在）
mkdir -p ~/.claude/skills/

# 复制 Skill 到 Claude Code Skills 目录（按实际解压目录）
cp -r ~/skills/360-ai-cloud-disk-cli-skill-v<version> ~/.claude/skills/360-ai-cloud-disk-cli-skill
# 或：cp -r ~/skills/360-ai-cloud-disk-cli-skill ~/.claude/skills/360-ai-cloud-disk-cli-skill

4. 重启 Claude Code

重启 Claude Code 以加载新的 Skill。

5. 验证集成

在 Claude Code 中打开聊天窗口，输入：

请帮我查看云盘根目录的文件列表

如果集成成功，Claude Code 会调用 360 Cloud Disk Skill 并返回文件列表。

使用示例

查看文件列表

请列出云盘根目录的文件

搜索文件

搜索包含"报告"的文档文件

创建目录

在云盘根目录创建一个名为"工作文档"的文件夹

保存文件

将这个文档保存到云盘的"工作文档"文件夹中

分享文件

分享云盘中的"年度报告.pdf"文件

移动文件

将"文档/草稿.txt"移动到"归档/2024/"文件夹

重命名文件

将"文档/旧名称.doc"重命名为"新名称.doc"

获取下载链接

获取"文档/报告.pdf"的下载链接

查看用户信息

查看我的云盘用户信息

常见问题

1. Skill 未加载

症状：在 OpenCode/Claude Code 中无法使用 360 Cloud Disk Skill

解决方案：

• 确认 Skill 目录结构正确
• 检查 .env 文件是否存在且配置正确
• 重启 OpenCode/Claude Code
• 查看日志文件确认是否有错误

2. API Key 无效

症状：调用工具时返回 invalid_token 错误

解决方案：

• 检查 .env 文件中的 API_KEY 是否正确
• 确保环境变量格式正确（无多余空格）
• 使用 ECS_ENV=test 进行测试

3. HTTP 连接失败

症状：调用工具时返回连接错误

解决方案：

• 检查 MCP_HTTP_URL 是否正确
• 确保网络连接正常
• 检查防火墙设置
• 尝试增加 MCP_HTTP_TIMEOUT 值

4. 权限问题

症状：无法复制 Skill 到目标目录

解决方案：

• 确认目标目录存在
• 检查目录权限
• 使用 sudo 命令（Linux/macOS）或以管理员身份运行（Windows）

5. 独立 skills 仓库中的故障排查入口失效

症状：在 skills 仓库根 README 中点击旧的 360-ai-cloud-disk 故障排查入口无法打开。

说明与处理：

• 新目录已统一为 360-ai-cloud-disk-cli-skill，旧目录入口已下线。
• 当前排查入口建议使用：
  • 360-ai-cloud-disk-cli-skill/SKILL.md
  • 360-ai-cloud-disk-cli-skill/references/tools.md
  • 平台帮助中心：/docs/mcp-server/troubleshooting

最佳实践

1. 使用 HTTP 模式：最简单、最稳定的配置方式
2. 定期更新 Skill：MCP Server 更新后及时重新生成 Skill
3. 测试验证：集成后务必测试功能是否正常
4. 安全存储：不要将 .env 文件提交到版本控制系统
5. 使用绝对路径：在 .env 中设置 MCP_SERVER_DIR 为绝对路径（local 模式）
6. 监控日志：定期查看 OpenCode/Claude Code 日志，及时发现和解决问题

下一步

• 配置说明 - 详细的环境变量和连接模式配置
• 工具参数 - 所有工具的详细参数说明
• Skill 模式介绍 - Skill 模式的概述和快速开始
• MCP Server 文档 - MCP Server 的完整文档