Cosmic CLI

Cosmic CLI 是什麼？

Cosmic CLI 是一個 AI 驅動的指令列介面，將 Cosmic 平台功能帶入終端機工作流程。它旨在讓您在不離開指令列的情況下建置應用、管理內容、部署到生產環境，並執行或編排 AI 代理。

CLI 不僅依賴 Cosmic 儀表板，而是提供互動式和 AI 輔助的指令模式，透過自然語言指令和結構化工作流程來執行多步驟任務，例如產生包含儲存庫設定和部署的生產就緒應用。

主要功能

• 一指令安裝與全域 CLI 使用：使用 npm 或 bun 全域安裝 CLI，從終端機執行 Cosmic 功能。
• 互動式 shell 工作區導覽：啟動互動工作階段，包含指令歷史、工作區感知提示、檔案系統式導覽，以及使用設定前綴執行系統指令的能力。
• 具內容脈絡的 AI 聊天模式：使用包含完整內容脈絡意識的對話模式，並可透過旗標提供額外脈絡給 AI 運作。
• 自然語言應用產生與儲存庫設定：描述您想建置的內容；CLI 會產生連接到 Cosmic 專案的生產就緒應用，並準備 GitHub 儲存庫以供部署。
• 從儲存庫的 AI 驅動程式碼更新：連接到現有儲存庫，讓 Code Agent 分析程式碼庫、建立功能分支，並根據您的指示提交變更。
• Vercel 部署自動化：直接部署到 Vercel，包含環境變數管理、自訂網域處理、預覽部署和生產發布，並提供即時日誌串流。
• CLI 控制 AI 代理與工作流程：從終端機建立、執行和管理三種代理類型，包含擷取瀏覽器認證工作階段供 Computer Use Agents 使用、核准待處理作業，以及將代理串聯成 AI Workflows 並逐步監控。
• 儲存庫與環境變數管理：管理 GitHub 儲存庫、分支、拉取要求、環境變數和自訂網域，同時自動設定本地環境變數與正確的 Cosmic API 金鑰（包含 Next.js 專用變體）。
• 多種 AI 模型提供者：從多個 AI 提供者中選擇並設定預設模型（範例包含 Anthropic 的 Claude、OpenAI 的 GPT 和 Google 的 Gemini）。

如何使用 Cosmic CLI

1. 全域安裝 CLI，使用您偏好的方法（文章提及 npm 和 bun）。
2. 認證，使用兩種支援方法之一：使用者認證以取得完整儀表板存取，或儲存桶金鑰認證以快速存取特定儲存桶。
3. 啟動互動工作階段 或使用直接指令在 Cosmic 工作區中作業。
4. 建立或更新專案，使用自然語言指令產生應用，或連接到現有 Git 儲存庫進行 AI 輔助程式碼變更。
5. 從 CLI 部署到 Vercel，包含預覽部署和生產發布，由 CLI 處理環境變數與網域設定。
6. 從終端機執行 AI 代理與工作流程，監控執行進度並核准必要待處理作業。

使用案例

• 從構想到上線應用（包含內容與部署）：透過單一端到端流程產生連接到 Cosmic 專案的生產就緒應用，並建立 GitHub 儲存庫與上線 Vercel 部署。
• 維護與擴展內容作業：使用 AI 驅動內容建立產生 Cosmic 儲存桶中結構正確的物件，並使用互動內容聊天模式處理持續內容任務。
• 修改現有程式碼庫並產生審核就緒變更：指向您的儲存庫，讓 Code Agent 建立功能分支並根據指示提交變更，接著開啟拉取要求並部署預覽。
• 更新環境設定並可靠部署：使用 CLI 在部署期間管理環境變數與自訂網域，同時串流日誌追蹤部署進度。
• 從終端機協調多步驟 AI 任務：執行支援的代理類型並將其串聯成 AI Workflows，檢視每個步驟進度並在需要時取消執行。

常見問題

• Cosmic CLI 需要使用 Cosmic 儀表板嗎？ 不需要。CLI 旨在將 Cosmic 功能帶入您的終端機，包括內容管理、應用程式建立、部署以及代理編排。

• CLI 如何處理驗證？ CLI 支援兩種方法：使用者驗證（完整儀表板存取權）以及儲存桶金鑰驗證（無需登入即可快速存取特定儲存桶）。

• CLI 可提供哪些 AI 互動？ CLI 包含具內容脈絡的 AI 聊天模式，並支援可從終端機控制的 AI 代理與 AI 工作流程。

• CLI 可以部署到 Vercel 嗎？ 可以。CLI 內建 Vercel 整合，支援環境變數管理、預覽部署、生產環境發佈、自訂網域以及即時日誌串流。

• CLI 使用有方案限制嗎？ 本文指出，Cosmic CLI 遵循與儀表板相同的方案限制，包括 AI 代理的限制。

替代方案

• API 驅動整合（自行撰寫腳本）：如果您偏好完全控制，可圍繞 Cosmic 的 API 建置自己的終端機腳本，用於內容操作、儲存庫自動化與部署；這以自訂性交換便利性。
• IDE 中的通用 AI 程式碼助理：專注 IDE 的程式碼助理可協助程式碼變更，但可能無法直接涵蓋 Cosmic 專屬的內容結構化、儲存庫準備以及 Vercel 部署工作流程。
• 工作流程自動化工具（CI/CD 與編排平台）：編排工作與部署的工具可自動化部分工作流程，但您需要額外步驟來產生結構化 Cosmic 內容並協調代理互動。
• 以儀表板為主的內容與應用管理：當您需要視覺化工具時，留在 Cosmic 儀表板內是替代方案，雖然它無法提供本文所述的終端機互動殼層、儲存庫/部署自動化或 CLI 控制的代理工作流程。