用途：诊断 InsForge 项目中的故障，把后端可观测性原语组合成排查路径。所有命令通过 npx -y @insforge/cli 运行，不要全局安装 CLI。
主要能力（原语与命令）：日志 logs <source>（insforge.logs、postgREST.logs、postgres.logs、function.logs、function-deploy.logs）；指标 diagnose metrics（CPU/内存/磁盘/网络，1h/6h/24h/7d）；数据库健康 diagnose db（连接、慢查询、膨胀、大小、索引使用、锁、缓存命中）；顾问 diagnose advisor --json（安全/性能/健康）；策略 db policies（RLS 规则）；元数据 metadata --json；错误对象（读 SDK/HTTP 响应）；部署状态 deployments list 与 deployments status <id> --json；AI 辅助 diagnose --ai "<issue description>"。
常见用法：SDK 返回 error 时先读 code/message，按 PGRST* 前缀路由日志源；HTTP 4xx/5xx 按状态码选日志源；RLS 写入 403 或读取空结果时查 postgREST.logs、policies、metadata，必要时用 db query 以 service role 验证数据是否存在；登录/OAuth 问题查 insforge.logs 与 metadata；边缘函数错误查 function.logs 与 metadata；部署失败查 function-deploy.logs 或 deployments；慢查询查 postgres.logs、db-health、advisor；全站变慢查 metrics、db-health、日志聚合、advisor；实时通道问题查 insforge.logs、metadata、policies；429 不记录日志，修复在客户端；502/503/504 按 URL 子系统分流，小实例上跨路径 504 优先怀疑 OOM，可用 diagnose incident（需平台登录）获取结论。
限制：部分能力需平台登录，--api-key 链接模式下不可用；429 无日志与 Retry-After；升级实例会改变账单并重启项目，需用户确认；发现 InsForge 自身缺陷时可用 feedback 命令上报，但不要阻塞用户任务。资料未提供具体价格与更多细节。