gxinxing/deepseek-harness-tui
70最近提交 2026年8月13日
deepseek-harness-tui DSH 插件
deepseek-harness-tui 为 DeepSeek 模型提供了一个零装饰的终端聊天界面，作为 DeepSeek Harness 命令行工具的插件运行。它具备工具调用折叠、思考过程折叠、自适应终端背景主题以及准确的 Markdown 渲染功能。界面底部锚定，始终显示最新对话内容。
如何安装 deepseek-harness-tui DSH 插件
dsh plugin --profile tui add /path/to/deepseek-harness-tui复制不会执行命令。安装 deepseek-harness-tui DSH 插件前请核对仓库和版本。
deepseek-harness-tui DSH 插件数据来源
deepseek-harness-tui DSH 插件快照日期：2026年8月16日
discovered
deepseek-harness-tui DSH 插件能做什么
- 终端原生 UI，无边框，基于 Ink（终端版 React）构建
- 工具调用折叠为紧凑单元格，显示状态、耗时和截断输出
- 主题通过 OSC 11 探测终端背景自动适配，也可通过 DSH_TUI_BG 环境变量手动覆盖
- 思考过程可通过 Ctrl+T 切换折叠，Esc 键可随时中断当前对话轮次
- Markdown 渲染保留标题、围栏代码块和行内代码，支持 CJK/表情符号正确换行
- 实时视图底部锚定，忙碌状态显示盲文旋转器和经过时间计时
deepseek-harness-tui DSH 插件适合哪些场景
- 在终端中与 DeepSeek 模型交互，无需离开命令行环境
- 以结构化、非滚动的方式监控和查看工具调用输出
- 折叠或展开模型的推理过程，以聚焦于最终答案
- 快速中断长时间运行的对话轮次，以调整提示或取消操作
- 作为 DeepSeek Harness 框架的轻量可插拔聊天界面使用
deepseek-harness-tui DSH 插件适合谁
- 偏好终端工作流的开发者，希望为 DeepSeek 模型提供原生聊天体验
- DeepSeek Harness 命令行工具的用户，需要比默认命令行更丰富的交互界面
- 终端爱好者，想要一个极简、主题随终端配置变化的聊天界面
deepseek-harness-tui DSH 插件的限制
- 需要 Node.js ≥ 20 并全局安装 DeepSeek Harness 命令行工具
- 依赖 TokenDance 网关和有效的 API 密钥，开箱不支持其他模型提供商
- TokenDance 的工具调用增量修复在每次 dsh 升级后需要重新应用（直到上游接受）
- 仅运行在终端中，没有图形或 Web 界面
- 插件处于早期阶段（约 800 行 UI 代码），功能可能不如完整聊天应用丰富
deepseek-harness-tui DSH 插件的仓库 README 摘录
以下文字摘自 deepseek-harness-tui DSH 插件的上游仓库 gxinxing/deepseek-harness-tui 的 README，版权归原作者，仅作引用。
**An interactive terminal chat for DeepSeek Harness — terminal-native style, built with Ink (React for terminals).** Give it a TokenDance key and a `dsh` install; run `dsh --profile tui` and you get a zero-chrome terminal chat with DeepSeek models: bottom-anchored transcript, tool calls folded into cells, thinking folding, and a theme that adapts to your terminal via OSC 11. It's a thin, readable plugin (~800 lines of UI) — not a re-implementation of the harness. [English](README.md) · [简体中文](README.zh-CN.md) [](https://github.com/gxinxing/deepseek-harness-tui) [](LICENSE) [](https://github.com/deepseek-ai/deepseek-harness)  ## Install Requires **Node.js ≥ 20** and the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) CLI: ```bash npm install -g @deepseek-ai/dsh # the harness (no Homebrew tap yet) git clone https://github.com/gxinxing/deepseek-harness-tui c
阅读完整 README仓库许可: MIT
deepseek-harness-tui DSH 插件常见问题
如何安装 deepseek-harness-tui？
首先需要 Node.js 20+ 并全局安装 DeepSeek Harness CLI：`npm install -g @deepseek-ai/dsh`。然后克隆本仓库，在目录中执行 `pnpm install`，最后使用 `dsh plugin --profile tui add /path/to/deepseek-harness-tui` 注册插件。同时还需要添加无头插件：`dsh plugin --profile tui add @deepseek-ai/dsh-headless`。
需要 TokenDance API 密钥吗？
是的，deepseek-harness-tui 通过 TokenDance 网关路由所有 LLM 请求。你必须设置环境变量 `TOKENDANCE_API_KEY` 或将其添加到 `~/.dsh/.credentials.yaml` 文件中（权限设为 0600）。默认模型为 `deepseek-v4-flash`，你可以通过编辑提供商设置切换到 `deepseek-v4-pro`。
为什么工具调用区域显示 'unknown tool' 错误？
这是 TokenDance 网关的一个已知问题。官方的 `@deepseek-ai/dsh-llm-deepseek` 适配器会将工具调用 ID 覆盖为空字符串。你需要一次性修补 `node_modules/@deepseek-ai/dsh-llm-deepseek/lib/index.js`，将 `if (call.id !== void 0)` 改为 `if (call.id)`，并对函数名做类似修改。此修补在 dsh 升级后会丢失，升级后需重新应用。
如何中断正在运行的回复？
在对话轮次中随时按 `Esc` 键。Harness 会通过 `agent.cancel({ kind: 'user' })` 取消当前代理调用。这在模型生成过长或你想更改提示时非常有用。
可以更改主题颜色吗？
主题会自动根据终端背景色通过 OSC 11 探测获取。消息色调和代码块会以 12% 白色（深色背景）或 4% 黑色（浅色背景）混合。你可以通过设置环境变量 `DSH_TUI_BG` 为十六进制颜色（如 `#ffffff`）来强制指定背景色进行测试。