dsh-TUI
Claude Code 风格的全屏终端交互，
为 DeepSeek Harness 补上没有 TUI 的那一块拼图。
像素鲸鱼顶栏、实时工作状态行、思考流式展开、双击 Esc 时间回溯、蓝白上下文进度条 + TPS 仪表。零核心改动，纯插件挂载 —— 装上即用，卸了不留补丁。
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui↑ 模拟演示 · 配色跟随主题切换（对应 TUI 的 OSC 11 自动检测）
核心能力
不只好看。dsh-TUI 把 Claude Code 的终端体验完整移植到 DSH 插件体系，同时为长会话做了性能设计。
终端原生交互
流式 Markdown、结构化工具卡、命令与文件补全、@ 文件引用（消息任意位置补全，发送时自动附加文件内容）、历史搜索、消息选择，inline / alternate-screen 两种渲染模式，/lang 中英界面一键切换。
可观察的 Agent 状态
实时工作状态行、上下文分段进度、TPS 仪表、缓存命中率、推理等级、输入/输出 token 与 Git/会话信息 —— Agent 在做什么，一眼可见。
完整会话工作流
/resume 恢复、/new 新会话、/compact 压缩、/export 导出、/btw 侧问、模型切换，以及双击 Esc 发起的会话 rewind / fork 时间回溯。
DSH 官方能力接入
Agent preset、Skills、MCP、Goals、Todos、子代理、ask_user_question 问卷，全部通过现有服务或注册表连接，不重复造轮子。
为长会话设计
事件驱动投影、差分终端输出、消息虚拟化、回放合并与有界缓存 —— 每帧成本从 O(全会话) 降到 O(可视窗口)，渲染与内存不随会话膨胀。
界面预览
真实截图，未加滤镜。Gentle Mist Blue 配色：雾蓝只承担品牌、焦点与高亮，正文保持中性灰；启动时通过 OSC 11 查询终端背景色，自动选择浅色/深色调色板。
被 DeepSeek Harness 官方公众号收录
在 DeepSeek Harness 官方公众号推文中，dsh-TUI 作为「内测用户精选插件」展示 —— 那只像素鲸鱼出现在了官方海报的 C 位。
npm 一键安装
前置条件：可用的终端 TTY、官方 dsh CLI、pnpm 10+；运行模型需要 DEEPSEEK_API_KEY。启动后插件会在后台检查 npm 新版本，输入 /update 即可自动更新并重启恢复会话。
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui插件自带 dsh-tui 直达命令。
dsh-tui首次运行自动初始化 dsh-tui profile（需 pnpm 10+）。
dsh-tui --resumeWindows 也可用仓库里的 dsh-tui.cmd，效果等价。
sh install.sh或dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui快捷键，全在指尖
macOS 上 Ctrl+<键> 同时可用 ⌘<键>（需终端支持扩展键盘协议：iTerm2 / kitty / WezTerm / ghostty / tmux）；仅 Ctrl+C / Ctrl+D 保持 Ctrl 不变。
- Enter发送（Shift+Enter 换行）；命令菜单打开时执行选中项
- Ctrl+C中断当前回合；空闲时连按两次退出
- Esc×2Esc★空输入双击 = 时间回溯（rewind / fork）
- Ctrl+O展开 / 收起详情：思考全文、工具参数与输出
- Ctrl+R历史消息搜索
- /会话内全文搜索，n / N 跳转
- Tab命令 / @ 文件补全，目录可继续深入
- Ctrl+V粘贴文本；Explorer 复制的文件 / 图片 → 插入文件路径
- ?快捷键菜单
- Shift+↑消息选择模式，Enter 展开单条
- 拖拽选择应用内文本选区，松开即复制（OSC 52 + 原生兜底）
- 双击 / 三击选词 / 选行，同样即选即复制
- 滚轮滚动消息列表（fullscreen 模式）
CC 指令全集复刻
所有本地命令均走 DSH 官方链路。/plan、/goal 来自 DSH 命令注册表插件，随插件自动并入 / 菜单。
零核心改动，纯插件挂载
TUI 只负责交互与呈现。会话日志是对话真源，模型调用、工具执行、fork/resume、compaction 与持久化继续由 DSH 服务拥有。
高亮处即 dsh-TUI 的挂载点：Cordis patch 层叠在 dsh-base 之上，卸载后不留核心补丁。
▸Gentle Mist Blue 配色
雾蓝只承担品牌、焦点、交互与高亮，正文保持中性灰；OSC 11 自动检测终端背景，无响应时回退深色。
▸事件驱动渲染
session/event 事件流 → 增量差分渲染，滚动状态独立维护，终端输出只做差分。
▸布局级虚拟化
屏幕外消息行渲染为「量高占位符」，子树完全不参与布局 —— 长会话每帧成本 O(可视窗口)。
▸上下文进度条 + TPS 仪表
最大余数法分段着色 + 多级缩略读数；流式 1/8 格 gauge、min-max sparkline、速度语义色（≥50 绿 / ≥20 黄 / <20 红）。
▸working-activity 生态
工作状态行消费 dsh-working-activity 的 log-only activity/status 事件，与 Web UI 同一数据源。
▸安全边界
不实现独立沙箱，沿用当前 DSH profile 的文件、Shell、sandbox 与 approval 策略；含敏感凭证的环境请先检查 profile 配置。
// 07 · GUIDES
深入了解 dsh-TUI
按主题阅读安装、功能、命令、快捷键与架构说明。
常见问题
关于 dsh-TUI 的定位、安装、平台支持与插件边界。
dsh-TUI 是什么？
dsh-TUI 是 DeepSeek Harness 的 Claude Code 风格全屏终端界面插件，提供流式 Markdown、结构化工具卡、会话管理、实时 Agent 状态和终端原生交互。
如何安装 dsh-TUI？
准备 Node.js ^22.19 或 24 及以上版本与 pnpm 10+，全局安装官方 dsh CLI 和 dsh-TUI 插件，然后运行 dsh-tui 即可启动。运行模型还需要配置 DEEPSEEK_API_KEY。
支持哪些操作系统？
支持 Windows、macOS 和 Linux。不同终端对扩展键盘协议、剪贴板和 OSC 52 的支持可能有所不同。
安装插件会修改 DeepSeek Harness 核心吗？
不会。dsh-TUI 通过 Cordis patch 作为插件挂载，会话、模型调用、工具执行与持久化仍由现有 DSH 服务负责；卸载后不会留下核心补丁。