@deepseek-harness-tui/dsh-tui 0.12.0 → 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

@@ -635,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 会话支撑（清单解析与报告渲染，交互/非交互共用）──────────────────────

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
@@ -447,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/configuration.en.md

@@ -67,6 +67,11 @@ A complete common override looks like this:
 | `splashFont` | `daily` | Big-text face on the header splash: `daily` rotates by local date (the default), any other value is a face id (`bold` / `square` / `bevel` / `wide` / `dot` / `stencil` / `classic` / `slab`) pinning that one; an unknown value falls back to `daily`. Also editable through `/settings` |
 | `whaleGirl` | `false` | Swap the header's pixel whale for the maid: real raster FIRST (Kitty/Sixel); falls back to the character-art maid without them |
 | `minimal` | `false` | Minimal UI (极简界面): reduce header decoration and colors. **A display switch only** — a different thing from the kernel's `minimal` agent preset under `preset` below (that one decides which tools the model can use) |
+| `sidePanel.splitEnabled` | `true` (boolean) | Master switch of the split layout: on, `Ctrl+B` and `/panel` open the side column next to the chat; off, neither splits and `/jobs` & co. keep their full-screen panels. Applies immediately |
+| `sidePanel.open` | `false` (boolean) | Whether a session opens with the sidebar already expanded; off by default, so the upgrade leaves the layout as it was. An in-session `Ctrl+B` / `/panel toggle` is not written back here. Applies immediately |
+| `sidePanel.ratio` | `0.68` (number, 0.1–0.95) | Chat column as a fraction of the content width; while the panel has focus, `+`/`-` nudge it live for the current session (not written back). Applies immediately |
+| `sidePanel.panels` | `todo,jobs,agents` (comma-separated text) | Enabled panel ids and their order (built-ins: `todo` `info` `trajectory` `jobs` `agents` `workspace` `companion`); a well-formed id no panel claims yet stays in the tab bar for a plugin to register later, a malformed entry is refused. The `⤢` on the right edge of the bar blows the active panel up to full screen (drawn only for panels that declare a fullscreen form). Applies immediately |
+ | `companion.skin` | `deepy` | Skin of the companion-panel pet: `deepy` (default, the deepy whale kit), `whaleGirl` (the whale-girl sticker pack, 22 animations incl. interaction reactions) or `whale` (the splash's layered pixel whale); the panel itself is enabled by adding `companion` to `sidePanel.panels`. Applies immediately |
 | `modes` | built-in trio | Shift+Tab session-mode cycle (plan/sandbox/approval atom bundles); defaults to default → plan → full-access |
 | `activity` | `true` | Show the live activity row |
 | `activityFrames` | `moon8` | Activity animation preset; `/activity` changes it at runtime. A legacy saved value of `claude` is read as `moon8`, and the picker no longer offers that legacy preset |
@@ -142,7 +147,7 @@ preset registry: `@deepseek-ai/dsh-agent-preset-registry` on 0.1.7, or
 | --- | --- | --- |
 | `standard` | Standard (default) | Editing, shell, search, skills, planning, goals, subagents, and workflows |
 | `ptc` (0.1.2) / `code` (legacy 0.1.1) | PTC | Standard plus the PTC SDK presentation for composing operations in TypeScript; both names resolve compatibly across versions |
-| `minimal` | Minimal | Kernel agent preset: a single persistent-shell tool (bash on POSIX, pwsh on Windows), with no compaction, no plan mode and no runtime context. `str_replace_editor` has been opt-in since 0.1.3-alpha.2, so this preset does not include it |
+| `minimal` | Minimal | Kernel agent preset: a single persistent-shell tool (bash on POSIX, pwsh on Windows), with no compaction, no plan mode and no runtime context. `str_replace_editor` has been opt-in since 0.1.3-alpha.2, so this preset does not include it. The cost is stated up front: no compaction and no tool-result pruning (a long session can hit the context limit, oversized tool output stays in full), and `/compact` plus the questionnaire are unavailable — Help and `/` completion mark the entry, and entering/resuming the preset says so once |
 | `cordis` | Creation | Standard plus runtime inspection and plugin-experimentation tools |
 | `liangshen` | Liangshen mode | Minimal's minimal tool surface first for root and delegated agents, the full catalog after the first tool call, and a fresh anchor after compaction |
 

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

@@ -64,6 +64,11 @@ Config；旧版仍使用 `~/.dsh/settings.yaml`。不要把旧文件路径当成
 | `splashFont` | `daily` | 开屏大字字体：`daily` 按本地日期轮换（默认），其余取字体 id（`bold` / `square` / `bevel` / `wide` / `dot` / `stencil` / `classic` / `slab`）pin 住那一款；非法值回落 `daily`。也可经 `/settings` 修改 |
 | `whaleGirl` | `false` | 把标题的像素鲸鱼换成女仆娘：**最优先**真图（Kitty/Sixel）；不支持时回落字符画版女仆娘 |
 | `minimal` | `false` | 极简界面（Minimal UI）：精简标题装饰与配色。**这是界面显示开关**，与下面 `preset` 里的内核「极简模式」预设完全是两件事（那个才决定模型能用哪些工具） |
+| `sidePanel.splitEnabled` | `true`（布尔） | 分栏总开关：开启时 `Ctrl+B` 与 `/panel` 在聊天右侧展开侧栏；关闭时两者都不再分栏，`/jobs` 等仍走整屏面板。立即生效 |
+| `sidePanel.open` | `false`（布尔） | 启动时侧栏是否已展开；默认关闭，升级后布局与原来一致。会话内的 `Ctrl+B` / `/panel toggle` 不写回这里。立即生效 |
+| `sidePanel.ratio` | `0.68`（数值，0.1–0.95） | 聊天列占内容宽度的比例；侧栏有焦点时 `+`/`-` 在当前会话内实时微调（不写回）。立即生效 |
+| `sidePanel.panels` | `todo,jobs,agents`（逗号分隔文本） | 启用的面板 id 与顺序（内置：`todo` `info` `trajectory` `jobs` `agents` `workspace` `companion`）；格式合法但暂无面板认领的 id 会留在标签栏等插件注册，格式非法的条目被拒绝。面板栏右端的 `⤢` 把当前面板放大成整屏（只对声明了整屏形态的面板出现）。立即生效 |
+ | `companion.skin` | `deepy` | 宠物面板的皮肤：`deepy`（默认，deepy 小鲸鱼素材包）、`whaleGirl`（鲸娘表情包，22 个动画含互动反应）或 `whale`（与开屏同款分层像素鲸鱼）；面板需在 `sidePanel.panels` 加入 `companion` 启用。立即生效 |
 | `modes` | 内置三档 | Shift+Tab 会话模式循环（plan/sandbox/approval 原子组合）；缺省为 默认 → 计划 → 完全访问 |
 | `activity` | `true` | 是否显示实时工作状态行 |
 | `activityFrames` | `moon8` | 工作状态动画预设；也可通过 `/activity` 修改。旧配置值 `claude` 读取时映射为 `moon8`，选择器不再显示该旧预设 |
@@ -127,7 +132,7 @@ Config；旧版仍使用 `~/.dsh/settings.yaml`。不要把旧文件路径当成
 | --- | --- | --- |
 | `standard` | 标准模式（默认） | 编辑、Shell、检索、Skills、计划、Goals、子代理与工作流 |
 | `ptc`（0.1.2）/ `code`（旧 0.1.1） | PTC 模式 | 标准能力，加 PTC SDK 呈现工具，可用 TypeScript 组合多步操作；两个名字可跨版本兼容解析 |
-| `minimal` | 极简模式 | 内核 Agent 预设：只暴露一个持久 shell 工具（POSIX 为 bash，Windows 为 pwsh），不带 compaction、计划模式与运行时上下文。`str_replace_editor` 自 0.1.3-alpha.2 起是 opt-in，该预设不含它 |
+| `minimal` | 极简模式 | 内核 Agent 预设：只暴露一个持久 shell 工具（POSIX 为 bash，Windows 为 pwsh），不带 compaction、计划模式与运行时上下文。`str_replace_editor` 自 0.1.3-alpha.2 起是 opt-in，该预设不含它。代价也如实说：没有压缩、也不剪枝工具结果（长会话可能撞上下文上限，超长工具输出整段留在上下文里），`/compact` 与问卷在该预设下不可用——Help 与 `/` 补全标注「不可用」，进入/恢复该预设时提示一次 |
 | `cordis` | 创造模式 | 标准能力，加运行时检查与插件实验工具 |
 | `liangshen` | 梁神模式 | 主 Agent 与子 Agent 首轮均保持极简模式的最小工具面，首次工具调用后开放完整目录，压缩后重新锚定 |
 

package/guide/dsh-tui-guide/getting-started.en.md

@@ -276,13 +276,16 @@ pnpm build
 pnpm smoke
 ```
 
-The repository has two submodules; `vendor/dsh-std` is required to install:
+The repository has a single submodule, and it is required to install:
 
 - `vendor/dsh-std`: its `packages/*` are listed as workspace packages in
   `pnpm-workspace.yaml`.
-- `dsh-ecosystem-spec`: the ecosystem specification used by contract checks.
 
-Without `--recurse-submodules` these directories stay empty and
+The TUI Profile (plugin admission and private protocol definitions) lives in
+`tui-profile/` as **plain files** (no longer a submodule); it is checked out and
+revised together with this repository and is what the contract checks read.
+
+Without `--recurse-submodules` that directory stays empty and
 `pnpm install --frozen-lockfile` fails outright. For a checkout that was
 already cloned:
 

package/guide/dsh-tui-guide/getting-started.md

@@ -268,11 +268,13 @@ pnpm build
 pnpm smoke
 ```
 
-本仓库有两个子模块，其中安装必需的是 `vendor/dsh-std`：
+本仓库只有一个子模块，且安装必需：
 
 - `vendor/dsh-std`：`pnpm-workspace.yaml` 把 `vendor/dsh-std/packages/*` 列为
   workspace 包。
-- `dsh-ecosystem-spec`：生态适配规范，供契约检查使用。
+
+TUI Profile（插件准入与私有协议定义）在 `tui-profile/`，是**普通文件**（不再是
+子模块），随本仓库代码一起检出与修订，供契约检查使用。
 
 漏掉 `--recurse-submodules` 会让这些目录为空，
 `pnpm install --frozen-lockfile` 直接失败。已经克隆过的检出补一条：

package/guide/dsh-tui-guide/interaction.en.md

@@ -17,6 +17,7 @@
 | `Ctrl+G` | Edit the current input in an external editor (`$VISUAL` → `$EDITOR`); saving and quitting fills it back, `:cq`/non-zero exit keeps the draft; with neither variable set the TUI asks you to configure one (no `vi` fallback) |
 | `Ctrl+Shift+E` | Expand the fullscreen draft editor (or click the `⛶` affordance at the end of the input row): line numbers + current-line highlight + live line/char stats<br>`Enter` inserts a newline, `Ctrl+Enter` or the Send button sends, `Esc` or the Collapse button keeps the draft and returns<br>wheel-scrolls freely; click/drag/double-click selection work as in the inline prompt; remappable via `/settings` |
 | `Esc` | Ladder: close help → close the image preview → close the command menu → close the file menu (only the current `@` token)<br>→ **with a selection in the prompt input: only clear it (text untouched)** → interrupt the turn and redeliver pending messages → clear non-empty input → double-tap on empty input = rewind<br>in fullscreen, an active mouse selection is cleared first (not copied) |
+| `Ctrl+Z` | Undo the prompt draft's last word-level edit (text, caret and images together). Draft-only: a submit, a history recall (`Ctrl+R`/`↑`) or a session switch ends the history; it is NOT the message/conversation rewind behind `Esc Esc`. Remappable via `/settings` |
 | `Esc` / `Ctrl+C` / `Enter` while an image preview is open | Close the preview and restore the surface underneath; other keys are not passed through |
 | `Left` / `Right` in the image modal | Previous / next image, no wrapping; caret peeks keep arrows with the prompt |
 | `←` (empty input) | Background this session and open the session-management screen (same as `/bg`) |
@@ -24,6 +25,8 @@
 | `Ctrl+D` | Same ladder as `Ctrl+C`: interrupt while working (press again to force-exit if the interrupt stalls); press twice while idle to exit |
 | `Ctrl+O` | Toggle transcript/verbose detail, including full reasoning and tool arguments/output; also the escape hatch for the **long-line fold** (a single line over 1000 chars is clipped to 1000 with a `… N chars folded` marker — see the user guide §5). Clicking the folded row (or the tool card face) toggles it too |
 | `Ctrl+P` | Toggle the loaded-context panel shown at startup (while it is on screen) |
+| `Ctrl+B` | Side panel, three states: closed → open and focus the right column; open with the chat focused → focus the right column; panel focused → close and return to the chat. Splits only under `fullscreen` at a content width of ≥93 columns; on narrow terminals and in inline mode the key does nothing (`/jobs` & co. keep their full-screen panels — see the user guide §2.8) |
+| `Alt+Z` | Zoom the active side panel (the chat column keeps its minimum width); press again to restore |
 | `Ctrl+T` | Open the trajectory scene (same as `/trace`); `q`/`Esc` returns to the conversation |
 | `Ctrl+R` | Open input-history search; repeat or press `Down` for the next result |
 | `Ctrl+L` | Clear and force a physical terminal redraw |
@@ -33,8 +36,8 @@
 | `Shift+Up` | Enter message selection; arrows move, `Enter` expands one row, `Esc` exits |
 
 **Remapping shortcuts**: paste, history search, external editor, `Ctrl+O/T/P/R/L`,
-subagent dashboard, show-all, and todo fold are remappable in `/settings` → `dsh-tui` →
-`Shortcuts`.
+side panel (`Ctrl+B`/`Alt+Z`), subagent dashboard, show-all, and todo fold are remappable in
+`/settings` → `dsh-tui` → `Shortcuts`.
 
 - Enter combos like `alt+v`; comma-separate several; leave blank to restore defaults. Saves apply live.
 - Combos that clash with the fixed editing keys or another action are rejected.
@@ -68,6 +71,66 @@ subagent dashboard, show-all, and todo fold are remappable in `/settings` → `d
 - Plugins provide the keyboard path for the same action through a slash command or `tuiShortcuts`.
 - A refused rich registration returns `undefined`; an admitted one returns a disposer that removes both the view and its Cordis effect.
 
+### Launchpad and first-run guide
+
+The startup **launchpad** and the **first-run wizard** each own the keyboard; both only hand
+results back to the chat screen and add no new behavior.
+
+- **Launchpad**: printable input goes into the input box (the prefix turns from `❯` to `⌘` when the line
+  starts with `/`), `Backspace`/`Delete`/`←`/`→`/`Home`/`End` edit it; the caret is an **inverse block
+  sitting on the current character** (inverse on that one character; an inverse blank cell at end of
+  line), blinking is a pure style toggle (inverse ↔ regular, ~550ms per phase) and never occupies an
+  extra cell or eats a character; `Alt+R` continues the most recent session (= the first entry row slot,
+  bound only on this screen, no-op when there is nothing to continue, remappable in `/settings`);
+  a leading `/` opens the
+  **command palette** (the same data source and component as the chat composer: `↑`/`↓` move the selection,
+  `Enter`/`Tab`/click **run** the selected command, `Esc` dismisses only the palette and keeps the draft);
+  with the palette dismissed, `Enter` **sends** the line straight away (a leading `/` line — including
+  plugin/registry commands — goes through the chat page's merged command table and never reaches the model);
+  `↑`/`↓`/`Tab` walk the focus ring (input box → the four param segments under the box → the quick
+  actions → the Tips line) and `Enter` activates the focused one (`Enter` on the Tips line rotates the
+  tip), while typing returns focus to the input box; `Esc` clears
+  a non-empty line and opens sessions when empty, and `Ctrl+C` on an empty line takes the exit funnel.
+- **Launchpad param row** (under the box: model · effort · mode · permission; model shows the bare model
+  name and mode shows the agent preset's display name — Standard/PTC/minimal…): each segment is
+  **clickable** and opens the very same picker the chat page uses (`/model` · `/effort` · `/preset` ·
+  `/permission`); the picker renders **above** the launchpad and owns the keyboard
+  (`Esc` closes it back onto the launchpad), the picked value updates the row in place and the typed draft
+  is untouched; clicking inside the picker selects, **clicking elsewhere closes it and clicking another
+  segment switches to that picker**.
+- **Entry row (v7, four slots)**: `Continue "…"` (Alt+R; the slot is absent when there is nothing to
+  continue) · `Sessions & workspaces` (`/home` — history and workspaces merged into one entry) ·
+  `Settings` (`/settings`) · a **conditional slot** (priority: background jobs running → `Background
+  jobs`; update detected → `Update available`; usage milestone reached and never starred → `Feed us a
+  star`; fallback `Help`). Full screens opened from the launchpad (sessions & workspaces / settings /
+  background jobs / the family tree / the wizard) render **above the launchpad** — `Esc` closes them
+  back onto the launchpad (draft, params and focus intact); **the only way off the launchpad into the
+  chat is submitting a non-command line with Enter**. Overlays on the launchpad side (pickers, the
+  command palette) are a **clean cutout** — every cell in the overlay rect is space-filled (host
+  glyphs never bleed through), yet no background color is emitted (no white block; Kitty splash
+  art still shows through the terminal-default cells; the chat page's pickers are unaffected).
+- **Tips line**: click to rotate (three tips cycle; the first-run tip has top priority and never rotates);
+  keyboard path = focus ring + `Enter`; as of v7 it also **auto-rotates** (~10s per tip; a manual
+  rotate resets the timer) — the switch changes only the text, never the row height or centering.
+- **Corner plates (v7)**: the bottom-left working directory is **clickable** — it opens the existing
+  `/workspace` menu (rendered above the launchpad; `Esc` returns to the launchpad), keyboard path =
+  the focus ring's last slot + `Enter`, hover/focus = text highlight; the bottom-right plate shows
+  **two versions stacked vertically**: `dsh-tui v<TUI>` on the first row, `dsh-core v<kernel>` on
+  the second (the kernel version is read from the host/kernel package manifests; only the TUI row
+  is drawn when neither resolves), both right-aligned with the cwd plate top-aligned to the first
+  row, truncated per the existing truncate-middle contract on narrow terminals.
+- **Wizard**: `←`/`→` change step (except the effort slider in step 3 and a drilled-in model list, where the
+  horizontal keys belong to the child control), `Tab` switches between the language/theme and
+  model/effort/workspace panes, `↑`/`↓` move the selection; `Enter` runs the step (step 1 = re-check
+  connectivity, step 3 = drill into a provider / switch model / open the workspace picker — **effort is not
+  on Enter**, it is `←`/`→` only and applies as you move); the theme pane previews on cursor move while the
+  **language pane applies on `Enter`**; `Enter` on the last step finishes and records the guide when the
+  focused card is a shortcut card, and tries the command when it is a command card; `Esc` skips
+  (**not recorded**, asked again next launch).
+- **Mouse** (fullscreen): the launchpad's quick actions (hover = the label turns accent-blue and bold,
+  leaving restores the dim look), param segments, command palette, Tips line, the wizard's "Try it" cards
+  and the workspace picker are clickable, and a click lands on the same command path as the keyboard.
+
 ## Editing keys
 
 | Key | Behavior |
@@ -591,7 +654,7 @@ The command menu merges local commands with the DSH command registry. Type `/` t
 **Status**
 
 - `/context`, `/status`, `/cost`, `/balance` — official DeepSeek balance: summary row + hover details, click to refresh.
-- `/config`, `/doctor`, `/init`, `/agents`, `/jobs` — background jobs panel: status/elapsed/exit code, `k` kills.
+- `/config`, `/doctor`, `/init`, `/agents`, `/jobs` — background jobs panel: status/elapsed/exit code, `k` kills; with the split layout on and the terminal wide enough it opens as a right-column panel instead (narrow terminals and inline mode keep the full-screen panel).
 - `/settings`.
 
 **Model and display**
@@ -600,6 +663,7 @@ The command menu merges local commands with the DSH command registry. Type `/` t
   session accent color: bare opens the palette picker, `<name>` sets directly, `status`/`reset`;
   input border + session-name chip at the top-right, per-session; chip off by default, enable
   in `/settings`.
+- `/panel` — side panel: toggle / focus / zoom / switch panels (subcommands in the user guide §2.8).
 - `/lang`.
 
 **Account and policy**
@@ -654,7 +718,7 @@ Additional forms:
 - Exiting plan mode restores the pre-plan atoms first, then the durable preset you were on before plan mode (while the registry still offers it).
 - When the registry service is absent, TUI uses its legacy three-row compatibility roster; a mounted but broken service is unavailable and fails closed.
 - `/lang` toggles the interface language (see "Interface language").
-- `/compact` compresses the session history; unavailable under the kernel Minimal agent preset (`minimal`, a single persistent-shell tool) — unrelated to the display-side Minimal UI switch.
+- `/compact` compresses the session history; unavailable under the kernel Minimal agent preset (`minimal`, a single persistent-shell tool), which mounts no compaction and does not prune tool results — a long session can hit the context limit and oversized tool output stays in full (Help and `/` completion mark the entry, and entering the preset says so once) — unrelated to the display-side Minimal UI switch.
 - `/thinking` toggles extended reasoning display; UI state only — **not persisted**.
 - After startup, the TUI checks npm for a newer version in the background and shows a notification when one is available.
 - The check follows the npm registry configuration (`NPM_CONFIG_REGISTRY` or `~/.npmrc`),

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

@@ -16,6 +16,7 @@
 | `Ctrl+V` / `Alt+V` | 从系统剪贴板插入文本或文件；图片作为持久附件发送。终端拦截 `Ctrl+V` 时用 `Alt+V` |
 | `Ctrl+G` | 用外部编辑器（`$VISUAL` → `$EDITOR`）编辑当前输入，保存退出后回填；`:cq` 或非零退出保留原稿；未设置变量时提示配置，无 `vi` 兜底 |
 | `Ctrl+Shift+E` | 展开全屏草稿编辑器（也可点输入行尾 `⛶`）：行号 + 当前行高亮 + 行/字统计，`Enter` 换行、`Ctrl+Enter` 或「发送」按钮发送、`Esc` 或「收起」按钮收起（草稿保留）；滚轮自由滚动、点击定位/拖选/双击选词与输入框一致；可经 `/settings` 重映射 |
+| `Ctrl+Z` | 撤销输入框草稿的上一步「词级」编辑（文本、光标、图片一起回退）。只作用于草稿：提交、历史召回（`Ctrl+R`/`↑`）或换会话后即结束；`Esc Esc` 的会话/消息回溯与它不是一回事。可经 `/settings` 重映射 |
 | `Esc` | 层级：关帮助 → 关图片预览 → 关命令菜单 → 关文件菜单（仅当前 `@` token）→ **输入框内有选区时仅清选区（文本不动）** → 中断回合并重投 pending 消息 → 有输入时清空 → 空输入连续两次 = 时间回溯 rewind；fullscreen 下有鼠标选区时优先取消选区（不复制） |
 | 图片预览打开时 `Esc` / `Ctrl+C` / `Enter` | 关闭预览，恢复下层界面；其余按键不透传 |
 | 图片弹窗中的 `←` / `→` | 上一张 / 下一张；首尾不循环，临时光标预览不抢输入框方向键 |
@@ -23,6 +24,8 @@
 | `Ctrl+D` | 与 `Ctrl+C` 同阶梯：工作中=中断（未收敛时再按=强制退出）；空闲时连续两次退出 |
 | `Ctrl+O` | 切换 transcript/verbose 详情，展开思考与完整工具参数/输出；也是**超长单行折叠**（单行 > 1000 字符裁到 1000 + `… 已折叠 N 字符` 标记，见 user guide §5）的展开逃生门——鼠标点被折叠的那一行（或工具卡卡面）同样能展开/收起 |
 | `Ctrl+P` | 切换启动时加载的 loaded-context 面板（面板在屏时有效） |
+| `Ctrl+B` | 侧栏三态：未开 → 打开并聚焦右栏；已开且焦点在聊天 → 聚焦右栏；焦点在右栏 → 关闭并回聊天。仅 fullscreen 且内容区 ≥93 列可分栏，窄屏与 inline 下此键不生效（`/jobs` 等仍走整屏面板，见用户指南 §2.8） |
+| `Alt+Z` | 缩放当前侧栏面板（聊天列保留最小宽度），再按恢复 |
 | `Ctrl+T` | 打开轨迹场景（等同 `/trace`）；场景内 `q`/`Esc` 返回对话 |
 | `Ctrl+R` | 打开输入历史搜索；重复按或 `Down` 移到下一项 |
 | `Ctrl+L` | 强制清理并重绘物理终端 |
@@ -33,7 +36,7 @@
 
 动作型快捷键支持在 `/settings` → `dsh-tui` → `Shortcuts` 自定义。
 
-- 覆盖：粘贴、历史搜索、外部编辑器、`Ctrl+O/T/P/R/L`、子代理面板、显示全部、待办折叠。
+- 覆盖：粘贴、历史搜索、外部编辑器、`Ctrl+O/T/P/R/L`、侧栏（`Ctrl+B`、`Alt+Z`）、子代理面板、显示全部、待办折叠。
 - 填 `alt+v` 这类组合，多个用逗号分隔；留空恢复默认，保存即生效。
 - 与固定编辑键或其它动作冲突的组合会被拒绝。
 - cordis.yml 可用 `shortcuts.<action>` 静态指定。
@@ -65,6 +68,48 @@
 - 富状态注册被拒绝时返回 `undefined`。
 - 注册成功时返回 disposer，会同时撤下视图和对应 Cordis effect。
 
+### 落地页与首次引导
+
+启动**落地页**与**首次引导向导**各自独占键盘；两者都只把结果交回对话页，不新增行为。
+
+- **落地页**：可打印字符接进输入框（行首 `/` 时前缀由 `❯` 变 `⌘`），`Backspace`/`Delete`/`←`/`→`/`Home`/`End` 编辑；
+- **落地页**：可打印字符接进输入框（行首 `/` 时前缀由 `❯` 变 `⌘`），`Backspace`/`Delete`/`←`/`→`/`Home`/`End` 编辑；
+  输入光标是**压在当前字符身上的反显块**（对那一个字符 inverse，行尾是反显空格），闪烁是纯样式切换
+  （inverse ↔ 常规，约 550ms 一相位），绝不另起一格、绝不吃掉字符；`Alt+R` 继续最近一条会话
+  （= 入口行第一格「继续「…」」，仅此屏生效，无可继续会话时无动作，键位可在 `/settings` 改）；
+  **执行**选中命令，`Esc` 只收面板、草稿不动）；面板没收时 `Enter` 直接**发送**这一行（行首 `/` 的命令——含
+  插件/registry 命令——按对话页同一条合并命令表判定，是命令就不发模型）；
+  `↑`/`↓`/`Tab` 沿焦点环走（输入框 → 框下参数行四段 → 快捷入口行 → Tips 行），`Enter` 激活焦点上的那一条
+  （焦点在 Tips 行上 `Enter` = 切下一条 Tip），在入口/参数段上敲字会把焦点收回输入框；有字时 `Esc` 只清空，
+  空输入 `Esc` 去看会话，空输入 `Ctrl+C` 走退出漏斗。
+- **落地页参数行**（框下一行：模型 · 思考深度 · 模式 · 权限；模型段只显示模型名，模式段显示 agent preset
+  的显示名——Standard/PTC/极简…）：四段**各自可点**，点开的就是对话页同一套选择器
+  （`/model` · `/effort` · `/preset` · `/permission`），选择器**盖在落地页之上**、吃走键盘
+  （`Esc` 关掉它回到落地页），选中的值就地更新参数行、已输入的草稿不动；选择器开着时点它内部是选择，
+  **点别处会关掉它、点另一段会直接切换**成那个选择器。
+- **入口行（第七版四格）**：`继续「…」`（Alt+R；无可继续会话时整格不画）· `会话与工作区`（`/home`，
+  历史会话与工作区合并成一个入口）· `设置`（`/settings`）· **条件位**（优先级：有后台任务在跑 →
+  `后台任务`；检测到新版本 → `有新版本`；用量到档且从未 star → `投喂一颗 Star`；兜底 `帮助`）。
+  从落地页打开的整屏界面（会话与工作区 / 设置 / 后台任务 / 家谱 / 引导向导）都**盖在落地页之上**，
+  `Esc` 退出回到落地页（草稿/参数/焦点原样保留）；**离开落地页进对话页的唯一方式是回车提交一条
+  非命令消息**。落地页这一侧的浮层（选择器/命令面板）是**干净的镂空**——矩形内空格占位
+  遮掉宿主屏的字形（绝不重影）、不发背景色（无白底；Kitty 立绘图像仍从终端默认背景透出；
+  聊天页同款选择器不受影响）。
+- **Tips 行**：可点击轮换（三条 Tips 循环；首启那一句优先级最高、不参与轮换），键盘路径 = 焦点环 + `Enter`；
+  第七版起还**自动轮换**（约 10s 一换，手动切换后计时重置），切换只改文本、行高与居中位置不变。
+- **双角铭牌（第七版）**：左下角工作目录**可点**——点开既有的 `/workspace` 菜单
+  （盖在落地页之上、`Esc` 回落地页），键盘路径 = 焦点环末格 + `Enter`，悬停/焦点 =
+  文字高亮；右下角是**双版本竖排两行**：第一行 `dsh-tui v<TUI>`、第二行
+  `dsh-core v<内核>`（内核版本读宿主/内核线包的 manifest，读不到只画 TUI 一行），
+  两行都右对齐、左下目录铭牌与第一行顶对齐，窄屏按既有 truncate-middle 截断。
+- **引导向导**：`←`/`→` 换步骤（例外：第三步的强度区、以及已钻进去的模型列表，横向键归子控件，不换步骤）、
+  `Tab` 在「语言 / 主题」与「模型 / 强度 / 工作区」两组面板间切、`↑`/`↓` 移动选择；
+  `Enter` 执行这一步（第一步 = 重新检查连通性，第三步 = 钻进 provider / 换模型 / 打开工作区选择器——**强度不走 Enter**，只用 `←`/`→` 调且移动即生效）；
+  主题面板移动光标即预览，**语言面板要 `Enter` 才生效**；最后一步的 `Enter` 在**键位卡**上「完成」并记账，
+  在命令卡上则是「试一下」；`Esc` 跳过（**不记账**，下次启动再问）。
+- **鼠标**（fullscreen）：落地页的快捷入口（悬停 = 文字变主题蓝加粗，移开复原）、参数行四段、命令补全面板、
+  Tips 行、引导招式卡的「试一下」与工作区选择器都可点，点击与键盘落到同一条命令路径。
+
 ## 输入编辑
 
 | 按键 | 行为 |
@@ -649,7 +694,7 @@ Windows `dsh-tui.cmd --resume` 使用 `~/.dsh-tui/resume.txt` 中最后选择的
 - `/context`、`/status`、`/cost`。
 - `/balance`：DeepSeek 官方余额，摘要行 + hover 明细，点击刷新。
 - `/config`、`/doctor`、`/init`、`/agents`。
-- `/jobs`：后台任务面板，状态/时长/退出码，`k` 停止。
+- `/jobs`：后台任务面板，状态/时长/退出码，`k` 停止；分栏开启且宽度足够时改为打开右栏面板，窄屏 / inline 回退整屏。
 - `/settings`。
 
 **模型与显示**
@@ -659,6 +704,7 @@ Windows `dsh-tui.cmd --resume` 使用 `~/.dsh-tui/resume.txt` 中最后选择的
   - 无参打开调色板选择器，`<名>` 直接设置，`status`/`reset`。
   - 输入框边框 + 右上角会话名标签，按会话保存。
   - 标签默认关闭，`/settings` 可开。
+- `/panel`：侧栏面板——开关 / 聚焦 / 缩放 / 切换（子命令见用户指南 §2.8）。
 - `/lang`。
 
 **账号与策略**
@@ -708,7 +754,7 @@ dsh-TUI 不预装通用技能；技能内容与发现规则由 DSH 及当前组
   - 服务已挂载但损坏、为空或不一致时标记 unavailable 并 fail closed。
   - 退出计划模式先恢复进入前的 sandbox/approval，再还原进入前所在的权限预设（registry 仍提供时）。
 - `/lang` 切换中英界面语言（见「界面语言」）。
-- `/compact` 压缩会话历史；内核「极简模式」预设（Agent preset `minimal`，只有一个持久 shell 工具）下不可用——与界面设置的「极简界面」无关。
+- `/compact` 压缩会话历史；内核「极简模式」预设（Agent preset `minimal`，只有一个持久 shell 工具）既不挂载压缩服务也不剪枝工具结果，长会话可能撞上下文上限、超长工具输出整段留在上下文里，`/compact` 因此不可用（Help 与 `/` 补全标注「不可用」，进入该预设时提示一次）——与界面设置的「极简界面」无关。
 - `/thinking` 扩展思考显示开关，仅本次界面状态、**不持久化**。
 - 启动后后台检查 npm 新版本，发现更新时提示。
   - 检测遵循 npm registry 配置（`NPM_CONFIG_REGISTRY` 或 `~/.npmrc`）。

package/guide/dsh-tui-guide/plugins.en.md

@@ -1,9 +1,9 @@
-# Plugin Development Guide (merged into spec)
+# Plugin Development Guide (authoritative text: the TUI Profile)
 
 [Documentation index](README.md) · [简体中文](plugins.md)
 
-> This document has been merged with the ecosystem admission specification:
-> [Plugin Admission and Development Guide](https://github.com/T-Auto/dsh-ecosystem-spec/blob/main/docs/plugin-admission-and-development.md)
+> This document has been merged with the in-repo TUI Profile (`tui-profile/`):
+> [Plugin Admission and Development Guide](../tui-profile/docs/plugin-admission-and-development.md)
 
 The ecosystem entry points and seam stability reference below are kept here
 for quick reference; the authoritative status and compatibility agreement
@@ -12,7 +12,7 @@ live in the admission & development guide.
 ## Ecosystem entry points
 
 - **Interface & compatibility agreement / Plugin development guide**:
-  [Terminal Interactive Ecosystem Plugin Admission and Development Guide](https://github.com/T-Auto/dsh-ecosystem-spec/blob/main/docs/plugin-admission-and-development.md)
+  [Terminal Interactive Ecosystem Plugin Admission and Development Guide](../tui-profile/docs/plugin-admission-and-development.md)
   (admission spec, seams, contracts, verification checklist).
 - **Organization**:
   [dsh-tui-ecosystem](https://github.com/dsh-tui-ecosystem)
@@ -28,17 +28,27 @@ live in the admission & development guide.
 
 An **informal** maturity grading to help plugin authors gauge investment;
 the authoritative status and compatibility agreement live in the
-[admission & development guide](https://github.com/T-Auto/dsh-ecosystem-spec/blob/main/docs/plugin-admission-and-development.md):
+[admission & development guide](../tui-profile/docs/plugin-admission-and-development.md):
 
 | Tier | Seams |
 | --- | --- |
 | Stable candidate (shape frozen; breaking changes go through a minor-version deprecation warning before removal) | VI settings sections · VIII full-screen scenes · X managed dialogs · XI status line · XII keyboard shortcuts · XIII entry renderers |
-| Experimental (may still shift with dsh-std / admission-spec evolution) | IX decision events · toast notifications (`ctx.tuiToast`, new) |
+| Experimental (may still shift with dsh-std / the TUI Profile) | IX decision events · toast notifications (`ctx.tuiToast`, new) · **Side panels (`ctx.tuiPanels`, full panel + compact row, experimental)** |
 | Upstream-tracked (stability owned by the cordis / dsh mechanisms underneath) | I session events · II official prompt slots · III bundled skills · IV themes · V system-prompt sections · VII profile composition |
 
 Also an experimental public surface:
 
 - `@deepseek-harness-tui/dsh-tui/api` (types-only entry).
+- **Side panels (experimental, §18)**: `ctx.tuiPanels.register({ apiVersion:
+  1, id, title, icon?, component | compact })` registers a right-sidebar
+  panel (the host prefixes `<pluginId>:`; ≤4 panels per plugin, ≤32 globally;
+  `open()` is rate-limited to once per 5s; 3 consecutive crashes disable the
+  panel for the session). Of the two render slots — the full panel
+  (`component`) and the compact row (`compact`, 1–3 lines) — **compact is
+  descriptor-validated only this phase and not mounted yet**; `sendToChat`
+  requires the `panels.chat.attach` grant (a later version) and currently
+  always returns `false` with a one-time hint. Types live at
+  `@deepseek-harness-tui/dsh-tui/panels` and `./api`.
 - The `@deepseek-harness-tui/dsh-tui/test-utils` subpath and
   `ctx.tuiPluginHost.grants.corrupt` were removed in the adapter layering
   refactor (#705).