前言¶
在本地项目里使用 DeepSeek Harness 时，终端使用通常不只是一次问答：需要在当前目录开始会话，继续追问，查看工具活动、审批问题、上下文窗口占用和权限状态，之后关掉终端还能回到同一个工作区。orriduck/dsh-tui 面向这类单人日常使用场景，把 DeepSeek Harness 的终端交互集中在一个小型 TUI 里。
这是什么¶
dsh-tui 是一个小型、会话感知的终端 UI，仓库为 orriduck/dsh-tui，由 orriduck 维护，采用 MIT 许可。它围绕 DSH 的 profile 使用方式做首次启动引导，创建本地 tui profile 并注册该 bundle。凭证、模型设置、会话、工具、沙箱和审批仍由 DSH 负责。
核心功能¶
- 流式文本与 reasoning。
- 工具活动与结果。
- 交互式审批和问题。
- 持久权限徽章，支持
/permission切换；切换仅限 idle，full access 需要确认。 - 上下文窗口使用与 token 总量。
- 已安装 DSH 版本和可选 npm update hint。
- 技能发现、直接调用可见性与 Tab 补全。
- 持久会话、当前目录延续，以及 TUI 内的 list/new/resume 命令。
- 一条命令完成 profile bootstrap。
- 在可用时自动上报 Herdr 生命周期。
安装与启用¶
先确认环境满足：
Node.js 22+
pnpm
官方 DeepSeek Harness CLI
安装 dsh-tui：
npm install -g github:orriduck/dsh-tui
进入目标项目目录后启动：
cd /path/to/your/project
dsh-tui
首次启动会创建本地 tui profile 并完成注册。
典型用法¶
先在一个项目目录开始新会话：
dsh-tui
之后回到同一目录继续最近会话：
dsh-tui -c
也可以带初始提示开始，或恢复指定 session：
dsh-tui "fix the failing test"
dsh-tui -r <session-id>
在 TUI 内，常用命令如下：
/sessions
/resume
/resume <session-id>
/new
/permission
/skills
/sessions 列出当前目录保存的 10 个最近会话；/resume 打开编号选择器，/resume <session-id> 直接切换到指定会话；/new 开始新会话。/permission 通过 DSH 官方命令切换当前会话权限，仅限 idle 状态；选择 full access 时需要输入 FULL ACCESS 确认。/skills 列出用户可调用的技能，输入 /skill-name 可直接加载，slash 命令和技能支持 Tab 补全。
需要一次性覆盖主题时，可以这样运行：
DSH_TUI_THEME=dark dsh-tui
权限与会话¶
默认 DSH permission preset 是 workspace-write，并带交互式审批。dsh-tui 不自行读取或存储 DeepSeek key，而是使用正常的 DSH credential chain。权限切换只影响当前会话，且必须在 idle 时执行；full access 需要人工输入确认。DSH 继续负责 credentials、model settings、sessions、tools、sandboxing 和 approvals。
Herdr 集成¶
当 dsh-tui 运行在 Herdr 中时，会进行自动的 Herdr lifecycle reporting。Herdr 0.8.0 尚未包含原生 dsh agent kind，因此原生 Herdr launch/control 还不在当前范围内；仍按普通 TUI 方式启动和输入即可。
版本与更新¶
状态栏会显示已安装的 DSH 版本，并可能给出可选的 npm update hint。DeepSeek Harness 当前仍是 developer preview；相关版本固定在 0.1.0-rc.6，以避免上游破坏性变更被静默带入。
适用场景与注意¶
dsh-tui 适合在本地项目目录中做单人日常 DSH 终端使用：开始会话、继续会话、查看权限与上下文、管理技能调用，并在可用时向 Herdr 上报生命周期。
使用前注意：
- 它需要
Node.js 22+、pnpm和官方 DeepSeek Harness CLI。 - 它会以当前 DSH 进程的权限运行，并沿用 DSH 的凭证、沙箱和审批机制。
- 安装前应检查源码、依赖和 MIT 许可证。
- 当前不包含：split panes、remote persistence、graphical cross-workspace session browser、image attachments、native Herdr launch/control、Web-client parity。
结尾¶
dsh-tui 把 DeepSeek Harness 的终端会话、权限、上下文、技能和 Herdr 生命周期信息放进一个轻量的 TUI，核心是“当前目录开始、随时继续、状态可见”。仓库地址：
https://github.com/orriduck/dsh-tui
