中国移动云盘文件管理

要解决的问题

当大模型需要处理中国移动云盘文件时，常见困难是云盘路径、文件 ID、登录态与沙箱边界混用，导致搜索、上传、下载失败或误操作。cm-cloud-manage 用命令行接口封装常见云盘操作，并明确哪些命令可全盘检索，哪些写操作只能在沙箱内完成。

技能如何工作

技能入口是 python3 {baseDir}/scripts/main.py，各子命令参数以 -h 为准。核心流程是先用搜索或 list 找到文件/目录 ID，再用 workspace 获取沙箱路径和 fileId。

• 搜索：search_keyword 按文件名关键词全盘搜索；search_filter 按 -t、--ext、--start-at / --end-at、--size-min / --size-max 过滤，不支持关键词；分页使用 --limit 与上一页 meta 的 cursor。
• 目录列举：list 传入 dirId 列举直接子项，默认不递归；dirId 最多 20 个，逗号分隔；-r 可包含子目录。
• 写入沙箱：workspace 返回沙箱路径和 fileId；mkdir 创建目录，名称不能含 /；upload 上传本机 localPath 到目标 dirId。mkdir、upload 的 --to、download 的源都必须在沙箱内。
• 下载文件：如果源文件不在沙箱，先 copy 到沙箱，再 download。copy 的 srcId 可来自全盘，--to 必须是沙箱内目录；成功结果的 newFileId 是副本 ID。
• 授权：遇到 record: auth 时，取 loginUrl 提示用户登录；用户确认后重试同一命令。

适用边界

适合脚本化搜索、目录定位、上传、复制到沙箱和从沙箱下载。除根目录 / 外，参数优先使用接口返回 ID，不要用云盘路径。写操作需要确认，时间参数需成对，cursor 需整段回传，search_filter 不接受关键词，download 不能直接读取沙箱外文件。