DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

tarnish233 /

tarnish233/dsh-TUI

Verified

Native DeepSeek Harness terminal plugin. DSH owns the agent; this is the same-process TUI.

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@67d8db12

DSH TUI · v0.1.10

DSH TUI app icon

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-tui profile。后续已挂载时不重复安装。首次出现一行挂载提示;包操作有取消、静默和总时限,失败明确退出,不再留一个没有界面的后台 profile。
  • 只处理本应用。 本项目同一路径的旧名称依赖由原生包管理先安装新身份,再移除旧别名;失败不会先删掉原应用。其他插件、模型、凭据和用户 patch 不迁移、不重建。另一个来源占用同名包、明确禁用本 bundle,或 profile 已选择其他已知前端时,会报错而非擅自替换。
  • 默认 fullscreen。 要主屏/终端 scrollback 才用 dsh-tui --inline。显式保存的 screen 偏好仍然生效,--inline/--fullscreen 可覆盖它。
  • 原生同进程入口。 本机 /opt/homebrew/bin/dsh-tui 软链仍指向项目 bin,不需要更换全局可执行文件。包检查/挂载完成后别名委托 native dsh,并通过一层原生 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 把自己替换成 native dsh: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(嵌入宿主可用公开 pluginPackages lookup)解析 DSH 公开 resource 和原生 AgentPreset 类,用 native loadOverlayPatches / composeEntries 组合;不从本包目录找可选 peer、不挂 Web 前端,也不复制工具清单、权限规则或 plan 语义。
  • 模型目录:ctx.llm.listProviders() / listModels() / resolveModelInfo() 加 native agentDefaultModel 的只读投影(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 原生 fileReferences provider:根输入候选跟随当前根 Agent 的 effective cwd 与工具命名空间,支持模糊路径、目录下钻和带空格引号;接受候选只填草稿,不读取或 stage 文件。子任务 Reply 不借用根目录候选。@path 是由模型按原生指引调用 read 的普通文本,和显式 /attach FileBlock 分开。
  • 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。人类目录与模型工具可见性独立,不因 skill schema 未披露而隐藏。技能引用原文交给 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。

—/ 5

No ratings yet

Verified DSH bundle

Commit 67d8db122b05

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout