@deepseek-harness-tui/dsh-tui 0.6.1 → 0.7.0

package/README.md

@@ -17,8 +17,13 @@
 
 # dsh-TUI
 
-> 一个美观且实用的 Claude Code 风格 TUI 插件：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、蓝白上下文进度条 + TPS 仪表。
-> 零核心改动，纯插件挂载。安装插件即可启用，卸载后不会留下核心补丁。
+>一个美观且实用的 Claude Code 风格 TUI 插件：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、蓝白上下文进度条 + TPS 仪表。
+>零核心改动，纯插件挂载。安装插件即可启用，卸载后不会留下核心补丁。
+>献给钟爱tui的各位极客们~
+>
+>A beautiful, practical Claude Code-style TUI plugin: pixel whale top bar, dual flowing-glow title, real-time status line, streaming thought expansion, double-Esc time rewind, blue-white context progress bar + TPS gauge.
+>Zero core changes, pure plugin mounting. Install to enable; uninstall leaves no core patches.
+>For all TUI-loving geeks~
 
 ## 🎉 官方收录
 
@@ -31,12 +36,12 @@
 ## 核心能力
 
   - **终端原生交互**：流式 Markdown、结构化工具卡、命令与文件补全、`@` 文件引用
-    （消息任意位置补全，发送时自动附加文件内容/目录列表）、历史搜索、消息选择、
+    （消息任意位置补全，文本附加内容，PNG/JPEG/WebP/GIF 作为持久图片块发送）、历史搜索、消息选择、
     inline/alternate-screen 两种渲染模式，以及 `/lang` 中英界面语言切换。
   - **可观察的 Agent 状态**：实时工作状态、上下文分段进度、TPS、缓存命中率、
     推理等级、输入/输出 token 与 Git/会话信息。
-  - **完整会话工作流**：`/resume`、`/new`、`/compact`、`/export`、模型切换，
-    以及双击 `Esc` 发起的会话 rewind/fork。
+  - **完整会话工作流**：`/resume`、`/new`、`/compact`、`/export`、`/btw` 侧问、
+    模型切换，以及双击 `Esc` 发起的会话 rewind/fork。
   - **DSH 官方能力接入**：Agent preset、Skills、MCP、Goals、Todos、子代理、
     `ask_user_question` 问卷都通过现有服务或注册表连接。
   - **为长会话设计**：事件驱动投影、差分终端输出、消息虚拟化、回放合并与有界缓存，
@@ -71,6 +76,10 @@ sh install.sh
 
 `dsh-tui --resume` 恢复上次会话；Windows 也可用仓库里的 `dsh-tui.cmd`（等价）。
 
+在 VS Code 中运行的完整指南（内置终端直接使用 + companion 扩展
+`dsh-tui-vscode` 一键启动/恢复与编辑器集成）见
+[在 VS Code 中运行 dsh-TUI](docs/vscode.md)。
+
 TUI 启动后会在后台检查 npm 是否有新版本；发现更新时会提示，输入 `/update`
 即可自动更新并重启恢复当前会话。
 
@@ -91,7 +100,8 @@ TUI 启动后会在后台检查 npm 是否有新版本；发现更新时会提
 | `Ctrl+R` | 历史消息搜索 |
 | `/` | 会话内全文搜索（`n`/`N` 跳转） |
 | `Tab` / `Enter` | 命令 / `@` 文件补全（目录可继续深入） |
-| `Ctrl+V` | 粘贴：文本直接插入光标处；**Explorer 复制的文件/图片 → 插入文件路径** |
+| `Ctrl+V` | 粘贴文本或文件管理器中的文件；图片显示为 `[Image #N]` 并作为持久附件发送 |
+| `Ctrl+X` | 用 `$VISUAL`/`$EDITOR`（如 nvim）打开当前输入编辑，保存退出后回填 |
 | `?` | 快捷键菜单 |
 | `Shift+↑` | 消息选择模式（Enter 展开单条） |
 
@@ -124,10 +134,10 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 
 | 分组 | 命令 |
 |---|---|
-| 会话 | `/new` 新会话 · `/resume` 恢复 · `/rename` 重命名 · `/clear` 清屏 · `/compact` 压缩 · `/export` 导出 Markdown |
+| 会话 | `/new` 新会话 · `/resume` 切换当前工作区内的会话 · `/rename` 重命名会话 · `/workspace resume|rename|open` 管理工作区 · `/clear` 清屏 · `/compact` 压缩 · `/export` 导出 Markdown · `/trace` 轨迹场景（亦可 `Ctrl+T`） |
 | 状态 | `/status` 会话信息 · `/cost` token 用量 · `/doctor` 环境自检 · `/config` 配置来源 · `/init` 创建 AGENTS.md |
 | 模型 | `/model` 选择器 · `/thinking` 思考显示 · `/tokens` token 明细 · `/theme` 主题选择器 · `/lang` 中英界面切换 |
-| 账号/策略 | `/login` 凭证状态 · `/logout` 登出说明 · `/permissions` 权限说明 · `/add-dir` 文件策略范围 · `/hooks` · `/mcp` · `/memory` |
+| 账号/策略 | `/provider` 添加模型提供方 · `/login` 凭证状态 · `/logout` 登出说明 · `/permissions` 权限说明 · `/add-dir` 文件策略范围 · `/hooks` · `/mcp` · `/memory` |
 | 技能 | `/audit` 代码审计 · `/bug` bug 报告 · `/review` 代码评审 · `/practice` 编程练习 · `/pr_comments` PR 评论 · `/release-notes` 发布说明 · `/vuln-check` 漏洞检查 |
 | 其它 | `/agents` 子代理列表 · `/update` 自动更新并重启 · `/vim` · `/terminal-setup` · `/connect` · `/help` · `/exit` |
 | 注册表 | `/plan` `/goal`（DSH 命令注册表插件，随插件自动并入 `/` 菜单） |
@@ -141,7 +151,9 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 | [主题系统](docs/themes.md) | 内置主题、自动检测、自定义 JSON 主题与校验规则 |
 | [交互与命令](docs/interaction.md) | 快捷键、鼠标、问卷、slash command 与会话工作流 |
 | [架构与限制](docs/architecture.md) | 运行链路、渲染与持久化设计、安全边界、已知限制 |
+| [VS Code 使用指南](docs/vscode.md) | 在 VS Code 集成终端运行 dsh-tui 与 companion 扩展 `dsh-tui-vscode` |
 | [贡献与开发约定](docs/contributing.md) | 贡献流程、仓库地图、构建产物、验证矩阵与修改规则 |
+| [插件开发指南](docs/plugins.md) | 插件接缝（会话事件 / 槽位 / 技能 / 主题 / prompt 段）、契约、规范与收录 |
 
 完整的中英文索引见 [`docs/README.md`](docs/README.md)。
 
@@ -149,11 +161,11 @@ macOS 自带 Terminal.app 会自行消费 `⌘` 快捷键，请继续使用 `Ctr
 
 - **Agent preset**：四种官方 Agent 模式（`standard` / `code` / `minimal` / `cordis`），
   `/preset` 切换；已产生对话的会话不可切换，空白会话立即生效。默认 preset 持久化
-  在 `~/.dsh-cc/agent-preset.json`；`/model` 的选择持久化在 `~/.dsh-cc/model.json`。
+  在 `~/.dsh-tui/agent-preset.json`；`/model` 的选择持久化在 `~/.dsh-tui/model.json`。
   详见[配置参考](docs/configuration.md#agent-preset)。
-- **自定义主题**：`/theme` 选择器（内置 `light` / `dark` / `dark-ansi`），也支持
-  `~/.dsh-cc/themes/<名字>.json` 自定义主题，选中即热切换并持久化；
-  `CC_TUI_THEME` 环境变量 > 持久化选择 > OSC 11 终端背景自动检测。
+- **自定义主题**：`/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` 查看连接状态。
@@ -177,6 +189,11 @@ TUI 只负责交互与呈现。会话日志是对话真源，模型调用、工
 compaction 和持久化继续由 DSH 服务拥有。更详细的模块边界与性能设计见
 [架构文档](docs/architecture.md)。
 
+```text
+聊天 / 工具基础事件 ──> 持久 Session 日志 ──> TUI / Web
+        └──────────────> ActivityTracker（内存）──> 仅 TUI 状态栏
+```
+
 ## 技术要点
 
 - **Gentle Mist Blue 配色**：雾蓝只承担品牌、焦点、交互与高亮，正文保持中性灰；
@@ -187,23 +204,31 @@ compaction 和持久化继续由 DSH 服务拥有。更详细的模块边界与
 - **上下文进度条**：参考 pi-nano-context 算法（最大余数法分段着色 + 多级缩略读数）。
 - **TPS 仪表**：参考 pi-tps-meter——流式 1/8 格 gauge、历史 min-max sparkline、
   速度语义色（≥50 绿 / ≥20 黄 / <20 红）。
-- **working-activity 生态**：工作状态行消费
+- **working-activity 生态**：工作状态行复用
   [dsh-working-activity](https://github.com/ccch1mneyyy/dsh-working-activity)
-  的 log-only `activity/status` 事件（与 Web UI 同一数据源）。
-- **终端粘贴**：raw 模式下 Ctrl+V 由应用接管——PowerShell `Get-Clipboard` 读取，
-  Explorer 复制的文件/图片插入文件路径，纯文本原样插入光标处。
+  的纯状态机，在进程内从基础会话事件派生，不向共享日志写入 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-cc/model.json`，重启与 `/new` 均沿用。
-- `Ctrl+V` 读剪贴板依赖 PowerShell `Get-Clipboard`：剪贴板被其他进程短暂锁定
-  时自动重试，持续锁定时静默放弃。
+  `~/.dsh-tui/model.json`，重启与 `/new` 均沿用。
+- `Ctrl+V` 读剪贴板按平台依赖外部工具：Windows 用 PowerShell `Get-Clipboard`
+  （剪贴板被其他进程短暂锁定时自动重试，持续锁定时静默放弃）；macOS 用
+  `osascript`/`pbpaste`（Finder 多文件复制没有稳定的 AppleScript 读法，按
+  文本/图片回退）；Linux 需要 `wl-paste`/`xclip`/`xsel` 之一且会话可连接
+  （工具缺失或会话不可连接时提示无可用剪贴板工具）。不受支持的图片格式或附件
+  服务不可用时会保留临时文件引用作为降级路径。
 - 退出时以进程退出收尾，不等待 agent 异步落盘（持久化由 persistence 插件兜底）。
-- DSH 的 `/permission`（沙箱模式切换）未适配：需要 approval 服务 + 审批 UI，
-  当前 TUI 不消费审批流，刻意不挂。
+- 工具级审批已实现：approval 服务 + TUI answerer（CC 式审批面板）消费审批流，
+  权限提升命令会弹出审批条。`/permission` 预设切换由 dsh-base 的
+  `permission-presets` 插件提供，profile 组合默认可用；裸组合 `cordis.yml`
+  未挂载该插件（无 `/permission` 命令）。
 - `/vim` `/connect` `/hooks` `/memory` 为 CC 同名占位：对应能力在 DSH 侧无等价
   机制，命令会给出明确说明而非静默。
 
@@ -222,6 +247,28 @@ pnpm smoke
 `pnpm build` 会把 `src/` 编译到已提交的 `lib/types/`。修改源码时必须同步生成产物；
 渲染、问卷和工具卡还需运行对应回归脚本。
 
+## 插件生态
+
+想为 dsh-TUI 做插件/扩展？欢迎加入生态：
+
+- **插件开发指南**：[`docs/plugins.md`](docs/plugins.md)（接缝、契约、规范与验证清单）
+- **生态组织**：[dsh-tui-ecosystem](https://github.com/dsh-tui-ecosystem)（社区插件与模板的家）
+- **模板仓库**：[plugin-template](https://github.com/dsh-tui-ecosystem/plugin-template)（从模板起步，5 分钟出一个插件）
+- **参考实现**：`dsh-working-activity`（实时工作状态行：TUI 槽位 + `activity/status` 会话事件双出口）
+
+核心仓库不迁移、社区插件独立成仓——组织只负责收录与背书，插件作者对自己的仓库保持完全所有权。
+
+## 社区
+
+- **生态组织**：[dsh-tui-ecosystem](https://github.com/dsh-tui-ecosystem) —— 社区插件、模板与收录列表的家。欢迎来发插件、提创意、互相取暖 🐋
+- **社区交流群**：使用问题、插件创意、功能许愿，都欢迎进来聊。
+
+| 微信群 | QQ 群（群号 572549239） |
+| :---: | :---: |
+| <img src="screenshots/wechat-group.jpg" alt="dsh-TUI 社区交流群微信群二维码" width="200"> | <img src="screenshots/qq-group.png" alt="dsh-TUI 社区交流群 QQ 群二维码" width="200"> |
+
+> 微信群二维码约 7 天过期一次，如遇失效请走 QQ 群（572549239），或开个 issue 提醒我们更新。
+
 ## 权限与安全边界
 
 `dsh-TUI` 不实现独立沙箱，而是使用当前 DSH profile 的文件、Shell、sandbox 与
@@ -235,6 +282,12 @@ Windows 当前没有对应的沙箱后端，组合会退回到 `danger-full-acce
 
 朋友们开发的[社区、相关项目与周边工具](docs/links.md)
 
+## 趋势
+
+<!-- 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)
+<!-- star-history:end -->
+
 
 ## License
 

package/bin/dsh-tui.js

@@ -9,81 +9,171 @@
  *   2. 检测 $DSH_HOME/profiles/dsh-tui 是否已初始化，未初始化则自动执行
  *      `dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui@<本包版本>`
  *      自举——版本号与本包对齐，避免 pnpm store 缓存带来的旧版漂移；
- *   3. 透传全部参数启动 `dsh --profile dsh-tui`。
+ *   3. 已初始化但版本与本包不一致时打印一行提示（TUI 内 /update 或重新 add）；
+ *   4. 透传全部参数启动 `dsh --profile dsh-tui`。
  *
- * `--resume` 由本启动器拦截：读取 TUI 保留的兼容路径 ~/.dsh-cc/resume.txt，
- * 以 DSH_CC_RESUME_SESSION 环境变量喂回（见 src/sessionHistory.ts 的
- * 启动器契约），该 flag 本身不再传给 dsh。
+ * `--resume` 由本启动器拦截：读取 TUI 保留的 ~/.dsh-tui/resume.txt
+ * （旧路径 ~/.dsh-cc/resume.txt 兜底，直到旧版 TUI 退场——见
+ * src/sessionHistory.ts 的启动器契约，issue #120），以
+ * DSH_TUI_RESUME_SESSION（并兼容写 DSH_CC_RESUME_SESSION）环境变量喂回，
+ * 该 flag 本身不再传给 dsh。
+ *
+ * 面向用户的消息走下方 MSG 双语表：与 TUI 的语言契约一致——
+ * `DSH_TUI_LANG` 显式指定时从其值，否则默认中文（同 src/i18n.ts 的缺省）。
  */
 import { spawn, spawnSync } from 'node:child_process'
 import { existsSync, readFileSync } from 'node:fs'
 import { homedir } from 'node:os'
-import { join } from 'node:path'
+import { isAbsolute, join, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
+import { shellQuote } from '../lib/types/utils/shellQuote.js'
+import { detectLegacyEnv, RENAMED_ENV } from '../lib/types/utils/paths.js'
 
 const here = fileURLToPath(new URL('.', import.meta.url))
 const ownVersion = JSON.parse(readFileSync(join(here, '..', 'package.json'), 'utf8')).version
 const PACKAGE = '@deepseek-harness-tui/dsh-tui'
 const PROFILE = 'dsh-tui'
 
+// --- 双语消息表（启动器跑在 TUI boot 之前，无法复用 src/i18n.ts）-------------
+// 与 TUI 一致：DSH_TUI_LANG 显式指定才生效，否则默认中文；旧名 CC_TUI_LANG
+// 仅用于让警告本身以用户习惯的语言显示（配置不再从旧名生效）。
+const lang = (process.env.DSH_TUI_LANG ?? process.env.CC_TUI_LANG) === 'en' ? 'en' : 'zh'
+const MSG = {
+  noDsh: {
+    en: '[dsh-tui] dsh CLI not found. Install the official client first:\n  npm install -g @deepseek-ai/dsh',
+    zh: '[dsh-tui] 未检测到 dsh CLI。请先安装官方客户端：\n  npm install -g @deepseek-ai/dsh',
+  },
+  noPnpm: {
+    en: '[dsh-tui] The first-time setup needs pnpm (dsh plugin delegates installs to it):\n  npm install -g pnpm   (or via corepack: corepack enable pnpm)',
+    zh: '[dsh-tui] 首次安装需要 pnpm（dsh plugin 会把安装转发给它）：\n  npm install -g pnpm   （或启用 corepack：corepack enable pnpm）',
+  },
+  bootstrapStart: {
+    en: `[dsh-tui] First run — initializing the ${PROFILE} profile (${PACKAGE}@${ownVersion})…`,
+    zh: `[dsh-tui] 首次运行，正在初始化 ${PROFILE} profile（${PACKAGE}@${ownVersion}）…`,
+  },
+  installFailed: {
+    en: `[dsh-tui] Plugin install failed. Retry manually later:\n  dsh plugin --profile ${PROFILE} add ${PACKAGE}@${ownVersion}`,
+    zh: `[dsh-tui] 插件安装失败。可稍后手工重试：\n  dsh plugin --profile ${PROFILE} add ${PACKAGE}@${ownVersion}`,
+  },
+  versionMismatch: {
+    en: (installed, own) =>
+      `[dsh-tui] note: the profile is running v${installed} but this launcher is v${own}.\n` +
+      `  To update the profile: run /update inside the TUI, or:\n` +
+      `  dsh plugin --profile ${PROFILE} add ${PACKAGE}@latest`,
+    zh: (installed, own) =>
+      `[dsh-tui] 提示：profile 内运行的是 v${installed}，而启动器是 v${own}。\n` +
+      `  更新 profile：在 TUI 内执行 /update，或运行：\n` +
+      `  dsh plugin --profile ${PROFILE} add ${PACKAGE}@latest`,
+  },
+  launchFailed: {
+    en: err => `[dsh-tui] Failed to launch: ${err.message}`,
+    zh: err => `[dsh-tui] 启动失败：${err.message}`,
+  },
+  legacyEnv: {
+    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}，旧名不再生效。`,
+  },
+}
+const msg = key => MSG[key][lang]
+
 // React 开发构建会把每次渲染的 performance.measure() 堆进无界缓冲区导致
 // 长会话 OOM——与仓库根 dsh-tui.cmd 保持一致，强制 production。
 process.env.NODE_ENV ??= 'production'
 
 const isWin = process.platform === 'win32'
 // Windows 上 .cmd shim 必须经 shell 启动（Node ≥18.20.2 的安全限制）；
-// 其余平台直接 spawn 无后缀的 dsh。
+// 其余平台直接 spawn 无后缀的 dsh。cmd.exe 以空格拼接参数且 Node 不做
+// 转义——shell 路径的所有参数必须先过 shellQuote（同 src/update.ts 的
+// /update 重启路径），否则含空格/引号的参数会被拆断。
 const shellOpt = isWin ? { shell: true } : {}
+// DEP0190（issue #148）：Node ≥22 对「shell:true + 非空参数数组」的调用
+// 发出弃用警告，判定是语法级的——参数已过 shellQuote 也一样告警；且未来
+// 大版本可能升级为运行时错误。把转义后的参数拼进命令字符串传入
+// （shell:true + 空参数数组不触发），非 Windows 路径保持数组直传。
+const cmd = (command, args) =>
+  isWin ? [`${command} ${shellQuote(args).join(' ')}`, []] : [command, args]
 
 // --- 1. dsh CLI 预检 ---------------------------------------------------------
-const probe = spawnSync('dsh', ['--version'], { stdio: 'pipe', ...shellOpt })
+const probe = spawnSync(...cmd('dsh', ['--version']), { stdio: 'pipe', ...shellOpt })
 if (probe.error || probe.status !== 0) {
-  console.error('[dsh-tui] 未检测到 dsh CLI。请先安装官方客户端：')
-  console.error('  npm install -g @deepseek-ai/dsh')
+  console.error(msg('noDsh'))
   process.exit(1)
 }
 
-// --- 2. profile 自举 ----------------------------------------------------------
+// --- 2. profile 自举与版本检查 -------------------------------------------------
 const dshHome = process.env.DSH_HOME || join(homedir(), '.dsh')
 const profileDir = join(dshHome, 'profiles', PROFILE)
-if (!existsSync(join(profileDir, 'node_modules', '@deepseek-harness-tui', 'dsh-tui'))) {
-  const pnpmProbe = spawnSync('pnpm', ['--version'], { stdio: 'pipe', ...shellOpt })
+// 以已装包的 package.json 可读为准（而非目录存在）：安装中途失败留下的
+// 残骸目录会触发重新安装，而不是以坏 profile 直接启动。
+let installedVersion
+try {
+  installedVersion = JSON.parse(
+    readFileSync(join(profileDir, 'node_modules', '@deepseek-harness-tui', 'dsh-tui', 'package.json'), 'utf8'),
+  ).version
+} catch {
+  installedVersion = undefined
+}
+if (installedVersion === undefined) {
+  const pnpmProbe = spawnSync(...cmd('pnpm', ['--version']), { stdio: 'pipe', ...shellOpt })
   if (pnpmProbe.error || pnpmProbe.status !== 0) {
-    console.error('[dsh-tui] 首次安装需要 pnpm（dsh plugin 会把安装转发给它）：')
-    console.error('  npm install -g pnpm   （或启用 corepack：corepack enable pnpm）')
+    console.error(msg('noPnpm'))
     process.exit(1)
   }
-  console.log(`[dsh-tui] 首次运行，正在初始化 ${PROFILE} profile（${PACKAGE}@${ownVersion}）…`)
-  const add = spawnSync('dsh', ['plugin', '--profile', PROFILE, 'add', `${PACKAGE}@${ownVersion}`], { stdio: 'inherit', ...shellOpt })
+  console.log(msg('bootstrapStart'))
+  const add = spawnSync(...cmd('dsh', ['plugin', '--profile', PROFILE, 'add', `${PACKAGE}@${ownVersion}`]), { stdio: 'inherit', ...shellOpt })
   if (add.status !== 0) {
-    console.error('[dsh-tui] 插件安装失败。可稍后手工重试：')
-    console.error(`  dsh plugin --profile ${PROFILE} add ${PACKAGE}@${ownVersion}`)
+    console.error(msg('installFailed'))
     process.exit(add.status ?? 1)
   }
+} else if (installedVersion !== ownVersion) {
+  console.error(MSG.versionMismatch[lang](installedVersion, ownVersion))
 }
 
 // --- 3. --resume 拦截 ---------------------------------------------------------
+// 换名过渡（issue #120）：全局 bin 与 profile 内 TUI 包版本可能错位，所以
+// env 双写（新旧名都设），文件读取新路径优先、旧路径兜底。
 const args = []
 for (const a of process.argv.slice(2)) {
   if (a === '--resume') {
-    try {
-      process.env.DSH_CC_RESUME_SESSION = readFileSync(join(homedir(), '.dsh-cc', 'resume.txt'), 'utf8').trim()
-    } catch {
-      // 没有历史会话可恢复——静默忽略，正常冷启动。
+    let sessionId = ''
+    for (const dir of ['.dsh-tui', '.dsh-cc']) {
+      try {
+        sessionId = readFileSync(join(homedir(), dir, 'resume.txt'), 'utf8').trim()
+        if (sessionId) break
+      } catch {
+        // 没有历史会话可恢复——静默忽略，正常冷启动。
+      }
     }
+    if (sessionId) {
+      process.env.DSH_TUI_RESUME_SESSION = sessionId
+      process.env.DSH_CC_RESUME_SESSION = sessionId
+    }
+  } else if (
+    process.env.DSH_TUI_WORKSPACE_TARGET === undefined
+    && !a.startsWith('-')
+    && (isAbsolute(a) || /^[a-z][a-z0-9+.-]*:\/\//iu.test(a) || existsSync(resolve(a)))
+  ) {
+    // A workspace target is launcher syntax, not an argument for the profile
+    // app. The registry resolves local paths/file URLs and provider URIs.
+    process.env.DSH_TUI_WORKSPACE_TARGET = a
   } else {
     args.push(a)
   }
 }
 
+// --- 3.5 旧环境变量警告（必须在 TUI 渲染前输出，fullscreen 下写 stderr 会破坏界面）
+for (const oldName of detectLegacyEnv()) {
+  console.error(MSG.legacyEnv[lang](oldName, RENAMED_ENV[oldName]))
+}
+
 // --- 4. 启动 ------------------------------------------------------------------
-const child = spawn('dsh', ['--profile', PROFILE, ...args], {
+const child = spawn(...cmd('dsh', ['--profile', PROFILE, ...args]), {
   stdio: 'inherit',
   env: process.env,
   ...shellOpt,
 })
-child.on('error', (err) => {
-  console.error(`[dsh-tui] 启动失败：${err.message}`)
+child.on('error', err => {
+  console.error(MSG.launchFailed[lang](err))
   process.exit(1)
 })
 child.on('exit', (code, signal) => {

package/cordis.patch.yml

@@ -11,11 +11,11 @@
 
 # ── surface-specific values over the dsh-base layer ─────────────────────────
 
-# The dsh-tui deployment persona; CC_TUI_PERSONA overrides the coding-agent
+# The dsh-tui deployment persona; DSH_TUI_PERSONA overrides the coding-agent
 # default (the base persona is empty).
 - id: system-prompt
   config:
-    persona: !!js process.env.CC_TUI_PERSONA ?? 'You are a coding agent.'
+    persona: !!js process.env.DSH_TUI_PERSONA ?? 'You are a coding agent.'
 
 # The native DeepSeek adapter, pinned to the harness defaults: full thinking
 # at max effort, key and base URL from the launching environment. The base
@@ -143,10 +143,10 @@
 # Sessions live in the shared JSONL store (~/.dsh/sessions) — the same
 # backend dsh web writes — so /resume here and the web session list see each
 # other (#24). The row itself comes from the dsh-base layer; this override
-# only re-points the root when DSH_CC_SESSION_ROOT is set (test isolation).
+# only re-points the root when DSH_TUI_SESSION_ROOT is set (test isolation).
 - id: session-persistence-jsonl
   config:
-    root: !!js process.env.DSH_CC_SESSION_ROOT ?? dshHomePath('sessions')
+    root: !!js process.env.DSH_TUI_SESSION_ROOT ?? dshHomePath('sessions')
 
 # ── dsh-tui rows ────────────────────────────────────────────────────────────
 
@@ -159,6 +159,35 @@
 # `ctx.userQuestions`.
 
 - insert:
+    # Workspace grouping is a separate durable ledger, not a cwd-derived
+    # projection. Mount the same domain stack and storage root as dsh-web-app
+    # so TUI-created sessions can attach to the exact registry Web reads.
+    - id: storage
+      name: '@deepseek-ai/dsh-storage'
+
+    - id: storage-json
+      name: '@deepseek-ai/dsh-storage-json'
+      config:
+        root: !!js dshHomePath('storages')
+
+    - id: storage-domain
+      name: '@deepseek-ai/dsh-storage-domain'
+      config:
+        backend: json
+
+    - id: workspace
+      name: '@deepseek-ai/dsh-workspace'
+
+    # Generic terminal workspace registry. Optional plugins add providers;
+    # the TUI itself always supplies LOCAL and has no provider-specific code.
+    - id: dsh-tui-workspaces
+      name: '@deepseek-harness-tui/dsh-tui/workspaces'
+
+    # Optional plugins contribute nested slash-command completion here;
+    # execution and durable command events remain owned by dsh-commands.
+    - id: dsh-tui-command-trees
+      name: '@deepseek-harness-tui/dsh-tui/command-trees'
+
     # The agent-preset roster (issue #8): `ctx.agentPresets`, the service the
     # TUI composes every session's model-facing world from. No `roots` here —
     # the dsh CLI's profile-boot overlays its shipped `config/agent-presets/`
@@ -180,10 +209,15 @@
 
     # 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.cmd --resume`
-    # feeds the session id through DSH_CC_RESUME_SESSION.
+    # (exiting the process) when the TUI unmounts. `dsh-tui --resume`
+    # feeds the session id through DSH_TUI_RESUME_SESSION (the pre-rename
+    # DSH_CC_RESUME_SESSION is still honored as a fallback for old
+    # launchers — TODO: drop once they age out, issue #120).
     - id: dsh-tui
       name: '@deepseek-harness-tui/dsh-tui'
+      # The entry-level dependency augments the plugin's `agents` inject and
+      # prevents startup Session creation from racing WorkspaceRegistry init.
+      inject: [workspaceRegistry, agents, tuiWorkspaces]
       config:
         provider: deepseek-official
         # Alt-screen fullscreen（CC 同款）：应用内鼠标选区（选择即复制, OSC 52 +
@@ -193,14 +227,34 @@
         fullscreen: false
         # 每个请求实际生效的推理强度，按当前路由的 adapter 档位校验
         # （deepseek: off/high/max）——不在档位表里的值被忽略，回落 adapter
-        # 默认值。优先于持久化的 Shift+Tab 选择（~/.dsh-cc/effort.json）；
+        # 默认值。优先于持久化的 Shift+Tab 选择（~/.dsh-tui/effort.json）；
         # 同时作为顶栏/状态栏的启动显示，首个请求头回来后以实际值为准。
         effort: max
-        # Static preset choice (CC_TUI_PRESET overrides): wins over the
-        # persisted `/preset` preference (~/.dsh-cc/agent-preset.json), which
+        # Shift+Tab session-mode cycle (array order IS the cycle order;
+        # absent → the built-in default/plan/full trio below). Each entry
+        # may declare any subset of the plan (on/off), sandbox (read-only/
+        # workspace-write/danger-full-access), and approval (ask/never)
+        # atoms; undeclared atoms are untouched. Entry index 0 is the
+        # unmarked base mode.
+        # modes:
+        #   - id: default
+        #     plan: false
+        #     sandbox: workspace-write
+        #     approval: ask
+        #   - id: plan
+        #     plan: true
+        #     sandbox: read-only
+        #     approval: ask
+        #   - id: full
+        #     plan: false
+        #     sandbox: danger-full-access
+        #     approval: never
+        # Static preset choice (DSH_TUI_PRESET overrides): wins over the
+        # persisted `/preset` preference (~/.dsh-tui/agent-preset.json), which
         # wins over the roster default (standard).
-        preset: !!js process.env.CC_TUI_PRESET ?? undefined
-        sessionId: !!js process.env.DSH_CC_RESUME_SESSION ?? undefined
+        preset: !!js process.env.DSH_TUI_PRESET ?? undefined
+        workspace: !!js process.env.DSH_TUI_WORKSPACE_TARGET ?? undefined
+        sessionId: !!js process.env.DSH_TUI_RESUME_SESSION ?? process.env.DSH_CC_RESUME_SESSION ?? undefined
 
     # Live working-line data source (thinking copy / running tool / turn
     # summary). Mounted through @deepseek-harness-tui/dsh-tui's own
@@ -210,13 +264,11 @@
     # dependency into the profile root (npm's flat layout hid this), so the
     # bare name died with ERR_MODULE_NOT_FOUND and disposed the whole app at
     # boot (#60).
-    # publishIntervalMs 500 keeps the status-line timers ticking smoothly
-    # (default 2000ms). publish is enabled here (upstream default off since
-    # 0.2.2) because this profile's resume path repairs third-party event
-    # types via src/compat/sessionLog.ts — the TUI is the protected consumer;
-    # the bare plugin stays default-off for unprotected web/headless users.
+    # The plugin stays mounted for its narration/system-prompt features. The
+    # TUI derives its working line in-process from the base session stream;
+    # never persist activity/status, so the shared log remains Web-readable.
     - id: working-activity
       name: '@deepseek-harness-tui/dsh-tui/working-activity'
       config:
-        publish: true
+        publish: false
         publishIntervalMs: 500

package/cordis.yml

@@ -9,8 +9,29 @@
 - id: user-questions
   name: '@deepseek-ai/dsh-user-questions'
 
+# The approval service (issue #49): the harness's sandbox escalation seam
+# (`sandbox_permissions: danger-full-access`) asks ApprovalService.request(),
+# which dispatches an `approval/request` waterfall; dsh-tui registers itself
+# as the interactive answerer (ApprovalStore + approval panel). Without this
+# row the waterfall has no service and fail-closes to 'unavailable'. Policy
+# expression mirrors the profile cordis.patch.yml row exactly (verified by
+# scripts/verify-cordis-approval.mjs): ask everywhere except
+# danger-full-access (nothing needs asking) and Windows (no sandbox — the
+# user's terminal trust model, matching every other terminal coding agent).
+- id: approval
+  name: '@deepseek-ai/dsh-user-approval'
+  config:
+    policy: !!js "process.platform === 'win32' ? 'never' : ((process.env.DSH_PERMISSION_MODE ?? 'workspace-write') === 'danger-full-access' ? 'never' : 'ask')"
+
+- id: dsh-tui-workspaces
+  name: '@deepseek-harness-tui/dsh-tui/workspaces'
+
+- id: dsh-tui-command-trees
+  name: '@deepseek-harness-tui/dsh-tui/command-trees'
+
 - id: dsh-tui
   name: '@deepseek-harness-tui/dsh-tui'
+  inject: [agents, tuiWorkspaces]
   config:
     provider: deepseek-official
     # Alt-screen fullscreen (CC 同款): 应用内鼠标选区（选择即复制, OSC 52 +
@@ -20,11 +41,30 @@
     # Reasoning effort applied to every request, validated against the live
     # route's adapter levels (deepseek: off/high/max) — an unlisted level is
     # ignored and the adapter default applies. Wins over the persisted
-    # Shift+Tab choice (~/.dsh-cc/effort.json); also seeds the startup
+    # Shift+Tab choice (~/.dsh-tui/effort.json); also seeds the startup
     # header/statusline until the first request header reports the live value.
     effort: max
-    #  feeds the chosen session id through this env var.
-    sessionId: !!js process.env.DSH_CC_RESUME_SESSION ?? undefined
+    # Shift+Tab 会话模式循环（数组顺序即循环顺序；缺省为下面三档）。
+    # 每档可声明 plan（计划模式开/关）、sandbox（read-only/
+    # workspace-write/danger-full-access）、approval（ask/never）三个
+    # 原子的任意子集；未声明的原子不动。首档（index 0）为无标记基态。
+    # modes:
+    #   - id: default
+    #     plan: false
+    #     sandbox: workspace-write
+    #     approval: ask
+    #   - id: plan
+    #     plan: true
+    #     sandbox: read-only
+    #     approval: ask
+    #   - id: full
+    #     plan: false
+    #     sandbox: danger-full-access
+    #     approval: never
+    #  feeds the chosen session id through this env var (DSH_TUI_ name; the
+    #  pre-rename DSH_CC_ spelling is still honored, issue #120).
+    sessionId: !!js process.env.DSH_TUI_RESUME_SESSION ?? process.env.DSH_CC_RESUME_SESSION ?? undefined
+    workspace: !!js process.env.DSH_TUI_WORKSPACE_TARGET ?? undefined
 
 # The DeepSeek adapter. Shipped default: full thinking at max effort.
 # rc.6 schema key is `apiKeyEnv` (a credential-ref env var NAME, default
@@ -106,7 +146,7 @@
 - id: agent-spine
   name: '@deepseek-ai/dsh-agent-spine-demo'
   config:
-    persona: !!js process.env.CC_TUI_PERSONA ?? 'You are a coding agent.'
+    persona: !!js process.env.DSH_TUI_PERSONA ?? 'You are a coding agent.'
     # Workspace context (AGENTS.md injection) at the standard 64KB cap;
     # task tools stay at their DSH defaults (on).
     workspaceContext:
@@ -141,18 +181,16 @@
 - id: command-goal
   name: '@deepseek-ai/dsh-command-goal'
 
-# Live working line for the status bar: thinking copy / running tool / turn
-# summary. dsh-tui consumes its log-only activity/status events; the
-# plugin's own TUI prompt slot is skipped without an official dsh-tui.
+# Live working line narration support. dsh-tui computes the visible status
+# in-process from base session events; activity/status is never persisted.
 # Mounted through @deepseek-harness-tui/dsh-tui's `./working-activity`
 # re-export (not the bare `dsh-working-activity` name) so the row resolves
 # from install layouts that never link transitive dependencies into the
 # boot anchor's node_modules — pnpm's isolated profile layout, issue #60.
-# publishIntervalMs 500: live-phase snapshots republish every 500ms so the
-# dsh-tui status-line elapsed timers tick smoothly (default 2000ms).
 - id: working-activity
   name: '@deepseek-harness-tui/dsh-tui/working-activity'
   config:
+    publish: false
     publishIntervalMs: 500
 
 # Durable session log (DSH's own persistence seam): /resume and rewind both
@@ -161,7 +199,7 @@
 - id: sessions
   name: '@deepseek-ai/dsh-session-persistence-jsonl'
   config:
-    root: !!js process.env.DSH_CC_SESSION_ROOT ?? (process.env.USERPROFILE ?? process.env.HOME) + '/.dsh-cc/sessions'
+    root: !!js process.env.DSH_TUI_SESSION_ROOT ?? (process.env.USERPROFILE ?? process.env.HOME) + '/.dsh-tui/sessions'
 
 # Read-only session lineage — the subagent service's /agents listing reads it.
 - id: session-query
@@ -181,5 +219,5 @@
     # would never make manual /compact useful. Default 20% (200k tokens)
     # with a 5% retained tail; both are overridable for tests and must keep
     # retainRatio < thresholdRatio (BasicCompactConfig validates this).
-    thresholdRatio: !!js parseFloat(process.env.CC_TUI_COMPACT_RATIO ?? '0.2')
-    retainRatio: !!js parseFloat(process.env.CC_TUI_COMPACT_RETAIN ?? '0.05')
+    thresholdRatio: !!js parseFloat(process.env.DSH_TUI_COMPACT_RATIO ?? '0.2')
+    retainRatio: !!js parseFloat(process.env.DSH_TUI_COMPACT_RETAIN ?? '0.05')

package/lib/types/activityPrefs.d.ts

@@ -2,7 +2,7 @@
  * Persisted working-activity indicator preference, mirroring the pi
  * working-activity extension's `~/.pi/agent/working-activity.json`
  * (`frames` key). dsh-tui keeps its own copy at
- * `~/.dsh-cc/working-activity.json` so the `/activity` choice survives
+ * `~/.dsh-tui/working-activity.json` so the `/activity` choice survives
  * restarts. The file is best-effort: a missing or corrupt file (or an
  * unknown preset left behind by an older version) just falls back to the
  * default preset.