终端智能体客户端 xiangbo3/dsh-cli

⚡ dsh-cli

DeepSeek Harness，就在你的终端里。

直接在终端里用 DeepSeek Harness —— 一个 Go 二进制文件。不需要 Node。不需要前端构建步骤。

🇺🇸 English · 🇨🇳 阅读中文版

这是什么

dsh-cli 是 DeepSeek Harness（dsh web）的终端客户端。它使用和 Web 客户端完全相同的协议 —— 浏览器里能做的事，键盘上都能做，两个前端可以随意切换：

- 💬 实时看智能体干活 —— 流式输出；工具卡片显示跑了什么、改了什么、花了多久；思考过程可展开；
- ✅ 一键审批 —— 智能体想执行命令？弹出窗口：ctrl+a 允许，ctrl+r 拒绝。它提的问题也在弹窗里回答；
- 🔄 随时切换任何东西 —— 模型、权限级别、工作模式、工作区：每个都有快捷键，回合进行中也能用；
- 📊 仪表盘与统计 —— 待办、后台任务、当前目标、消息队列；按时间 / 工作区 / 会话统计 token 消耗；
- 🖱️ 完整支持键盘 + 鼠标，配色跟随你的终端主题；
- ⌨️ 适合管道的单次模式 —— dsh-cli "summarize this repo" 直接打印答案；丢进脚本和 CI 就能用。

看一眼

dsh-cli main view

🚀 60 秒上手

前提：DSH Web 服务已在运行（dsh web，默认 http://127.0.0.1:3080）。

make deps # first time: download modules
make check # vet + tests + build → produces ./dsh-cli

./dsh-cli # interactive TUI (connects to 127.0.0.1:3080)
./dsh-cli --url http://host:8080 # connect to a remote server

远程使用需要在服务端加 --trusted-host；本地回环不需要认证。
服务端重启或网络抖动都不是事：它会自己重连并重新同步。

首次启动你会看到：

Welcome screen

✨ 功能详解

看它干活

- 实时流式输出 —— 智能体边想边说；消息到达即渲染；工具卡片带参数、耗时和 ✓/✗；
- 回合结论 —— ✓ done / ⏹ interrupted / ✗ error / ⚠ max tokens，耗时和本回合 token 一眼可见；
- 思考与细节 —— 思考块默认折叠；ctrl+e 展开完整推理和工具输出；
- 完整 GFM 渲染 —— 表格、任务列表、删除线、emoji：Web 能渲染的，这里都能。

审批与交互

- 工具审批和用户提问一到就弹窗；搁置的随时用 ctrl+i 重新打开；回合运行期间发送消息属于 steer（会重定向当前回合）；排队中的消息显示在条带里，ctrl+x 丢弃最旧的一条。

切换（每项都有快捷键；回合进行中同样可用）

- 模型（ctrl+n）—— 服务商 → 模型 → 推理强度，共三级；←→ 循环切换强度；/model <name> 直接跳转（唯一前缀也可以）；
- 权限（ctrl+p）—— 循环切换只读 → 工作区可写 → 完全访问；不涉及模型回合，无需等待；
- 模式（ctrl+o）—— Standard / PTC / Minimal / Creator，外加你自己的预设；空白会话立即生效，运行中的会话会暂存，等下一个新会话再应用；
- 工作区（ctrl+w）—— 添加 / 重命名 / 删除 / 切换（切换会落到空白会话；需要时会新建一个）。

ctrl+n 模型选择器：

Model picker

会话

- 会话窗口（ctrl+s）—— 实时搜索（标题 / id / 内容）、切换、新建、重命名；
- Fork（ctrl+f）—— 从你当前查看的位置分出新会话 —— 网页版的分支按钮，搬到键盘上；
- 从上次中断处恢复 —— 启动时上次的会话和工作区已就绪。

鼠标与剪贴板

- 滚轮滚动；拖拽选中，双击选词，三击选行；
- 松开即自动复制 —— 走系统剪贴板二进制（wl-copy / pbcopy / clip / xclip），没装的话走终端内置的 OSC 52 通道；不需要 CGO；
- ctrl+c 或 ctrl+shift+c 再次复制选中内容；esc 清除选中。

外观与韧性

- 双语界面 —— 英文内置在二进制里（永远不会丢），中文随包发布；/language zh 一键切换，选择在重启后依然保留；
- 主题跟随 —— 颜色取自终端主题，主题变化时重新着色；终端不响应时回退到内置中性配色；
- 自愈连接 —— 服务器不可用时显示 connecting…；恢复后重新同步缺失状态。什么都不丢。

📮 一次性 / 管道模式

给脚本、CI 用，或者你只想要答案：

dsh-cli "summarize this repo" # auto-picks a session, prints the final answer
dsh-cli --new "explain go slices" # run in a fresh session
echo "explain go slices" | dsh-cli # read the prompt from stdin
dsh-cli -v "reply in one word" # stream live + print tool calls
dsh-cli --thinking "solve: 1+1" # also print the reasoning

- 最终答案输出到 stdout（原始 markdown）；进度和工具活动输出到 stderr —— 可以管道到任何地方；
- 常用参数：--url、--session <id>、--new、--cwd <dir>、--preset <mode>、-v、--thinking、--timeout 2m、--version；
- 细则：裸 TTY 没有提示词会快速失败，并给出提醒（通常是忘了写提示词）；stdin 上限 1MiB；超时默认 10m，超时退出码为 3，脚本可以据此分支；服务器缺失时给出一行提示「用 dsh web --no-open 启动它」。

🔍 检查命令

| 命令 | 作用 |
| dsh-cli status | 客户端 + 主机版本、cwd、模型、会话数与工作区数 |
| dsh-cli ls | 每个会话：状态 / 模式 / 最近活动 / 标题 / cwd |
| dsh-cli new | 创建会话并打印其 id（--cwd 指定目录，--preset 指定模式） |
| dsh-cli history <id> | 把完整记录导出为纯文本 |
| dsh-cli models [id] | 当前模型 + 完整目录（默认取最近活跃的会话） |
| dsh-cli workspaces | 工作区注册表：标题 / 路径 / 会话数 |

终端里的 /status 窗口（即上表，外加 token 用量统计）：

/status window

⌨️ 快捷键

| 按键 | 作用 |
| enter | 发送（回合进行中 = 给智能体引导） |
| shift+enter | 插入换行 |
| ctrl+j | 插入换行（所有终端都可用） |
| / | 命令菜单，tab 补全 |
| esc | 中断当前回合 / 关闭弹窗 / 清空输入 |
| ctrl+n | 选择模型（←→ 调整推理强度） |
| ctrl+p | 循环切换权限级别 |
| ctrl+o | 切换工作模式 |
| ctrl+w | 管理工作区 |
| ctrl+s | 会话窗口（搜索 / 切换 / 新建 / 重命名） |
| ctrl+f | 在视图位置分叉会话（输入为空时） |
| ctrl+t | 停靠面板：待办 / 任务 / 子代理 / 队列 / 目标（ctrl+1–ctrl+5 切换标签页） |
| ctrl+e | 切换详情：完整思考、工具输出（输入为空时） |
| ctrl+i | 重新打开挂起的提问 / 审批 |
| ctrl+x | 丢弃队列中最旧的消息 |
| ← / → | 上一个 / 下一个会话（输入为空时） |
| ctrl+a / ctrl+r | 在审批弹窗中：允许一次 / 拒绝 |
| ctrl+h | 帮助（支持搜索） |
| ctrl+q / ctrl+d | 退出（输入为空时） |

输入行上方还有 / 命令菜单：/help /status /new /title /model /mode /search /workspace /language [en|zh] —— 外加主机命令，如 /plan /compact /goal 以及技能。

ctrl+h 帮助窗口（可搜索）：

Help window

📦 须知

- 依赖：Go 1.27+（用于构建）以及正在运行的 dsh web（默认 http://127.0.0.1:3080）。
- 服务器地址：优先级为 --url 参数 > $DSH_URL 环境变量 > ~/.dsh-cli/config.json（{"url": "http://host:port"}）> 内置默认值；启动时连接失败会提示用 dsh web --no-open 启动 DSH。
- 认证 token（cookie 门控构建）：较新的 dsh web 启动时会打印一个启动 token（http://…/?token=…）。用 --token 传入，或设置 $DSH_LAUNCH_TOKEN，也可以让它存进配置；客户端首次连接时用它换取会话 cookie，之后启动就复用这个 cookie（过期的话会自动重新换取一次）。旧版构建不需要 token。
- 默认语言：~/.dsh-cli/config.json 里的 "language" 优先；没设置时，界面跟随系统区域设置（LC_ALL/LC_MESSAGES/LANG）；两者都没有，就用内置英文。/language 切换会把选择写回配置，重启后依然生效。
- 本地数据：配置、语言文件、缓存和用量统计都放在 ~/.dsh-cli 下。
- 许可证：GNU GPLv3。

⚡ dsh-cli — the DeepSeek Harness, in your terminal.

🇨🇳 阅读中文版