前言¶

DeepSeek Harness（dsh）默认给人看的是 Web UI：本机跑起来以后，浏览器打开 http://127.0.0.1:3080 就能对话、调工具、看会话。官方仓库和文档把这套框架的核心理念写成「一切皆插件」——模型、工具、技能、会话、沙箱、存储、循环、调度，以及界面本身，都可以在配置层替换，不必改核心源码。

对习惯在 SSH、tmux 或纯终端里干活的人来说，开浏览器并不是最短路径。社区里因此出现了多款终端界面插件。本文介绍的是目录页 slug 为 dsh-tui-dsh-tui 的这一份：维护者组织 dsh-tui，仓库 dsh-tui/dsh-tui，npm 包名 @dsh-tui/dsh-tui。它把 Claude Code / Codex 那种对话式终端界面，做成挂在官方 @deepseek-ai/dsh-base 之上的树外 bundle。

同一份社区目录里还有另一款更常见、星标更高的 dsh-TUI（目录页是 /plugins/dsh-tui/，维护者不同）。两者名字接近，安装命令和能力边界并不相同。下文只按 dsh-tui/dsh-tui 的目录页、GitHub README、package.json 和 LICENSE 核实后的内容来写。

社区插件目录 deepseek-harness-plugin.com 是独立站点，与 DeepSeek / 幻方没有官方从属关系，不能当成官方应用商店。

这是什么¶

dsh-tui 是一款界面增强插件，由 GitHub 组织 dsh-tui 维护。目录页给出的定位是：Claude Code 风格的 DeepSeek Harness 终端 UI，以独立 dsh 插件包提供。

仓库 README 写得更具体：它是 DeepSeek Harness 智能体的交互式终端入口，基于 @earendil-works/pi-tui 构建，组合在官方 @deepseek-ai/dsh-base 之上。shell、文件系统工具、技能、子代理、工作流、沙箱审批，走的仍是官方 web 界面那一套插件生态，不 fork 核心。

来源也写在仓库里。LICENSE 与 README 都说明：TUI 实现恢复自 DeepSeek Harness 仓库历史中的 packages/ui/tui（上游在 commit 10bb9cbf4a 移除），再移植到已发布的 rc API。LICENSE 同时保留 DeepSeek（原始 @deepseek-ai/dsh-tui）与 OpenGuardrails 在 2026 年的版权声明。package.json 当前版本是 0.1.2，许可证字段为 MIT。目录页和 GitHub 的 SPDX 显示为 NOASSERTION，是识别结果与仓库自述不一致，安装前仍应直接读 LICENSE。

截至本文核对时（2026-08-18），目录页与 GitHub 仓库均显示 18 颗星；主要语言是 TypeScript；目录收录日期为 2026-08-15。

核心功能¶

仓库 README 列出的能力可以分成界面、交互和会话三块。目录页「更多介绍」与其中斜杠命令、审批对话框两项一致。

流式输出与工具卡片¶

模型正文和思考过程按 Markdown 流式渲染。工具调用会做成卡片，渲染意图分三种：terminal、diff、generic。Ctrl+O 在预览、展开、隐藏三档之间循环。

审批对话框和 ask_user_question 也做在终端里，plan 模式评审包含在内。也就是说，智能体要跑命令、改文件或向你提问时，不必切回 Web UI。

引用、补全与斜杠命令¶

输入框支持 @文件 路径自动补全，以及 @session 会话引用卡片。斜杠命令方面，仓库和目录页都列出：

• /model：切换模型，并可选推理力度
• /resume：恢复会话
• /compact：压缩上下文
• /details
• /help

其他插件注册进当前 profile 的命令，也会出现在这套界面里。

状态栏与主题¶

界面常驻 todo 面板，状态栏显示 token 用量和上下文压力，会话有标题。主题可配置；是否启用真彩色，按环境变量 COLORTERM 检测。

bundle 自带的 cordis.patch.yml 里，默认 agent 使用 deepseek-official 提供方、deepseek-v4-pro 模型，并把 thinking 打开、reasoningEffort 设为 max。密钥和端点不写死在这份补丁里，运行时从 llm-deepseek 设置、凭据存储和 DEEPSEEK_BASE_URL 解析。

安装与启用¶

目录页给出的安装命令¶

社区目录要求在 DeepSeek Harness 终端里运行：

dsh plugin add github:dsh-tui/dsh-tui

需要可复现安装时，按目录页说明固定 commit 哈希：

dsh plugin add github:dsh-tui/dsh-tui#commit

把 #commit 换成实际哈希。插件以当前 dsh 进程的权限运行，安装时可能执行代码。装之前应检查源码仓库和许可证。

仓库推荐的 profile 安装¶

README 把常用路径写成：先装 dsh CLI，再把插件加进名为 tui 的 profile。环境要求是 Node ^22.19 || >=24，CLI 安装命令为：

npm i -g @deepseek-ai/dsh@next

然后：

dsh plugin --profile tui add @dsh-tui/dsh-tui
dsh --profile tui
dsh --profile tui --resume <session-id>

第一条把 npm 包 @dsh-tui/dsh-tui 装进 tui profile；第二条在当前目录开新会话；第三条按会话 id 恢复已持久化的会话。

若要跟踪 GitHub 仓库而不是 npm 发布版，README 写的是 add github:dsh-tui/dsh-tui。git 安装会走 prepare 脚本构建，pnpm 默认拦截构建脚本。如果 add 失败，按它打印的键名，在 ~/.dsh/profiles/tui/pnpm-workspace.yaml 里放行后再跑一次：

allowBuilds:
  "@dsh-tui/dsh-tui": true

API 密钥放在环境变量 DEEPSEEK_API_KEY，也可以写在启动目录或 $DSH_HOME 下的 .env。

典型用法¶

在当前目录开一轮对话¶

装好 CLI 和插件、设好密钥之后，进入要处理的项目目录：

dsh --profile tui

之后按终端里的对话、工具卡片和审批提示操作即可。仓库说明：真实模型回合需要可达的 DeepSeek 兼容端点；组合、渲染、审批、/resume 这些发生在发请求之前的步骤，没有 key 也能走通。

接本地或自部署端点¶

README 给出三种不改插件代码的接法。

1. 环境变量，把基址指到本地 OpenAI 兼容接口：

export DEEPSEEK_BASE_URL=http://localhost:8000/v1
export DEEPSEEK_API_KEY=...

2. 写 $DSH_HOME/settings.yaml，这项支持热加载：

llm-deepseek:
  baseURL: http://localhost:8000/v1

3. 走 vLLM、SGLang 这类 OpenAI 兼容网关时，在 profile 补丁 $DSH_HOME/profiles/tui/cordis.patch.yml 里声明 llm-pi-ai 路由，再把默认模型指过去。具体字段以 dsh 的 providers 指南为准，本文不展开未在本仓库核对过的键名。

开发构建（可选）¶

如果要改这份插件本身，仓库给出的命令是：

pnpm install
pnpm build

pnpm install 会应用 patches/ 里针对 pi-tui 的补丁。pi-tui 钉在 0.80.7，补丁打的是编辑器提示符前缀；构建结果打进 lib/，仓库之外的安装方拿不到未打补丁的副本。

适用场景与注意事项¶

适合已经在用 DeepSeek Harness、又希望把交互留在终端里的人：SSH 远程、tmux 分屏、不想开浏览器，或者要和本地 / 自部署的 DeepSeek 兼容端点一起用。它解决的是「界面怎么画、输入怎么收」，不是另做一套 agent 运行时。模型路由、工具执行、会话持久化仍由 dsh-base 和官方服务负责。

使用前注意下面几条，都来自目录页或仓库原文，不是使用建议式的发挥。

1. 权限与许可证。 插件以当前 dsh 进程权限运行，安装可能执行代码。装之前看源码和 LICENSE。仓库自述为 MIT，目录页 SPDX 为 NOASSERTION，以你读到的 LICENSE 为准。
2. 依赖的是预发布 rc。 README 写明：项目对着 @deepseek-ai/dsh 的 pre-release rc 线开发，上游稳定前随时可能不兼容；peer 依赖钉在验证过的 rc（package.json 里多数字段是 ^0.1.0-rc.6）。DeepSeek Harness 本身也处于开发者预览，官方 README 同样提示未来会有破坏性变更。
3. 测试套件尚未可跑。 仓库里的 tests/ 是移植前留下的，当前不能运行。不要把它当成已经有完整回归覆盖的发行版。
4. 运行环境。 Node 需要 ^22.19 || >=24。真彩色依赖 COLORTERM。没有可达的 DeepSeek 兼容端点，发不出真正的模型回合。
5. 同名插件。 目录「相关插件」里列出的 dsh-TUI（/plugins/dsh-tui/）是另一份项目。安装命令、维护者和功能清单都不要混用。

小结¶

dsh-tui 把官方曾经放在 packages/ui/tui 里的终端界面，做成可以独立安装的 dsh bundle：叠在 @deepseek-ai/dsh-base 上，用 Claude Code 风格的 TUI 驱动同一套工具、技能和审批。目录安装命令是 dsh plugin add github:dsh-tui/dsh-tui；日常更常见的是 dsh plugin --profile tui add @dsh-tui/dsh-tui，再用 dsh --profile tui 进入当前目录。

它仍在对着 dsh 的 rc 线迭代，星标也不高。若终端是你的主界面，可以按上面的命令装一份，先核对源码和许可证，再决定是否固定 commit。

目录页：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-tui-dsh-tui/

GitHub：https://github.com/dsh-tui/dsh-tui