新来这里？从通过 CLI 连接开始链接您的项目。本部分关于代理在连接后如何处理后端。
基元
CLI 工具
代理的双手。用于登录、架构、部署、配置和诊断的一个终端接口。
诊断和顾问
拉取顾问发现、DB 健康、指标和错误日志，代理可以读取和修复。
代码配置
身份验证、SMTP、存储、保留和部署设置存在于
insforge.toml 中。计划和应用如基础设施。分支
将整个后端克隆到隔离分支以测试危险更改，然后合并或重置。
为什么这很重要
人和代理想要来自后端的不同东西。一个人想要一个 UI 点击。一个代理想要一个稳定的文本接口，可以驱动、读取和推理。这在 InsForge 各处显示。 架构更改是您的存储库中的迁移，项目配置是一个insforge.toml 文件，所以代理编辑文本、提交它并在 PR 中评论它，而不是点击表单。当它想尝试危险的事情时，它旋转一个后端分支、运行对副本的更改并在出错时扔掉分支。当某些事情看起来不对时，它直接用 npx @insforge/cli diagnose 获取诊断和顾问发现，没有仪表板在循环中，这就是让它关闭像许可 RLS 策略这样的安全漏洞本身而不是等待人类记得检查。它还用 npx @insforge/cli metadata 直接从后端读取当前架构、日志和元数据，所以它从真实状态工作，而不是猜测。
循环
这些串联在一起。会话通常是这样的：- 用
npx @insforge/cli metadata读取当前状态。 - 分支后端、写一个迁移并检查什么是待处理的
npx @insforge/cli db migrations list，或编辑insforge.toml并用npx @insforge/cli config plan预览配置差异。 - 用
npx @insforge/cli db migrations up --all或config apply应用它，针对分支先，然后父项。 - 运行
npx @insforge/cli diagnose以检查顾问发现和错误日志，并问diagnose --ai以解释它们。 - 应用补救、重新运行诊断并合并分支。