Skip to main content
@insforge/cli 是编码代理用来操作后端的接口。当人类到达仪表板时，代理到达终端：它运行命令、读取输出并决定下一步做什么。每个命令都会说 --json，所以代理从结构化数据而不是解析屏幕。
使用 npx @insforge/cli 运行 CLI。不要全局安装，所以代理始终使用项目固定的版本。

​
为什么是代理的 CLI

仪表板为人类指针构建；CLI 为任何可以写文本的东西构建。传递 --json 到任何命令，代理获得可以解析的结构化结果；传递 --yes 它运行无需停止确认提示。架构、身份验证配置、存储、函数、部署、分支和诊断都是同一工具的子命令，所以有一个要学习的表面而不是要导航的仪表板。它在任何终端、任何编辑器或 CI 中运行，无需设置集成。在更改后，代理可以运行 npx @insforge/cli diagnose 并读取正确中断的内容。

​
命令表面

运行 npx @insforge/cli help <command> 以获取任何这些命令的标志。

​
升级和删除项目

projects update-version 将项目迁移到最新的 InsForge 后端版本。默认针对已链接的项目；传递 --project <id> 以选择其他项目。该命令会重启实例，因此预期会有短暂停机。添加 --wait 以阻塞直到更新完成。 projects delete 会永久删除项目：其数据库、存储以及所有其他资源，包括其后端分支。这里 --project 是必需的，且永远不会回退到已链接的项目，因此游离的环境值不会把删除指向错误的项目。两个命令在执行前都会确认，但仅在交互模式下：--yes 和 --json 都会跳过提示，所以 projects delete --project <id> --json 会立即删除。删除不可逆。切勿在此传递 --yes，并在命令运行前让人工核实确切的项目 ID。 要改为从仪表板执行其中任一操作，两者都位于 Settings → General。

​
典型代理运行

​
让代理解释输出

诊断配有 AI 标志，所以代理可以将自己的后端数据传递给模型并取回解释：
这将原始信号（顾问发现、DB 健康、错误日志）与纯文本阅读配对，这是将”这是堆栈跟踪”变成”这是修复”的原因。请参阅诊断和顾问。

​
后续步骤

  • 使用代码配置将身份验证、SMTP、存储、保留和部署设置放在版本控制中。
  • 在后端分支上测试危险更改，然后触及生产。