前言¶
DeepSeek Harness（dsh）的 headless 形态适合提交即跑、结果进 stdout 的一次性任务。当需要持续会话、审查工具执行、随时插话追问时，直接使用浏览器会打断终端流。dsh --profile tui 插件提供了一个终端交互客户端，将 DeepSeek Harness 的核心能力带入命令行。
核心定位¶
这是一个 out-of-tree profile bundle，由 TheMcSwift 维护，使用 MIT 许可证。它通过挂载 tui profile，为 dsh 增加终端聊天界面，与官方 web 客户端共享同一套智能体状态、设置和插件，不经过 HTTP 中转，无功能降级。
核心功能¶
- 渲染能力：支持流式 Markdown、推理块分级着色、代码高亮、TeX 数学公式、Mermaid 图表。
- 工具执行可视化：展示工具执行卡片，包括终端卡（退出码）、Read 高亮卡、grep/glob 分组卡、web_search 引用卡以及
run_code子调用树。产物文件支持 OSC 8 链接（Cmd 点击打开）。 - 交互方式：全键盘驱动，支持 Tab 焦点环与 Enter 展开/收起，支持会话级面板（goal / todo / jobs / workflow）。
- 内置文档：安装即自带
/tui操作手册技能，可通过/菜单或/skills查看。 - 兼容性：本版本对齐 dsh 0.1.2-alpha.5 的破坏性更新（session 事件序列/日志偏移重构、settings 新注册面、user-questions waterfall 等）。
安装与启用¶
前置要求：Node ≥ 22.19、pnpm。
安装插件：
dsh plugin --profile tui add @mcswift/dsh-tui
安装即用，不修改 dsh 本身源码，不打依赖补丁。渲染引擎 pi 以 vendor 快照形式内嵌，版本固定为 0.84.1。
典型用法¶
启动新会话：
$ dsh --profile tui
恢复指定会话或最近会话：
$ dsh --profile tui --resume <id>
$ dsh --profile tui -c
切换视图模式：
$ dsh --profile tui --fullscreen
常用的斜杠命令包括：
- 会话控制：
/new、/quit、/clone - 推理与配置：
/effort（推理强度）、/lang（语言）、/rate（评分）、/export（导出会话日志） - 模型与权限：
/model [provider/model]、/permission [preset] - 系统查看：
/config（供应商管理）、/status、/tokens、/cost、/tui（操作手册）
适用场景与注意¶
- 适用场景：在终端中与智能体持续对话，审查工具执行过程，需要快速切换上下文或查看会话状态。
- 运行限制：本 TUI 只跑在
dsh安装本机，无远程模式。 - 渲染模式：默认 regular 渲染，主屏输出留在终端 scrollback，应用内搜索跳转/滚动不可用（可用终端原生 Cmd+F 搜索）。
--fullscreen切回视口模式（旧的默认模式）。 - 功能降级：浏览器能力（图像/拖拽/设置表单）以终端形态降级（图片→占位行，设置页→
/config）。 - 版本维护：pi 版本固定（0.84.1 vendor 快照），上游修复需手动跟进。
结尾¶
DeepSeek-TUI 是在终端环境中使用 DeepSeek Harness 的一个补充方案。它通过复用 dsh 的核心逻辑，提供了与 Web 客户端对齐的交互体验，适合习惯在终端工作的开发者。
