使用说明

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

OpenCode 集成

1. 获取 Skill

直接下载指定版本的 Skill 压缩包：

• 下载地址：360-cloud-disk-skill-v0.7.5.zip
• 解压到对应平台的 ~/skills 目录下：

# macOS/Linux
cd ~ && mkdir -p skills
cd skills
unzip ~/Downloads/360-cloud-disk-skill-v0.7.5.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-cloud-disk-skill-v0.7.5 ~/Library/Application\ Support/OpenCode/skills/360-cloud-disk

4. 重启 OpenCode

重启 OpenCode 以加载新的 Skill。

5. 验证集成

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

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

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

Claude Code 集成

1. 获取 Skill

直接下载指定版本的 Skill 压缩包：

1. 下载地址：360-cloud-disk-skill-v0.7.5.zip
2. 解压到对应平台的 ~/skills 目录下：

# macOS/Linux
cd ~ && mkdir -p skills
cd skills
unzip ~/Downloads/360-cloud-disk-skill-v0.7.5.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-cloud-disk-skill-v0.7.5 ~/.claude/skills/360-cloud-disk

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）

最佳实践

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 的完整文档