@deepseek-harness-tui/dsh-tui 0.11.2 → 0.13.0

package/assets/whaleGirl/img/timings.json

@@ -0,0 +1 @@
+{"idle":[{"dur":700,"file":"00.png"},{"dur":280,"file":"01.png"},{"dur":280,"file":"02.png"},{"dur":240,"file":"03.png"},{"dur":360,"file":"04.png"},{"dur":60,"file":"05.png"},{"dur":90,"file":"06.png"},{"dur":60,"file":"07.png"},{"dur":650,"file":"08.png"},{"dur":280,"file":"09.png"},{"dur":280,"file":"10.png"},{"dur":240,"file":"11.png"},{"dur":420,"file":"12.png"},{"dur":60,"file":"13.png"},{"dur":80,"file":"14.png"},{"dur":60,"file":"15.png"},{"dur":140,"file":"16.png"},{"dur":60,"file":"17.png"},{"dur":80,"file":"18.png"},{"dur":60,"file":"19.png"},{"dur":800,"file":"20.png"}],"idle-look":[{"dur":500,"file":"00.png"},{"dur":420,"file":"01.png"},{"dur":70,"file":"02.png"},{"dur":80,"file":"03.png"},{"dur":70,"file":"04.png"},{"dur":380,"file":"05.png"},{"dur":420,"file":"06.png"},{"dur":110,"file":"07.png"},{"dur":420,"file":"08.png"},{"dur":140,"file":"09.png"},{"dur":140,"file":"10.png"},{"dur":140,"file":"11.png"},{"dur":400,"file":"12.png"}],"idle-spout":[{"dur":450,"file":"00.png"},{"dur":260,"file":"01.png"},{"dur":110,"file":"02.png"},{"dur":110,"file":"03.png"},{"dur":130,"file":"04.png"},{"dur":150,"file":"05.png"},{"dur":170,"file":"06.png"},{"dur":170,"file":"07.png"},{"dur":170,"file":"08.png"},{"dur":350,"file":"09.png"},{"dur":400,"file":"10.png"}],"thinking":[{"dur":220,"file":"00.png"},{"dur":220,"file":"01.png"},{"dur":260,"file":"02.png"},{"dur":260,"file":"03.png"},{"dur":260,"file":"04.png"},{"dur":300,"file":"05.png"},{"dur":170,"file":"06.png"},{"dur":170,"file":"07.png"},{"dur":170,"file":"08.png"},{"dur":170,"file":"09.png"},{"dur":170,"file":"10.png"},{"dur":170,"file":"11.png"},{"dur":90,"file":"12.png"},{"dur":110,"file":"13.png"},{"dur":200,"file":"14.png"},{"dur":200,"file":"15.png"},{"dur":260,"file":"16.png"}],"typing":[{"dur":150,"file":"00.png"},{"dur":170,"file":"01.png"},{"dur":150,"file":"02.png"},{"dur":170,"file":"03.png"},{"dur":150,"file":"04.png"},{"dur":170,"file":"05.png"},{"dur":210,"file":"06.png"},{"dur":150,"file":"07.png"},{"dur":170,"file":"08.png"},{"dur":150,"file":"09.png"},{"dur":170,"file":"10.png"},{"dur":150,"file":"11.png"},{"dur":170,"file":"12.png"},{"dur":210,"file":"13.png"}],"music":[{"dur":150,"file":"00.png"},{"dur":150,"file":"01.png"},{"dur":150,"file":"02.png"},{"dur":150,"file":"03.png"},{"dur":150,"file":"04.png"},{"dur":150,"file":"05.png"},{"dur":150,"file":"06.png"},{"dur":150,"file":"07.png"}],"conducting":[{"dur":150,"file":"00.png"},{"dur":150,"file":"01.png"},{"dur":150,"file":"02.png"},{"dur":150,"file":"03.png"},{"dur":150,"file":"04.png"},{"dur":150,"file":"05.png"},{"dur":150,"file":"06.png"},{"dur":150,"file":"07.png"},{"dur":150,"file":"08.png"},{"dur":150,"file":"09.png"},{"dur":150,"file":"10.png"},{"dur":150,"file":"11.png"}],"building":[{"dur":130,"file":"00.png"},{"dur":100,"file":"01.png"},{"dur":80,"file":"02.png"},{"dur":90,"file":"03.png"},{"dur":100,"file":"04.png"},{"dur":120,"file":"05.png"},{"dur":90,"file":"06.png"},{"dur":130,"file":"07.png"},{"dur":130,"file":"08.png"},{"dur":100,"file":"09.png"},{"dur":80,"file":"10.png"},{"dur":90,"file":"11.png"},{"dur":100,"file":"12.png"},{"dur":120,"file":"13.png"},{"dur":90,"file":"14.png"},{"dur":130,"file":"15.png"},{"dur":130,"file":"16.png"},{"dur":100,"file":"17.png"},{"dur":80,"file":"18.png"},{"dur":90,"file":"19.png"},{"dur":100,"file":"20.png"},{"dur":120,"file":"21.png"},{"dur":90,"file":"22.png"},{"dur":130,"file":"23.png"}],"error":[{"dur":90,"file":"00.png"},{"dur":80,"file":"01.png"},{"dur":80,"file":"02.png"},{"dur":80,"file":"03.png"},{"dur":90,"file":"04.png"},{"dur":200,"file":"05.png"},{"dur":200,"file":"06.png"},{"dur":160,"file":"07.png"},{"dur":200,"file":"08.png"},{"dur":300,"file":"09.png"}],"happy":[{"dur":200,"file":"00.png"},{"dur":90,"file":"01.png"},{"dur":90,"file":"02.png"},{"dur":100,"file":"03.png"},{"dur":100,"file":"04.png"},{"dur":100,"file":"05.png"},{"dur":100,"file":"06.png"},{"dur":110,"file":"07.png"},{"dur":110,"file":"08.png"},{"dur":120,"file":"09.png"},{"dur":400,"file":"10.png"}],"notification":[{"dur":110,"file":"00.png"},{"dur":110,"file":"01.png"},{"dur":110,"file":"02.png"},{"dur":110,"file":"03.png"},{"dur":110,"file":"04.png"},{"dur":110,"file":"05.png"},{"dur":110,"file":"06.png"},{"dur":110,"file":"07.png"}],"compacting":[{"dur":300,"file":"00.png"},{"dur":130,"file":"01.png"},{"dur":130,"file":"02.png"},{"dur":130,"file":"03.png"},{"dur":130,"file":"04.png"},{"dur":200,"file":"05.png"},{"dur":100,"file":"06.png"},{"dur":160,"file":"07.png"},{"dur":220,"file":"08.png"},{"dur":240,"file":"09.png"}],"carrying":[{"dur":140,"file":"00.png"},{"dur":140,"file":"01.png"},{"dur":140,"file":"02.png"},{"dur":140,"file":"03.png"},{"dur":140,"file":"04.png"},{"dur":140,"file":"05.png"},{"dur":140,"file":"06.png"},{"dur":140,"file":"07.png"}],"sleeping":[{"dur":330,"file":"00.png"},{"dur":330,"file":"01.png"},{"dur":330,"file":"02.png"},{"dur":330,"file":"03.png"},{"dur":330,"file":"04.png"},{"dur":330,"file":"05.png"}],"waking":[{"dur":420,"file":"00.png"},{"dur":110,"file":"01.png"},{"dur":120,"file":"02.png"},{"dur":100,"file":"03.png"},{"dur":100,"file":"04.png"},{"dur":110,"file":"05.png"},{"dur":200,"file":"06.png"},{"dur":70,"file":"07.png"},{"dur":80,"file":"08.png"},{"dur":70,"file":"09.png"},{"dur":500,"file":"10.png"}],"poke-left":[{"dur":300,"file":"00.png"},{"dur":110,"file":"01.png"},{"dur":90,"file":"02.png"},{"dur":90,"file":"03.png"},{"dur":200,"file":"04.png"},{"dur":140,"file":"05.png"},{"dur":140,"file":"06.png"},{"dur":240,"file":"07.png"},{"dur":200,"file":"08.png"},{"dur":200,"file":"09.png"},{"dur":400,"file":"10.png"}],"poke-right":[{"dur":300,"file":"00.png"},{"dur":110,"file":"01.png"},{"dur":90,"file":"02.png"},{"dur":90,"file":"03.png"},{"dur":200,"file":"04.png"},{"dur":140,"file":"05.png"},{"dur":140,"file":"06.png"},{"dur":240,"file":"07.png"},{"dur":200,"file":"08.png"},{"dur":200,"file":"09.png"},{"dur":400,"file":"10.png"}],"tickle":[{"dur":90,"file":"00.png"},{"dur":90,"file":"01.png"},{"dur":90,"file":"02.png"},{"dur":90,"file":"03.png"},{"dur":90,"file":"04.png"},{"dur":90,"file":"05.png"},{"dur":90,"file":"06.png"},{"dur":90,"file":"07.png"},{"dur":90,"file":"08.png"},{"dur":90,"file":"09.png"},{"dur":90,"file":"10.png"},{"dur":90,"file":"11.png"},{"dur":200,"file":"12.png"},{"dur":400,"file":"13.png"}],"drag":[{"dur":90,"file":"00.png"},{"dur":90,"file":"01.png"},{"dur":90,"file":"02.png"},{"dur":90,"file":"03.png"},{"dur":90,"file":"04.png"},{"dur":90,"file":"05.png"},{"dur":90,"file":"06.png"},{"dur":90,"file":"07.png"},{"dur":90,"file":"08.png"},{"dur":90,"file":"09.png"}],"swim":[{"dur":150,"file":"00.png"},{"dur":150,"file":"01.png"},{"dur":150,"file":"02.png"},{"dur":150,"file":"03.png"},{"dur":150,"file":"04.png"},{"dur":150,"file":"05.png"},{"dur":150,"file":"06.png"},{"dur":150,"file":"07.png"}],"smile-hearts":[{"dur":100,"file":"00.png"},{"dur":100,"file":"01.png"},{"dur":100,"file":"02.png"},{"dur":100,"file":"03.png"},{"dur":100,"file":"04.png"},{"dur":100,"file":"05.png"},{"dur":100,"file":"06.png"},{"dur":100,"file":"07.png"},{"dur":100,"file":"08.png"},{"dur":100,"file":"09.png"},{"dur":100,"file":"10.png"},{"dur":100,"file":"11.png"},{"dur":100,"file":"12.png"},{"dur":100,"file":"13.png"},{"dur":100,"file":"14.png"},{"dur":100,"file":"15.png"}],"thumbs-up":[{"dur":160,"file":"00.png"},{"dur":120,"file":"01.png"},{"dur":90,"file":"02.png"},{"dur":80,"file":"03.png"},{"dur":80,"file":"04.png"},{"dur":100,"file":"05.png"},{"dur":110,"file":"06.png"},{"dur":110,"file":"07.png"},{"dur":90,"file":"08.png"},{"dur":430,"file":"09.png"},{"dur":100,"file":"10.png"},{"dur":100,"file":"11.png"},{"dur":400,"file":"12.png"}]}

package/bin/dsh-tui.js

@@ -62,6 +62,16 @@ const ownPackage = readJson(join(ownDir, 'package.json'))
 const ownVersion = ownPackage?.name === '@deepseek-harness-tui/dsh-tui' ? ownPackage.version : undefined
 const PACKAGE = '@deepseek-harness-tui/dsh-tui'
 const PROFILE = 'dsh-tui'
+
+// 随包用户手册（guide/，见 scripts/build-guide.mjs）：交给 dsh 当内核
+// dsh-skill-filesystem 的随包技能根（rank 600 的 bundledSkillDir 默认取这个
+// 环境变量）。会话里模型常驻只多一行技能目录，用户真问到 dsh-tui 时才按需
+// 读手册。用户自己设过就不覆盖；包里没有 guide/（旧安装/裁剪包）时保持原样。
+const withGuideSkillDir = env => {
+  if (env.DSH_BUNDLED_SKILL_DIR !== undefined) return env
+  const guideDir = join(ownDir, 'guide')
+  return existsSync(guideDir) ? { ...env, DSH_BUNDLED_SKILL_DIR: guideDir } : env
+}
 // 救援 profile（最小可用）：同 home 下的空白 profile（仅 base+TUI，无第三方
 // 插件），是主 profile 装炸时的干净启动通道——创建走官方 dsh plugin add
 // （钉当前版本，同 bootstrap 语义）。
@@ -625,9 +635,14 @@ const runDoctorChecks = () => {
     'DEEPSEEK_API_KEY',
     keyFromEnv ? L.keySetEnv : keyFromStore ? L.keySetStore : 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}`}`)
-  }
+  // `~/.dsh-tui/cordis.yml` 是裸组合（`dsh --config cordis.yml`）时代的用户根
+  // 配置：profile 安装不使用它，全包也没有任何代码读它——缺席是常态，不是故障。
+  // 恒报 ✗ 会把旁边唯一有意义的 profile 补丁一起变成噪音（用户会去创建这个对
+  // 功能毫无影响的文件）。只在用户确实留了它时列出。
+  const legacyConfig = join(homedir(), '.dsh-tui', 'cordis.yml')
+  if (existsSync(legacyConfig)) report(true, 'config', legacyConfig)
+  const profileConfig = join(profileDir, 'cordis.patch.yml')
+  report(existsSync(profileConfig), 'config', `${profileConfig}${existsSync(profileConfig) ? '' : `  ${L.missing}`}`)
   return { hardFailure, lines }
 }
 // ─── safe 会话支撑（清单解析与报告渲染，交互/非交互共用）──────────────────────
@@ -728,7 +743,7 @@ const startDshSession = (dshArgs, profile = PROFILE, env = process.env) =>
   new Promise(resolve => {
     const child = spawn(...cmd('dsh', ['--profile', profile, ...dshArgs]), {
       stdio: 'inherit',
-      env,
+      env: withGuideSkillDir(env),
       ...shellOpt,
     })
     child.on('error', err => resolve({ kind: 'error', error: err }))
@@ -751,6 +766,23 @@ const rescueEnv = () => {
   return env
 }
 
+// 安全模式「重试正常启动」的环境（菜单选项 1，首启 fallback 与 `safe` 共用）：
+// 崩溃往往发生在 TUI 的退出漏斗之前，此时 `~/.dsh-tui/resume.txt` 是"用户上
+// 一刻在哪个会话"的唯一线索（TUI 侧崩溃分支也会写它，见
+// src/dsh-adapter/plugin.ts 的退出漏斗）。不带这个变量重试等于开一个新的空会话
+// ——正是「会话丢了」的观感。已经显式设了该变量（用户自己 `--resume`）则不覆盖；
+// 指针缺失/不可读时保持冷启动语义。
+const resumeEnvForRetry = () => {
+  if (process.env.DSH_TUI_RESUME_SESSION !== undefined) return process.env
+  let target = ''
+  try {
+    target = readFileSync(join(homedir(), '.dsh-tui', 'resume.txt'), 'utf8').trim()
+  } catch {
+    // 没有历史会话可恢复——静默冷启动。
+  }
+  return target === '' ? process.env : { ...process.env, DSH_TUI_RESUME_SESSION: target }
+}
+
 // TTY 判定：询问与菜单都要求 stdin/stdout 均可交互（readline 需要 stdin，
 // 菜单可读需要 stdout）；任一非 TTY（脚本/管道/headless 宿主）走降级。
 const isInteractive = () => Boolean(process.stdin.isTTY && process.stdout.isTTY)
@@ -1071,7 +1103,7 @@ const settleFirstResult = async (result, firstArgs) => {
   if (result.kind === 'error') {
     console.error(msg('launchFailed')(result.error))
     if (isInteractive()) {
-      if (await askSafeEntry(1)) process.exit(await runSafeSession({ pendingExitCode: 1, retryDsh: () => startDshSession(firstArgs) }))
+      if (await askSafeEntry(1)) process.exit(await runSafeSession({ pendingExitCode: 1, retryDsh: () => startDshSession(firstArgs, PROFILE, resumeEnvForRetry()) }))
     } else {
       console.error(msg('safeHint')(1))
     }
@@ -1082,7 +1114,7 @@ const settleFirstResult = async (result, firstArgs) => {
     console.error(msg('profileExited')(result.code))
     if (isInteractive()) {
       if (await askSafeEntry(result.code)) {
-        process.exit(await runSafeSession({ pendingExitCode: result.code, retryDsh: () => startDshSession(firstArgs) }))
+        process.exit(await runSafeSession({ pendingExitCode: result.code, retryDsh: () => startDshSession(firstArgs, PROFILE, resumeEnvForRetry()) }))
       }
     } else {
       console.error(msg('safeHint')(result.code))

package/cordis.patch.yml

@@ -333,6 +333,12 @@
     - id: dsh-tui-scenes
       name: '@deepseek-harness-tui/dsh-tui/scenes'
 
+    # Optional plugins register side-panel surfaces (sidebar Panel +
+    # compact row, experimental §18) here; admission, budgets and crash
+    # isolation remain owned by the tuiPanels runtime + PanelStore.
+    - id: dsh-tui-panels
+      name: '@deepseek-harness-tui/dsh-tui/panels'
+
     # Plugin-interop anchor (Community Consensus v0.15): the unified grant
     # store, runtime generation id, and Host Descriptor live here; later
     # contract surfaces (plugin storage, message observation, effect
@@ -409,11 +415,30 @@
       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
+    # DeepSeek account sign-in uses the Host-owned /oauth/callback route. A
+    # TUI-only profile needs a loopback listener; a mixed Web+TUI profile
+    # reuses Web's official webserver instead of opening a second one. Hosts
+    # without an enabled account service row leave this listener disabled.
+    - id: dsh-tui-webserver
+      name: '@deepseek-ai/dsh-host-webserver'
+      disabled: !!js >-
+        (() => {
+          const require = process.getBuiltinModule('node:module').createRequire(ctx.baseUrl)
+          try { require.resolve('@deepseek-ai/dsh-host-webserver/package.json') } catch { return true }
+          const entries = [...ctx.loader.entries()]
+          return !entries.some(entry => entry.options.name === '@deepseek-ai/dsh-deepseek-account-platform' && !entry.disabled)
+            || entries.some(entry => entry.options.id === 'webserver' && entry.options.name === '@deepseek-ai/dsh-host-webserver' && !entry.disabled)
+        })()
+      config:
+        host: 127.0.0.1
+        port: 0
+
+    # Built-in subscription OAuth sign-in: mounts available pi-ai routes
+    # (ChatGPT/Codex, Claude, Grok; newer pi-ai adds OpenAI direct and Meta)
+    # plus the /auth command. Its facade also delegates DeepSeek sign-in to
+    # the Host-owned account service when available. The TUI's /provider
+    # wizard gains its OAuth branch from ctx.dshAuth. Entry-level inject only —
+    # the internal 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'
@@ -428,7 +453,7 @@
       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, tuiScenes, tuiDialogs, tuiStatus, tuiShortcuts, tuiRenderers, tuiThemes]
+      inject: [workspaceRegistry, agents, tuiWorkspaces, tuiScenes, tuiPanels, tuiDialogs, tuiStatus, tuiShortcuts, tuiRenderers, tuiThemes]
       # `tuiWorkspaces`/`tuiScenes` (and the dsh-tui-extensions services,
       # including `tuiThemes`)
       # live in the entry-level inject ONLY as an ordering (and reload-rebind)

package/guide/dsh-tui-guide/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: dsh-tui-guide
+description: Use when the user asks about dsh-tui itself (usage, shortcuts, config, themes, migration, VS Code). Load before answering; skip for normal coding tasks.
+---
+
+# dsh-tui 用户手册（索引）
+
+用户手册全文就在**本文件所在目录**——`skill` 工具返回的 `resourceBase`。共 8 篇，
+每篇中英各一份：中文文件名无后缀，英文加 `.en.md`。拿不到绝对路径时，用
+`glob` 在 dsh-tui 包里搜 `guide/dsh-tui-guide`。
+
+## 怎么用
+
+1. **跟用户同语言**：中文提问读无后缀文件，英文提问读加后缀的那份；回答也用同一种语言。
+2. **先定位再读**：16 个文件合计约 290 KB，整篇读既慢又挤上下文。先 `grep` 关键词拿到命中行，
+   再用 `read` 带 `offset`/`limit` 只展开需要的那几段。
+3. **一次一到两篇**：按下面的路由表挑最贴近的；跨主题时再补第二篇。
+4. **给出处**：回答末尾写清来源（文件名 + 小节标题），用户能直接翻回去核对。
+5. **别编**：手册没写的直说"手册没写"，再给保守建议；不要拿记忆里的旧行为顶替。
+
+## 路由表
+
+| 用户问的 | 文件 |
+| --- | --- |
+| 安装、首次启动、启动失败、排障 | `getting-started.md` |
+| 日常使用、键位、斜杠命令、会话与工作流、设置 | `user-guide.md` |
+| 输入框、鼠标、选中复制、粘贴、图片、问卷与审批 | `interaction.md` |
+| 配置覆盖层、TUI 开关、agent preset、模型路由、MCP | `configuration.md` |
+| 主题、配色、自动检测、自定义主题 | `themes.md` |
+| 从 Claude Code / Codex / OMP / zcode / Grok 迁移会话 | `migrate.md` |
+| VS Code 集成、扩展、IDE 选区 | `vscode.md` |
+| 插件生态、接缝稳定性分级 | `plugins.md` |
+
+英文提问时把上表文件名接上后缀（例如 `user-guide.en.md`）。
+
+> 除本文件外，这些副本由 `scripts/build-guide.mjs` 从仓库 `docs/` 逐字节同步生成，
+> 不要手改；改文档请改 `docs/` 再跑一次构建。