介绍 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 存储桶中自动创建和构建内容对象。
• 自然语言应用程序构建： 只需描述您需要的内容，即可生成完整的、可投入生产的应用程序并连接到您的 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 "向 header 组件添加一个深色模式切换"。
• 用于部署： 执行 cosmic deploy --target vercel 将您的最新更改推送到线上。

CLI 会根据您当前的目录或指定的标志自动处理上下文、API 密钥和环境配置，确保开发任务之间的平稳过渡。

使用场景

Cosmic CLI 非常适合希望最大限度提高终端效率并利用生成式 AI 处理日常任务的开发人员和团队：

1. 快速原型设计和 MVP： 使用单个自然语言提示快速搭建整个应用程序结构，包括后端内容模型和前端样板代码，从而大幅缩短初始设置时间。
2. 自动化内容摄取： 对于大规模内容迁移或持续的数据录入，在 CI/CD 管道中使用 Content Agent 来研究、构建和自动注入数千个内容对象。
3. 即时代码重构： 当功能需要快速调整或修复错误时，开发人员可以使用 Code Agent 生成必要的更改、创建功能分支，并直接从终端打开 PR，避免切换到 GUI 的上下文。
4. CI/CD 集成： 将复杂的部署和环境配置步骤直接集成到自动化脚本中。CLI 使用环境变量管理确保跨暂存和生产环境的一致、可重复的部署。
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 用户凭据进行完全访问，或使用特定的 Bucket Keys 进行受限的自动化访问。CLI 安全地管理这些凭据，确保 API 密钥为本地开发和部署任务正确配置。

问：我可以使用 CLI 管理我的 Vercel 部署吗？ 答：绝对可以。CLI 内置了对 Vercel 的集成，允许您触发部署、管理自定义域名、配置特定于部署目标的 নয়ন 变量，并直接从终端流式传输实时日志。