DSH TUI · v0.1.10
DeepSeek Harness 的原生同进程终端应用插件。 Agent、模型、认证、工具、权限、preset、会话与持久化全部归 DSH;本仓库提供 CC 风格终端界面,并 vendored Pi TUI 作为终端/输入组件。它不是另一个 Harness,也不是独立后端。
当前版本为 v0.1.10,npm 包为 @tarnish233/dsh-tui(public),GitHub 仓库标记 dsh-plugin topic。DSH 官方插件市场截至 2026-11-14 尚未开放第三方提交;本版本按官方 bundle 规范发布到 npm,官方市场上线后可直接从该来源收录。默认 profile 与命令名仍是 dsh-tui。v0.1.8 已公开,但 npm 的 publish packlist 漏掉了 vendor/pi-tui/native/*/prebuilds 中的六个 native prebuilds,现已在 registry 标记为 deprecated;v0.1.10 改用三个显式平台 prebuild 目录修复,并用 npm packlist 回归覆盖。0.1.9 只是传播延迟期间暂存的候选,没有公开,stage 已 reject。
问卷、审批、历史搜索与短选择/输入按用途放到编辑框上方,完整浏览/管理页保留独立面板;主输入采用 Pi 式 Ctrl+C:一次清空并保留可恢复草稿,后台继续,500ms 内再按退出。Esc 保留局部优先与原生中断;弹窗内 Ctrl+C 只取消/拒绝当前交互。
v0.1.7 收录 Default model / Default model effort、P1/P2 Review 修复和输入/渲染/会话状态简化优化:/settings → DSH 直接读写 DSH 原生默认选择;Ctrl+J/LF 与决策面板转义注入、preset 写入取消、pre-ready 事件、packing prebuild、历史空删除/分片 paste、catalog failure/revision 等均已收口。完整边界与验收见 默认模型设置 与 验收记录。v0.1.10 完成 npm 打包修复:npm 包名为 @tarnish233/dsh-tui、private:false,bundle patch/launcher assertion 使用同一 scoped name,并保留旧本地 dsh-tui link 的“先 add 新身份、成功后再 remove 旧别名”迁移;不更换全局程序。完整 pnpm check 2905/2905(227 文件,576161ms,EXIT 0),547 个输入前后一致。
Rex 使用原生通用 >_ 图标,标题只保留静态 🐳;窗口状态、通知与工作目录遵循 DSH 原生事实。终端支持与明确限制见 Rex / Ghostty。
现场问题边界: 用户报告的退出卡住仍未确认具体触发步骤。当前工作树已用真实 native plugin PTY 故障注入验证并修复“本地清理卡住会延后 native 退出请求”的缺口;它复用 DSH 既有退出保护,不把历史现场问题的根因或全部退出故障标成已解决。
安装与启动
需要 Node >= 24.9 与 DSH 0.2.2-rc.1(与原生 DSH 的最低 Node 要求一致)。
从 npm 安装
dsh plugin --profile dsh-tui add @tarnish233/dsh-tui
dsh --profile dsh-tui
tarball 已包含编译后的 lib/*.js、vendored Pi TUI dist 与三平台 native prebuilds,安装时不需要项目源码或本地构建。dsh-tui 兼容别名仍可用于本机源码开发;npm 用户直接使用原生 dsh --profile dsh-tui 即可。
本地源码开发
插件装载的是编译后的 lib/*.js,构建产物(lib/、vendor/pi-tui/dist/)不提交到仓库,首次使用或有源码变更后需要先构建:
cd /Users/fulei/workspace/dsh-tui
pnpm install --ignore-scripts
pnpm build # 先构建 vendor/pi-tui,再把 src 编译到 lib
构建后日常直接启动,不需要先手动挂载,也不需要 screen 参数:
dsh-tui
- 首次安全自动挂载。 入口从将要执行的 DSH 安装加载公开 package/profile API;缺少本应用时,通过 DSH 原生 package operation 把当前已构建包以
link:加入默认dsh-tuiprofile。后续已挂载时不重复安装。首次出现一行挂载提示;包操作有取消、静默和总时限,失败明确退出,不再留一个没有界面的后台 profile。 - 只处理本应用。 本项目同一路径的旧名称依赖由原生包管理先安装新身份,再移除旧别名;失败不会先删掉原应用。其他插件、模型、凭据和用户 patch 不迁移、不重建。另一个来源占用同名包、明确禁用本 bundle,或 profile 已选择其他已知前端时,会报错而非擅自替换。
- 默认 fullscreen。 要主屏/终端 scrollback 才用
dsh-tui --inline。显式保存的 screen 偏好仍然生效,--inline/--fullscreen可覆盖它。 - 原生同进程入口。 本机
/opt/homebrew/bin/dsh-tui软链仍指向项目bin,不需要更换全局可执行文件。包检查/挂载完成后别名委托 nativedsh,并通过一层原生 startup assertion 验证终端真的激活;不是私有 backend、profile 镜像或第二套启动树。 - 其他 profile。
dsh-tui --profile <name>对指定 profile 做相同安全检查;不会自动关闭它原有的前端。--dsh指向原生 DSH launcher,不能是无法定位公开 SDK 的任意 shell wrapper。 - 仍可手动用 DSH 管理。 npm 安装使用
dsh plugin --profile dsh-tui add @tarnish233/dsh-tui;本地开发使用dsh plugin --profile dsh-tui add /Users/fulei/workspace/dsh-tui。之后也可直接dsh --profile dsh-tui;原生dsh本身不会替一个尚未包含本插件的 profile 做 TUI 的自动挂载。 - 通过 native DSH 启动时,应用版本参数要越过 launcher 边界:
dsh --profile dsh-tui -- --version。裸--version属于 DSH 启动器。直接运行别名时dsh-tui --version由别名自身处理。 dsh-tui在 POSIX 上用process.execve把自己替换成 nativedsh:TUI 与 DSH 处于同一进程,没有前端/后端 IPC 或 supervisor。没有execve的平台只做整应用委托(spawn native dsh),不保留 TUI 壳层。宿主拒绝替换(sandbox/权限/缺少/usr/bin/env)时也回落到同一条子进程委托路径,只输出一行受控提示,不冒泡原始原生错误或堆栈。
离线 demo(不需要 DSH)
dsh-tui --demo # 默认 fullscreen + tools 场景
dsh-tui --demo tasks # Todo + Goal + 多 Subagent,共存/更新/结束/小屏
dsh-tui --demo --inline tasks # 同一场景,主屏/原生 scrollback
dsh-tui --demo tools-group # 连续工具分组、I/O 详情与独立 Diff
dsh-tui --demo images # 用户/assistant/工具图片与重复附件
dsh-tui --demo subagent # 编辑框上方进度、子会话与原生 Reply/Stop 的离线 fixture
dsh-tui --demo subagent-many # 同一 fixture + 并行活动项,演示有限高度的 +N more
demo 始终是离线 fixture,不加载 DSH、不读 profile、不调用模型、不执行真实工具。它不会在真实连接失败时自动启用。任务区启动即展示 Activities: 1 tool · 1 update 和独立子任务消息,Ctrl+O 对照通知展开/收起,固定区同时显示三类任务。提交 tasks next/tasks done/tasks clear/tasks history 手动推进,tasks 重新开始;也可在本项目执行 pnpm demo tasks。完整交互与临时配置隔离示例见 Demo 指南。
原生同进程边界
启动与组合归 DSH,本插件只做终端界面和窄适配:
- 生命周期:startup 插件负责 native 命令行解析与选项服务,主插件通过 native
appReady启动。卸载时ctx.effect先同步恢复终端,再异步关闭 App 与 backend;appExit属于 DSH,本插件不调用process.exit,也不 dispose 宿主 root。 - 没有第二套 Harness:不存在 bridge/protocol/discover/runtime-home/native-profile,不存在 scratch home、profile 镜像、YAML 合并器、第二个 Agent loop、调度器或前端/后端 IPC。
src/backend/context.ts只是同进程薄适配,直接使用宿主 Cordis context 的公开服务。 - preset:从宿主
profileContext.installAnchor(嵌入宿主可用公开pluginPackageslookup)解析 DSH 公开 resource 和原生AgentPreset类,用 nativeloadOverlayPatches/composeEntries组合;不从本包目录找可选 peer、不挂 Web 前端,也不复制工具清单、权限规则或 plan 语义。 - 模型目录:
ctx.llm.listProviders()/listModels()/resolveModelInfo()加 nativeagentDefaultModel的只读投影(src/backend/model-view.ts);不挂完整 SessionController,不导入 Pi 目录/凭据,不维护第二套默认策略。 - 默认保存:模型/effort 的落盘由真实 native ConfigEditor 负责。兼容
/model//effort的 setter 确认仍保守返回defaultsPersisted:false/defaultPersistence:'native';显式 Settings 默认编辑使用原生settings.describe/mutate的 revision guard、同一次 provider/model/effort 操作与真实 read-back。正常成功显示在 Settings/底栏,不刷对话区;失败、overlay 拒绝和未知警告仍可见。本层不直接写 profile 或凭据。 - 工具:优先消费原生
presentCall/presentResult;模型提出调用不等于已执行,没有结果不冒充成功/失败。命令执行、校验与审计由 DSH 拥有。 - 流式与会话:真实订阅
agent/assistant-stream、session/event、agent/status、agent/error;保留原生surfaceOp/sourceEventSeqs,模型上下文裁剪不覆盖人类历史。普通启动不创建 Agent,首次真正发送或需要会话的命令才物化;--resume/-r显式恢复。 - 附件与图片:
ctx.attachments原生准入与按引用读取;同进程没有 8 MiB IPC 帧或 6 MiB 图像传输上限,图像仍受 DSH 存储/准入限制和本层显示/编辑内存预算约束。模型 vision 准入仍归 DSH。 - 诊断:TUI 生命周期内的原生 JS
console.*/stdout/stderr 写入通过独立受控日志通道;Pi renderer/protocol 用专用原始终端 writer,目录刷新成功不会进入编辑框/对话。日志脱敏、限长与轮换;警告通过现有 notice 去重限流,致命错误先恢复终端再保留原生错误输出/退出。不改 provider 刷新、会话/工具/图片事实。原生 addon、子进程直接 fd 或/dev/tty写入不属于这个 JS 层隔离范围。
当前能力
相邻工具与纯原生子任务状态通知可进入 Activities 混合展示组,分别统计 tools/updates,保留原始身份、顺序与原文;真实子任务消息、用户输入/可见文本/todo/diff 等不被混入。两个分组设置都开启才启用,Ctrl+O/点击展开复用原有 disclosure。规则见 展示层整体收敛。
- CC/readline 编辑命令、kill/yank、undo、原子大段粘贴、外部编辑器、Unix 挂起恢复;一套可热更新的键位设置。主 Ctrl+C 按用户选择采用 Pi 清空/500ms 二次退出规则,不中断后台。
- 输入邻近交互:问卷、审批、历史搜索、主命令短表单与快速选择共享编辑框上方的真实高度预算,保留唯一主 Editor;完整 native 计划/Proposal 可打开只读详情,返回保留原回答。
- 原生
/history大纲与有界只读事件窗口、live Workspace 原生 summary/diff、审批Proposal · not run yet;不改 live transcript、不扫描工作区或执行预览工具。入口只按 mounted capability 开放。 @文件/目录 mention 直接消费 DSH 原生fileReferencesprovider:根输入候选跟随当前根 Agent 的 effective cwd 与工具命名空间,支持模糊路径、目录下钻和带空格引号;接受候选只填草稿,不读取或 stage 文件。子任务 Reply 不借用根目录候选。@path是由模型按原生指引调用read的普通文本,和显式/attachFileBlock 分开。- inline / fullscreen 两种 Pi renderer;工具卡、Markdown、原生 Diff、连续工具分组、Input/Output 预览与只读 Inspector;思考折叠摘要。
- 真实模型流式上屏与结算、排队/steering、取消、权限预设、审批与问题;
/model模型选择器(搜索、provider 分组、effort 保留)。 - 原生 preset 选择、原生命令透传、会话新建/恢复与启动会话选择器;
/reload走 native HMR 配置重组合。 - 附件:
[Image #N]/[File #N]在同一 Editor 中原子编辑、undo/stash/history;/attach [local-path]显式经 DSH 存储输入一般文件,32 MiB 是本地 frontend transfer-memory budget,不是 native 文件规则。文件-only/mixed/重复 refs 保序;queue 显示 image/file counts,文件 refs 直接恢复 ready,图片仍按原生引用读取;history.json只存文字,不写 bytes/base64。原生命令图片按 descriptor 准入,当前未挂载 receipt owner 的命令文件明确不可用。 - Subagents:编辑框上方的 Pi 风格两行活动进度树,运行图标与 Working 共用动态帧,根会话 ready 时也转但不改根状态。名字链接立即打开只读子会话/加载界面;连续目录/结算/任务消息分组,正文与非名字单元不导航。已结算项退场,目录/历史通过
/agent/Agents 树查看;保留原生 Stop/Reply 与子审批来源。 - Todo/Goal/Subagent 固定区:由一个
StatusDockStack统一顺序、预算、间距和鼠标行区间;先保留有用内容,宽裕时统一一行间距,紧凑时全部零间距,最后一个区域后没有空行。完整 Todo 最多五项,一行预算保留 counts/首个未完成项,空/隐藏/完成/settled 区域不占位。Ctrl+T 显隐不追加历史、不改原生事实;整体编排 与 CC 边界。 - 原生 UI:
/jobs只读列表/非消费式输出;Goal phase/rounds 固定展示;/rename [title]、确认/fork到可继续输入的 native root;Settings 中默认 preset/permission 以确认+revision guard 修改,默认模型与 effort 共用一个原生选择 target;/inspect只读能力摘要,/questions只回答原生 continued call,不增加 timeout/loop。 - 状态栏:原生 usage/sessionStats 投影、上下文占用、缓存命中、速率/TTFT、workspace/native effective cwd 区分,以及 git 只读状态。
- 终端集成:通用 OSC 7501 根/子状态、原生 DSH 标题、OSC 7 workspace、Ghostty 焦点安全的 OSC 777 通知及兼容进度;Rex 使用用户接受的
app=terminal通用活动分类,以显示原生>_图标(Terminal status On);标题只保留静态🐳,已去掉鲸鱼前的星号/工作符号及标题动画时钟接缝;Terminal title 可关闭标题展示,普通 UI 动画不变。Rex 默认由其 Program Activity 决定提醒,不叠加通知。取消/历史/尝试结算不冒充成功,原生 command 完成与 turn 完成分开。 - 品牌蓝主题与共享 semantic surfaces:Settings/弹窗继承主界面的终端 canvas,不再使用独立黑板;foreground、raised/selected 和 syntax/diff 分层,嵌套 ANSI reset/padding 统一处理。静态字符块 DeepSeek logo,无启动动画、无原生图片 logo。
- 应用图标资产:蓝底白色像素鲸鱼 SVG/512px/64px PNG。它不是终端图片上传协议;Rex 当前使用内置通用
>_图标,正式像素鲸鱼图片仍需终端侧收录,见 图标与限制。
常用键
| 键 | 行为 |
|---|---|
| Enter | 空闲发送,工作中排队;补全打开时先接受候选 |
@ |
打开 DSH 原生工作区文件/目录候选;Tab/Enter 接受,Esc 关闭 |
| Shift+Enter / Alt+Enter / Ctrl+J | 换行 |
| Ctrl+P / Ctrl+N | 视觉行导航,到边界浏览历史;列表导航;空输入可取回排队文本 |
| Ctrl+A / E / B / F | 当前逻辑行首尾 / 字符左右 |
| Alt+B / F / D | 普通词移动 / 删除,标点与中文分词 |
| Ctrl+W | 删到前一空白,路径 / flag 一次删完 |
| Ctrl+Backspace / Alt+Backspace | 普通词删除,与 Ctrl+W 分开 |
| Ctrl+U / K / Y、Alt+Y | 行 kill / yank / yank-pop |
| Ctrl+_ / Ctrl+Shift+- | 撤销 |
| Ctrl+R | 历史搜索;Tab/Esc 放回编辑,Enter 发送,Ctrl+C 取消 |
| Ctrl+S | 暂存 / 恢复完整草稿 |
| Ctrl+C | 主输入清空并保留可恢复草稿,后台继续;500ms 内再按退出。弹窗内只取消/拒绝当前交互 |
| Esc | 先取消局部状态;审批拒绝/问题取消。child Reply 先返回根目标并保留草稿;根回合运行中原生中断,有队列时保留既有释放队列语义。空闲非空草稿双 Esc 清空 |
| Ctrl+D | 有文本删字符,空输入重复确认退出 |
| Ctrl+L | 重绘,保留草稿和会话 |
| Ctrl+G / Ctrl+X Ctrl+E | 外部编辑器(VISUAL / EDITOR / nano) |
| Ctrl+T | 显示/隐藏编辑器上方原生 Todo 清单(不追加对话摘要) |
| Ctrl+O | 工具折叠/展开;问卷/审批有完整 native 内容时打开只读详情 |
| Ctrl+X Ctrl+O | 工具 Inspector;[ / ] 或 Alt+Left/Right 浏览调用,Tab 切 Input/Output,c 复制 |
| Alt+P | 模型选择 |
| Shift+Tab | 循环 DSH 暴露的权限预设(执行原生 /permission,不切换 plan) |
| Ctrl+Enter | 根会话:取消当前回合并立刻发送草稿;空输入发送队列第一条。其余排队消息留在 inbox;child reply 中明确拒绝该根语义 |
| Ctrl+X Ctrl+S | 把草稿插进当前回合的下一步(DSH steer) |
| Ctrl+X Enter | 明确排到下一回合 |
| Ctrl+Z | Unix 挂起,fg 恢复 |
| Ctrl+V | 原生剪贴板图片附件;无图片时回退为文本(Windows/WSL 另有 Alt+V) |
| Ctrl+X Ctrl+I | 查看当前草稿或会话图片;[/] 或 Alt+Left/Right 切换,Esc 关闭 |
| Ctrl+X Ctrl+A | 打开 Agents 树;Enter 查看子会话,R 回复 continuable child,S 停止活动 child |
| Ctrl+X Ctrl+Q | 打开原生队列弹窗;按 message id 编辑、立即发送或取消一条排队消息 |
| Ctrl+F(弹窗内) | 搜索当前 Settings / Keyboard / Help / Tools / Agents / Queue / Resume 内容;字段内仍是 readline 的字符右移 |
回合进行中按 Enter 把消息排进 DSH inbox。排队的消息列在输入框上方,每一行可以 Send now、Edit 或 Cancel;Ctrl+X Ctrl+Q 打开同一个原生队列的搜索弹窗,不会建立第二份队列。Up 在空输入框仍把可收回的消息取回同一个草稿。Ctrl+C 只清空主草稿,不取消当前回合或队列,也不额外触发发送;显式配置的 app.interrupt 仍可调用原生中断。
Subagent 进度紧贴编辑框上方,保留两行设计:蓝色 ● Agents 标题、树形 agent 摘要和下一行原生当前活动。运行图标使用和 Editor Working 相同的 · → ✻ → ✶ → ✳ 动态帧与 App 的同一个 100ms 时钟;没有每个 child 自己的计时器,根会话 ready/空闲时仍转,但不改根 busy、退出确认、计数或模型调度。进度只显示 running/initializing child;idle、完成、失败或停止项在原生状态更新后立即退场,没有活跃项就完全收起。标题与溢出数只统计已知活跃项,完整原生目录不删除;continuable child 再次运行会重新出现。明确回复目标若已 idle,只保留 Editor 的 Replying to … 提示,不用进度行冒充正在工作。Settings → Agents 可隐藏整个进度区,也可独立关闭 Agents 消息分组;两者都不停止或删除原生 child。
fullscreen 仅点击蓝色、加粗、带下划线的名字进入对应子会话,原生读取尚未完成时立即显示 Loading child session…,不等待 child 从 initializing 变成 running。Esc 关闭加载/详情界面,返回同一个 Editor 并保留草稿/图片,不中断根会话;迟到读取不能复活已关闭的界面或释放新 attachment 的 follow。Agents/+N more 文字打开完整树;根会话 /agent 和 Ctrl+X Ctrl+A 始终是历史入口。状态、指标、模型、活动和空白保留拖选/复制,不跳转;这些是内部导航,不生成外部 URL。inline 保留相同进度样式与键盘入口。完成项退场不强行关闭用户正在阅读的子会话详情;终端变矮或输入变高时仍按原有预算降级。
macOS Option/Alt 快捷键需要终端发送 Meta;无法区分的控制字节会标记诊断,不伪造支持。完整动作与兼容说明见 输入说明。
Rex / Ghostty
构建后重启即可启用,无需安装通知 daemon、Rex 插件或改终端配置。Settings → General 的 Terminal status / Terminal title / Terminal notifications 是显示偏好,不控制 DSH 自动标题生成、权限或 plan。默认 Automatic:Rex 使用原生状态提醒;Ghostty 在确切未聚焦时请求一次隐私安全的通知。Off 只关闭直接通知,Always 可与原生提醒重复。
真实 Rex 两 renderer、原生 DSH 与 CLI/PTY 协议回归已有验证;Ghostty 的支持依据匹配版本源码和 PTY,不把它写成真机 GPU/通知弹窗验收。当前 Rex 及 Ghostty 路径不支持恢复原自定义标题的标题栈,退出后依赖 shell integration 重设;启动前关闭 Terminal title 可避免主动改标题。完整矩阵、SSH/tmux 降级、手测步骤与证据见 终端支持及深度对照。
命令与设置
/help、/settings、/agent、/model [provider/model]、/effort [id|status]、/preset [id|status]、/resume [id]、/new、/reload、/exit 属于界面或原生控制服务;/compact、/permission、/plan、/goal、/feedback 等以当前 DSH 命令注册表为准,原样转交并保留原生校验、审计与结果。快捷键入口在 /settings,不另设 /hotkeys。
Skills /
/技能名:/补全合并 DSH 原生用户可调用技能,标注Skill/user-only;Tab 只补入草稿,Enter 按原有提交规则发送。新空会话用 DSH 公开agentPresets.acquireScope读取 preset 目录,启动即可以列出技能且不创建 Agent;live 会话优先读取当前 preset 的 Skills registry。人类目录与模型工具可见性独立,不因skillschema 未披露而隐藏。技能引用原文交给 DSH pre-step 加载与注入,同名原生命令优先,TUI 不展开正文。/help始终保留只读 Skills 区,区分元数据服务不可用、不完整和真正为空;不可用/失败不会被缓存为永久空目录。根目录不假冒 child 回复范围。详见 Skills;dsh-tui --demo skills仅展示离线元数据 fixture。/compact:摘要目标仍是最近一次实际路由时,原生插件接缝继承该请求的显式 reasoning effort;不同摘要模型不串用 effort,没有历史 effort 时保留 DSH 默认。消息、工具和输出预算不变。若压缩失败,界面在原生提示的下一行显示按 command/session 关联、脱敏且限长的Native cause,不再只剩笼统错误。Subagents /
/agent:根会话/agent是打开现有 Agents 目录的 UI 导航,不注册第二套 DSH 业务命令、不创建或恢复 child。进度只显示原生 running/initializing 项,保持摘要+活动两行;结算后隐藏,但主对话原生事实行和 Agents 历史仍保留。名字点击立即打开详情/加载界面,Esc 返回原 Editor;只有Agents/+N more文字打开完整树,其余进度文本可选字复制但不跳转。External 在历史中是没有本地 transcript 的叶子,不显示伪链接。Ctrl+X Ctrl+A仍可打开树;R 把同一个主 Editor 切到 continuable child 回复目标,S 停止 running/initializing child,两种操作也有可点击 chips。Ctrl+C 清空主草稿但不停止 child;停止使用现有 S 操作或显式配置的app.interrupt;child 回复目标中的/...仍是 child 文本,先 Esc 返回根会话才执行/agent等根命令。queue/steer、文本/图片、accepted receipt、失败草稿、子审批来源与父子 transcript 隔离均保留。token/timing 仍为 child session 累计值,没有假造 Pi turn/tool/context 计数;快捷键在/settings修改,详见 Subagents。dsh-tui --demo subagent可看离线示例。Subagent 更新分组:连续的目录状态行、
Subtask status updated和Task message received合成一个 Tools 风格组;真实 user/assistant/tool/attempt/notice 等内容会中断分组,不跨边界、不改原生顺序或文字。折叠时保留各记录的名字与归属摘要,点击组标题或 Ctrl+O 展开真实正文;Settings → Agents → Group agent messages独立控制这一展示,旧版本首次读取会沿用当时Group tool calls的值,迁移后与 Tools 完全独立,恢复默认也不回读 Tools。只有已知可打开 child 的名字为蓝色加粗下划线链接,其余标题、图标、状态、正文和空白可拖选复制,不导航;展开正文也不是折叠按钮。未知/external sender 是诚实的普通文字,显示链接不会额外读 child session。原生能力入口:
/jobs、/inspect、/questions、/rename [title]、/fork、/attach [local-path]只按当前 mounted capability 开放;已读到的同名原生命令优先。Settings 的默认 agent/permission preset 仍是安全 allowlist,不提供 raw profile、credentials 或 tool-policy 编辑。Goal 和 permission/Plan 不合并;timed 工具未挂载时不自动启用。完整边界见 两批记录。/model/ Alt+P:按原生 provider 分组;输入文字过滤模型 ID/名称/描述,切换 provider 保留查询;Enter 明确选择,Esc 关闭。字母/数字是查询文本,不是快捷键。搜索框复用同一个CcEditor。保留 DSH 原生行为:选择当前模型也提交原生默认;读取失败/刷新未完成时不能确认旧名册。/effort:来自当前目标模型的原生resolveModelInfo().reasoning;default清除显式等级,回到模型/适配器默认,同时按既有 DSH 行为提交默认选择。模型选择后只携带目标仍声明支持的显式等级,不把目标默认值提升为显式设置。Settings → DSH → Default model / Default model effort:只编辑原生启动默认,不调用当前会话的 model selector。新/未显式选择的会话沿用 DSH 默认跟随规则,已有 CLI pin、logged selection/request 和恢复会话不被改写。模型选择器标记
default,effort 名册来自保存的默认模型(可以与当前会话不同);Default移除显式 effort override。不支持/读不到 reasoning 时 effort 不可编辑,仍可选择有效模型修复旧默认;无原生写入服务时不退回本地设置。保存或取消返回同一 Settings 行、搜索与滚动位置,主草稿不变。详见 合同与验收。/preset:原生 Agent preset 名册;空白会话可原地切换,已开始的会话保留给下一次/new,底栏用next preset区分。正常成功不刷对话区:模型、effort、权限和 preset 的成功切换只更新底栏(自动标题显示在 Settings);失败、保存异常和原生警告仍可见。
/preset status、/effort status、裸/permission不回显状态列表,当前值看底栏。取消与排队:中断调用原生
Agent.cancel({kind:'user'}, {keepInbox:true});草稿与两个 inbox 队列保留,取消本身不主动续发。空输入 Up/Ctrl+P 取回可编辑的人类文本;后台任务唤醒仍归 DSH。已完成工具副作用不回滚。审批与问题:编辑框上方显示当前 native 决策;问题中 Ctrl+C/Esc 以原生
{cancelled:true}结算,审批返回原生rejected,不额外全局 abort。Ctrl+O 打开 supplied native detail/pure Proposal 的只读完整内容,返回保留原回答;显式app.interrupt的回合 abort 仍与局部取消区分。/reload:空闲且无待决策时,先做本层 idle 检查,再调用hmr.runExclusive(() => hmr.reconcileProfile())。当前 Agent、会话、transcript、草稿和缓存不重建;结果与 restart/pending 提示来自 DSH。忙碌、保留队列或待决策时拒绝。普通配置与插件启停由 DSH 原生重组;需要重启的情况以原生结果为准。直接重载前端插件会卸载/重建界面,不自动恢复最近会话。/settings:可搜索、可滚动的连续单页,用 General / Thinking / Tools & Diff / Agents / Images / DSH / Keyboard 分组标题分隔,不再切换 tab 页面。Up/Down 跨组逐项移动;Tab/Shift+Tab(或 Right/Left)跳到下一/上一组,搜索不会被清空。原有 Tools/Diff、Thinking、screen、auto title 与 Keyboard shortcuts 都保留;新增 Agents 进度、Agents 独立分组、图片自动/文本预览、全屏选字复制、队列默认折叠、减少动态效果,以及 General 的终端状态/标题/通知。布尔直接切换,枚举和数字进入明确选择/编辑,每项可恢复默认;保存失败只回退该项并在当前弹窗显示。DSH 分类保留当前 model/effort/preset/permission/Skills/plan 的状态与导航,并提供 Default model/Default model effort、默认 preset/permission 的安全 native 编辑。Thinking 分组只控制显示,不是模型 effort。显示偏好仍写同一个settings.json;模型和 effort 默认值只交给 DSH 原生 Settings/ConfigEditor,不增加配置层级。/resume:启动参数--resume <id>/-r <id>,或-r不带 id 打开当前目录会话选择器(Ctrl+A切当前目录/全部,模糊搜索,Esc 保留新会话);不自动选择最近会话。重复恢复当前 id 按 DSH 原生语义保留已有 Agent/attachment,不取消流式、队列或待决策;切换其他 id 先准备成功再释放旧连接,失败仍可继续使用当前会话。状态栏:第一行模型、effort、状态、preset、上下文占用、缓存命中、速率/TTFT 与瞬态提示;第二行 cwd、git 分支/状态、权限值。usage/sessionStats 来自原生投影,git 只读本地轮询,绝不 fetch/写索引。
偏好文件
界面偏好、键位与输入 recall 默认在 ~/.dsh-tui/(--config-dir 优先,其次 DSH_TUI_CONFIG_DIR):
~/.dsh-tui/
├── settings.json # 显示、思考、Tools/Diff、Agents/图片/队列/动效、终端标题/状态/通知;只写实际 override
├── keybindings.json # 自定义快捷键;保存覆盖时才创建
├── history.json # 按工作目录保存的文字 recall,不含图片 bytes/base64
└── logs/
├── terminal-diagnostics.log # 0600、限长、脱敏的原生运行诊断
└── terminal-diagnostics.log.1 # 至多一个轮换副本
这里不读取 Pi / CC 配置;模型、认证、权限、会话和插件组合仍使用 DSH 原生 profile/home。--models-file 已移除并明确失败,Pi 的 models.json/auth.json 永不被读取。
构建与验证
pnpm build # vendor/pi-tui 先构建,再 src -> lib
pnpm typecheck
pnpm test
pnpm check # build + typecheck + test
- native 二进制只来自 tarball。
package.json的files通过vendor/pi-tui/native/{darwin,linux,win32}/prebuilds三个显式目录只发布预构建.node;native 源码、header 和 build 脚本只是仓库构建输入,不进安装包。test/package-pack.test.ts同时检查pnpm pack构建产物与 npm 的 publish packlist,防止两者 glob 语义差异再次漏包。pnpm build/prepack只编译 JS,从源码重新生成 native prebuild 不是打包或安装的一部分(需要在对应平台用本地工具链单独构建)。 - 离线测试使用临时 home/workspace 与 fake Cordis 宿主;不读真实 profile、凭据、会话日志,也不访问真实 provider。
- 覆盖同进程原生流式/结算、模型选择器(搜索/effort)、权限/取消/ask/approval、HMR 配置重组合,以及原有 UI/input/image 回归。插件化之前的图片/PTY 与旧 CloudAgent 实网数字标为历史记录,不构成当前健康证明;本轮原生图片与 PTY 验收单独记录。
- 私有 native PTY(
test/plugin-pty.test.ts)保留 inline/fullscreen × 正常退出、外部 SIGINT 130、demo 和卸载-重挂载的 8 个 case;test/plugin-attachment-pty.test.ts额外覆盖无参数首启、全新 profile、幂等再启、同源旧名称升级、包操作失败/取消,以及整个前端行被禁用。全部使用临时 profile,要求终端恢复,不发送模型 prompt。当前完整结果见 验收记录。 - 真实模型/vision/GPU 像素截图验收不在本轮:没有宣称真实 provider 请求、真机像素或真实模型 vision 已通过。
- 可选的手动真实小 prompt(明确 opt-in,不推荐自动运行):
DSH_TUI_LIVE=1 DSH_TUI_LIVE_PROFILE=dsh-tui node scripts/live-smoke.ts,会通过原生 CLI 启动完整 TUI。原scripts/live-providers-smoke.ts已删除。
已知边界
- 开发验收没有修改真实 home/profile/global 安装;用户之后运行
dsh-tui时才会按上述规则自动挂载本地应用。其他前端清理与凭据配置仍由用户通过 native DSH 明确完成;不会自动迁移凭据、重建 profile,或重写用户 patch 中的旧 row id。npm publish、GitHub topic/release 与 v0.1.10 版本提交是本轮用户明确授权的发布动作;不安装或替换全局可执行文件。 - Pi 式 TUI 扩展热插拔暂未纳入;
/reload只做 native HMR 配置重组合,不重载 TUI 核心源码。 - 模型能力、上下文、推理级别与网关参数以 DSH 原生目录为准;TUI 不推断或另存第二份模型定义。默认模型持久化归宿主 ConfigEditor;兼容 setter 不以 fulfilled promise 冒称落盘,显式 Settings 写入则核验 native revision/read-back。临时 profile 重启验收不代表可以绕过只读 composition 或 home/CLI overlay 的原生拒绝。
- 历史恢复有事件数/UTF-8 字节预算,截断会提示;完整持久日志仍在 DSH 数据 home。工具耗时包含审批/策略等待,不另抓取逐行输出;大 Diff 超预算时提示并保留完整 Before/After 源。
- 图片显示转换独立于模型 vision;被拒绝的附件不会绕过 DSH 准入。终端 inline-image 能力由 Pi TUI 公共实现决定,tmux/screen 等未确认环境保守降级文字。
- 主屏在 resize 或视口上方更新时可能全量重绘;全屏可避开原生 scrollback 限制。不要把任何 TUI 写入同一终端的普通日志。
- 已做 ANSI 仿真与真实 PTY 验收,但具体终端的输入法/字体/GPU 手感仍需亲手试用。
相关文档
- 输入 API 与限制 · 输入行为 · 输入生命周期
- Tools 分组、详情与设置 · 工具 Diff 归属
- 图片投影、预览、附件输入与边界
- 模型/provider 原生投影 · 默认模型与 effort 设置 · Skills 原生接入
- DSH 同进程集成
- 输入邻近交互合同 · 原生历史与工作区 · 审批 Proposal
- Rex / Ghostty 终端支持 · Grok Build / CC 深度对照
- 主题与启动区 · 鼠标抽象
- 总体方案 · 验收记录
- Review 修复与取消最终验收(历史)
MIT;来源与许可见 THIRD_PARTY_LICENSES.md。
No comments yet. Be the first to write one.