SuperAPI AI 工具集

box

办公与效率

查看项目

更新于 10-16 07:24

技能介绍

用途:该技能通过 /opt/hatch/bin/box-cli 访问 Box,用于搜索、读取、上传、下载、移动、重命名、删除、恢复和分享 Box 内容,并管理评论与元数据。

连接:先运行 /opt/hatch/bin/box-cli status 检查连接状态;若未连接,运行 /opt/hatch/bin/box-cli authorize-url,将返回的 connect_url 作为 Connect Box 分享。新连接默认申请只读权限,需等待浏览器授权后再次检查状态。执行可能需要更广权限的操作前,运行 status --for-command <command-or-method>;若 scope_status 为 not_granted,需原样复制返回的 scope_add_url 并单独成行发布为 Additional Box access,等待授权后重试。不要自行构造授权 URL 或替换原始 Box scope。OAuth 授权不替代 Muse 审批。

主要能力与用法:运行 list-tools 查看可用 MCP 工具、参数 schema 和 Muse 权限,再用 call-tool 配合 Box 返回的 ID 调用。get_file_content 读取文档文本;下载和变更默认需要 Muse 审批。示例命令包括 list_folder_content_by_folder_id 浏览根目录、search_files_keyword 搜索 PDF、get_file_details 查看元数据、create_folder 建文件夹、upload_file 上传文本、create_file_comment 发表评论。本地文件上传、完整下载、移动、重命名和删除使用文件命令,如 download、upload、update-file、delete-file;update-folder 和 delete-folder 使用 --folder-id;upload-version 替换文件内容且 --name 会重命名文件。

限制与错误处理:下载会覆盖输出文件;Box 回收站禁用时删除为永久操作,删除非空文件夹需 --recursive。list-trash 返回保留项,可用 --marker 分页,restore-file 或 restore-folder 恢复,--fallback-parent-folder-id 仅在原父文件夹不存在时生效。下载会报告保存路径和字节数,其他结果显示在 result 下,ok: false 表示失败。REST 命令只尝试一次:HTTP 202 表示文件未就绪可稍后重试下载,HTTP 401 先运行 refresh 再重试。只读托管 MCP 请求在 401 后刷新并重试一次;托管 MCP 写操作发送后不会自动重放,401 时应先检查 Box 是否已生效,再手动 refresh 并重试。仅当 refresh 失败时才重新连接 Box。不要通过其他命令重试被拒绝访问的操作。refresh 刷新连接,disconnect 断开 Box 与 Muse。