用途:该技能通过 /opt/hatch/bin/box-cli 命令访问 Box 云存储,在客户端中完成内容浏览、检索、读写与分享等操作。
主要能力:搜索文件(如按关键字与扩展名筛选 PDF)、列出文件夹内容、读取文档文本、查看文件元数据、创建文件夹、上传文本或本地文件、下载文件、移动与重命名文件、删除文件与文件夹、管理评论、处理回收站(查看 list-trash、用 restore-file/restore-folder 恢复)、上传新版本替换文件内容。可运行 list-tools 查看可用 MCP 工具、参数结构与 Muse 权限。
使用方式:先运行 /opt/hatch/bin/box-cli status 检查连接;未连接时执行 authorize-url 并在浏览器完成授权。新连接默认只请求只读权限。执行可能需更广权限的操作前,先运行 status --for-command <命令或方法名>;若 scope_status 为 not_granted,需按返回的 scope_add_url 在单独一行以 Additional Box access 形式提交等待同意,再重试原操作,不可自行构造授权链接。MCP 操作使用 call-tool 并传 --name 与 --arguments-json。示例:call-tool --name list_folder_content_by_folder_id --arguments-json '{"folder_id":"0","limit":20}';call-tool --name get_file_content --arguments-json '{"file_id":"<file_id>"}'。本地文件操作使用 download、upload、update-file、delete-file 等命令,update-folder 与 delete-folder 接收 --folder-id,upload-version 可替换并重命名文件,具体选项用 <command> --help 查看。
适用场景:需要在对话中检索 Box 文档、读取内容、整理目录、分享与协作评论、维护文件版本等。
限制与注意:下载会覆盖输出文件;Box 回收站关闭时删除为永久删除,删除非空文件夹需 --recursive。下载和变更默认需要 Muse 审批,OAuth 访问不替代 Muse 审批。结果是 ok: false 表示失败;REST 命令只尝试一次,遇 HTTP 202 可稍后重试下载,遇 HTTP 401 先运行 refresh 再重试,重试变更前先确认是否已生效;被拒绝的操作不要换命令重试。首次连接为只读权限。