dsh-TUI
ccch1mneyyy/dsh-TUI
Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。
安装
把 dsh-TUI 装进 DeepSeek Harness
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库,也不需要额外配置。如果你用的是别的 profile,把 `web` 换成对应的名字。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/web/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
桌面版有自己的 profile,叫 desktop,只认它自带的 dsh 命令——npm 装的 dsh 会直接拒掉这个 profile。先在应用菜单里点 Manage dsh Command… 装上这个命令,打开一次桌面版再彻底退出,跑下面这条,然后重新打开桌面版。
npm 方式
直接拉已发布的 tarball,不用克隆整个仓库。
GitHub 方式 · npm 包
从 GitHub 装会执行项目自己的构建脚本,而 pnpm 默认拦着不让跑——先跑一次这条命令,pnpm 会打印出要加到 ~/.dsh/profiles/desktop/pnpm-workspace.yaml 里 `allowBuilds` 下面的那个 key。
我们的实装是在 npm 版 dsh 的 web profile 里跑的,没在桌面版上跑过。
我们跑过之后
DeepSeek Harness 0.2.2-rc.1 拒装最新版
从 0.2 起,DeepSeek Harness 装插件前会先核对它声明的 dsh 版本范围,当前版本不在范围内就整条命令拒掉。最新版要求 ^0.1.0-rc.6 || ^0.1.1-rc.1 || 0.1.2-alpha.3 || 0.1.2-alpha.4 || 0.1.2-alpha.5 || 0.1.2-rc.1 || 0.1.3-alpha.2 || 0.1.5-alpha.1 || 0.1.5-alpha.2 || 0.1.5-rc.1 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5, 0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5, 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5, 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.2 || 0.2.1-rc.3 || 0.2.1-rc.4 || 0.2.1-rc.5,我们跑的是 0.2.2-rc.1。
它还没有哪一版接受 DeepSeek Harness 0.2.2-rc.1。`dsh plugin allow-version … --accept-risk` 可以硬装,风险 harness 自己已经写明了;不然就等作者更新。
这里每条命令都在一次性容器里、对着干净 profile 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 11 天前,DeepSeek Harness 0.2.2-rc.1.
安装前须知
装 dsh-TUI 之前,先看这几条
- 源码在这里: ccch1mneyyy/dsh-TUI——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
安全
装 dsh-TUI 会执行什么
- 构建脚本
没测到——DSH 在执行任何东西之前就拒装了最新版。
来源:我们在沙箱里的实装,DeepSeek Harness 0.2.2-rc.1,11 天前。
- 安装钩子
package.json 里没有 preinstall / install / postinstall 脚本。
来源:最近一次同步时读到的 GitHub 上的 package.json。prepare 没有记录——它只在从 GitHub 装时执行,被 pnpm 拦下时会出现在「构建脚本」那一行。
- README 里提到
shell 命令(bash、exec、spawn 之类)
来源:对 README 做的关键词匹配,只提示它可能碰到什么,不是代码分析。
这不是安全审计。上面是一次实装记录加两次文本扫描,没有人替你读过这个插件的代码。插件带着你 agent 的权限在跑。
AI 锐评
是什么 — 在终端里给 DeepSeek Harness 会话铺一块可点可输的全屏工作台,思考过程、任务状态和上下文占用画在同一屏。
谁该装 — 你在本机终端里用 DeepSeek Harness 对着仓库改代码、盯一轮轮 tool 调用,缺的是 TPS、上下文进度条和双 Esc 时间倒带。 只把 DSH 当无头后端、输出只进日志或 CI、人从不盯着会话看的,不必装。
注意 — 实测 DeepSeek Harness 0.2.2-rc.1 在安装前就拒绝最新版:声明的 DSH 范围不含该号,且没有任何一版能装上这个 DSH。 它会在本机执行 shell 命令。 安装没成功,所以没有会话内实测。
锐评 — 我不会降级 DSH 来迁就它,空着等作者放出能装进我正在用的那套 DSH 的版本。
grok-4.6 写的,只当参考,不当结论。里面说装得上或装不上,是在干净 profile 里真跑过的;其余都是读仓库读出来的。以实际运行为准。
dsh-TUI 是做什么的

dsh-TUI 是一个 DeepSeek Harness 插件,为 DSH 会话提供 Claude Code 风格的全屏终端界面。它显示像素鲸鱼顶栏、实时工作状态、思考流、上下文进度、TPS 和 token 信息,并提供流式 Markdown、工具卡、历史搜索、命令与 @ 文件补全、图片附件以及会话回溯和分叉。
它通过 dsh-tui profile 挂载 Cordis patch,不改动 DSH 核心。会话和工具事件先进入 DSH 的持久日志,再由 TUI 投影为 React 组件,并通过 Ink/Yoga 渲染到终端;模型调用、工具执行、fork、resume、压缩和持久化仍由 DSH 服务负责。插件会保存 ~/.dsh-tui/agent-preset.json、~/.dsh-tui/model.json,也会读取 ~/.dsh-tui/themes/<name>.json。
它适合需要终端原生交互和详细 agent 状态的开发者。不适合没有可用 TTY,或只想使用基础 DSH 界面的环境。插件直接接触终端输入输出、鼠标和剪贴板;运行模型还需要 DEEPSEEK_API_KEY、官方 dsh CLI 和 pnpm 10+。
<<>>
dsh-TUI 的文档
配置
DSH_TUI_THEME 的优先级高于已保存的主题和终端背景自动检测。~/.dsh-tui/agent-preset.json 保存 agent preset,~/.dsh-tui/model.json 保存 /model 选择的模型;自定义主题放在 ~/.dsh-tui/themes/<name>.json。内置主题为 auto、light、dark、dark-ansi。可用 preset 包括 standard、code、minimal、cordis 和随 TUI 提供的 liangshen。已有消息的会话不能切换 preset,空白会话可以切换。
命令
会话命令包括 /new、/resume、/rename、/workspace resume|rename|open、/clear、/compact、/export、/trace 和 /btw。状态与配置使用 /status、/cost、/doctor、/config、/init、/tokens、/permissions、/add-dir。模型和界面使用 /model、/thinking、/theme、/lang、/vim、/help、/exit;/mcp 查看 MCP 状态,/agents、/plan、/goal 提供 agent 或注册表功能,/update 更新并重启。
环境要求
需要可用的终端 TTY、官方 dsh CLI 和 pnpm 10+;运行模型需要 DEEPSEEK_API_KEY。Windows 可使用 dsh-tui.cmd。macOS 的 ⌘ 快捷键需要终端支持扩展键盘协议。插件通过 profile 开启全屏鼠标模式,涉及终端输入输出与剪贴板。
行为说明
Cordis patch 将 DSH 的会话和工具事件投影为 React 组件,再由 Ink/Yoga 渲染。持久会话日志是真源,模型调用、工具执行、fork、resume、压缩和持久化仍归 DSH 服务;TUI 状态使用内存中的 ActivityTracker。长会话使用事件驱动投影、差分输出、消息虚拟化、回放合并和有界缓存。
<<>>
根据项目自己的文档整理,会跟着上游更新。两边对不上时以源码仓库为准—— 去 GitHub 看原始 README
同一分类
dsh-TUI 的同类插件
dsh-web-ui-all
zhu1090093659
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。
DeepSeek-Balance-Whale-Widget
MeteorNOX
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
我们跑过,装得上