dsh-TUI
未验证 ccch1mneyyy
功能简介
解决DSH 官方尚无终端 TUI 痛点的补位之作，献给偏爱cli的各位极客：Claude Code 风格全屏交互终端插件——像素鲸鱼顶栏、实时工作状态行、思考流式展开、双击 Esc 回滚、上下文进度条 + TPS 仪表。npm 一键安装。
未验证 — 尚未实测
解决DSH 官方尚无终端 TUI 痛点的补位之作，献给偏爱cli的各位极客：Claude Code 风格全屏交互终端插件——像素鲸鱼顶栏、实时工作状态行、思考流式展开、双击 Esc 回滚、上下文进度条 + TPS 仪表。npm 一键安装。 尚未验证——请自行安装测试。
「未验证」表示我们的自动化 CI 尚未安装过该插件。功能描述与版本兼容性均为作者声明。这不是安全审计，也不代表对第三方代码的背书。
README
简体中文 | English
dsh-TUI
一个美观且实用的 Claude Code 风格 TUI 插件：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、蓝白上下文进度条 + TPS 仪表。
零核心改动，纯插件挂载。安装插件即可启用，卸载后不会留下核心补丁。
献给钟爱tui的各位极客们~A beautiful, practical Claude Code-style TUI plugin: pixel whale top bar, dual flowing-glow title, real-time status line, streaming thought expansion, double-Esc time rewind, blue-white context progress bar + TPS gauge.
Zero core changes, pure plugin mounting. Install to enable; uninstall leaves no core patches.
For all TUI-loving geeks~
🎉 官方收录
本插件被 DeepSeek Harness 官方公众号 推文收录，也被 dshfind 插件目录与 GitHub Trending 收录，同时登上了Github Treding日榜第七
DeepSeek Harness 官方公众号推文收录 |
dshfind 插件目录收录 dshfind Github Treding榜第七 |
- 终端交互：低资源占用，长会话稳定可靠；多种主题切换，样式美观，实时显示工作状态、TPS、缓存命中率等
推理等级、输入/输出 token 与 Git/会话信息。 - 功能全面：
/resume、/new、/compact、/export、/btw，模型热切换，原生subagent，会话fork，自动更新；可在vs code中以vscode插件形式启动，已上架 VS Code Marketplace。 - 扩展丰富：原生浏览器交互，compter use等大量附属功能性扩展
界面预览
首屏：像素鲸鱼顶栏 |
工作状态行 + 上下文进度条 |
快速开始
前置条件：安装Nodejs与deepseek-harness，注册DEEPSEEK_API_KEY。
安装命令：
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui
启动命令：
# 完整命令
dsh-tui
# 如果你不想按键盘七次
dst
如果你想手动安装，可以使用仓库根目录的 install.sh：
sh install.sh
# 或：dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui
# 之后 dsh-tui 与 dsh --profile dsh-tui 等价
新用户提示：若
dsh plugin安装时报ERR_PNPM_IGNORED_BUILDS（pnpm ≥11 默认阻止带安装脚本的依赖，如@google/genai、protobufjs——这些脚本运行时不需要，忽略即可），在 profile 的pnpm-workspace.yaml里加入：allowBuilds: '@google/genai': false protobufjs: false
/update与dsh-tui update会自动写入这份配置，无需手工处理。
更面向零基础的安装流程、profile 叠加机制、源码构建与常见问题见安装与快速开始。
插件扩展与开发指南
想为 dsh-TUI 做插件/扩展？欢迎加入生态！
- 接口与兼容性协定 / 插件开发指南：终端交互生态插件准入与开发指南（准入规范、接缝、契约、验证清单）
- 生态组织：dsh-tui-ecosystem（社区插件与模板的家）
- 模板仓库：plugin-template（从模板起步，5 分钟出一个插件）
- 参考实现：
dsh-working-activity（实时工作状态行：TUI 槽位 +activity/status会话事件双出口）
文档索引
| 主题 | 内容 |
|---|---|
| 安装与快速开始 | 前置条件、安装、启动、profile 生命周期、源码开发 |
| 配置参考 | Cordis 覆盖、配置字段、Agent preset、MCP、环境变量 |
| 主题系统 | 内置主题、自动检测、自定义 JSON 主题与校验规则 |
| 交互与命令 | 快捷键、鼠标、问卷、slash command 与会话工作流 |
| 架构与限制 | 运行链路、渲染与持久化设计、安全边界、已知限制 |
| VS Code 使用指南 | 在 VS Code 集成终端运行 dsh-tui；companion 扩展 dsh-tui-vscode 提供与 Claude Code 官方扩展几乎一致的体验（已上架 Marketplace） |
| 贡献与开发约定 | 贡献流程、仓库地图、构建产物、验证矩阵与修改规则 |
| 插件准入与开发指南 | 接口与兼容性协定 / 插件准入规范 / 插件接缝 / 契约 / 验证清单（已并入 dsh-ecosystem-spec） |
完整的中英文索引见 docs/README.md。
社区
- 生态组织：dsh-tui-ecosystem —— 社区插件、模板与收录列表的家。欢迎来发插件、提创意、互相取暖 🐋
- 社区交流群：使用问题、插件创意、功能许愿，都欢迎进来聊。
| 微信群 | QQ 群（群号 572549239） | 微信三群 |
|---|---|---|
 |
 |
 |
微信群二维码约 7 天过期一次，如遇失效请走 QQ 群（572549239），或开个 issue 提醒我们更新。
权限与安全边界
dsh-TUI 不实现独立沙箱，而是使用当前 DSH profile 的文件、Shell、sandbox 与 approval 策略。仓库提供的 profile 在非 Windows 平台默认采用工作区约束与审批；Windows 当前没有对应的沙箱后端，组合会退回到 danger-full-access 且不弹审批。在包含敏感凭证或不可信仓库的环境中启动前，请先检查 profile 配置。
详见权限边界与已知限制。
友情链接
朋友们开发的社区、相关项目与周边工具
Stars
License
安装
装一次目录插件，之后本站所有插件都能让 DeepSeek Harness 自动找、自动装：
dsh plugin add dshbase-catalog然后对 agent 说「帮我装 dsh-TUI」，它会在目录里找到并自动安装。文档：dshbase-catalog · 已验证场景包。
该插件是 GitHub 源码（未发 npm）——直接从仓库装：
Web profile：
dsh plugin --profile web add github:ccch1mneyyy/dsh-TUIHeadless（CLI）profile：
dsh plugin --profile headless add github:ccch1mneyyy/dsh-TUI实测报告
尚未 L3 验证——若已跑过，见下方失败备注。
备注：验证: install-fail (0.1.0-rc.6) 浏览全部待验证失败 →
使用场景
改善终端体验——TUI、命令面板或 shell 集成——让 dsh 在终端里如原生一般。
适合谁
终端优先、从命令行驱动 dsh、想让它像熟悉的 CLI agent 一样工作的开发者。
二次开发建议
TUI 布局和 shell 集成是缝——加面板、快捷键或新的 shell 钩子。
- 危险命令 (high)
- 越权访问 (medium)
分享徽章
把这枚徽章粘进 README——它会链回本页，实测状态变化时自动更新：
[](https://dshbase.com/zh/plugins/dsh-TUI/)<a href="https://dshbase.com/zh/plugins/dsh-TUI/"><img src="https://dshbase.com/badges/dsh-TUI.svg" alt="dshbase 已收录"></a>