自 v0.20.1 以来,dsh-TUI 跟上 DSH 0.2.2-rc.5 验证线(继续兼容 0.2.2-rc.4、0.2.2-rc.3 及更早验证线),
为 present 工具加上专用交付卡,让 /restart 与 /update 在 POSIX 上原地替换进程,并修好 Windows /update
引擎解析、全屏跨页选区复制、@ 模糊补全缓存、Linux 终端桌面处理器以及 Host 服务行诊断与 dsh-working-activity 依赖兼容问题。
亮点
- 适配 DSH
0.2.2-rc.5(含0.2.2-rc.4) — 主验证线从0.2.2-rc.3推进到0.2.2-rc.5,peer 范围保留0.2.2-rc.4、0.2.2-rc.3及更早验证线,停在 rc.3/rc.4 的用户也能直接装这版,程序内/update会把 dsh 引擎对齐到0.2.2-rc.5。rc.4 为 DeepSeekrefusal停止原因新增的CONTENT_REFUSED结束码由 TUI 既有reason.kind分类自然覆盖;rc.5 起dsh-base不再固定web.searchProvider,/settings→ 网页搜索的「搜索」未配置时呈现为「自动」(DeepSeek 模型路由用 Messages 搜索,其他路由与对话外搜索用 Search API),并以settings.describe()的base层决定是否提供「自动」,同时按凭据引用去重展开 Messages / Search API 密钥控件。宿主复刻指纹与 rc.3 一致,本版新增0.2.2-rc.5的 patch surface 键。(#2065 by @Lucas2011wastaken) present交付文件卡 —present工具不再渲染成原始参数 JSON 与纯文本Presented行,而是渲染为专用交付卡:折叠态按行显示四格类型徽章(或通过/settings→ 外观 →nerdFontIcons开启 Nerd Font 图标)、文件名、文件大小与修改时间;展开(Ctrl+O或点击卡片)后单独分行展示解析后的完整目标路径与模型描述;点击文件行打开既有文件操作菜单,相对路径优先从结果中的Presented <绝对路径>行解析(以meta.cwd兜底),工作目录切换后仍能命中同一文件。(#2047 by @Lucas2011wastaken)
需要留意的行为变化
- 网页搜索默认改为「自动」 — 在 DSH
0.2.2-rc.5上,/settings→ 网页搜索中的「搜索」未设置时显示「自动」,选中会清除用户层覆盖并交回按路由选择。若下层组合仍固定searchProvider(旧验证线dsh-base或部署自带的 base 层补丁),界面不提供「自动」且手输automatic会被拒绝,与官方 Web 菜单一致;用户 profile 补丁只写用户层,仍可选「自动」清掉覆盖。在「自动」模式下,若 Search API(searchApiKeyEnv)与 Messages(apiKeyEnv/DEEPSEEK_API_KEY)引用不同凭据,会分别显示「Messages API 密钥」与「搜索 API 密钥」;共用同一引用时只显示一个输入框。 present交付卡底色与nerdFontIcons— 除极简界面(minimalUi)外,即使toolBackground设为none,present交付卡也保留自己的底色(无背景时暖橙、subtle/strong时深紫罗兰)。/settings→ 外观新增nerdFontIcons(默认关闭),开启需终端使用 Nerd Font Mono,否则图标会显示为方框。/restart与/update原地替换进程 — 在支持process.execve的非 Windows 运行时上,普通/restart与/update会原地替换当前进程(保留 PID 与前台作业,不再保留等待中的父进程,也不再由父进程在启动失败时打印TUI did not come up / session preserved);Windows、不支持execve的运行时、目标预检未通过与内核切换仍走子进程监督交接。已委托给dsh --profile的启动链在普通重启时保持该路径,直到下次冷启动或切换内核。- 全屏跨页选区跟随滚动 — 全屏拖选时按住鼠标配合
PgUp/PgDn或滚轮跨页扩展选区,起点随文本移动、另一端留在指针处;松手后两端继续随滚动移动,完全离屏后保留已捕获文本且不再高亮边缘无关字符,滚回后恢复位置与列范围。不支持鼠标拖到视口边缘自动滚动;inline 模式仍用终端原生选区。 @模糊补全按需刷新 — 工作区文件扫描完成后缓存 2 秒,过期后的下一次@查询才重扫(菜单静止时不轮询,空结果可立即重试);@src/等路径查询及原有 100 文件 / 100 目录扫描预算不变。- Linux
Terminal=true桌面处理器范围 — 只有本地文件的默认.desktop处理器声明Terminal=true时才包装进终端运行;URL、目录与非终端处理器仍走xdg-open,带非空Path=的条目也保持直接交给xdg-open(其 generic 路径仍可能无 TTY 或忽略工作目录)。
修复
/restart与/update原地替换与委托清理 — 普通/restart与/update在 POSIX 上通过process.execve原地替换进程(替换前预检process.execPath并显式刷盘usageStats);同时让委托给dsh启动的/update预先证明当前 DSH 入口归属以免 pnpm 组轮换后失效,并在会话销毁时同步关闭与清理 Claude 侧问及其私有凭据临时文件。(#2024 by @Lucas2011wastaken 与 @FlyingDuck,#2031 by @Lucas2011wastaken)- Windows
/update引擎解析与回退修复 — 按「显式目录 → 正在运行的引擎(argv[1])→ PATH → 模块回退」的顺序解析当前宿主,不再被旧 npx 缓存遗留的共享回退链接拦住升级;识别带常规dsh.cmd且不含项目 manifest/lock 的自定义 Windowsnpm config set prefix目录;Windows 共享回退 junction 改为先建暂存链接再换位(失败可恢复旧链接);npm就地升级改为以目标 manifest 与 PATH 探测验证结果,profile 安装改为直接执行计划选定宿主的bin.dsh入口,不再被另一套 PATH 引擎否决。(#2029 by @Lucas2011wastaken) - 全屏跨页拖选与滚回复制 — 按虚拟滚动实际绘制位移和
boxDeltaY平移选区,修复快速滚轮 /PgUp/PgDn及底部页眉卸载时的漏行与重复复制,同时修复反向滚回恢复与源码尾部硬换行保留。(#2043 by @Lucas2011wastaken) @模糊文件候选按需刷新 — 工作区扫描完成后 2 秒过期并在下次查询按需重扫,新建或删除文件无需重启即可出现在@补全中,同时复用在途与快速连续输入时的同一次扫描。(#2017 by @ccch1mneyyy 与 @Lucas2011wastaken)- Linux 下用终端运行
Terminal=true桌面处理器 — 本地文件通过xdg-mime解析默认.desktop条目,对Terminal=true的条目展开Exec字段码并在终端(依次尝试$TERMINAL、KDETerminalApplication、xdg-terminal-exec与常见终端)中启动,不再继承无 TTY 标准输入输出而静默退出;找不到终端、参数不支持或启动失败时回退到xdg-open。(#2053 by @Lucas2011wastaken) - 点名被禁用的 Host 服务行 — profile 中提供 Host 服务的行被禁用导致
agents.create/agents.resume失败时,诊断指出被禁用的行 ID、已装包版本与恢复顺序,并在启动 notice 中本地化提示/kernel、/quit与需要对齐的包名。(DSH0.2.2+已将模型选择移至会话投影,该特定model-selection-settings路径仅在0.2.1及更早兼容线上触发;其他被禁用的 Host 服务仍适用。)(#1862 by @MomentDerek) - 更新
dsh-working-activity至0.6.0— 将dsh-working-activity范围从^0.5.0升至^0.6.0,对齐 DSH 0.2.x 与 React 19 peer 声明,消除自定义 profile 下pnpm peers check的未满足 peer 警告。(#1974 by @ccch1mneyyy) - 文档 — 精简 README 的通知概览,将投递预算、原生 toast 注册与回退、让位规则、tmux 配置及
jumpBack机制说明归入用户指南。(#1941 by @baobaolaodie)
兼容与升级
- DSH 主适配线:
0.2.2-rc.5;0.2.2-rc.4、0.2.2-rc.3、0.2.2-rc.2、0.2.2-rc.1、0.2.1-rc.5、0.2.1-rc.4、0.2.1-rc.3、0.2.1-rc.2、0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-rc.1以及更早的验证线仍在契约内,契约外版本打漂移警告。 - DSH 在 npm 上的
latest仍是0.2.2-rc.1:0.2.2-rc.5走next标签。程序内/update会在目标 TUI 的 peer 范围内选已发布的最高版本,因此会把 dsh 引擎对齐到0.2.2-rc.5。 - 从 v0.20.1 升级:程序内
/update(本版会一并把 dsh 引擎对齐到0.2.2-rc.5、并对齐全局启动器),或
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui@0.20.2。 dst自动化 CLI 的验证线未同步前移:仍验证到0.2.1-rc.5;在 0.2.2 宿主上可用dst dsh原样转交官方参数。- 嫡系插件清单:随包的
tui-profile/feed/first-party.json钉到0.20.2。 - DSH
0.2.2要求 Node>=24.9:本包自身仍声明^22.19 || >=24;用更旧的 Node 运行0.2.2宿主属于上游未支持组合,升级前请先确认node -v。 - Windows 离线安装器:引擎验证范围随契约前移到
0.2.2-rc.5;已装更高的 RC 会降回验证线。
安装
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui@0.20.2偏好一键安装的用户可下载 Release 中的 dsh-tui-setup.zip(解压后 macOS / Linux 运行 sh install.sh,Windows 双击 install.bat)
或 Windows 离线安装程序 dsh-tui-setup-win-x64.exe;便携包解压即用。
What's Changed
- docs(readme): summarize the notifications entry by @baobaolaodie in #1941
- fix(restart): replace the current process instead of retaining parents by @Lucas2011wastaken in #2024
- fix(restart): repair delegated updates and side-query cleanup by @Lucas2011wastaken in #2031
- fix(update): resolve the running engine before stale fallbacks (#2028) by @Lucas2011wastaken in #2029
- fix(selection): keep cross-page copy complete while scrolling by @Lucas2011wastaken in #2043
- fix(completion): refresh stale fuzzy file candidates on demand by @ccch1mneyyy in #2017
- fix(deps): update working activity for DSH 0.2.x by @ccch1mneyyy in #1974
- feat(tool): render present deliveries as a delivery card by @Lucas2011wastaken in #2047
- fix(open): run Terminal=true desktop handlers in a terminal by @Lucas2011wastaken in #2053
- fix(dsh-adapter): name the disabled Host row behind a failed agent start by @MomentDerek in #1862
- test(dsh-adapter): follow upstream 0.2.2 in the Host-scope oracle by @Lucas2011wastaken in #2062
- chore(upstream): adapt to dsh 0.2.2-rc.5 by @Lucas2011wastaken in #2065
- chore(release): prepare v0.20.2 by @Lucas2011wastaken in #2066
Full Changelog: v0.20.1...v0.20.2