# @caddis/cli 中文文档 规范地址：https://npmcn.com/package/%40caddis/cli/ 版本：0\.4\.100 npm 元数据更新时间：2026-11-09T02:57:05.935Z 中文译文更新时间：2026-11-09T05:32:40.545Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40caddis/cli 原文对照：https://npmcn.com/package/%40caddis/cli/?lang=original 项目主页：https://github.com/saajunaid/caddis-plugin#readme 源码仓库：https://github.com/saajunaid/caddis-plugin ## 关键信息（来自 npm 元数据） - 包体积（解压后）：14.1 MB，1007 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=20\.19 - 运行依赖：6 个 - 首次发布：2026-07-27T19:33:56.386Z - 最新版本发布：2026-11-09T02:57:05.588Z - 近 30 天下载量：6603（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：105（近 12 个月 105 个） ## 中文简介 安装、更新和诊断在您使用的每一个编码剂上的 Caddis dev 吊带( Claude Code, agy/ Antigravity, 以及更多). ## 安装 ```sh npm install @caddis/cli ``` 也可以使用：`pnpm add @caddis/cli`、`yarn add @caddis/cli`、`bun add @caddis/cli` ## README # @caddis/ cli (中文(简体) ) **一个安装、更新和诊断命令 [卡迪丝](https://github.com/saajunaid/caddis-plugin) 你使用的每一个编码代理都使用dev拉带.** ```bash npx @caddis/cli init # detect your agents, confirm, install caddis into each npx @caddis/cli doctor # what is installed where, and what to do about it ``` 如果使用一个以上的编码代理,则Caddis可以使用一个以上的地方 stale. 这个CLI是单一的正门. * * * ## 它会做什么 caddis是一个 **元安装器**它探测到机器上的特工和驱动器 **每个人都有自己的 本地安装机制** 它永远不会重新执行它们 也不会为你安装代理. | 探员 | 通过 | 如何安装 Caddis | 状态 | | --- | --- | --- | --- | | **克劳德代码** | `claude` 路径 | 其插件市场 | ✅ | | **不错** (反重力) | `agy` 路径 | 运入此套件的 caddis 捆绑(`--extras` 添加 `caddis-extras`(中文(简体) ) | ✅ | | **代码** | `codex` 路径/ `~/.codex` | 配置合并 | 计划 | | **GitHub 副驾驶** | `copilot` 路径/ `.github/copilot-instructions.md` | 配置合并 | 计划 | 代码和副驾驶 **检测和报告**从来没有写信。 他们是档案组的, 也就是说,要正确支持它们,就必须合并成你已经拥有的配置——即船舶 这是安全的,不是以前. **缺席是优雅的.** 失踪的特工有原因 绝对不会出错 一个代理失败 永远不会阻止其他人. * * * ## 安装 ```bash npx @caddis/cli # no install npm i -g @caddis/cli # then just: caddis ``` 要求数 **节点 20.19**。 。 。 . * * * ## 图标 ### `caddis doctor` 一个值得知道。 每个代理,caddis版本 每个实际有, 是否匹配什么 这艘CLI飞船 是从哪里读来的版本 以及修复每个缺口的确切命令. ``` Environment ✓ node 22.14.0 • platform win32 x64 • @caddis/cli 0.2.0 ✓ shipped pool 1.3.39 bundle antigravity-plugin @ 1.3.39 bundle antigravity-plugin-extras @ 1.3.13 Agents ▲ Claude Code — caddis 1.3.38 → 1.3.39 available C:\Users\you\AppData\Roaming\npm\claude.CMD agent version 2.1.220 read from `claude plugin list` → caddis update --agent claude ▲ agy (Antigravity) — caddis 1.3.38 → 1.3.39 available ~\.gemini\config\plugins\caddis\plugin.json → caddis update --agent agy • Codex — detected — not yet supported Summary 3 of 4 agents detected · 0 current · 2 stale · 0 not installed 2 things to fix: • Claude Code has caddis 1.3.38, this CLI ships 1.3.39 caddis update --agent claude • agy (Antigravity) has caddis 1.3.38, this CLI ships 1.3.39 caddis update --agent agy ``` `--strict` 当某物需要修复时退出非零( 对于 CI) 。 检测到但没有支持的物剂 信息,而不是失败,永远不要绊倒 `--strict`。 。 。 . `--json` 给出机器可读输出. **`doctor` 还检查是否 `@caddis/cli` 本身在 npm 后面** (单位:千美元) `npm view` 查找, 选择进入 `doctor` 仅 -- `status`编号 :`init`编号 :`update` 默认情况下保持无网络状态,这样他们就不会觉得挂下线了. 这很重要,因为上面的每张逐剂漂移检查 都比起装入的游泳池 _这个_ 安装 —— 一种本身僵化的CLI可以少报告漂移情况,尽管每项比较都是 没错 当落后时,医生补充说: ``` ▲ @caddis/cli 0.2.3 → 0.2.4 available npm i -g @caddis/cli@latest ``` 并算作一个 `--strict`\- 抽水问题,和代理漏洞一样. ### `caddis status` 与可观表相同的事实. 光着身子跑 `caddis` 这样做. ``` caddis cli 0.2.0 · pool 1.3.39 · extras 1.3.13 AGENT DETECTED CADDIS EXTRAS STATE ───────────────── ──────── ────── ────── ──────────────── Claude Code yes 1.3.38 — update available agy (Antigravity) yes 1.3.38 1.3.13 update available Codex yes — — planned GitHub Copilot no — — — 2 agent(s) behind — run caddis update (or caddis doctor for detail) ``` ### `caddis update` 将每个检测到的、 支持的代理带入此 CLI 中的 Caddis 版本, 通过该版本 特工的内在机制。 已存在的代理被跳过( E)`--force` 重新驾驶它们. **特务.** `caddis-extras` 是可选的长尾技能库。 没错 **从未安装 默认** - 它很大而且总是满载的,但是 `--extras` 加上它,一旦安装, 平地 `update` 保持它流畅 以免它被遗忘的旗帜所腐烂 它的版本独立于 核心池,这样 `status` 财务报告和审定财务报表 `doctor` 在单独的一栏中报告漂移情况. ```bash caddis init --extras # core + extras caddis update --extras # add extras to an existing install ``` ### `caddis init` 初行所行相会. 检测,显示它要运行的确切内容,询问,然后安装. `--yes` 跳过 请求CI. ### `caddis hub` 一个本地网页(只有127.0.0.1页),其中包含您的重置,公关,计划和直播会话. `caddis hub start` 开始于背景; `caddis hub stop` 别闹了. **更新本身.** 运行中的中枢检查 npm 一个新的 `@caddis/cli` 开始后60 s,然后每30分钟一次. 当发布较新的版本时,中心会安装它(`npm i -g @caddis/cli@`),检查已安装的版本,并在同一端口重新启动. 打开标签显示"caddis中枢更新到X,再装入"并重新装入. 手册 `npm i -g @caddis/cli` 并在一分钟内重新启动中枢。 一个失败的安装使旧的枢机运行,并在一个小时后再次尝试. 只有运行于全局 npm 安装的中枢才会安装更新: 运行于 dev 退出或 `npx` 只有日志"更新可用". 只检查和日志, 设置 `"auto_update": false` 内 `~/.caddis/hub/config.json`。每一步 `~/.caddis/hub/hub.log`。 。 。 . **从登录开始.** `caddis hub autostart enable` 在每个登录后启动中枢,所以在重启后会回来。 在 Windows 上创建登录任务 `caddis-hub`。当 Windows 拒绝任务时(对于不是管理员的用户来说,“拒绝访问”),它表示 `caddis-hub.vbs` 在您的启动文件夹中, 信件中写着它用的哪个 . `caddis hub autostart status` 显示已设置的; `caddis hub autostart disable` 将两者去掉. **最后一个登录.** 运行 `caddis hub open` 获取一次性登录码并打开中枢. 您的会话持续7天,没有使用,最多30天, 它从一个中心重启中存活下来. **时间线第一,董事会第二.** 路线图和计划默认在时间线视图上打开,审计委员会视其为第二个选项。 点击时间线上的任何相位平板来打开相位面板并读取其跟踪器状态,PR链接和计划部分文本. **分支进展.** 一个公开的PR修改计划显示PR分支的Tracker和 `status:`带着徽章 `on branch (PR #n)`。在主干线上完成后永远不再返回,叉子不显示。 中心读取来自GitHub的PR头和来自本地的分站对接,从不取取. 没有公关数据 上面的线说 `branch progress off (no PR data)`。 。 。 . `caddis hub export --prs ` 取输出 `gh pr list --json number,headRefName,isDraft,isCrossRepository,updatedAt`。“导出”从不公布分支名称,而“隐私”只出现在分支内容中只公布主要内容. **指南海报和细节.** 《指南》的网页有: `Poster` 选项卡(与 `Workflow` 财务报告和审定财务报表 `Mind map` 视图,加a `Print` a3 风景墙海报)和 `Details` 选项卡。 海报上的每件物品都链接到它在"细节"中的条目. **指南墙海报.** 第三个标签, `Wall poster` (单位:千美元)`#/guide/wall`),显示了一个A4景观表:按顺序排列的每日命令,每个舞台的卡片(计划,建设,审查,船舶,连续性,知识,设置),以及代理. 这个 `Print` 按钮在一页上准确打印工作表。 它由与其他标签相同的已安装的向导数据所构建,所以一个新的命令、代理或计数本身在之后出现 `caddis update` 并启动中枢。 文字在向导成长时会收缩(最多为60%),所以没有被切断. 每行是描述的第一条;"细节"标签有全文. **向导地图.** 第四个标签, `Map` (单位:千美元)`#/guide/map`),列出整个插件:每日循环(计划、建设、审查、船舶)及其命令,辅助道(持续、知识、设置),钩子作为会话解雇它们的时间表,代理商及其模型和一个 `writes files` 标记,按家庭分列的技能,以及接收caddis的运行时间。 每个名字都链接到它在"细节"中的条目. 过滤箱会暗指不匹配的东西,而且 `Print` 在 A3 地貌上打印地图。 地图上的任何内容都不是由手书写的: 它是从安装的向导数据中构建的,所以一个新的命令,代理,技能或钩子本身在之后出现 `caddis update` 并启动中枢. **多个代理的会话.** 克劳德代码会话来自 `claude agents --json`疯狂的 (Antigravity)会话来自caddis agy hooks:每个gy turn会写一个状态文件,并且 中枢以 `agy` 芯片。 芯片。 开始的一转 `working`。结束的一转 `waiting` (等待您,45 s之后). 10分钟未写入的会话 `idle`除非它等待 和它的疯狂过程仍然运行。 中枢在其进程时会降会话 停止或当它没有写到24小时。 无头运行( E)`CADDIS_HEADLESS`)无所写. 任何其他代理都可以以同样的方式显示其会话. 每个会话写一个 JSON 文件到 `~/.caddis/sessions/.json` (单位:千美元)`CADDIS_HOME` 替换主文件夹)。 写入临时文件 在文件夹中,然后重命名为目标: ```json { "session_id": "c0ffee-1234", "harness": "my-agent", "caddis_version": "1.3.200", "pid": 4242, "started": 1793000000.0, "last_seen": 1793000300.0, "status": "waiting", "status_since": 1793000300.0, "cwd": "/work/shop", "repo_path": "/work/shop", "waiting_for": "input needed" } ``` - 时间是Unix秒. `status` 实值 `working` 或者说 `waiting`; 中枢忽略一个没有文件的文件. - `pid` 是代理人自己的程序,或者 `null` 当它不知道的时候。 带了个活塞 中心就掉了 当进程停止时,会话。 没有了,只有时间. - `harness` 给探员起名 中枢跳过 `claude`,因为克劳德代码会话来自 `claude agents`。 。 。 . - `cwd` 将届会置于重播之下. `waiting_for` 这是很短的理由;等待时显示. - 前六个键是会话心跳 `caddis doctor` 已经读取。 不取出他们. ### 删除 Caddis **没有 `caddis remove`。 。 。 .** 此 CLI 安装并更新; 它永远不会卸载 。 清除去 通过每个特工自己的指挥——与这里其他一切相同的原则: ```bash claude plugin uninstall caddis@caddis # Claude Code claude plugin uninstall caddis-extras@caddis agy plugin uninstall caddis # agy agy plugin uninstall caddis-extras ``` `npm uninstall -g @caddis/cli` 删除 **只有这个CLI**,而不是它安装到的 caddis 插件 你的探员 如果你想让Caddis完全消失的话 先把那些装好. * * * ## 旗帜 | 旗帜 | 效果 | | --- | --- | | `--dry-run` | 打印确切的供应商命令; 无更改 | | `-y, --yes` | 从不提示 | | `-a, --agent ` | 限于特定代理人`claude`, (中文(简体) ), `agy`, (中文(简体) ), `codex`, (中文(简体) ), `copilot`(中文(简体) ) | | `--extras` | 同时安装可选 `caddis-extras` 长尾技能(`init`, (中文(简体) ), `update`(中文(简体) ) | | `--json` | 机器可读输出`doctor`, (中文(简体) ), `status`(中文(简体) ) | | `--strict` | 退出 1 当某事需要修复时 (`doctor`(中文(简体) ) | | `--no-update-notifier` | 跳过“ 更新的 @ caddis/ cli 可用” 检查 | 旗帜在子命令之前或之后工作 : `caddis update --dry-run` 财务报告和审定财务报表 `caddis --dry-run update` 都一样. **总是可以安全预览 :** ```bash $ caddis update --dry-run · Claude Code — dry run — nothing executed would run: claude plugin marketplace update caddis would run: claude plugin update caddis@caddis · agy (Antigravity) — dry run — nothing executed would run: agy plugin install ``` * * * ## Caddis 内容来自何处 卡迪丝把船捆了起来 **在此 npm 包内**, 与 CLI —— Caddis 相锁 安装是获得的卡地斯,没有额外的取回。 这就是为什么柏油球是几个MB: 搭载核心的疯狂捆绑和可选的 `caddis-extras` 图书馆. `doctor` 比较每个代理安装的 与所运出版本相对应的版本;这种区别就是"驱动"的通篇含义. ## 许可证 麻省理工学院 ## 常见问题 ### @caddis/cli 是什么？ 安装、更新和诊断在您使用的每一个编码剂上的 Caddis dev 吊带\( Claude Code, agy/ Antigravity, 以及更多\)\. ### 如何安装 @caddis/cli？ 在项目目录运行 npm install @caddis/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 caddis、caddis-cli、claude-glm、claude-oss、claude-deepseek，可以用 npx caddis 直接运行。 ### @caddis/cli 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/caddis\_\_cli 是否存在。 ### @caddis/cli 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @caddis/cli 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=20\.19。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @caddis/cli 可以商用吗？ @caddis/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @caddis/cli 的下载量有多少？ 根据 npm 官方下载统计，@caddis/cli 在 2026/10/09 – 2026/11/07 这 30 天内被下载 6,603 次，日均约 220 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @caddis/cli 还在维护吗？ 最新版本 0\.4\.100 发布于 2026/11/09（今天）；至今共发布 105 个版本，其中过去 12 个月发布了 105 个；首次发布于 2026/07/28。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。