跳到正文

用 AI 编程助手接入 ​

云匣的命令都可以不经交互运行,并输出 JSON,所以可以交给 Claude Code、Codex、Cursor 等编程助手按步骤完成接入。只有一件事留给你自己:保存腾讯云密钥。不要把 SecretId / SecretKey 发给 AI,也不要让它写进命令行参数或文件。

在客户端里一键复制 ​

macOS 客户端 的「存储」面板(点仓库标题右侧的存储状态)有「复制给 AI 的接入说明」。它会按仓库用的存储(腾讯云 COS 或 R2 等 S3 兼容存储;未接入时按面板里选的存储)生成一段提示词,带上:

  • 仓库路径和当前检查结果(已接入、需要处理的项目或未接入);
  • 客户端自带 CLI 的路径,终端里没有安装 yunbox 也能用;
  • 下面的步骤和安全规则。

粘贴给编程助手即可。

自己写提示词 ​

不用客户端时,可以把下面这段发给编程助手,把仓库路径换成你的:

text
请帮我把这个 Git 仓库接入云匣 YunBox(Git LFS 素材直传我自己的腾讯云 COS),并安装推送检查。
仓库:/path/to/repo

按顺序做,每一步先读 JSON 结果再决定下一步:
1. 运行 `yunbox doctor --json` 查看现状;不清楚的选项看 `git yunbox init --help`。
2. 如果缺少 COS 密钥:停下来,请我自己运行 `yunbox login`。不要向我索要密钥,也不要把密钥写进命令行、文件或仓库。
3. 运行 `yunbox buckets --json`,和我确认 bucket 和目录前缀;新建 bucket 前先问我。
4. 运行 `git yunbox init --bucket <名称-APPID> --region <地域> --prefix <前缀> --yes`。
5. 再运行 `yunbox doctor --json`,确认没有失败项。
6. 运行 `yunbox hook install`。
7. 问我是否需要禁推时段,需要时用 `yunbox freeze set "Mo-Fr 09:00-18:00"`,再用 `yunbox freeze check --json` 核对。
8. 把 .gitattributes 和 .yunbox/config 的改动给我看,由我决定是否提交;不要 git push。

仓库用 Cloudflare R2 或其他 S3 兼容存储时,把第 3、4 步换成:「和我确认 bucket 和 endpoint,然后按 git yunbox init --help 里的 --preset r2(或 aws、minio)接入」,密钥由我自己用 yunbox login --provider s3 保存,见接入 R2 和 S3 兼容存储。

终端里没有 yunbox 命令时先运行 npm install -g yunbox(需要 Node.js 22.18+)。

可以交给 AI 的命令 ​

命令输出用途
yunbox doctor --json每项检查和修复命令判断现状、核对结果
yunbox buckets --json本机密钥能看到的 bucket选择 bucket
git yunbox init --bucket … --region … --prefix … --yes文本接入,不再提问
yunbox hook install文本安装 pre-push 检查
yunbox inspect --push --json体积报告推送前检查
yunbox freeze set / list --json / check --json / off / on禁推时段设置、查看和临时关闭禁推时段

yunbox login 也支持 --secret-key-stdin,但请自己运行,不要让 AI 转交密钥。

AI 推送被拦下时 ​

装了 yunbox hook install --confirm 后,AI 运行的 git push 一旦超出预算,你的屏幕上会弹出确认对话框,由你来决定。对话框底部可以写一句原因,取消或继续都可以带上;光标默认就在输入框里,写完点按钮即可,不写也行。

原因会出现在 git push 的输出里,编程助手能直接读到:

text
已取消推送,原因:先把 opening.mp4 压到 200 MiB 以下再推
这是人工确认的结果:请按原因处理,不要提高限额或用 --no-verify 绕过检查后重新推送。

所以 AI 不会只知道「推送失败了」然后自己去调高限额重试,而是按你的意思处理:压缩文件、拆成几次推送,或者先停下来问你。继续推送时写的原因(例如「美术已确认」)也会显示出来。被取消的推送连同原因记在本机,macOS 客户端的「最近被拦截」里能看到。

没有窗口的环境(例如 Linux 终端)里,原因写在回答后面:n 先压缩图片、y 美术已确认。

MIT 许可证发布