# @caffeineai/cli 中文文档 规范地址：https://npmcn.com/package/%40caffeineai/cli/ 版本：0\.2\.1 npm 元数据更新时间：2026-11-13T13:55:19.517Z 中文译文更新时间：2026-11-13T14:19:50.059Z 软件包许可：SEE LICENSE IN LICENSE 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40caffeineai/cli 原文对照：https://npmcn.com/package/%40caffeineai/cli/?lang=original 项目主页：https://caffeine.ai/ ## 关键信息（来自 npm 元数据） - 包体积（解压后）：13.3 kB，5 个文件 - TypeScript 类型：未声明 - 运行依赖：0 个 - 首次发布：2026-04-27T18:19:14.264Z - 最新版本发布：2026-11-13T13:55:19.335Z - 近 30 天下载量：7322（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：56（近 12 个月 56 个） ## 中文简介 咖啡因CLI(咖啡因CLI) ## 安装 ```sh npm install @caffeineai/cli ``` 也可以使用：`pnpm add @caffeineai/cli`、`yarn add @caffeineai/cli`、`bun add @caffeineai/cli` ## README # @caffineai/cli (英语) 公共咖啡因命令行界面认证, 项目 管理,本地开发工作流程,以及无头AI聊天. ## 开发发布 这是DEV发布。 在npm下发布 `dev` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}现在 需要迅速释放 CLI 时需要经常更新 软件包解决. ## 特征 - 设备和基于浏览器的登录 - 项目列名、检查、创建、克隆和删除 - 团队工作空间列表、状态和切换`X-Workspace-Id`(中文(简体) ) - 本地安装、构建、检查、预览、导入、导出、配置、医生和更新流量 - 在 Cafeine AI API 上进行互动和独立的聊天 - 浏览器在您想要网络用户界面时的聊天 ## 安装 ```bash npm install -g @caffeineai/cli@dev caffeine --version ``` 安装了三个相等的命令名称: `caffeine`, (中文(简体) ), `caf`,以及 `cfn`。 。 。 . ## 快速启动 ```bash caffeine auth login # Sign in caffeine projects list # List your Caffeine projects caffeine projects clone # Clone one locally caffeine build # Build the current project caffeine preview # Upload a draft to Caffeine cloud ``` ## 支持的平台 原生二进制船: - macOS arm64和x64 (中文(简体) ) - Linux arm64 和 x64, glibc 和 musl 语言 - 视窗臂64和x64 ## 图标 | 组 | 命令 | 说明 | | --- | --- | --- | | 认证 | `auth login [--device]` | 通过 OAuth 循环或设备流签名 | | 认证 | `auth logout` | 签字 | | 认证 | `auth status` | 显示当前会话 | | 项目 | `projects list` | 列出您的工程 | | 项目 | `projects show ` | 显示工程细节 | | 项目 | `projects create ` | 创建新工程 | | 项目 | `projects clone [--dest ] [--include-wip]` | 克隆本地项目 | | 项目 | `projects delete ` | 删除工程 | | 工作空间 | `workspaces list` | 列出个人账户和团队工作空间 | | 工作空间 | `workspaces status` | 显示选中的工作空间 | | 工作空间 | `workspaces use ` | 坚持团队工作空间,或 `personal` | | 当地 | `import ` | 从 a 导入工程 `.zip` | | 当地 | `export` | 导出当前工程为 a `.zip` | | 构建 | `install` | 安装构建依赖性 | | 构建 | `build` | 构建当前工程 | | 构建 | `check` | 验证代码和配置 | | 构建 | `preview` | 上传已建工程为草稿 | | 聊天 | `chat` | 打开或继续主交互聊天工作流程 | | 聊天 | `chat interactive` | 互动聊天工作流程的明确形式 | | 聊天 | `chat send ` | 立即发送并保持固定 | | 聊天 | `chat send --detach ` | 立即提交并返回 | | 聊天 | `chat reply ` | 发送免费澄清回复 | | 聊天 | `chat active` | 发现可能的活动聊天会话 | | 聊天 | `chat status` | 显示当前会议的高级别摘要 | | 聊天 | `chat watch` | 附加到动态会话和流更新 | | 聊天 | `chat resume` | 重新排队,等待下一个稳定状态 | | 聊天 | `chat transcript` | 显示当前记录 | | 聊天 | `chat feed` | 收集原始项目种子事件 | | 聊天 | `chat list` | 列出聊天消息 | | 聊天 | `chat tail` | 在AI到达稳定状态前, 播放聊天信息 | | 聊天 | `chat submit-form` | 提交结构化澄清表答复 | | 聊天 | `chat open` | 为工程打开浏览器聊天 | | 配置 | `config list` 编号 : `config get ` 编号 : `config set ` | 管理 CLI 配置 | | 信封 | `doctor [--fix]` | 诊断地方建设的先决条件 | | 元数据 | `update` | 检查或安装更新的 CLI | | 元数据 | `version` | 显示版本信息 | 运行 `caffeine --help` 为全旗列表. ## 聊天工作流程 ```bash caffeine chat caffeine chat --project-id 11111111-1111-4111-8111-111111111111 caffeine chat interactive --project-id 11111111-1111-4111-8111-111111111111 caffeine chat send --detach "Build a weather dashboard" caffeine chat active caffeine chat status caffeine chat watch --project-id 11111111-1111-4111-8111-111111111111 caffeine chat resume --project-id 11111111-1111-4111-8111-111111111111 caffeine chat transcript --project-id 11111111-1111-4111-8111-111111111111 caffeine chat feed --project-id 11111111-1111-4111-8111-111111111111 --timeout 5s caffeine chat submit-form \ --project-id 11111111-1111-4111-8111-111111111111 \ --message-index 42 \ --form-data '{"appName":"Habit Hero"}' caffeine chat open ``` 所有命令支持 `--json` 用于机器可读输出. `caffeine chat` 是人类的主要工作流程。 它可能恢复活动聊天 在目标项目的会话中,当无内容时,显示最近的记录尾部 活动,并让您继续对话直到退出. `chat interactive` 即明显的等同于赤裸 `chat`。 。 。 . 需要更多脚本或去除流程时使用下级子命令 : - `chat send --detach` 立即提交工作并返回 - `chat watch` 财务报告和审定财务报表 `chat resume` 重新加入飞行工作 - `chat transcript`, (中文(简体) ), `chat list`, (中文(简体) ), `chat tail`,以及 `chat feed` 显示原始聊天状态 - `chat reply` 财务报告和审定财务报表 `chat submit-form` 请你明确回答澄清 交互聊天不支持 `--json`。使用下级子命令用于 自动化、CI和机器可读输出. 澄清处理: - `ai_follow_up` 意思是AI想要更多的自由格式输入,所以回答 `chat reply` - `system_dialog` 与 `info.form` 意味着你应该打电话 `chat submit-form` - `ai_answer` 表示成功完成的交换 ## 贾森 而非交互模式 每个命令都接受 `--json`JSON输出使用一个稳定的信封: ```json { "ok": true, "data": {} } { "ok": false, "error": { "code": "...", "message": "..." } } ``` 使用 `--non-interactive` 在脚本和CI. `--workspace ` 财务报告和审定财务报表 `--personal` 是只处理的账户覆盖。 他们 不重写 `workspace.selectedId`。 。 。 . `caffeine workspaces use` 持续 选择以后的CLI和本地MCP进程. ## 认证 `caffeine auth login` 为 OAuth 流打开浏览器。 CI,远程 SSH 或其他无头环境,添加 `--device` 要使用设备流 换句话说. 托肯斯被存储在您的OS证书商店. ## MCP 服务器 从 Claude 代码、 Cursor 、 VS 代码、 Codex 、 Windsurf 或其他代码驱动咖啡因 MCP主机与伴星MCP服务器: ```bash npx -y @caffeineai/mcp@dev --version ``` CLI和MCP服务器共享相同的认证,工作空间,项目,构建和聊天合同. 一个登录流可以覆盖同一机上的两个工具. ## 链接 咖啡因平台: [https://caffine.ai (英语)](https://caffeine.ai/) 此软件包通过npm可选依赖安装匹配平台二进制. 直接安装主包而不是平台包. 每一版中的变化都发生在 `CHANGELOG.md`在读本旁边. ## 常见问题 ### @caffeineai/cli 是什么？ 咖啡因CLI\(咖啡因CLI\) ### 如何安装 @caffeineai/cli？ 在项目目录运行 npm install @caffeineai/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 caf、cfn、caffeine，可以用 npx caf 直接运行。 ### @caffeineai/cli 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/caffeineai\_\_cli 是否存在。 ### @caffeineai/cli 可以商用吗？ @caffeineai/cli 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。 ### @caffeineai/cli 的下载量有多少？ 根据 npm 官方下载统计，@caffeineai/cli 在 2026/10/09 – 2026/11/07 这 30 天内被下载 7,322 次，日均约 244 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @caffeineai/cli 还在维护吗？ 最新版本 0\.2\.1 发布于 2026/11/13（今天）；至今共发布 56 个版本，其中过去 12 个月发布了 56 个；首次发布于 2026/04/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。