聊天集 CLI
官方ChatCut桌面应用程序的小命令行入口. 这个 不含视频编辑器、第二 MCP 服务器、下载的技能目录或 第三方运行时间依赖。 桌面拥有编辑、代理连接和 技术与应用版本一起运出.
CLI工具和技能路线需要 @chatcut/cli 0.1.2 或后经. 合并源
仅更改不会发布新的 npm 版本.
在用户计算机上运行命令的任何代理都可以通过桌面 cLI(英语:CLI). 代理运行这些命令; 用户只处理登录或OS 需要时的批准按钮 :
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 <name> --file references/<file> 读取
支持该技能范围内的文件。 工具计划来自活服务器.
对于工具参数,使用 --args-file <file> 或者说 --args-file - 与 JSON 打开
stdin; (中文(简体) ); --args '<json>' 还提供。 公开辩论意味着 {}检查
退出代码和 ok,并保存返回的 MCP 结果和原始错误.
电话从不自动重审:超时可以跟随状态变化.
--timeout <seconds> 设置1至1800秒之间的调用超时(默认为300).
CLI 曝光相同的桌面工具及其权限; 引用编辑
工具可以改变一个项目。 CLI 访问与装入工具分离
主机自己的工具表,应相应报告.
包括Grok Bot在内的Cloud代理商必须使用经批准的本地计算机指令 能够运行此 CLI 。 云壳不能到达用户的本地套接字; cLI从不通过公共地道曝光桌面,也不复制登录机密.
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政策,缺少权限,
签字评估失败则保留其原始证据.
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 <name> 是可选的本地主机设置入口。 它打开/ 安装桌面, 询问桌面
注册或修复所支持的代理集成并同步其管理
然后用真正的工具调用验证本地 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 <channel> (或 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 被支持的干净的切入点
在广告发布前使用机器.