隆重介紹 Cosmic CLI：從您的終端機進行 AI 驅動的內容與程式碼管理

什麼是 Cosmic CLI？

Cosmic CLI 是一個強大、經過 AI 增強的命令列介面，旨在將 Cosmic 平台功能的完整範圍直接帶入您的終端機環境。它的根本目標是將傳統的多步驟開發工作流程——通常涉及結構設計、管理介面建置、前端編碼和 CI/CD 配置——濃縮為少數快速、自然語言的指令。透過將 AI 代理程式直接整合到命令列中，開發人員可以在幾分鐘內，從初步構想到完全可運作、已部署在 Vercel 等平台上的生產就緒應用程式，全程無需離開他們偏好的鍵盤驅動工作流程。

該工具認識到，雖然 Cosmic 管理介面提供了強大的視覺化環境，但開發人員在終端機中進行腳本編寫、自動化和追求速度時效率最高。Cosmic CLI 不僅僅是 API 呼叫的包裝器；它具有互動式 Shell、情境感知提示以及理解您的內容結構和程式碼庫的複雜 AI 聊天模式，允許使用簡單的對話式指令來執行複雜的操作。

主要功能

Cosmic CLI 充滿了專為速度、自動化和開發人員效率而設計的功能：

• AI 驅動的內容管理： 利用 內容代理程式 (Content Agent) 根據自然語言研究主題、匹配現有內容風格，並在您的 Cosmic 儲存區 (buckets) 中自動建立和建構內容物件。
• 自然語言應用程式建置： 只需描述所需內容，即可生成連接到您的 Cosmic 專案的完整、生產就緒的應用程式。CLI 負責處理腳手架、GitHub 儲存庫建立和部署準備工作。
• 智慧型程式碼更新： 程式碼代理程式 (Code Agent) 連接到現有的儲存庫，分析程式碼庫，根據指令智慧地實施所需變更、建立功能分支並提交更新。
• 單一指令部署： 無縫地將應用程式直接部署到 Vercel，內建環境變數、自訂網域和即時日誌串流的管理功能。
• 互動式 Shell： 啟動一個持續的會話，可以在其中運行指令而無需前綴，允許像導航本地檔案系統一樣導航您的 Cosmic 工作區，並輕鬆執行系統指令。
• AI 代理程式協調： 直接從 CLI 建立、運行和管理所有三種類型的 AI 代理程式（內容、程式碼、電腦使用），包括將它們鏈結成自動化的多步驟 AI 工作流程的能力。
• 多模型 AI 支援： 靈活選擇領先的 AI 提供商，包括 Anthropic (Claude)、OpenAI (GPT) 和 Google (Gemini)，並設定您偏好的預設模型。
• 檔案系統導航： 像導航本地檔案系統一樣直觀地導航您的 Cosmic 工作區層級結構（儲存區、專案）。

如何使用 Cosmic CLI

開始使用 Cosmic CLI 的設計宗旨是快速且直接。初始設定涉及全域安裝和身份驗證。

1. 安裝： 使用 npm 或 bun 全域安裝 CLI：

npm install -g @cosmicjs/cli
bun install -g @cosmicjs/cli

2. 身份驗證： 登入您的帳戶以獲得完整的管理介面存取權限，或使用特定的儲存區金鑰進行焦點操作：

cosmic login
# 或針對特定儲存區存取
cosmic login --bucket-key <YOUR_KEY>

3. 核心工作流程： 驗證身份後，您可以立即利用其強大功能：

• 建置： 使用類似 cosmic build "建立一個具有 'Posts' 內容類型的 Next.js 部落格範本並部署到 Vercel" 的指令。
• 管理內容： 輸入互動式 Shell (cosmic shell) 並使用對話式指令，例如 content create "撰寫一篇關於量子計算的文章，風格與我現有的內容相符"。
• 更新程式碼： 導航到您的專案目錄並運行 cosmic code update "在標頭元件中新增深色模式切換功能"。
• 部署： 執行 cosmic deploy --target vercel 以將您的最新變更推送到線上。

CLI 會根據您目前的目錄或指定的旗標自動處理情境、API 金鑰和環境配置，確保開發任務之間的順暢轉換。

使用案例

Cosmic CLI 非常適合尋求最大化終端機效率並利用生成式 AI 處理例行任務的開發人員和團隊：

1. 快速原型設計與 MVP： 使用單一自然語言提示快速建構整個應用程式結構，包括後端內容模型和前端樣板代碼，從而大幅減少初始設定時間。
2. 自動化內容攝取： 對於大規模內容遷移或持續資料輸入，請在 CI/CD 管線中使用內容代理程式來研究、建構和自動注入數千個內容物件。
3. 即時程式碼重構： 當功能需要快速調整或錯誤修復時，開發人員可以使用程式碼代理程式生成必要的變更、建立功能分支，並直接從終端機開啟 PR，避免切換到 GUI 的情境轉換。
4. CI/CD 整合： 將複雜的部署和環境配置步驟直接整合到自動化腳本中。CLI 使用環境變數管理，確保在 Staging 和 Production 環境之間部署的一致性和可重複性。
5. AI 代理程式管理： 建置複雜自動化解決方案的團隊可以使用 CLI 來管理、測試和協調複雜的多步驟 AI 工作流程，這些工作流程可以在沒有人工干預的情況下處理複雜的業務邏輯。

常見問題 (FAQ)

問：Cosmic CLI 是 Cosmic Dashboard 的替代品嗎？ 答：不是。CLI 旨在補充管理介面。它在速度、自動化和鍵盤驅動的工作流程方面表現出色，而管理介面仍然是視覺化內容編輯、複雜 UI 配置和高階專案監督的首選環境。

問：我可以使用哪些 AI 模型與 CLI 配合使用？ 答：CLI 支援多個領先模型，包括 Anthropic 的 Claude、OpenAI 的 GPT 系列和 Google 的 Gemini。您可以使用 CLI 旗標或配置設定來設定您偏好的預設模型。

問：CLI 是否尊重我現有的 Cosmic 方案限制？ 答：是的。Cosmic CLI 尊重與標準 Cosmic 管理介面完全相同的基於方案的限制（例如 API 呼叫、代理程式使用）。所有透過 CLI 執行的操作都會計入您已建立的帳戶配額。

問：身份驗證如何確保安全性？ 答：您可以使用您的主要 Cosmic 使用者憑證進行完全存取，或使用特定的儲存區金鑰進行受限的自動化存取。CLI 安全地管理這些憑證，確保 API 金鑰為本地開發和部署任務正確配置。

問：我可以使用 CLI 來管理我的 Vercel 部署嗎？ 答：絕對可以。CLI 具有內建的 Vercel 整合功能，允許您觸發部署、管理自訂網域、配置特定於部署目標的環境變數，並直接從您的終端機串流即時日誌。