dsh-tui

DSH TUI

基于 DSH 原生内核与 @earendil-works/pi-tui 的终端工作台。第二版结合原来的鲸鱼标识与 Claude Code 的终端交互：蓝色强调、暖色欢迎框、清楚的角色标记与简洁输入区。上下文与工具全文按需查看。欢迎页是对话流的第一行内容（不是常驻表头），会随对话增长自然滚入终端 scrollback，往上滚随时能看到。

第二版设计说明 · 最新前后对照 · 第一版归档

开始使用

dsh tui
dsh tui "检查这个项目的测试"
dsh tui --resume <session-id>
dsh tui --model provider/model
dsh tui --preset standard

本机包装器把 dsh tui 转成 dsh --profile tui；其他环境可直接使用后者。需要已经安装 DSH、配置模型并建立 profile。

dsh plugin --profile tui add link:/path/to/DSH-TUI

在 ~/.dsh/profiles/tui/package.json 的 dsh.profile.bundles 中加入 @deepseek-ai/dsh-base 与 @arcaneorion/dsh-tui；在 profile 的 cordis.patch.yml 配置 agent-default-model 的 provider/model。本仓库需先 pnpm install，供 link: 安装后的 Node 模块解析使用。

无需模型也能体验：

npm run demo

演示使用固定虚构数据，支持工作台、工具全文、上下文与消息队列；不会调用模型或执行文件工具。

操作

全文面板：↑↓ / j k 滚动，PgUp/PgDn 翻页，Home/End / g G 到首尾，Esc 返回。面板打开时 Esc 优先关面板；回到编辑器后 Esc 中断回合，保留待处理输入。空闲时 Ctrl+C 退出，运行时连续两次 Ctrl+C 退出。

文件面板只占正文右侧 42%，输入框与状态栏保持全宽；面板高度随输入框变化，在输入区上方结束。外观采用独立深灰面板，参照 Claude Code 文件侧栏。左侧保留编辑摘要，完整 diff 在右侧查看。支持键盘浏览：F6 聚焦后，[ / ] 切文件，↑↓ / PgUp/PgDn 滚动，←→ 看长行，f 恢复跟随，b 切换范围，r 刷新，x 关闭，Esc 返回输入。浏览时保留草稿；主动选文件或滚动会固定阅读位置，新编辑不会抢走焦点。

Git 工作区默认显示 未提交改动（含已有改动），覆盖 Bash、格式化器与外部编辑；在工具完成后和面板打开期间刷新。b 可切回 会话编辑记录（各文件最近一次修改片段），这里的行号是片段内行号。没有 Git 时自动使用编辑记录。最多读取 60 个改动文件；较大或二进制新增文件显示说明。首版使用键盘审阅，尚未接入鼠标选区和直接编辑。

直接体验：npm run demo:files（固定数据，不调用模型），或在 dsh tui 中运行 /diff 查看当前工作区。效果预览 · 截图。

Ctrl+T 按一次切换思考显示，长按重复与松开事件不会再次切换。/resume 先准备目标会话并保存当前会话，成功后更新历史、模型、预设与状态栏；失败保留当前会话。当前回合、子 Agent 正在运行或仍有待处理输入时，先结束工作或通过 /queue 处理队列，再切换。列表显示最近 100 个可恢复的非驻留主会话；也可以直接传完整 ID。

打开列表要扫会话目录（实测全库 ~250ms）并为每个候选折叠标题（~620ms），所以底栏在读取期间显示「正在读取会话目录…」；同一范围 20 秒内重复打开走缓存（实测 66ms）。DSH_TUI_DEBUG_SESSIONS=1 会把两段耗时写进 $TMPDIR/dsh-tui-sessions-timing.log。

@ 优先使用原生 fileReferences，支持目录与 @"带空格路径"。它是路径引用，模型按需 read；UI 不会暗中展开文件全文。缺少服务时降级为本地路径补全。

默认将裸 LF 当作提交；DSH_TUI_LF_SUBMITS=0 保留 Ctrl+J 换行。支持扩展键盘协议的终端可以用 Shift+Enter 换行。

信息与事实

• 聊天记录保留已读对话，压缩替换不追加为新回复；/context 单独显示当前模型可见内容。
• /context 读取 session.deriveMessages()，不重新执行 prompt assembly。
• /inject 尚未被处理的材料位于 /queue，不提前标为模型已收到。
• 底栏是一行连续色块状态行（对齐 Claude Code 的状态行样式）：模型 · think · 上下文用量 · 权限 · 路径 · 分支 · 状态提示 · CPU · 内存 · 时间，每段一块饱和底色 + 浅色文字、段间无缝、末段铺满整行。窄屏按优先级丢弃（用量与权限最后丢），路径段先左截断成 …/tail。切换模型会刷新容量，不沿用旧上限。
• 输入栏只有上下两道线条（用比通用 border 更实的 editorBorder，深色终端上看得见），没有底色块、没有提示符。
• 启动时先清屏再接管（launcher/插件在 TUI 起来前打的日志不再留在界面上方），随后在对话区写一块 pi 式开机信息（[Context] / [Commands] / [Plugins] / [Theme]，列出本次实际加载的 cordis 行），随对话滚入 scrollback。
• 状态行下面还有一行持久权限提示（⏸ 权限 <预设>（Shift+Tab 循环），危险档转警示色 ⚠），对齐 Claude Code 的 ⏸ plan mode on (shift+tab to cycle)。底部区域预览见 docs/bottom-area.png。
• 工具预览短小，完整结果在 /inspect；面板打开时可以读取工具的新结果。
• TUI 接管后，插件的 console 日志正文直接显示在会话中；普通日志淡色，警告和错误按级别显示，同时保留日志文件记录。
• 审批与提问只认领当前 TUI 所属 Agent 树，支持独立取消、多选、自定义答案与计划全文审阅。
• 子 Agent 的“未驻留”不表示成功完成。

扩展

活跃 UI 发布为 Cordis 服务 dshTui：

export const inject = ['dshTui']
export function apply(ctx) {
  const { registry } = ctx.get('dshTui')
  const dispose = registry.setStatus('my-plugin', '● connected')
  ctx.effect(() => dispose)
}

支持 setHeader、setFooter、setEditor、setWidget、setWorkingIndicator 与 setMessageRenderer(role, factory)。返回的 disposer 幂等并支持乱序卸载。'*' 仅为未注册角色兜底；统一包裹消息时遍历 registeredRoles() 并按角色替换。

输入仍由 pi-tui 处理粘贴、历史、IME 与补全，WorkbenchEditor 负责外观。只有 kernel.js 导入 DSH 运行时包；工作台使用其显式 runtime 接口。

验证与设计材料

npm test
npm run check
npm run audit
npm run demo
npm run demo:files
npm run preview:files
npm run design:preview

design:preview 读取 Git HEAD 作为基线，也可用 npm run design:preview -- --baseline f8ce820 指定第一版提交。在 /tmp 建源码副本，用同样的事件和宽度渲染新旧组件，输出 HTML、ANSI、JSON 到 docs/benchmark-v2/，保留第一版材料；不访问模型。

已验证：组件与交互测试、真实 PTY 演示、隔离 DSH profile 挂载、26 项工具目录、上下文注入与队列撤回。本轮未发送真实模型计费请求；流式、工具结果与审批回归使用确定性事件和服务测试。

第一版范围

• 一套深色主题；字体和整体背景由终端控制。
• 保留终端原生滚动，无鼠标工具卡或常驻侧栏。
• 图片显示存在性提示，尚无图片粘贴、上传或像素渲染。
• 子 Agent 面板为读取时快照，目前不直接发送子 Agent 消息或控制其任务。
• 历史行有缓存，但每帧组装仍为 O(消息数)，未实现虚拟化。