hongxin/dsh-tvision

tvision

CI
License: MIT

给 DeepSeek Harness 智能体的字符型窗口管理器。 带投影的重叠窗口、Borland 式菜单栏、功能键提示条、鼠标拖拽、五套配色皮肤——以普通的 dsh profile bundle 形式安装，不是 fork。

tvision 动图——菜单栏、一次智能体回合、五套皮肤

你的手在 Turbo C 年代记住的那抹蓝——同一个二进制里还带着另外四副面孔：

| 琥珀 CRT | 磷光绿 | 石板灰 | ANSI（One Dark 风） |
|:---:|:---:|:---:|:---:|
| 琥珀 CRT | 磷光绿 | 石板灰 | ANSI，One Dark 风 |

File  View  Agent  Tools  Window  Help                        dsh tvision
╔═════════════════════════ Conversation ═════════════════════════╗┌───── Project ──────┐
║> You                                                            ║  o src/parser.ts   │
║  why is the first token so slow?                                ║  o src/stream.ts   │
║                                                                 ║  o README.md       │
║| Agent · 1.4s                                                   ║                    │
║  The parser buffers the whole document before it emits          ║                    │
║  anything, which is why the first token never arrives until     ║                    │
║  the whole file is read.                                        ║                    │
║                                                                 ║                    │
║~ bash  npm test -- parser                                       ║┌────── Tasks ───────┐
║  ok ▸                                                           ║  ✓ Find why it is  │
║                                                                 ║  ▸ Make the parser │
║─────────────────────────────────────────────────────────────────║  · Update the test │
║dsh> refactor it so it streams                                   ║                    │
╚═════════════════════════════════════════════════════════════════╝  ░░░░░░░░░░░░░░░░░░░
│ F10 menu │ 3 win │ ████░░ 62% │ ↑12.4k ↓3.1k │ deepseek-flash
F1 Help      F2 New       F3 Open      F4 Tools     F5 Focus     F6 Next      F7 Project

不需要智能体就能先看看

不需要 API key、不需要 profile、不需要联网。demo 用一段脚本化的智能体驱动真实的桌面：

npm install
npm run build
node lib/demo.js                 # Turbo Vision 蓝
node lib/demo.js --skin amber    # P3 琥珀单色
node lib/demo.js --list-skins

随便输入点什么按回车就会重放脚本；F1 列出按键，F10 打开菜单。

作为 dsh profile 安装

需要 Node ^22.19 || >=24 与 dsh CLI。

git clone https://github.com/hongxin/dsh-tvision
cd dsh-tvision && npm install && npm run build
dsh plugin --profile tvision add "$(pwd)"
dsh --profile tvision                                    # 在当前目录开启会话
dsh --profile tvision --resume               # 恢复历史会话
dsh --profile tvision --skin amber --no-mouse            # 启动选项

包发布到 npm 后，克隆构建两步收敛为 dsh plugin --profile tvision add dsh-tvision。

在环境变量（或启动目录 / $DSH_HOME 下的 .env）里设置 DEEPSEEK_API_KEY。本地或自建端点无需改代码——把 DEEPSEEK_BASE_URL 指过去，或在 $DSH_HOME/settings.yaml 里设置 llm-deepseek.baseURL。

状态。 已验证：桌面在真实 dsh --profile tvision 智能体上挂载并在真实终端绘制（python3 scripts/pty-profile.py）；完整链路——流式、reasoning、审批、工具往返——在脚本化模型端点上端到端跑通（python3 scripts/pty-wire.py）；独立 demo 通过 18 场景真终端扫描且不变量零缺陷；真实 API 的实弹回合已人工跑过。黄金语料是钉住真实事件形状的手写合成内容——真实转录永不入库。见设计文档的范围一节。

按键

全局

| 按键 | 作用 |
|---|---|
| F1 | 帮助——完整按键表与鼠标说明 |
| F2 | 新会话 |
| F3 | 会话窗口 |
| F4 | 展开 / 折叠全部工具卡片 |
| F5 | 聚焦输入行 |
| F6 | 下一个窗口 |
| F7 | 项目窗口——选中文件会在输入行插入引用 |
| F8 | 任务窗口 |
| F9 | 切换皮肤 |
| F10 | 菜单栏 |
| Ctrl+Q | 退出 |
| Ctrl+C | 取消当前回合 |
| Ctrl+O | 展开 / 折叠工具卡片 |
| Ctrl+R | 显示 / 隐藏思考过程 |
| Ctrl+Z | 缩放当前窗口 |
| Ctrl+F | 搜索转录——Enter 下一个、Shift+Enter 上一个、Esc 回到原位 |
| Ctrl+B | 断点——在工具运行前按规则拦下它 |
| Ctrl+L | 重绘屏幕 |

菜单

F10 进入菜单栏，←/→ 在栏上移动，↓ 拉下列表。Alt + 带下划线的字母可直接打开对应菜单；在已打开的列表里按同样的字母会直接执行该项。

输入行

| 按键 | 作用 |
|---|---|
| Enter | 发送 |
| Alt+Enter | 插入换行而不发送 |
| Tab | 补全 /命令 或 @文件 |
| ↑ / ↓ | 浏览输入历史 |
| Ctrl+A / Ctrl+E | 行首 / 行尾 |
| Ctrl+U / Ctrl+K | 删到行首 / 行尾 |
| Ctrl+W | 删除前一个词 |

对话区

| 按键 | 作用 |
|---|---|
| PageUp / PageDown | 翻页 |
| ↑ / ↓ | 滚动一行 |
| Home / End | 跳到开头 / 结尾 |

向上滚动离开末尾后，新输出不会再把你拽回底部；按 End 恢复跟随。

会话与任务

| 按键 | 作用 |
|---|---|
| 直接输入 | 过滤会话列表——标题、工作区或 id |
| Backspace / Esc | 编辑 / 清空过滤词 |
| k | 终止选中的后台任务（先确认） |
| Enter | 恢复会话 / 查看任务详情 |

鼠标

拖标题栏移动窗口 · 拖右下角亮色边角缩放 · 点 [■] 关闭 · 点 [↑] 或双击标题最大化 · 滚轮滚动指针底下的任何东西，包括功能键提示条。

皮肤

| --skin | |
|---|---|
| tvision | Turbo Vision——Borland 蓝：深蓝桌面上的青色窗口框 |
| phosphor | P1 绿色 CRT——单一色相，层级全靠亮度 |
| amber | P3 琥珀——更暖，长时间看更舒服 |
| slate | 现代深色——只要窗口管理器，不要怀旧戏服 |
| ansi | One Dark 式编辑器配色，走终端自带的十六色 |

每套皮肤是完整的约 55 个语义角色，而不是换一组颜色：因此在某套皮肤下能看清的控件，在其他皮肤下同样能看清。

安装后的默认皮肤是 tvision——Borland 蓝正是招牌；--skin ansi（或 F9）换成跟随终端主题的 One Dark 风。独立的 demo 同以 tvision 蓝作为招牌。

为什么这样做

一句话：智能体天然适合字符型 IDE。 它的活动本来就是文件编辑、shell 命令、diff、任务列表、子代理——这正是当年 Borland 那套界面为之而生的东西，只是少了调试器。

这不是「加了个边框的聊天 TUI」，而是一个窗口管理器：

- 带投影的重叠窗口：层次在你读一个字之前就已经可见。
- 活动窗口用双线框，非活动用单线框：隔着房间也能看出键盘要去哪。
- 菜单栏浮于所有窗口之上：没有任何能力只是「键盘圈的传说」。
- 功能键提示条由键位表生成：所以它不会说谎。
- 固定单行的输入行：会自己长高的输入框会把整段对话推上推下。
- 模态对话框就是普通窗口：审批提示因此白拿同一套键盘、鼠标与焦点逻辑。
- 工具断点——把调试器的断点搬到智能体身上：/breakpoint bash(rm *) 让匹配的调用在运行前停进模态框——Y 运行一次、a 本会话总是、n 拒绝（模型会被告知）。--deny 规则不问直接拒。Ctrl+B 管理规则；模式匹配的正是转录里显示的那行标签。

对话区左侧有一个字符的装订线——> 是你、| 是智能体、· 是思考、~ 是工具、! 是错误——于是对话的形状先于文字可见。工具调用折叠时占一行，展开后是带框的实体，diff 按增删着色。

完整的设计推理、架构说明与「刻意没做完的部分」，见 docs/DESIGN.md。

开发

npm install
npm run typecheck     # tsc --noEmit
npm test              # 505 个测试
npm run build         # 打包到 lib/
npm run demo          # 跑 demo

测试值得单独说一句。tests/compositor.spec.ts 把画好的帧重放进真实的终端模拟器（xterm.js headless），然后逐单元格比对结果网格——这是唯一能抓住「转义字符串看着对、屏幕上却是错的」那类 bug 的办法。tests/snapshot.spec.ts 把整屏帧以 ASCII 形式签入仓库，所以 review diff 时能直接看到整个界面：

Tvision_SNAPSHOT=refresh npx vitest run tests/snapshot.spec.ts

在真实终端里验证

模拟器能证明转义序列产生的网格与我们以为的一致，但它证明不了真实终端也同意——更够不到任何交互路径。为此有一套 pty 工具：

在真实 pty 下驱动 demo，向它敲键、拖拽。
python3 scripts/pty-drive.py '{"argv":["node","lib/demo.js"],"columns":104,"rows":30,"timeout":8}' > /tmp/capture.bin

读回真实终端屏幕上到底是什么。
npm run verify:pty -- /tmp/capture.bin 104 30

鼠标拖拽、菜单下拉、帮助窗口与真彩配色，就是这样在真实屏幕上（而非模拟器里）确认的。

scripts/pty-sweep.py 会跑一个「尺寸 × 按键序列」的矩阵，检查终端会静默执行的那些不变量——没有写到屏幕右边界之外、没有哪一帧把屏幕滚动了、chrome 没有错位：

python3 scripts/pty-sweep.py --json .tools/sweep.json   # 需要 pty
npx vitest run tests/sweep.spec.ts                      # 检查抓取结果

它读取 .tools/sweep.json，文件不存在时自动跳过，所以在无法分配 pty 的机器上测试依然是绿的。

目录结构

src/kit/        cell · text · styles · screen · painter · widget · wm · input · skin
src/session/    保留式文档模型
src/views/      transcript · dialogs
src/widgets/    frame · menubar · statusbar
src/app/        app · composer · questions · events · project · sessions
src/term/       真实终端

kit/ 不 import 它上面的任何东西，也不知道「智能体」是什么；它本身就是一个通用的字符窗口库。

致谢

MIT。实现是原创的；集成方式参考了 deepseek-harness 上游移除、后被恢复为 @dsh-tui/dsh-tui（MIT，DeepSeek 与 OpenGuardrails）的开源终端前端——Cordis 插件的组织方式、会话事件折叠的职责划分、审批与提问的 waterfall 接缝、以及测试基建的思路都以其为范本。也正是因为读了它，才发现它自带的两处 API 漂移。

界面的形态则要归功于 Turbo Vision（Borland）、Midnight Commander 与 moc。