# @chatcut/cli 中文文档 规范地址：https://npmcn.com/package/%40chatcut/cli/ 版本：0\.1\.3 npm 元数据更新时间：2026-10-30T13:36:16.554Z 中文译文更新时间：2026-11-09T11:39:45.152Z 软件包许可：UNLICENSED 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40chatcut/cli 原文对照：https://npmcn.com/package/%40chatcut/cli/?lang=original ## 关键信息（来自 npm 元数据） - 包体积（解压后）：100 kB，10 个文件 - 模块格式：ES Module - TypeScript 类型：未声明 - Node.js 要求：\>=22 - 运行依赖：0 个 - 首次发布：2026-10-26T12:08:00.661Z - 最新版本发布：2026-10-30T13:36:16.239Z - 近 30 天下载量：5818（2026-10-10 至 2026-11-08，npm 官方下载统计） - 已发布版本数：5（近 12 个月 5 个） ## 中文简介 安装、打开、诊断和维修 ChatCut 桌面 ## 安装 ```sh npm install @chatcut/cli ``` 也可以使用：`pnpm add @chatcut/cli`、`yarn add @chatcut/cli`、`bun add @chatcut/cli` ## README # 聊天集 CLI 官方ChatCut桌面应用程序的小命令行入口. 这个 不含视频编辑器、第二 MCP 服务器、下载的技能目录或 第三方运行时间依赖。 桌面拥有编辑、代理连接和 技术与应用版本一起运出. CLI工具和技能路线需要 `@chatcut/cli` 0.1.2 或后经. 合并源 仅更改不会发布新的 npm 版本. 在用户计算机上运行命令的任何代理都可以通过桌面 cLI(英语:CLI). 代理运行这些命令; 用户只处理登录或OS 需要时的批准按钮 : ```sh npx --yes @chatcut/cli connect --json npx --yes @chatcut/cli skills list --json npx --yes @chatcut/cli skills read product-help npx --yes @chatcut/cli tools list --json npx --yes @chatcut/cli tools describe get_active_project --json npx --yes @chatcut/cli tools call get_active_project --json ``` 常规 `connect`, (中文(简体) ), `tools` 财务报告和审定财务报表 `skills` 要求在此源更改之前先发布 命令可以从 npm 中获取. `connect` 验证一个真正的桌面工具呼叫 并返回可用的工具/技能名称。 这些命令重用已运行的 桌面认证的本地IPC连接及其MCP工具调度器. 他们 仅在需要时安装/打开已签名的制作桌面,同时使用已有的 出版社检查。 工具调用不会启动第二次电子运行时间. 它们不需要本地主机注册或重启主机. 技能内容 来源于已安装的桌面版本, 因此发现名称而不是假设 新的技能已经存在. `skills read --file references/` 读取 支持该技能范围内的文件。 工具计划来自活服务器. 对于工具参数,使用 `--args-file ` 或者说 `--args-file -` 与 JSON 打开 stdin; (中文(简体) ); `--args ''` 还提供。 公开辩论意味着 `{}`检查 退出代码和 `ok`,并保存返回的 MCP 结果和原始错误. 电话从不自动重审:超时可以跟随状态变化. `--timeout ` 设置1至1800秒之间的调用超时(默认为300). CLI 曝光相同的桌面工具及其权限; 引用编辑 工具可以改变一个项目。 CLI 访问与装入工具分离 主机自己的工具表,应相应报告. 包括Grok Bot在内的Cloud代理商必须使用经批准的本地计算机指令 能够运行此 CLI 。 云壳不能到达用户的本地套接字; cLI从不通过公共地道曝光桌面,也不复制登录机密. ```sh npx --yes @chatcut/cli app # Optional permanent command: npm install --global @chatcut/cli chatcut chatcut app ``` 需要节点.js 22+. 桌面支持苹果硅或英特尔上的macOS 13+和 Windows x64 (英语). 此启动器不会在 Linux 或无头服务器上安装 GUI . `chatcut` 财务报告和审定财务报表 `chatcut app` 重新使用一个安装的, 签名的生产应用程序。 当它是 丢失,他们下载官方的文物,验证其出版商,安装 必要时为当前用户,并请求启动。 重复通话保留 现有应用程序、账户和项目。 失败的发射永远不会触发替换. macOS拷贝使用新的中接捆和回滚,而不是合并捆绑. Windows使用签名的每个用户NSIS安装器. OS政策,缺少权限, 签字评估失败则保留其原始证据. ```sh chatcut connect --json chatcut connect --client codex --json chatcut connect --client claude-code --json chatcut doctor --json chatcut doctor --client codex --json chatcut doctor --fix --json chatcut update --json ``` `connect --client ` 是可选的本地主机设置入口。 它打开/ 安装桌面, 询问桌面 注册或修复所支持的代理集成并同步其管理 然后用真正的工具调用验证本地 MCP 连接。 工具为 通过桌面的 MCP 服务器提供 。 使用 `--client` 选择 `codex`, (中文(简体) ), `claude-code`, (中文(简体) ), `hermes`, (中文(简体) ), `workbuddy`, (中文(简体) ), `deepseek-harness`, (中文(简体) ), `qwen-work`,或 `doubao-work`。 。 。 . 无 `--client`, (中文(简体) ), `connect` 不修复本地主机而建立 CLI 访问权限 登记册; `doctor --fix` 检查和修复所有已知的整合。 自动连接和技能 修复支持 Codex, Claude Code, Hermes, WorkBuddy, DeepSeek Harness 桌面 profile, and Quen Work (千问办公). 缺少主机配置之家被跳过; 命令不安装这些代理. Doubao Work (QQ) 支持自动管理的技能同步到 `~/DoubaoWork/skills` 和现场桌面连接诊断。 首次参加MCP 注册使用Doubao的签名自定义连接器UI. `connect` 编制 应用程序本地设置技能和精确连接器设置, 然后打开一个 Doubao 任务与已选择的技能和请求。 用户单击发送和任何 需要登录或系统许可按钮。 Doubao的本地电脑使用工具 填充并保存正式表格,然后验证一个真正的连接器工具调用; 用户不输入命令、路径、运输类型或环境变量. 设置任务使用 `/bin/sh` 以发射器作为关于macOS的单独论据, 因为杜宝在空间上分割了它的指挥场. 窗口设置用途 `cmd.exe` 和单独的论据, 仍然需要本地接受。 系统权限 可能需要重启 Doubao; 任务必须在中断后恢复. 一旦注册, `doctor --fix` 更新稳定的发射器和拥有的技能. 一个主机只有在它认证的活的 MCP 会话成功后才能连接 列出工具; 结束该会话可清除该值。 一个成功的工具呼叫 单独列报于 `discovery.lastToolCall`。这是配置客户端 归属,不是新的宿主身份/安全边界。 一个独立的医生探测器 不建立主机发现。 命令报告设置不完整 在主机设置任务待决时失败 。 打开任务不是连接 成功吗? 它从不写出被猜想为"多巴"(Doubao)MCP注册或借入浏览器证书. DeepSeek 的配置适配器使用 `$DSH_HOME/profiles/desktop/cordis.patch.yml` (默认) `~/.dsh`和 `$DSH_HOME/skills`. Quen的后遗症适配器使用 `~/.qwenworkcn/mcp.json` 财务报告和审定财务报表 `~/.qwenworkcn/skills`; Quen Work 1.4.0 使用一个 帐号扫描连接器注册,但没有在 本地测试。 书面配置不是实用的本土融合. 在本地注册未解决时使用 CLI 访问 . 命令重复使用 `doctor --fix`包括长期退出和保留定制技能. 为跳过的主机或剩余动作读取返回的发现; 通过检查 并不意味着选择退出或没有可用的主机已连接。 读取 `hostHandoffs` 即使当 `ok` 真实性: 诊断客户端无法在 呼叫探员 先检查探员的技能和工具 如果已经工作,则避免再次装入。 否则将采取以下具体行动: | 东道主 | 代理应该告诉用户 | 接受证据 | | --- | --- | --- | | 代码 CLI | 退出并重开代理会话 | 新鲜的 CLI 0.160.1 读取已安装的技能并成功调用桌面; 未建立每个重新装入选项的必要性 | | Codex 桌面应用程序 | 尝试已准备好的新对话; 如果缺少工具, 重新启动 Codex | 等待重新装入应用程序 | | 克劳德代码 | 退出并重开代理会话 | 本地接受目前被登录所阻断 | | 赫尔墨斯 | 立即使用 CLI 访问; 对本地配置更改使用新会话 | 原生 Hermes 0.22.5 技能 视图和桌面 MCP 呼叫通过; CLI 路由也称为桌面成功 | | 工作杂务 | 使用 CLI 访问; 本地注册仍需修复 | 本地 5.9.3 在应用程序重新启动后缺少工具, 并且缺少新任务; 真代理完成 CLI 路由 | | 深搜索策略 | 使用 CLI 访问; 本地注册仍需修复 | 真实桌面 通过 CLI 完成代理连接并读取产品帮助;本地工具表注册仍未解决 | | Quen 作业 | 使用 CLI 访问; 本地账户范围注册仍需修复 | 实际 1.4.0 代理读取技能, 通过 CLI 调用桌面; 本地工具表注册尚未解决 | | 杜宝工作 | 在新任务中继续; 仅在系统权限屏幕需要时重启 | 原生macOS 2.34.9 自动安装和新任务工具呼叫通过;优化了CLI交接接收等待 | 在请求用户重启或进行新聊天之前, 准备继续上下文 . 用户只应该点击主机的按钮,而不复制命令,编辑 配置,或者重新进入他们的请求. 复职后,特工必须读到 管理技能和调用真正的桌面工具. `hostAcceptance` 明确保存 这与独立的诊断成功是分开的。 固定测试或配置 仅凭登记并不能使东道主符合本国接受的条件. JSON结果确定这一切入点 `command: "connect"`。 。 。 . 没有医生 `--fix` 不安装或打开桌面或更改代理设置. 它通过经过认证的用户扫描的 IPC 检查运行的桌面 启动一个新的本地 MCP 客户端, 谈判协议, 列出工具和呼叫 `get_active_project`。空动工程是有效的。 缓存列表后继 一个失败的工具呼叫是失败的检查 。 桌面可能服务 MCP 读取其图形用户界面 关闭; 正在运行的 MCP 探测器不能确定 GUI 是否运行 当前主机对话已装入其工具和技能. `--fix` 明确打开/安装桌面,请桌面修复选中的 支持整合,并检查结果。 桌面继续拥有主机 配置和技能同步,包括其站立选择退出. 可去除未改变的表态拥有的过时技能。 用户编辑,外国, 互联互通和模棱两可的重叠技能得到保存和报告。 不同 客户端的变体是故意的,不得仅以名称来去去重复. 医生报告原错误和其余行动. 在桌面内签名 需要时; 在连接或技能组合后启动新的代理对话 变化。 新的诊断客户端不能证明当前主机的发现 状态。 旧桌面发布时没有医生IPC报告更新要求. 当主机 CLI 失败时, 桌面报告其源错误代码和操作阶段 和标记明确省略命令输出。 检查本地主机为 剩余错误文本;省略的信息是证据空白,而不是诊断. 可能打开桌面的图标( E)`app`, (中文(简体) ), `connect`, (中文(简体) ), `tools`, (中文(简体) ), `skills`接受 `--source ` (或 `CHATCUT_INSTALL_SOURCE`记录哪些分配 通道安装来自, 例如 `--source oss_viral_cloner`。 。 。 . CLI 在桌面中留下值 `install-handoff.json`桌面通过它 当它开始,或者在第一个呼叫 如果它已经运行, 保持该剖面图的第一个频道, 并用它的分析和 代理电话 它是一个分析标签,而不是证书,和失败 以记录它从来没有挡住设置。 值为 2–48 个字母、数字或下划线 从信起. `--source` 需要0.1.3或以后; 旧版本 忽略环境变量。 见 `docs/development/analytics/install-source.md` 用于频道注册. `update` 明确且与诊断不同。 首先关闭桌面; 从未 强制退出运行中的编辑器 。 它使用官方签名的发布,保留 用户数据并拒绝降级。 共享的 Windows 安装使用其已有的 应用更新器或交互式官方安装器. `--json` 写入一个 JSON 结果为 stdout; 进度为 stderr 。 退出 0 表示 完成所要求的操作或通过所有必要的诊断检查. 1出局保留故障阶段,原原因和剩余动作. 资料 选择退出、 无法选择的主机和保存的自定义技能不是失败 . 历史 `@chatcut/skill` 套件还导出 a `chatcut` 其可执行文件 云工作流程. 使用 `npx --yes @chatcut/cli ...` 不改变安装, 或明确删除旧的全局软件包,然后在全球安装. 不使用 `--force` 覆盖另一个软件包的可执行性。 幸存的云层 证书和工作不会被此 CLI 迁移或删除 . 对贡献者:运行 `npm test` 财务报告和审定财务报表 `npm pack --dry-run` 从此目录. 原生安装/信任边界在macOS、Windows上有确定性固定装置 和 Linux CI; 实际出版商验证和真实安装仍然分开 释放接受证据。 弹出 `apps/cli/package.json` 以发布更改。 这个 全部生产工作流程(`.github/workflows/sst-production.yml`检查 npm npm Trusted Publishing出版公司. 只编辑器运行跳过出版物 。 这个 `@chatcut/cli` npm 软件包必须信任 `ChatCut-Inc/chatcut`工作流程 `sst-production.yml`环境 `production`。 。 。 . 检查焦油丸并核实公布的 `npx` 被支持的干净的切入点 在广告发布前使用机器. ## 常见问题 ### @chatcut/cli 是什么？ 安装、打开、诊断和维修 ChatCut 桌面 ### 如何安装 @chatcut/cli？ 在项目目录运行 npm install @chatcut/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 chatcut，可以用 npx chatcut 直接运行。 ### @chatcut/cli 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chatcut\_\_cli 是否存在。 ### @chatcut/cli 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @chatcut/cli 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @chatcut/cli 可以商用吗？ @chatcut/cli 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。 ### @chatcut/cli 的下载量有多少？ 根据 npm 官方下载统计，@chatcut/cli 在 2026/10/10 – 2026/11/08 这 30 天内被下载 5,818 次，日均约 194 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @chatcut/cli 还在维护吗？ 最新版本 0\.1\.3 发布于 2026/10/30（9 天前）；至今共发布 5 个版本，其中过去 12 个月发布了 5 个；首次发布于 2026/10/26。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。