@deepseek-harness-tui/dsh-tui 0.8.8 → 0.9.1

package/README.md

@@ -13,12 +13,6 @@
   <a href="LICENSE"><img alt="MIT License" src="https://img.shields.io/badge/license-MIT-263146?style=flat-square"></a>
   <img alt="Public beta" src="https://img.shields.io/badge/status-public%20beta-7da1de?style=flat-square">
   <img alt="官方收录" src="https://img.shields.io/badge/DeepSeek%20Harness%20官方公众号-收录-brightgreen">
-  <a href="https://github.com/ccch1mneyyy/dsh-TUI/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/ccch1mneyyy/dsh-TUI?style=flat-square&color=4b6fff"></a>
-  <a href="https://www.npmjs.com/package/@deepseek-harness-tui/dsh-tui"><img alt="npm downloads" src="https://img.shields.io/npm/dm/@deepseek-harness-tui/dsh-tui?style=flat-square&color=4b6fff"></a>
-</p>
-
-<p align="center">
-  <a href="https://trendshift.io/repositories/146168" title="GitHub Trending 日榜 #7 · TypeScript 口径"><img alt="Trendshift" src="https://trendshift.io/api/badge/trendshift/repositories/146168/daily?language=TypeScript"></a>
 </p>
 
 # dsh-TUI
@@ -33,52 +27,77 @@
 
 ## 🎉 官方收录
 
-本插件被 **DeepSeek Harness 官方公众号** 推文收录，作为"内测用户精选插件"展示：
-
-<p align="center">
-  <img src="screenshots/wechat-official.png" alt="DeepSeek Harness 官方公众号推文收录 dsh-TUI" width="560">
-</p>
-
-同时也被 [dshfind](https://dshfind.com/zh/plugins/ccch1mneyyy/dsh-TUI) 插件目录收录：
-
-<p align="center">
-  <a href="https://dshfind.com/zh/plugins/ccch1mneyyy/dsh-TUI"><img src="https://dshfind.com/api/card/ccch1mneyyy/dsh-TUI?lang=zh" alt="dsh-TUI on dshfind"></a>
-</p>
-
+本插件被 **DeepSeek Harness 官方公众号** 推文收录，也被 [dshfind](https://dshfind.com/ccch1mneyyy/dsh-TUI) 插件目录与 [GitHub Trending](https://trendshift.io/repositories/146168) 收录，同时登上了Github Treding日榜第七
+
+<div align="center">
+  <table>
+    <tr>
+      <td align="center" valign="middle" width="50%">
+        <img src="screenshots/wechat-official.png" alt="DeepSeek Harness 官方公众号推文收录 dsh-TUI" width="480">
+        <br>
+        <strong>DeepSeek Harness 官方公众号推文收录</strong>
+      </td>
+      <td align="center" valign="middle" width="50%">
+        <a href="https://dshfind.com/ccch1mneyyy/dsh-TUI"><img src="https://dshfind.com/api/card/ccch1mneyyy/dsh-TUI?lang=zh" alt="dsh-TUI on dshfind" width="420"></a>
+        <br>
+        <strong>dshfind 插件目录收录</strong>
+        <br><br>
+        <a href="https://trendshift.io/repositories/146168" title="GitHub Trending 日榜 #7 · TypeScript 口径"><img alt="Trendshift" src="https://trendshift.io/api/badge/trendshift/repositories/146168/daily?language=TypeScript"></a>
+         <br>
+        <strong>dshfind Github Treding榜第七 </strong>
+      </td>
+    </tr>
+  </table>
+</div>
 ## 核心能力
 
-  - **终端原生交互**：流式 Markdown、结构化工具卡、命令与文件补全、`@` 文件引用
-    （消息任意位置补全，文本附加内容，PNG/JPEG/WebP/GIF 作为持久图片块发送）、历史搜索、消息选择、
-    inline/alternate-screen 两种渲染模式，以及 `/lang` 中英界面语言切换。
-  - **可观察的 Agent 状态**：实时工作状态、上下文分段进度、TPS、缓存命中率、
+  - **终端交互**：低资源占用，长会话稳定可靠；多种主题切换，样式美观，实时显示工作状态、TPS、缓存命中率等
     推理等级、输入/输出 token 与 Git/会话信息。
-  - **完整会话工作流**：`/resume`、`/new`、`/compact`、`/export`、`/btw` 侧问、
-    模型切换，以及双击 `Esc` 发起的会话 rewind/fork。
-  - **DSH 官方能力接入**：Agent preset、Skills、MCP、Goals、Todos、子代理、
-    `ask_user_question` 问卷都通过现有服务或注册表连接。
-  - **为长会话设计**：事件驱动投影、差分终端输出、消息虚拟化、回放合并与有界缓存，
-    避免渲染成本和内存随会话无限增长。
+  - **功能全面**：`/resume`、`/new`、`/compact`、`/export`、`/btw`，模型热切换，原生subagent，会话fork，自动更新；可在vs code中[以vscode插件形式启动](docs/vscode.md)，已上架 VS Code Marketplace。
+  - **扩展丰富**：原生浏览器交互，compter use等大量附属功能性扩展
+
+
 
 ## 界面预览
 
-![首屏：像素鲸鱼顶栏](screenshots/splash.png)
+<div align="center">
+  <table>
+    <tr>
+      <td align="center" valign="middle" width="50%">
+        <img src="screenshots/splash.png" alt="首屏：像素鲸鱼顶栏" width="480">
+        <br>
+        <strong>首屏：像素鲸鱼顶栏</strong>
+      </td>
+      <td align="center" valign="middle" width="50%">
+        <img src="screenshots/working-line.png" alt="工作状态行 + 上下文进度条" width="480">
+        <br>
+        <strong>工作状态行 + 上下文进度条</strong>
+      </td>
+    </tr>
+  </table>
+</div>
 
-![工作状态行 + 上下文进度条](screenshots/working-line.png)
 
 ## 快速开始
 
-前置条件：可用的终端 TTY、官方 `dsh` CLI，以及 `pnpm` 10+。运行模型还需要
-`DEEPSEEK_API_KEY`。
+前置条件：安装[Nodejs](https://nodejs.org/zh-cn)与[deepseek-harness](https://github.com/deepseek-ai/deepseek-harness)，注册`DEEPSEEK_API_KEY`。
+
+安装命令：
 
 ```sh
-# 1. 全局安装 CLI + 本插件（本插件自带 dsh-tui 直达命令）
 npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui
+```
+
+启动命令：
 
-# 2. 启动（首次运行会自动初始化 dsh-tui profile，需 pnpm）
+```bash
+# 完整命令
 dsh-tui
+# 如果你不想按键盘七次
+dst
 ```
 
-备选——手工安装 profile（仓库根目录 `install.sh` 已封装，含 pnpm 预检）：
+如果你想手动安装，可以使用仓库根目录的 `install.sh`：
 
 ```sh
 sh install.sh
@@ -86,106 +105,11 @@ sh install.sh
 # 之后 dsh-tui 与 dsh --profile dsh-tui 等价
 ```
 
-`dsh-tui --resume` 恢复上次会话；Windows 也可用仓库里的 `dsh-tui.cmd`（等价）。
+更面向零基础的安装流程、profile 叠加机制、源码构建与常见问题见[安装与快速开始](docs/getting-started.md)。
 
-### Herdr
 
-在 [Herdr](https://herdr.dev) pane 中直接运行 `dsh-tui` 即可，无需额外配置。
-dsh-TUI 会通过 Herdr 提供的本地接口上报 `idle`、`working`、`blocked` 状态；
-问卷或工具审批出现时标记为 `blocked`。离开 Herdr 运行时该集成完全不启用。
-Herdr 的 `agent start --kind dsh-tui`、session 身份与服务重启后自动恢复仍需 Herdr
-上游加入原生 agent kind；当前可正常保活、重连和观察手工启动的 pane。
 
-在 VS Code 中运行的完整指南（内置终端直接使用 + companion 扩展
-`dsh-tui-vscode`——**真实集成终端承载、体验与 Claude Code 官方扩展几乎一致、
-已上架 VS Code Marketplace**）见
-[在 VS Code 中运行 dsh-TUI](docs/vscode.md)。
-
-TUI 启动后会在后台检查 npm 是否有新版本；发现更新时可输入 `/update`。
-`/update` 更新当前 `dsh-tui` profile 中的 runtime 并重启会话，它不会静默修改
-npm/pnpm 的全局安装。若通过全局 `dsh-tui` 命令启动且 Launcher 版本落后，
-0.8.3 起会给出精确的全局对齐命令，例如：
-
-```sh
-npm install -g @deepseek-harness-tui/dsh-tui@<profile-version>
-```
-
-旧版 `dsh-cc-tui` / `cc-tui` profile 的迁移命令与兼容数据说明见
-[安装与快速开始](docs/getting-started.md#从旧包迁移)。
-
-安装流程、profile 叠加机制、源码构建与常见问题见
-[安装与快速开始](docs/getting-started.md)。
-
-## 快捷键
-
-| 键 | 功能 |
-|---|---|
-| `Enter` | 空闲=发送（`Shift+Enter` 换行，无法上报修饰键时可用 `Ctrl+J`，mac Terminal.app 可用 `Option+Enter` 兜底，issue #110）；**模型工作时=steer**（注入下一步边界，不中断）；命令菜单打开时执行选中项 |
-| `Ctrl+Enter`（⌘Enter） | **打断当前回合并立即发送**（interrupt） |
-| `Alt+Up` | 把最后一条未处理消息取回输入框编辑（不中断回合） |
-| `Tab` | 补全 `/` 命令或 `@` 文件（目录可继续深入）；**模型工作时=follow-up**（排入当前回合之后） |
-| `Ctrl+C` | 中断当前回合；空闲时连按两次退出 |
-| `Esc` | 关闭命令/文件菜单；空闲双击清空输入；**空输入双击 = 时间回溯** |
-| `Ctrl+O` | 展开/收起详情（思考全文、工具参数与输出） |
-| `Ctrl+R` | 历史消息搜索 |
-| `/` | 会话内全文搜索（`n`/`N` 跳转） |
-| `Ctrl+V` | 粘贴文本或文件管理器中的文件；图片显示为 `[Image #N]` 并作为持久附件发送 |
-| `Ctrl+G` | 用 `$VISUAL`/`$EDITOR`（如 nvim）打开当前输入编辑，保存退出后回填 |
-| `?` | 快捷键菜单（仅输入框为空时响应） |
-| `Shift+↑` | 消息选择模式（Enter 展开单条） |
-| `Ctrl+P` | 切换启动时 loaded-context 面板（面板在屏时有效） |
-| `Home` / `End`、`Ctrl+A` / `Ctrl+E` | 逻辑行首 / 行尾；`Ctrl+E` 双义：输入框=行尾，转录中=展开/折叠隐藏的旧消息 |
-| `Ctrl+←` / `Ctrl+→`（⌘←/→） | 按词跳转 |
-| `Ctrl+U` / `Ctrl+K` | 删除光标前（至行首）/ 光标后（至行尾） |
-| `Ctrl+W` | 删除前一个单词 |
-
-**模型工作中的三态投递**：`Enter`=steer（注入下一步边界，不中断）· `Tab`=follow-up（排入当前回合之后）· `Ctrl+Enter`=interrupt（打断并立即发送）。
-
-**macOS 修饰键**：上表中 Windows/Linux 的 `Ctrl+<键>` 在 macOS 上同时可用 `⌘<键>`
-（如 `⌘V` 粘贴、`⌘O` 展开详情、`⌘Enter` 立即发送）；仅 `Ctrl+C` / `Ctrl+D`
-（中断/退出）保持 Ctrl 不变，避免与 macOS 系统级 `⌘C` 复制等肌肉记忆冲突。
-`⌘` 需终端支持扩展键盘协议（iTerm2 / kitty / WezTerm / ghostty / tmux）；
-macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctrl`。
-
-**鼠标（`fullscreen: true` 全屏模式；默认关，profile 补丁层覆盖开启）**
-
-| 操作 | 功能 |
-|---|---|
-| 拖拽选择 | 应用内文本选区，**松开即复制**（OSC 52 + `wl-copy`/`xclip`/`xsel` 原生兜底；tmux 内走 `load-buffer -w`），复制后自动取消选区并弹出「已复制 N 个字符」提示 |
-| 双击 / 三击 | 选词 / 选行，同样即选即复制 |
-| 滚轮 | 仅在 fullscreen 且鼠标跟踪启用时：Help 打开时滚动帮助，否则滚动消息列表（±3 行/格）；默认 inline 模式不会把滚轮事件交给 TUI |
-| `Esc` | 拖拽进行中取消选区（不复制） |
-| 单击消息行 | 展开/收起该行 |
-| 单击「加载更早消息」/「ctrl+e 显示前 N 条」 | 加载更早消息 / 展开全部 |
-| 单击 StickyHeader / 「↓ N new messages」 | 跳回固定消息处 / 滚动到底部 |
-| 单击超链接 | 打开浏览器 |
-| 键盘扩展选区 | 有选区时 `Shift+←/→/↑/↓/Home/End` 扩展/收缩（跨行环绕） |
-
-**问卷（模型发起 `ask_user_question` 时）**
-
-| 键 | 功能 |
-|---|---|
-| `↑/↓` | 选择选项 |
-| `Space` | 多选题勾选/取消 |
-| `Tab` | 切到自定义回答（不选选项直接打字） |
-| `Enter` | 提交当前选择 |
-| `Esc` / `Ctrl+C` | 取消整批提问（模型收到 ASK_CANCELLED，可继续对话） |
-
-**本地命令（CC 指令全集复刻，均走 DSH 官方链路）**
-
-| 分组 | 命令 |
-|---|---|
-| 会话 | `/new` 新会话 · `/resume` 会话浏览器（搜索、预览、跨项目、折叠子 agent 运行） · `/rename` 重命名会话 · `/workspace resume|rename|open` 管理工作区 · `/clear` 清屏 · `/compact` 压缩 · `/export` 导出 Markdown · `/trace` 轨迹场景（亦可 `Ctrl+T`） · `/rewind` 回退选择器（同空输入双击 Esc 的时间回溯） · `/btw <问题>` 侧问（不打断主回合、不写历史） |
-| 状态 | `/context` 已加载上下文明细 · `/status` 会话信息 · `/cost` token 用量 · `/doctor` 环境自检 · `/config` 配置来源 · `/init` 创建 AGENTS.md · `/settings` 设置面板（命名空间读取/编辑） |
-| 模型 | `/model` 选择器（**切换 = fork 会话续聊，历史保留**） · `/effort` 推理强度（滑杆 / `status` / `<id>`） · `/preset` Agent 预设（**已开始会话不可切换**，blank-only） · `/thinking` 思考显示 · `/tokens` token 明细 · `/activity` 工作状态行动画（`frames <名>` / `status`） · `/theme` 主题选择器 · `/lang` 中英界面切换（`/settings` 中亦可选择） |
-| 账号/策略 | `/provider` 添加模型提供方 · `/login` 凭证状态 · `/logout` 登出说明 · `/permissions` 权限说明 · `/add-dir` 文件策略范围 · `/hooks` · `/mcp` |
-| 技能 | `/audit` 代码审计 · `/bug` bug 报告 · `/review` 代码评审 · `/practice` 编程练习 · `/pr_comments` PR 评论 · `/release-notes` 发布说明 · `/vuln-check` 漏洞检查 |
-| 其它 | `/agents` 子代理列表 · `/skills` 技能目录 · `/plugins check <路径>` 插件诊断 · `/update` 自动更新并重启 · `/vim` · `/terminal-setup` · `/connect` · `/help` · `/exit`（别名 `/quit` `/q`） |
-| 注册表 | `/plan` `/goal` `/feedback` `/permission`（DSH 命令注册表插件，随插件自动并入 `/` 菜单） |
-
-> 未知命令会作为普通消息发给模型（如 `/permission` 未挂载的组合里）。
-
-## 插件生态
+## 插件扩展与开发指南
 
 想为 dsh-TUI 做插件/扩展？欢迎加入生态！
 
@@ -195,11 +119,9 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 - **模板仓库**：[plugin-template](https://github.com/dsh-tui-ecosystem/plugin-template)（从模板起步，5 分钟出一个插件）
 - **参考实现**：`dsh-working-activity`（实时工作状态行：TUI 槽位 + `activity/status` 会话事件双出口）
 
-核心仓库不迁移、社区插件独立成仓。组织只维护收录列表与准入规范，不对社区插件
-的功能、质量或安全作背书或担保；插件作者对自己的仓库保持完全所有权，并自行承担
-维护与安全责任。
 
-## 文档
+
+## 文档索引
 
 | 主题 | 内容 |
 | --- | --- |
@@ -214,103 +136,6 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 
 完整的中英文索引见 [`docs/README.md`](docs/README.md)。
 
-## 配置与扩展
-
-- **Agent preset**：四种官方 Agent 模式（`standard` / `code` / `minimal` / `cordis`）和
-  TUI 随包提供的“梁神模式”（`liangshen`），
-  `/preset` 切换；已产生对话的会话不可切换，空白会话立即生效。默认 preset 持久化
-  在 `~/.dsh-tui/agent-preset.json`；`/model` 的选择持久化在 `~/.dsh-tui/model.json`。
-  详见[配置参考](docs/configuration.md#agent-preset)。
-- **自定义主题**：`/theme` 选择器（`auto` 跟随系统/终端背景，内置 `light` / `dark` /
-  `dark-ansi`），也支持 `~/.dsh-tui/themes/<名字>.json` 自定义主题，选中即热切换
-  并持久化；`DSH_TUI_THEME` 环境变量 > 持久化选择 > OSC 11 终端背景自动检测。
-  详见[主题系统](docs/themes.md)。
-- **MCP**：通过 `@deepseek-ai/dsh-mcp-client` 挂载服务器，工具以
-  `mcp__<服务器>__<工具>` 注册；`/mcp` 查看连接状态。
-  详见[配置参考](docs/configuration.md#mcp)。
-
-## 工作方式
-
-```text
-dsh profile
-  -> dsh-base
-  -> dsh-TUI Cordis patch
-  -> Agent preset + DSH services
-  -> session/event
-  -> Channel projection
-  -> React components
-  -> ported Ink/Yoga renderer
-  -> terminal
-```
-
-TUI 只负责交互与呈现。会话日志是对话真源，模型调用、工具执行、fork/resume、
-compaction 和持久化继续由 DSH 服务拥有。更详细的模块边界与性能设计见
-[架构文档](docs/architecture.md)。
-
-```text
-聊天 / 工具基础事件 ──> 持久 Session 日志 ──> TUI / Web
-        └──────────────> ActivityTracker（内存）──> 仅 TUI 状态栏
-```
-
-## 技术要点
-
-- **Gentle Mist Blue 配色**：雾蓝只承担品牌、焦点、交互与高亮，正文保持中性灰；
-  启动时查询终端背景色（OSC 11）自动选浅色/深色调色板，终端不响应时回退深色。
-- **事件驱动渲染**：`session/event` 事件流 → 增量差分渲染，滚动状态独立维护。
-- **布局级虚拟化**：长会话的每帧成本从 O(全会话) 降到 O(可视窗口)——屏幕外的
-  消息行渲染为"量高占位符"，其子树完全不参与布局。
-- **上下文进度条**：参考 pi-nano-context 算法（最大余数法分段着色 + 多级缩略读数）。
-- **TPS 仪表**：参考 pi-tps-meter——流式 1/8 格 gauge、历史 min-max sparkline、
-  速度语义色（≥50 绿 / ≥20 黄 / <20 红）。
-- **working-activity 生态**：工作状态行复用
-  [dsh-working-activity](https://github.com/ccch1mneyyy/working-activity)
-  的纯状态机，在进程内从基础会话事件派生，不向共享日志写入 UI 状态。
-- **终端粘贴**：raw 模式下 Ctrl+V 由应用接管，按平台读取系统剪贴板——Windows
-  走 PowerShell `Get-Clipboard`，macOS 走 `osascript`/`pbpaste`，Linux 自动探测
-  `wl-paste`/`xclip`/`xsel`；普通文件插入路径，图片文件生成 `@` 引用，剪贴板位图
-  写入附件库并在输入框显示 `[Image #N]`，纯文本原样插入光标处。
-
-## 已知限制
-
-- 注入上下文（plugin source 内容）未做独立展示，随系统提示词并入进度条统计。
-- `/model` 实时切换走"会话 fork 续聊"（DSH 无原位换模型 API）：历史原样保留，
-  新会话路由到新模型，旧会话仍留在 `/resume` 列表里；选择写入
-  `~/.dsh-tui/model.json`，重启与 `/new` 均沿用。
-- `Ctrl+V` 读剪贴板按平台依赖外部工具：Windows 用 PowerShell `Get-Clipboard`
-  （剪贴板被其他进程短暂锁定时自动重试，持续锁定时静默放弃）；macOS 用
-  `osascript`/`pbpaste`（Finder 多文件复制没有稳定的 AppleScript 读法，按
-  文本/图片回退）；Linux 需要 `wl-paste`/`xclip`/`xsel` 之一且会话可连接
-  （工具缺失或会话不可连接时提示无可用剪贴板工具）。不受支持的图片格式或附件
-  服务不可用时会保留临时文件引用作为降级路径。
-- 退出时以进程退出收尾，不等待 agent 异步落盘（持久化由 persistence 插件兜底）。
-- 工具级审批已实现：approval 服务 + TUI answerer（CC 式审批面板）消费审批流，
-  权限提升命令会弹出审批条。`/permission` 预设切换由 dsh-base 的
-  `permission-presets` 插件提供，profile 组合默认可用；裸组合 `cordis.yml`
-  未挂载该插件（无 `/permission` 命令）。
-- `/vim` `/connect` `/hooks` 为 CC 同名占位：对应能力在 DSH 侧无等价
-  机制，命令会给出明确说明而非静默。
-- `/thinking` 思考显示开关**不持久化**，重启或新会话回到默认。
-- minimal preset 下 `/compact` 不可用（minimal 不组合 compaction）。
-- `/update` 仅 `dsh --profile` 启动方式可用，回合运行中会拒绝。
-
-完整已知限制与安全边界见[架构与限制](docs/architecture.md)。
-
-## 开发
-
-CI 使用 Node 24 与 pnpm 11；包声明支持 Node `^22.19 || >=24`。
-
-```sh
-pnpm install --frozen-lockfile
-pnpm build
-pnpm smoke
-```
-
-`lib/types/` 是忽略入库的生成目录；`pnpm build` 会从干净输出目录重新编译并运行
-构建门禁。**Git URL 安装不受支持**（源 manifest 的 `@dsh-std/*` 为 workspace 依赖、
-`vendor/dsh-std` 为子模块、且 pnpm ≥11 默认拒绝 git 依赖的 `prepare` 脚本）；请安装
-registry 包：`dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui`。渲染、问卷和工具卡
-改动还需运行对应回归脚本。
-
 
 
 ## 社区
@@ -326,10 +151,7 @@ registry 包：`dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui`
 
 ## 权限与安全边界
 
-`dsh-TUI` 不实现独立沙箱，而是使用当前 DSH profile 的文件、Shell、sandbox 与
-approval 策略。仓库提供的 profile 在非 Windows 平台默认采用工作区约束与审批；
-Windows 当前没有对应的沙箱后端，组合会退回到 `danger-full-access` 且不弹审批。
-在包含敏感凭证或不可信仓库的环境中启动前，请先检查 profile 配置。
+`dsh-TUI` 不实现独立沙箱，而是使用当前 DSH profile 的文件、Shell、sandbox 与 approval 策略。仓库提供的 profile 在非 Windows 平台默认采用工作区约束与审批；Windows 当前没有对应的沙箱后端，组合会退回到 `danger-full-access` 且不弹审批。在包含敏感凭证或不可信仓库的环境中启动前，请先检查 profile 配置。
 
 详见[权限边界与已知限制](docs/architecture.md#权限与安全边界)。
 
@@ -337,7 +159,7 @@ Windows 当前没有对应的沙箱后端，组合会退回到 `danger-full-acce
 
 朋友们开发的[社区、相关项目与周边工具](docs/links.md)
 
-## 趋势
+## Stars
 
 <!-- star-history:start -->
 [![Star History](https://raw.githubusercontent.com/ccch1mneyyy/dsh-TUI/bot-star-history/assets/star-history/star-history.png)](https://star-history.com/#ccch1mneyyy/dsh-TUI&Date)

package/bin/dsh-tui.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * dsh-tui — 双态启动器（delegating launcher，0.8.8）。
+ * dsh-tui — 双态启动器（delegating launcher，0.9.1）。
  *
  * 同一个文件按“自己住在哪”决定扮演的角色：
  *
@@ -31,7 +31,7 @@ import { spawn, spawnSync } from 'node:child_process'
 import { existsSync, readFileSync, realpathSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { dirname, isAbsolute, join, resolve } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { fileURLToPath, pathToFileURL } from 'node:url'
 
 const here = dirname(fileURLToPath(import.meta.url))
 const ownDir = dirname(here)
@@ -140,9 +140,9 @@ const MSG = {
   },
   delegateFailed: {
     en: path =>
-      `[dsh-tui] cannot launch the profile copy:\n  ${path}\nReinstall the global launcher:\n  npm install -g ${PACKAGE}@latest`,
+      `[dsh-tui] cannot launch the profile copy:\n  ${path}\nReinstall the global launcher:\n  npm install -g --legacy-peer-deps ${PACKAGE}@latest\n(--legacy-peer-deps avoids an npm 12 peer-resolution crash; the launcher is a thin shim, so skipping global peer resolution is safe.)`,
     zh: path =>
-      `[dsh-tui] 无法启动 profile 内副本：\n  ${path}\n请重装全局启动器：\n  npm install -g ${PACKAGE}@latest`,
+      `[dsh-tui] 无法启动 profile 内副本：\n  ${path}\n请重装全局启动器：\n  npm install -g --legacy-peer-deps ${PACKAGE}@latest\n（--legacy-peer-deps 可绕过 npm 12 的 peer 解析崩溃；启动器是瘦壳，跳过全局 peer 解析是安全的。）`,
   },
   profileExited: {
     en: code => `[dsh-tui] dsh profile exited with code ${code}. Run it directly for diagnostics:\n  dsh --profile ${PROFILE}`,
@@ -152,6 +152,68 @@ const MSG = {
     en: (oldName, newName) => `[dsh-tui] note: env ${oldName} was renamed to ${newName}; the old name no longer takes effect.`,
     zh: (oldName, newName) => `[dsh-tui] 提示：环境变量 ${oldName} 已更名为 ${newName}，旧名不再生效。`,
   },
+  notInstalled: {
+    en: '(not installed)',
+    zh: '（未安装）',
+  },
+  doctorLabels: {
+    en: {
+      dshMissing: 'not found — install it first:  npm install -g @deepseek-ai/dsh',
+      pnpmMissing: 'not found — needed for install/update:  npm install -g pnpm',
+      profileMissing: 'not installed — run `dsh-tui` once to bootstrap it',
+      aligned: 'aligned',
+      profileNewer: v => `profile is newer — align the launcher:  npm install -g ${PACKAGE}@${v}`,
+      profileOlder: v => `profile is older — align it:  dsh plugin --profile ${PROFILE} add ${PACKAGE}@${v}`,
+      keySet: 'set',
+      keyMissing: 'not set — interactive launch reads DEEPSEEK_API_KEY',
+      missing: 'missing',
+    },
+    zh: {
+      dshMissing: '未找到——请先安装：  npm install -g @deepseek-ai/dsh',
+      pnpmMissing: '未找到——安装/升级需要它：  npm install -g pnpm',
+      profileMissing: '未安装——运行一次 `dsh-tui` 即可自举',
+      aligned: '已对齐',
+      profileNewer: v => `profile 较新——对齐启动器：  npm install -g ${PACKAGE}@${v}`,
+      profileOlder: v => `profile 较旧——对齐它：  dsh plugin --profile ${PROFILE} add ${PACKAGE}@${v}`,
+      keySet: '已设置',
+      keyMissing: '未设置——交互启动读取 DEEPSEEK_API_KEY',
+      missing: '缺失',
+    },
+  },
+  updateUnavailable: {
+    en:
+      `[dsh-tui] \`update\` needs the profile's compiled copy, but it is missing or too old to carry the CLI entry.\n` +
+      `Update manually instead:\n  dsh plugin --profile ${PROFILE} add ${PACKAGE}@latest`,
+    zh:
+      `[dsh-tui] \`update\` 需要 profile 的编译产物，但它缺失或版本过旧、不含 CLI 入口。\n` +
+      `请改用手工升级：\n  dsh plugin --profile ${PROFILE} add ${PACKAGE}@latest`,
+  },
+  helpText: {
+    en:
+      `Usage: dsh-tui [command] [options] [path|url]\n\n` +
+      `Commands:\n` +
+      `  update                 Update the ${PROFILE} profile to the latest release\n` +
+      `  doctor                 Pre-flight environment checks (dsh/pnpm/profile/key)\n` +
+      `  version                Show launcher and profile versions\n` +
+      `  help                   Show this help\n\n` +
+      `Options:\n` +
+      `  --resume [id]          Resume the last (or the given) session\n` +
+      `  -c, --continue         Same as --resume\n` +
+      `  <path|url>             Open with the given workspace target\n\n` +
+      `Any other argument is forwarded to \`dsh --profile ${PROFILE}\`.`,
+    zh:
+      `用法：dsh-tui [命令] [选项] [路径|URL]\n\n` +
+      `命令：\n` +
+      `  update                 将 ${PROFILE} profile 升级到最新版本\n` +
+      `  doctor                 启动前环境诊断（dsh/pnpm/profile/密钥）\n` +
+      `  version                显示启动器与 profile 版本\n` +
+      `  help                   显示本帮助\n\n` +
+      `选项：\n` +
+      `  --resume [id]          恢复上次（或指定 id 的）会话\n` +
+      `  -c, --continue         同 --resume\n` +
+      `  <路径|URL>             以指定工作区目标启动\n\n` +
+      `其余参数原样转发给 \`dsh --profile ${PROFILE}\`。`,
+  },
 }
 const msg = key => MSG[key][lang]
 
@@ -174,6 +236,78 @@ const profileBin = join(profilePkgDir, 'bin', 'dsh-tui.js')
 const installedPkgPath = join(profilePkgDir, 'package.json')
 const runningInsideProfile = sameDir(ownDir, profilePkgDir)
 
+// ─── 子命令：version / help ──────────────────────────────────────────────────
+// 只认第一个参数，且在角色分支之前应答：两种角色都不经过委托与自举——
+// `dsh-tui --help` 在没装 dsh、profile 残缺时也必须能出（否则求助命令
+// 本身先触发一轮安装）。后续位置的同名字符串不截获，保持既有透传与
+// 工作区目标嗅探行为不变。
+const subcommand = process.argv[2]
+if (subcommand === 'version' || subcommand === '--version' || subcommand === '-v') {
+  const role = runningInsideProfile ? 'profile' : 'launcher'
+  console.log(`${PACKAGE} ${ownVersion ?? 'unknown'} (${role})`)
+  const profileVersion = readJson(installedPkgPath)?.version
+  console.log(`profile: ${profileVersion ?? msg('notInstalled')}  ${profilePkgDir}`)
+  process.exit(0)
+}
+if (subcommand === 'help' || subcommand === '--help' || subcommand === '-h') {
+  console.log(msg('helpText'))
+  process.exit(0)
+}
+// ─── 子命令：doctor ──────────────────────────────────────────────────────────
+// 启动前环境诊断——针对「TUI 起不来」的故障域（装不上、update 后版本不
+// 同步、密钥没配），与 TUI 内 /doctor 的会话内诊断互补。零 lib 依赖、
+// 不委托、不自举：profile 残缺时它必须还能跑。密钥红线：只报告是否已
+// 设置，绝不输出值。仅 dsh 缺失记为硬失败（其余检查全部照常打印后再
+// 以退出码 1 收束）。
+if (subcommand === 'doctor') {
+  const L = msg('doctorLabels')
+  let hardFailure = false
+  const report = (ok, label, detail) => console.log(`${ok ? '✓' : '✗'} ${label}: ${detail}`)
+  console.log(`dsh-tui doctor · ${PACKAGE} ${ownVersion ?? 'unknown'}`)
+  report(true, 'node', `${process.version} · ${process.platform} ${process.arch}`)
+  const probeVersion = command => {
+    const probe = spawnSync(...cmd(command, ['--version']), { stdio: 'pipe', encoding: 'utf8', ...shellOpt })
+    if (probe.error || probe.status !== 0) return undefined
+    // 白名单校验：只回显版本号形状的首行。诊断输出的红线是绝不泄露密钥，
+    // 而 PATH 上的 wrapper 理论上可以把任意环境变量 echo 进 --version——
+    // 不匹配版本形状的输出一律不转印。
+    const line = String(probe.stdout ?? '').trim().split('\n')[0] ?? ''
+    return /^v?\d[\w.+-]*$/.test(line) ? line : '(version unreadable)'
+  }
+  const dshVersion = probeVersion('dsh')
+  if (dshVersion === undefined) {
+    hardFailure = true
+    report(false, 'dsh', L.dshMissing)
+  } else {
+    report(true, 'dsh', dshVersion)
+  }
+  const pnpmVersion = probeVersion('pnpm')
+  report(pnpmVersion !== undefined, 'pnpm', pnpmVersion ?? L.pnpmMissing)
+  const profileVersion = readJson(installedPkgPath)?.version
+  if (profileVersion === undefined) {
+    report(false, 'profile', `${L.profileMissing}  (${profileDir})`)
+  } else {
+    report(true, 'profile', `${profileVersion}  (${profileDir})`)
+    if (ownVersion !== undefined && !runningInsideProfile) {
+      if (profileVersion === ownVersion) {
+        report(true, 'launcher ↔ profile', L.aligned)
+      } else if (isVersionNewer(profileVersion, ownVersion)) {
+        report(false, 'launcher ↔ profile', L.profileNewer(profileVersion))
+      } else {
+        report(false, 'launcher ↔ profile', L.profileOlder(ownVersion))
+      }
+    }
+  }
+  // truthiness 而非 !== undefined：空字符串的 key 同样发不了请求，且 TUI 内
+  // /doctor（channel.doctorInfo）按 truthiness 报告——两个 doctor 不许分叉。
+  const keySet = Boolean(process.env.DEEPSEEK_API_KEY)
+  report(keySet, 'DEEPSEEK_API_KEY', keySet ? L.keySet : L.keyMissing)
+  for (const candidate of [join(homedir(), '.dsh-tui', 'cordis.yml'), join(profileDir, 'cordis.patch.yml')]) {
+    report(existsSync(candidate), 'config', `${candidate}${existsSync(candidate) ? '' : `  ${L.missing}`}`)
+  }
+  process.exit(hardFailure ? 1 : 0)
+}
+
 const forwardExit = child => {
   child.on('error', err => {
     console.error(msg('launchFailed')(err))
@@ -237,6 +371,37 @@ const bootstrapProfile = () => {
   }
 }
 
+// ─── 子命令：update ──────────────────────────────────────────────────────────
+// 顶层处理、两种角色同一条路径——不放进委托链。委托会把 update 交给
+// profile 内的旧 bin：旧副本不认识这个词，只会当参数透传，恰好是「profile
+// 落后、最需要升级」的用户永远到不了新入口。这里统一动态 import **profile
+// 的**编译产物（不是本副本的——DSH_TUI_NO_DELEGATE 下两者不同包，读本副本
+// 会拿全局包版本误判 already-latest/half-updated）；瘦壳零 lib 静态依赖的
+// 迁移契约不变。profile 未初始化时先走既有自举（dsh/pnpm 预检在其中）；
+// 编译产物缺失或没有 cliUpdate 导出（半更新的旧版）给手工升级指引退出 1。
+// 判定先于工作区目标嗅探：cwd 里名为 update 的文件不再被当成路径。
+if (subcommand === 'update') {
+  if (!profileReady()) bootstrapProfile()
+  {
+    const probe = spawnSync(...cmd('dsh', ['--version']), { stdio: 'pipe', ...shellOpt })
+    if (probe.error || probe.status !== 0) {
+      console.error(msg('noDsh'))
+      process.exit(1)
+    }
+  }
+  let cliUpdate
+  try {
+    ;({ cliUpdate } = await import(pathToFileURL(join(profilePkgDir, 'lib', 'types', 'update.js')).href))
+  } catch {
+    cliUpdate = undefined
+  }
+  if (typeof cliUpdate !== 'function') {
+    console.error(msg('updateUnavailable'))
+    process.exit(1)
+  }
+  process.exit(await cliUpdate(PROFILE))
+}
+
 // ─── 全局副本：瘦壳角色 ───────────────────────────────────────────────────────
 // DSH_TUI_NO_DELEGATE=1 是测试/调试逃生口：强制走完整逻辑（verify-launcher
 // 的沙箱用它直接驱动全量路径；现场排查委托链时同样可用）。
@@ -266,6 +431,7 @@ if (!runningInsideProfile && ownVersion !== undefined && process.env.DSH_TUI_NO_
       process.exit(1)
     }
   }
+
   let installedVersion
   try {
     installedVersion = JSON.parse(readFileSync(installedPkgPath, 'utf8')).version
@@ -297,7 +463,8 @@ if (!runningInsideProfile && ownVersion !== undefined && process.env.DSH_TUI_NO_
     if (installedNewer) {
       console.error(
         `[dsh-tui] note: the profile is already v${installedVersion}; this launcher copy is v${ownVersion}.\n` +
-          `  npm install -g ${PACKAGE}@${installedVersion}`,
+          `  npm install -g --legacy-peer-deps ${PACKAGE}@${installedVersion}\n` +
+          `(--legacy-peer-deps avoids an npm 12 peer-resolution crash, see issue #459)`,
       )
     } else {
       // profile 更旧但同 minor（patch 级错位）：允许启动，指引用 add 把

package/cordis.patch.yml

@@ -261,6 +261,16 @@
       name: '@deepseek-ai/dsh-cordis-host-runner'
       disabled: !!js "[...ctx.loader.entries()].some(entry => entry.options.id === 'cordis-host-runner' && entry.options.name === '@deepseek-ai/dsh-cordis-host-runner' && !entry.disabled)"
 
+    # Subscription OAuth sign-in (bundled dsh-auth dependency): mounts the
+    # ChatGPT/Codex, Claude Pro/Max and SuperGrok provider routes plus the
+    # /auth command; the TUI's /provider wizard gains its OAuth branch from
+    # the ctx.dshAuth service this row provides. Entry-level inject only —
+    # the plugin module's own inject is empty so a stale patch cannot
+    # deadlock a composition lacking these services (#183 pattern).
+    - id: dsh-tui-auth
+      name: '@deepseek-harness-tui/dsh-tui/oauth'
+      inject: [llm, commands]
+
     # The interactive front door. The plugin creates/resumes its agent at
     # runtime, seeds the startup status line, and disposes the whole app tree
     # (exiting the process) when the TUI unmounts. `dsh-tui --resume`
@@ -286,10 +296,12 @@
       config:
         provider: deepseek-official
         # Alt-screen fullscreen（CC 同款）：应用内鼠标选区（选择即复制, OSC 52 +
-        # wl-copy/xclip/xsel 兜底）、滚轮滚动、双击选词/三击选行。默认关闭——
-        # inline 模式下由终端原生选择/复制/scrollback 接管；想用 fullscreen 在
-        # profile 用户层 cordis.patch.yml 同 id 覆盖整行 config（fullscreen: true）。
-        fullscreen: false
+        # wl-copy/xclip/xsel 兜底）、滚轮滚动、双击选词/三击选行。出厂默认开启，
+        # 与 schema 默认（index.ts fullscreen default true）保持一致——两处必须
+        # 同步翻转，否则本覆盖层会盖住 schema 默认，更新后用户仍落在 inline。
+        # 想退回 inline 主屏（终端原生滚动/选择）：/settings 全屏开关或 cordis.yml
+        # `fullscreen: false`——显式选择始终优先于默认。
+        fullscreen: true
         # Edit/Write diff 呈现：auto（≥110 列双栏对照，窄屏统一式）/
         # split（强制双栏）/ unified（强制统一式）。/settings 屏可实时改。
         # diffLayout: auto