Cheng CLI 使用指南

适用版本：ChengOS v0.1.0+ ｜ 最后核对：2026-08-12 ｜ 来源：crates/cheng-cli/src/main.rs、crates/cheng-cli/src/commands.rs、crates/cheng-cli/src/config.rs

不带参数运行 cheng，就会在当前目录下开始对话。其余的内容要么是子命令，要么是会话内的斜杠命令。

子命令

cheng chat          # 在当前目录开启交互式会话（默认行为）
cheng back          # 以无界面后台智能体的方式把当前目录作为工作区提供出去
cheng sessions      # 服务器上你的 CLI 会话（用于找到 --resume 的 id）
cheng history       # 持久会话，包括已暂停的和历史的工作
cheng ps            # 你启动的后台智能体
cheng stop <id>     # 按 PID 或会话 id 停止一个后台智能体
cheng logs <id>     # 查看后台智能体的日志文件
cheng restart <id>  # 重启一个后台智能体
cheng rm <id>       # 删除已停止或失效的智能体元数据
cheng prune         # 删除所有已停止和失效的智能体元数据

注意 sessions 与 history 的区别：session 是带沙箱的 CLI 连接，而 conversation 是比它活得更久的持久对话。这正是 --resume-conversation 存在的原因——即使原来的 session 已经过期，你也能接着做原来的工作。

cheng chat 参数

--resume-conversation 与 --resume、--workspace、--workflow 互斥：对话本身已经决定了这三者，再指定就自相矛盾了。

当你希望智能体分析一个仓库、且完全排除写入可能时，使用 --read-only——这比在提示词里叮嘱它不要写强得多。

后台智能体

cheng back 运行一个无界面的智能体，把当前目录作为客户端本地工作区提供给网页 UI。这就是让浏览器编辑器操作你本机文件（而非服务器文件）的方式。

后台模式始终是 client-local 的——cheng back 刻意没有 --workspace-mode 参数，因为提供你的本地目录正是它的全部用途。

用 ps、stop、logs、restart、rm 和 prune 管理它们。ps -a 会包含已停止和失效的智能体。

斜杠命令

一部分斜杠命令由 CLI 本地处理，另一部分发送到服务器。区别体现在它们影响什么：本地命令改变你的终端，服务器命令改变会话。

本地

服务器

/new、/workspace、/workflow、/channel、/model、/status、/cancel、/approve、/reject、/help、/compact、/shortcuts（别名 /kj、/kjlist）、/presets（别名 /fl、/fllist）。

长会话中最值得记住的是 /compact：它会压缩对话历史，让上下文窗口不再成为瓶颈。

粘贴进来的绝对路径（如 /home/user/file.txt）不会被当作命令——首个 token 中若含有另一个 / 会被识别为路径。未知的 /word 输入同样会作为普通消息处理，而不会报命令错误。

终端中的审批

当工作流需要人工决策时，会话会显示审批提示；用 /approve 和 /reject 回应。这与编辑器中的审批卡片是同一套机制，也是同一个 waiting_for_review 执行状态。

容错

如果事件流静默 30 秒，CLI 会把前台执行与 API 做一次对账，而不是无限等待——这样断开的连接会呈现真实状态而不是卡住。会话保存在服务端，因此终端意外退出并不会丢失工作：用 cheng sessions 找到它，再用 --resume 恢复。

下一步

• 安装 CLI——配置与令牌。
• ReAct 智能体指南——提示符背后的智能体在做什么。