简体中文 | 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 官方公众号 推文收录，作为"内测用户精选插件"展示：

核心能力

• 终端原生交互：流式 Markdown、结构化工具卡、命令与文件补全、@ 文件引用 （消息任意位置补全，文本附加内容，PNG/JPEG/WebP/GIF 作为持久图片块发送）、历史搜索、消息选择、 inline/alternate-screen 两种渲染模式，以及 /lang 中英界面语言切换。
• 可观察的 Agent 状态：实时工作状态、上下文分段进度、TPS、缓存命中率、 推理等级、输入/输出 token 与 Git/会话信息。
• 完整会话工作流：/resume、/new、/compact、/export、/btw 侧问、 模型切换，以及双击 Esc 发起的会话 rewind/fork。
• DSH 官方能力接入：Agent preset、Skills、MCP、Goals、Todos、子代理、 ask_user_question 问卷都通过现有服务或注册表连接。
• 为长会话设计：事件驱动投影、差分终端输出、消息虚拟化、回放合并与有界缓存， 避免渲染成本和内存随会话无限增长。

界面预览

快速开始

前置条件：可用的终端 TTY、官方 dsh CLI，以及 pnpm 10+。运行模型还需要 DEEPSEEK_API_KEY。

# 1. 全局安装 CLI + 本插件（本插件自带 dsh-tui 直达命令）
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

# 2. 启动（首次运行会自动初始化 dsh-tui profile，需 pnpm）
dsh-tui

备选——手工安装 profile（仓库根目录 install.sh 已封装，含 pnpm 预检）：

sh install.sh
# 或：dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui
# 之后 dsh-tui 与 dsh --profile dsh-tui 等价

dsh-tui --resume 恢复上次会话；Windows 也可用仓库里的 dsh-tui.cmd（等价）。

在 VS Code 中运行的完整指南（内置终端直接使用 + companion 扩展 dsh-tui-vscode——真实集成终端承载、体验与 Claude Code 官方扩展几乎一致、 已上架 VS Code Marketplace）见 在 VS Code 中运行 dsh-TUI。

TUI 启动后会在后台检查 npm 是否有新版本；发现更新时会提示，输入 /update 即可自动更新并重启恢复当前会话。

旧版 dsh-cc-tui / cc-tui profile 的迁移命令与兼容数据说明见 安装与快速开始。

安装流程、profile 叠加机制、源码构建与常见问题见 安装与快速开始。

快捷键

macOS 修饰键：上表中 Windows/Linux 的 Ctrl+<键> 在 macOS 上同时可用 ⌘<键> （如 ⌘V 粘贴、⌘O 展开详情、⌘Enter 立即发送）；仅 Ctrl+C / Ctrl+D （中断/退出）保持 Ctrl 不变，避免与 macOS 系统级 ⌘C 复制等肌肉记忆冲突。 ⌘ 需终端支持扩展键盘协议（iTerm2 / kitty / WezTerm / ghostty / tmux）； macOS 自带 Terminal.app 会自行消费 ⌘ 快捷键，请继续使用 Ctrl。

鼠标（fullscreen: true 全屏模式；默认关，profile 补丁层覆盖开启）

问卷（模型发起 ask_user_question 时）

本地命令（CC 指令全集复刻，均走 DSH 官方链路）

文档

完整的中英文索引见 docs/README.md。

配置与扩展

• Agent preset：四种官方 Agent 模式（standard / code / minimal / cordis）和 TUI 随包提供的“梁神模式”（liangshen）， /preset 切换；已产生对话的会话不可切换，空白会话立即生效。默认 preset 持久化 在 ~/.dsh-tui/agent-preset.json；/model 的选择持久化在 ~/.dsh-tui/model.json。 详见配置参考。
• 自定义主题：/theme 选择器（auto 跟随系统/终端背景，内置 light / dark / dark-ansi），也支持 ~/.dsh-tui/themes/<名字>.json 自定义主题，选中即热切换 并持久化；DSH_TUI_THEME 环境变量 > 持久化选择 > OSC 11 终端背景自动检测。 详见主题系统。
• MCP：通过 @deepseek-ai/dsh-mcp-client 挂载服务器，工具以 mcp__<服务器>__<工具> 注册；/mcp 查看连接状态。 详见配置参考。

工作方式

dsh profile
  -> dsh-base
  -> dsh-TUI Cordis patch
  -> Agent preset + DSH services
  -> session/event
  -> Channel projection
  -> React components
  -> ported Ink/Yoga renderer
  -> terminal

TUI 只负责交互与呈现。会话日志是对话真源，模型调用、工具执行、fork/resume、 compaction 和持久化继续由 DSH 服务拥有。更详细的模块边界与性能设计见 架构文档。

聊天 / 工具基础事件 ──> 持久 Session 日志 ──> TUI / Web
        └──────────────> ActivityTracker（内存）──> 仅 TUI 状态栏

技术要点

• Gentle Mist Blue 配色：雾蓝只承担品牌、焦点、交互与高亮，正文保持中性灰； 启动时查询终端背景色（OSC 11）自动选浅色/深色调色板，终端不响应时回退深色。
• 事件驱动渲染：session/event 事件流 → 增量差分渲染，滚动状态独立维护。
• 布局级虚拟化：长会话的每帧成本从 O(全会话) 降到 O(可视窗口)——屏幕外的 消息行渲染为"量高占位符"，其子树完全不参与布局。
• 上下文进度条：参考 pi-nano-context 算法（最大余数法分段着色 + 多级缩略读数）。
• TPS 仪表：参考 pi-tps-meter——流式 1/8 格 gauge、历史 min-max sparkline、 速度语义色（≥50 绿 / ≥20 黄 / <20 红）。
• working-activity 生态：工作状态行复用 dsh-working-activity 的纯状态机，在进程内从基础会话事件派生，不向共享日志写入 UI 状态。
• 终端粘贴：raw 模式下 Ctrl+V 由应用接管，按平台读取系统剪贴板——Windows 走 PowerShell Get-Clipboard，macOS 走 osascript/pbpaste，Linux 自动探测 wl-paste/xclip/xsel；普通文件插入路径，图片文件生成 @ 引用，剪贴板位图 写入附件库并在输入框显示 [Image #N]，纯文本原样插入光标处。

已知限制

• 注入上下文（plugin source 内容）未做独立展示，随系统提示词并入进度条统计。
• /model 实时切换走"会话 fork 续聊"（DSH 无原位换模型 API）：历史原样保留， 新会话路由到新模型，旧会话仍留在 /resume 列表里；选择写入 ~/.dsh-tui/model.json，重启与 /new 均沿用。
• Ctrl+V 读剪贴板按平台依赖外部工具：Windows 用 PowerShell Get-Clipboard （剪贴板被其他进程短暂锁定时自动重试，持续锁定时静默放弃）；macOS 用 osascript/pbpaste（Finder 多文件复制没有稳定的 AppleScript 读法，按 文本/图片回退）；Linux 需要 wl-paste/xclip/xsel 之一且会话可连接 （工具缺失或会话不可连接时提示无可用剪贴板工具）。不受支持的图片格式或附件 服务不可用时会保留临时文件引用作为降级路径。
• 退出时以进程退出收尾，不等待 agent 异步落盘（持久化由 persistence 插件兜底）。
• 工具级审批已实现：approval 服务 + TUI answerer（CC 式审批面板）消费审批流， 权限提升命令会弹出审批条。/permission 预设切换由 dsh-base 的 permission-presets 插件提供，profile 组合默认可用；裸组合 cordis.yml 未挂载该插件（无 /permission 命令）。
• /vim /connect /hooks /memory 为 CC 同名占位：对应能力在 DSH 侧无等价 机制，命令会给出明确说明而非静默。

完整已知限制与安全边界见架构与限制。

开发

CI 使用 Node 24 与 pnpm 11；包声明支持 Node ^22.19 || >=24。

pnpm install --frozen-lockfile
pnpm build
pnpm smoke

lib/types/ 是忽略入库的生成目录；pnpm build 会从干净输出目录重新编译并运行 构建门禁。npm Git URL 安装通过 prepare 生成同一套运行时。渲染、问卷和工具卡 改动还需运行对应回归脚本。

插件生态

想为 dsh-TUI 做插件/扩展？欢迎加入生态：

• 插件开发指南：docs/plugins.md（接缝、契约、规范与验证清单）
• 生态组织：dsh-tui-ecosystem（社区插件与模板的家）
• 模板仓库：plugin-template（从模板起步，5 分钟出一个插件）
• 参考实现：dsh-working-activity（实时工作状态行：TUI 槽位 + activity/status 会话事件双出口）

核心仓库不迁移、社区插件独立成仓——组织只负责收录与背书，插件作者对自己的仓库保持完全所有权。

社区

• 生态组织：dsh-tui-ecosystem —— 社区插件、模板与收录列表的家。欢迎来发插件、提创意、互相取暖 🐋
• 社区交流群：使用问题、插件创意、功能许愿，都欢迎进来聊。

微信群	QQ 群（群号 572549239）

微信群二维码约 7 天过期一次，如遇失效请走 QQ 群（572549239），或开个 issue 提醒我们更新。

权限与安全边界

dsh-TUI 不实现独立沙箱，而是使用当前 DSH profile 的文件、Shell、sandbox 与 approval 策略。仓库提供的 profile 在非 Windows 平台默认采用工作区约束与审批； Windows 当前没有对应的沙箱后端，组合会退回到 danger-full-access 且不弹审批。 在包含敏感凭证或不可信仓库的环境中启动前，请先检查 profile 配置。

详见权限边界与已知限制。

友情链接

朋友们开发的社区、相关项目与周边工具

趋势

License

MIT