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、儲存體、保留和部署設定放在版本控制中。
  • 在後端分支上測試危險變更，然後觸及生產環境。