Tencent Drive(Weiyun) MCP

1. 上传文件应该怎么做：直接用 python3 scripts/upload_to_weiyun.py <文件路径> --pdir_key <目录key>，无需手动计算参数或调用 MCP 2. 下载时 pdir_key 应该填什么：使用 weiyun.list 响应中顶层的 pdir_key，而不是文件自身的 pdir_key 字段（该字段可能为空字符串） 3. 生成分享链接时 pdir_key 不能为空：必须先调用 weiyun.list，使用响应顶层的 pdir_key（不是 file_list[i].pdir_key，该字段通常为空）。pdir_key 为空会导致分享链接打开异常 4. 查询子目录时 pdir_key 怎么填：填入子目录所在父目录的 key。对于根目录下的子目录，就是根目录 weiyun.list 响应顶层的 pdir_key 5. 下载时需要携带 cookie：weiyun.download 返回的下载链接需要用 curl -b "" 携带 cookie 值，同时 -L 跟随重定向 6. 上传报 "Cannot upload to a directory that you do not own"：必须指定 --pdir_key 参数。先调用 weiyun.list 获取响应中顶层的 pdir_key 7. 分片上传通道 len=0：每轮上传完一片后，返回的通道列表可能全部 len=0，需要重新预上传获取下一批通道。upload_to_weiyun.py 已自动处理此问题 8. SHA1 不匹配：确保分块 SHA 值使用流式 SHA1 内部状态（小端序），而非独立分块 SHA1 9. file_sha 被覆盖：服务端用最后一个 block 的 SHA 覆盖 file_sha — 两者必须相等 10. Base64 双重编码：MCP 框架自动将 base64 字符串转为 bytes 传给 file_data 字段，服务端会再次进行 Base64 解码 11. 通道 ID 不匹配：上传分片时 channel_id 必须与 channel_list 中某个条目匹配 12. 环境标识：SIT 环境需在 Cookie 中携带 env_id=sit-xxxxx 13. 权限校验：下载、删除、分享操作会校验目录所有权，非本人目录的文件会被跳过 14. 腾讯文档过滤：列表查询会自动过滤腾讯文档类型的文件 15. pip install requests：上传脚本依赖 requests 库，如提示缺少请先安装：pip install requests 16. 所有需要 pdir_key 的操作（下载、删除、分享、上传、重命名），都应使用 weiyun.list 响应顶层的 pdir_key，而不是文件/目录条目自身的 pdir_key 字段 17. Windows 编码要求（防止中文乱码）：Windows 下执行 Python 脚本或 mcporter 命令前必须先切换控制台代码页为 UTF-8，格式为 chcp 65001 >nul && python ...。Python 脚本已内置 _encoding_fix.py 模块自动修复 stdout/stderr 编码，但 chcp 65001 仍然是必要的（确保 cmd/PowerShell 控制台本身使用 UTF-8 解码输出） 18. Windows 下使用 python 而非 python3：Windows 系统通常使用 python 命令，macOS/Linux 使用 python3。请根据用户操作系统自动选择正确的命令 19. 重命名文件/目录：先调用 weiyun.list 获取 file_id/dir_key、dir_name 和顶层 pdir_key，再调用 weiyun.rename_file 或 weiyun.rename_dir（重命名目录时需额外传 src_dir_name 即原目录名） 20. 按分类查找文件：使用 weiyun.list_by_category，通过 category_id 或 lib_id 指定分类，支持 server_version 续拉。该接口需要同时携带真实微云 cookie 和 mcp_token 21. 生成带密码的分享链接：在调用 weiyun.gen_share_link 时设置 passwd 参数即可创建加密分享 22. 创建文件夹：调用 weiyun.create_dir，传入 pdir_key（父目录 key）和 dir_name（文件夹名称）。pdir_key 为空时在 token 绑定的根目录下创建。返回的 dir_name 可能因同名冲突被自动改名 23. 移动文件/目录：使用 weiyun.move_file 或 weiyun.move_dir。需要先通过 weiyun.list 分别获取源目录和目标目录的 pdir_key，填入 src_pdir_key 和 dst_pdir_key。两个 key 都不能为空 24. 移动操作的目录 key 获取：src_pdir_key 来自文件/目录当前所在位置的 weiyun.list 响应顶层 pdir_key；dst_pdir_key 来自目标位置的 weiyun.list 响应顶层 pdir_key 或目标目录的 dir_key 25. 删除目录返回 1192 错误：dir_name 是删除目录时的必填字段，需通过 weiyun.list 获取目录的 dir_name 后传入 weiyun.delete。删除文件不需要此字段 26. 上传时报 50000 服务繁忙：这是服务端瞬时不可用，非 MCP 工具缺陷。等待 2~5 秒后重试，最多 3 次。推荐使用 upload_to_weiyun.py 一键上传脚本（已内置重试逻辑）