Weiyun

微云网盘 MCP 技能

首次安装使用时，需要先完成本地安装和注册，详见 references/auth.md。

Windows 用户：所有 bash ./setup.sh 命令请替换为 powershell -ExecutionPolicy Bypass -File setup.ps1，详见 references/auth.md。

版本更新检查（每天首次使用前必须执行）

每天使用本 SKILL 前进行一次更新检查，按照如下步骤执行：

1. 查看当前版本 version

读取本文件顶部 frontmatter 中的 version 字段；格式为 MAJOR.MINOR.PATCH。

2. 查看最新版本 latest

通过命令获取最新版本信息 latest，输入参数 version 为上一步获取的当前版本：

mcporter call "https://www.weiyun.com/api/v3/mcpserver" "check_skill_update" --args '{"version": "当前版本"}'

Windows (PowerShell) 用户注意：需先切换 UTF-8 编码，单引号内的 JSON 需改为转义双引号：

chcp 65001 >nul && mcporter call "https://www.weiyun.com/api/v3/mcpserver" "check_skill_update" --args "{`"version`": `"当前版本`"}"

JSON 格式数据返回，返回参数示例：

3. 更新版本

如果当前版本 version 低于最新版本 latest，则遵循 instruction 指令进行更新，或提示用户更新。

功能概述

提供微云（Weiyun）网盘通过 MCP 协议进行文件管理的完整能力，包含 12 个 MCP Tool：

核心架构原则：文件哈希计算和 block_sha_list 生成必须在客户端/本地完成。服务端只接收预计算好的哈希值，不会接收原始文件数据来计算哈希。这种设计是为了防止海量请求打爆服务器的存储和 CPU。

触发场景

• 使用微云 MCP 工具进行文件管理（查询、下载、删除、上传、分享、重命名、创建文件夹、移动文件/目录）
• 上传文件到微云：优先使用 scripts/upload_to_weiyun.py 一键完成，无需手动计算参数或调用 MCP
• 按分类（文档、图片、视频等）查找微云文件（weiyun.list_by_category Tool）
• 重命名微云文件或目录（weiyun.rename_file、weiyun.rename_dir Tool）
• 在微云中创建文件夹（weiyun.create_dir Tool）
• 移动微云文件或目录到其他位置（weiyun.move_file、weiyun.move_dir Tool）
• 实现或调试微云 MCP 文件上传（weiyun.upload Tool）
• 计算 block_sha_list、check_sha、check_data 等上传参数
• 理解微云两阶段上传协议（预上传 → 分片上传）
• 检查技能版本更新（check_skill_update）
• 调试 FTN 上传错误或 SHA1 校验不匹配问题

接口一览（速查）

所有接口请求时都务必在 req_header 字段中携带上报数据（详见 references/api-tools.md）。

上传文件优先使用脚本：python3 scripts/upload_to_weiyun.py <文件路径> --pdir_key <目录key>（Windows 用 python，脚本依赖 requests）。

详细文档索引（按需加载）