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 真跑过,结果取自 harness 自己的记录,不是读源码猜的。 最近一次 11 天前.
挂进你的 README
给维护者的:badge 取这条 listing 最近一次 sandbox 实测的结果,重跑之后它自己会变,读者点开就是这页的完整记录。
安装前须知
装 dsh-TUI 之前,先看这几条
- 源码在这里: ccch1mneyyy/dsh-TUI——已进入社区精选库,DSH 自带的插件市场就是从这儿装的。
- 开源协议:MIT。
- 自动识别到:终端执行。授权之前请先读一遍源码。
- 被收录在这里不代表通过了安全审计。插件是带着你 agent 的权限在跑。
AI 锐评
是什么 — dsh-TUI 是一个全屏终端界面插件。
谁该装 — 当你需要在终端中展示实时状态行和会话历史时。 对于主要使用图形界面工具的用户来说。
注意 — 沙箱实测通过:在全新 profile 里装上,并被 harness 注册进 profile。 没发现明显的坑。
锐评 — 我会装它,因为它可以在VS Code中以插件形式启动。
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-all
zhu1090093659
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
我们跑过,装得上
dsh-web-ui-all
zhu1090093659
DSH Web UI 插件与皮肤合集:任务看板、git 图、右侧面板、远程移动端 UI、桌宠、实时 token 统计与皮肤中心。
没有一行式安装命令——这个插件在一个大仓库的子目录里,也没发 npm 包。
DeepSeek-Balance-Whale-Widget
MeteorNOX
右下角常驻的小鲸鱼挂件:余额、今日已用与每轮对话消耗(含峰谷价),余额预警与今日预算的泡泡内容都可编辑;泡泡点击序列模块化自定义,支持并列加权 A/B、随机台词与随机图片;内置 30+ 厂商模板(OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等),按模型查余额与订阅额度;另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机,无遥测。
我们跑过,装得上