分享：做了个开源终端 TUI 工具： dsh-tui (DeepSeek Harness)

最近在尝试 DeepSeek 官方的 agent harness （dsh），官方自带的是 web-app 和 headless 两种前端，平时用终端用的比较多，正好学习写了个 TUI —— dsh-tui。

- 项目地址：[https://github.com/tomowang/dsh-tui](https://github.com/tomowang/dsh-tui)
- npm：[https://www.npmjs.com/package/@tomowang/dsh-tui](https://www.npmjs.com/package/@tomowang/dsh-tui)

快速安装:

```sh
dsh plugin --profile tui add @tomowang/dsh-tui

dsh --profile tui
dsh --profile tui --resume <sessionId> # reopen a persisted session
dsh --profile tui --agent-preset <presetId> # start a fresh session on a given preset
dsh --profile tui --dump-config # inspect the composed plugin tree
```

## 是什么

dsh-tui 是一个 out-of-tree 的 dsh bundle ，同时也是一个 Cordis 插件。原理上和官方 dsh-web-app / dsh-headless 一样，都是叠在 `@deepseek-ai/dsh-base` 之上，模型适配、工具调用、会话持久化、沙箱和审批策略这些全部留在 dsh-base 里没动，dsh-tui 只负责终端侧的输入和渲染，算是给 dsh 换了个「壳」。

## 功能
- 状态栏：session id 、当前模型/provider 、agent 预设、运行状态（带 spinner ）、排队消息数
- 统计行：turn/step 数、LLM/工具耗时、TTFT 、解码速度、cache 命中率、计费 token 、context 占用
- `/model`：终端里直接切模型，或增删改自定义 LLM provider （不用去改配置文件）
- `/presets`：浏览/切换 agent 预设，配合启动参数 `--agent-preset`
- `/trajectory`、`/context`、`/plugins`：分别是事件台账、context 占用可视化、插件树状态，排查问题挺好用
- `Shift+Tab` 循环切换权限预设（只读/工作区可写/完全放开/自定义）
- `--resume <sessionId>` 精确还原历史：因为渲染只读持久化的事件日志，不维护额外的内存状态，回放和实时走的是同一套逻辑
- readline 风格的行编辑、跨进程持久化的输入历史（上下箭头翻）

## 技术栈
TypeScript + Ink （React 渲染终端 UI）+ Cordis （dsh 底层的插件框架），MIT 协议。

## 预览

---

原文链接：[点击查看](https://www.v2ex.com/t/1234696)