微云网盘 MCP

微云网盘文件管理的接入难点

微云的文件操作散落在 Web 前端与内部接口之间：目录遍历要传 dir_key 与 pdir_key，批量删除目录还得补上目录名，上传更是一套自研的哈希与分片协议。直接拿 HTTP 对接，很容易在分页游标、秒传判定和重试策略上反复踩坑。

这套技能是怎么工作的

它把能力包装成 12 个 MCP Tool：weiyun.list 做目录列表，weiyun.list_by_category 按文档 / 图片 / 视频分类分页并用 local_version 续拉，weiyun.download 批量取 HTTPS 链接，weiyun.upload 走两阶段协议，另外还有重命名、创建目录、移动文件与目录、生成分享短链。

上传是重点。第一阶段预上传只发送文件元数据与 block_sha_list，服务端据此判断能否秒传；第二阶段按返回通道逐片传输。哈希必须在本地算完再上报：分块 512KB，共享同一个 SHA1 对象，除最后一块外提取内部寄存器的小端输出，最后一块取整文件的标准 SHA1，且 file_sha 必须等于 block_sha_list 的末位值。upload_to_weiyun.py 封装了完整流程，gen_block_info_list.py 只算参数、便于调试。

边界与注意点

• 删除目录时 dir_name 缺失会直接报 1192，需要先从 weiyun.list 取回再传。
• 分享外链生成后无法用本技能下载，只能提示用户打开网页。
• weiyun.list 会自动过滤腾讯文档文件；list_by_category 需要真实微云 cookie 与 mcp_token 同时存在。
• 移动与分享都要用响应顶层的 pdir_key，传空字符串会导致失败。
• 上传遇到 50000 属于瞬时不可用，等 2~5 秒重试；117401 是当日配额耗尽；117407 需要重新授权。
• Windows 用户把 bash ./setup.sh 换成 setup.ps1，上传脚本里 python3 改 python。
• 每天首次使用前先跑一次 check_skill_update。