用途:将 Box 作为云文件系统,完成文件操作、协作、元数据与文档工作。适合整理、上传、版本管理、移动、共享 Box 文件与文件夹,搜索内容或已有元数据,就 Box 文件提问、提取元数据或基于文件生成文本,批量处理文件夹而无需下载全部源文件,以及构建 Box 应用、集成或 webhook。
主要能力:通过 Hermes 终端工具运行 Box CLI,覆盖常规内容工作与 Box AI;支持 OAuth 授权,Hermes 以浏览器中授权的 Box 账号身份操作,权限由该账号决定。Box AI 提供 ai:ask(问答、摘要、比较)、ai:extract-structured(已知字段或元数据模板)、ai:extract(灵活键值提取)、ai:text-gen(基于单个 Box 文件写作)。超过 25 个文件的问答或可复用知识库可用 Box AI for Hubs。CLI 缺少子命令时可用 box request 调用对应 REST 端点。
使用方式:先确认 CLI 与当前操作者,POSIX 用 command -v box,PowerShell 用 Get-Command box -ErrorAction SilentlyContinue;若已安装则运行 box users:get me --json --fields id,name,login。缺少 box 时,经终端批准后在当前 Hermes home 的 tools/box-cli 安装 @box/cli,不要全局安装、使用 sudo 或改 PATH。OAuth 前需确认 Hermes 与授权浏览器是否在同一台计算机:同机用 box login,远程或无头用 box login --code。自定义 OAuth Platform App 仅在需要额外 scope(如 webhook 管理)时使用,client secret 只在本地 CLI 提示中输入。
限制与注意:Box AI 需启用并消耗 AI units,且受当前操作者权限限制;返回内容仍可能含敏感信息。Box 不允许创建全局元数据模板,企业模板管理超出常规 OAuth 内容工作流,需 Box 管理员或授权 Co-Admin 单独创建。删除、协作或共享链接、权限变更、身份变更、大规模批量变更或目标不明确时须先确认。共享链接会改变访问权限,不应仅为导航而创建。写入后需读回验证,元数据写入要逐字段比对。报告结果时附 ID 与可点击链接,如 https://app.box.com/file/<FILE_ID>、https://app.box.com/folder/<FOLDER_ID>、https://app.box.com/hubs/<HUB_ID>。