@deepseek-harness-tui/dsh-tui 0.14.1 → 0.15.0

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

@@ -44,7 +44,8 @@ dsh-tui
    the marker — when `Enter` lands on a **shortcut card** (on a command card `Enter` tries the command).
    Re-run it any time with `/setup`.
 2. **Launchpad** (the first screen of an **ordinary launch** — no `--resume`, no workspace target,
-   no prompt; `DSH_TUI_NO_LAUNCHPAD=1` skips it entirely): the pixel-whale header (`✦ dsh-TUI`
+   no prompt; turn it off in `/settings` (`launchpad`, on by default, restart to apply), or
+   `DSH_TUI_NO_LAUNCHPAD=1` skips it entirely): the pixel-whale header (`✦ dsh-TUI`
    version, `DEEPSEEK / HARNESS` big text, current model and effort, working directory, and a
    **startup hint**; the header here is **frozen from the first frame** — the intro animation is
    left to the transcript header once you are in the chat), a **real input box** underneath
@@ -164,7 +165,7 @@ Unrecognized keys are ignored, `Esc` does nothing, clear with `Ctrl+C`/`dd`.
 
 | Action | Effect |
 |---|---|
-| left-drag | select text, **copy on release** (OSC 52 + system clipboard tools as fallback), auto-clear the selection |
+| left-drag | select text, **copy on release** (OSC 52 + system clipboard tools as fallback), keep the selection after copying; a new selection replaces it |
 | double-click / triple-click | select word / line, copy immediately |
 | wheel | scroll the message list (±3 rows/notch); **with a text selection, pan the selection with the content** |
 | in the input box | drag / Shift+click / double-click build a selection; `Backspace`/`Delete` delete it, typing replaces, `←/→` collapse, `Esc` clears only the selection, `Ctrl+C` copies it |
@@ -274,8 +275,11 @@ one-column seam between the two surfaces.
   reach the chat, while `Ctrl+C`/`Ctrl+D`/`Ctrl+L` and the other Ctrl combos still do.
 - **Mouse**: click the chat column to focus the chat, click the panel column to focus the panel;
   clicking a tab on the bar switches to that panel (hover highlights it), and the `⤢` on its right
-  edge blows the active panel up to the full screen. The panel column is excluded from
-  drag-selection.
+  edge blows the active panel up to the full screen. Hovering over the seam highlights it; hold
+  the left mouse button and drag it left to widen the panel or right to narrow it. Chat keeps
+  at least 64 columns and the panel at least 28. Dragging exits zoom, preserves keyboard focus,
+  and keeps the width for the current session. Text drags starting in chat select only chat;
+  drags starting inside the panel can select panel text.
 - **Panels**: all eight built-in panels are enabled by default and can be changed in `sidePanel.panels`. `todo` (Goals/Todos — with a split it moves here from above the input), `jobs`
   (background jobs; clicking a job card in the transcript focuses that job here), `agents`
   (subagent dashboard and detail: Enter opens the detail, Esc steps back), `companion`
@@ -302,6 +306,7 @@ one-column seam between the two surfaces.
   drags, plus its own hearts and thumbs-up) or `whale` (the splash's pixel whale). **On terminals
   with an image protocol (kitty/sixel) whaleGirl renders at native 240px with all 267 frames**
   (transparent float, decoded on demand); without one it falls back to the character-art form.
+  The splash uses these skins only under the DeepSeek brand: `deepy` and `whaleGirl` replace the maid portrait; choose `whale` and enable Maid portrait to use it. Claude uses its own artwork; Codex uses its own raster portrait or the maid character-art fallback. Both brands ignore these settings for splash artwork. See the [precedence table](configuration.en.md).
 
 | Subcommand | Effect |
 |---|---|
@@ -324,7 +329,7 @@ one-column seam between the two surfaces.
 
 ## 3. Command reference
 
-The command menu = built-in commands (58, aliases included) + DSH registry commands (`/plan` `/goal` etc.) + the skill catalog
+The command menu = built-in commands (aliases included) + DSH registry commands (`/plan` `/goal` etc.) + the skill catalog
 (completion only, hidden from the `/help` menu). `/lang` switches the UI and command descriptions between English and Chinese.
 
 ### 3.1 Session
@@ -337,7 +342,8 @@ The command menu = built-in commands (58, aliases included) + DSH registry comma
 | `/tree` | none | session fork tree: hover to preview, click to rewind / fork / switch branch |
 | `/fork` | none | copy the current session into a resumable clone (original unaffected) |
 | `/restart` | none | restart the process and resume this session (rejected mid-turn, `Ctrl+C` first) |
-| `/kernel` | none | kernel picker: switch between DSH and the experimental Claude backend; remembers the pick and restarts into a new session (rejected mid-turn); see [Claude backend](claude-backend.en.md) |
+| `/kernel` | none | kernel picker: switch between DSH, Codex and the experimental Claude backend; remembers the pick and restarts into a new session (rejected mid-turn); see [Claude backend](claude-backend.en.md) |
+| `/dsh` / `/codex` / `/claude` | none | directly choose the named kernel through the same checks and restart flow as `/kernel`; the current kernel does not restart, a running turn blocks switching, and missing Claude opens the install wizard |
 | `/rename` | `<新名称>` | rename the current session (no arg shows the current title and usage) |
 | `/recap` | none | recent-activity summary (one line) + suggested title; press `a` or click to apply the title. With `dsh-tui.recapOnOpen` (default on), opening/resuming a session auto-shows a divider + `回顾：` summary line at the bottom; hover to view actions, click to expand, gone after the next message |
 | `/workspace` | `resume` / `rename <名称>` / `open <路径或URI>` | manage workspaces; `open` accepts an absolute path, file URI, or plugin scheme |
@@ -372,8 +378,8 @@ The command menu = built-in commands (58, aliases included) + DSH registry comma
 | Command | Args | Effect |
 |---|---|---|
 | `/channel` | none | relay channel profiles (Claude backend only); **import / add / manage and any switch that needs a process restart are refused while a turn runs** (the picker itself still opens), see [Interaction](interaction.en.md#channel-profiles-channel-claude-only) |
-| `/model` | none | model selector; **switching = fork the session** (history kept, only routing changes; a session nobody has typed into records no branch, keeping automatic titles for its first prompt), choice persisted to `~/.dsh-tui/model.json` |
-| `/effort` | `status` / `<id>` | reasoning effort: no-arg slider (`←/→` adjust); `status` current level; `<id>` set directly. Persisted to `~/.dsh-tui/effort.json`; new-session start level follows /settings `effortDefault` (§5.3) |
+| `/model` | none | model selector; **switch within the same session** (ID, history, and title kept; the next request uses the new route), choice persisted to `~/.dsh-tui/model.json` |
+| `/effort` | `status` / `<id>` | reasoning effort: no-arg slider (`←/→` adjust); `status` current level; `<id>` set directly. Persisted to `~/.dsh-tui/effort.json` and reused by the next launch (it outranks the cordis.yml `effort` default); new-session start level follows /settings `effortDefault` (§5.3) |
 | `/thinking` | none | extended-thinking display toggle (thinking expands item by item while streaming) |
 | `/tokens` | none | three separate figures, never two different quantities side by side: **this request**'s upload (input + cache read + cache write — the harness's four buckets are disjoint), the **session totals** (uncached input / output / cache read / cache write), and **context occupancy** |
 | `/activity` | `frames <名>` / `status` | working-status animation: no-arg selector, `frames <名>` sets directly (includes `random`), default `moon8`. Persisted to `~/.dsh-tui/working-activity.json` |
@@ -397,7 +403,7 @@ The command menu = built-in commands (58, aliases included) + DSH registry comma
 | `/hooks` | none | placeholder: notes when DSH hooks aren't mounted in the composition |
 | `/mcp` | none | MCP connection state (tools grouped as `mcp__服务器__工具`); shows a `cordis.patch.yml` snippet when unconfigured |
 | `/skills` | none | skill-catalog selector (name+source+blurb); Enter fills a direct-call skill as `/name ` |
-| `/plugins` | `check <dsh-plugin.json 路径>` | plugin diagnostics: trust banner + host descriptor + authorization matrix + ledger; `check` validates a manifest and reports compatibility |
+| `/plugin` | `list` · `check <dsh-plugin.json 路径>` · `info <id or spec>` · `registries` | `list` shows the plugins you added, without the installation-supplied bundles; bare `/plugin` gives the full diagnostics — trust banner + host descriptor + authorization matrix + ledger + the profile's bundles and rows (reserved for the plugin management panel, a later stage); `check` validates a manifest and reports compatibility, `info` describes an installed bundle or an install spec, `registries` lists where installations ask |
 | `/update` | none | update the TUI and auto-restart to resume the session (only via `dsh --profile`; rejected mid-turn) |
 | `/terminal-setup` | none | terminal setup advice (Windows Terminal ≥110 columns, paste keys) |
 
@@ -436,7 +442,11 @@ dsh-TUI ships no generic skills; `/skills` browses skills DSH discovers, and a d
 | Exit | `/exit` (or `/quit` `/q`) | double-press `Ctrl+C` or `Ctrl+D` also exits when idle; mid-work, press `Ctrl+C`/`Ctrl+D` again to force quit when the interrupt won't settle |
 
 Command-line resume: `dsh-tui --resume` (last session) / `dsh-tui --resume <id>` (specific session).
-`-c` / `--continue` are equivalent.
+`-c` / `--continue` are equivalent. Startup recovery only ever targets **the backend this
+launch selected**: a backend with no last session, or a derived target belonging to a
+different backend, refuses with a clear error and exit code 1 — no silent cold start, no new
+session (safe mode's "retry normal startup" degrades to a warning plus a cold start, see the
+[README](../README.md)).
 
 ### 4.2 Time-travel rewind (double-press Esc)
 
@@ -471,8 +481,12 @@ Full-screen view of the whole session timeline (doesn't pollute scrollback); key
 
 ### 4.6 Model switching and presets
 
-- `/model`: selector. **Switching = fork the session** (history kept, only routing changes, the old session stays in `/resume`);
-  persisted to `~/.dsh-tui/model.json`.
+Switching within a session requires DSH `0.1.2-alpha.3` or later; older versions prompt an upgrade so subagents cannot keep using the previous model. Parked sessions retain their selection.
+
+- `/model`: selector. **Switch within the same session** (ID and history kept; the next request uses the new route);
+  persisted to `~/.dsh-tui/model.json` and reused by the next launch (a `provider`/`model`
+  pair in cordis.yml/profile is only the first-run deployment default).
+- DSH provider tabs start with **Recently used**, and `Tab` / `Shift+Tab` switch providers; Codex and Claude show their catalogs directly without these tabs. All backends use `↑/↓` to select a model, `←/→` to adjust its effort, `Enter` to apply both, and `Esc` to cancel the draft. Click the available tabs, models, effort levels, or select/cancel hints; clicking an effort level immediately applies the focused model and that effort and closes the picker. The wheel moves model focus.
 - Switching is rejected mid-turn.
 - `/preset` options: `standard` (default full features), `ptc`, `minimal` (the kernel's Minimal preset: one persistent-shell tool only, no compaction, no plan mode — and therefore no compaction and no tool-result pruning, so a long session can hit the context limit and `/compact` plus questions are unavailable; Help and `/` completion mark the command, and entering the preset says so once),
   `cordis`, `liangshen` (Liangshen mode).
@@ -497,6 +511,9 @@ Keys are in §2.7. Key points:
 - `/plan` `/goal` `/feedback` `/permission` come from the DSH registry, merged into the `/` menu.
 - **Goals/Todos panel appears automatically**: when the model writes a goal/todo, it renders above the input
   (🎯 goal + phase badge + tree todo), no action needed; with a split it moves to the `todo` panel on the right (see §2.8).
+  The goal bar keeps a one-line summary: hovering truncated goal text reads the whole objective, and a bare `/goal` prints the
+  full status (objective, phase, rounds or budget, available commands) as a `/plugins`-shaped transcript block — inline mode has
+  no pointer, so a long objective is read from that block.
 
 ### 4.9 MCP / Workspace / other
 
@@ -522,7 +539,7 @@ An empty session shows the whale logo area at the top (scrolls away with the con
 
 - **Intro animation** (~3.4 s, three picked each launch, `/deepseek` egg re-rolls): classic / heart / sleep.
 - **Welcome idle animation** (`whaleIdle`, default on): fin, blink, tail wag, sleeps with Z after 10 s idle; **click to show a heart and wake it**.
-- **Maid portrait** (`whaleGirl`, default off): swaps the header's pixel whale for the author-drawn maid — FIRST as a **real raster** through the terminal image protocols (Kitty/Sixel); terminals without graphics support fall back to the character-art maid. **Click her** and she turns into the "happy" portrait for a few seconds, then eases back on her own; the first agent task freezes her (no more reactions).
+- **Maid portrait** (`whaleGirl`, default off): under the DeepSeek brand, enable it with Companion skin set to `whale` to show the author-drawn maid — a **real raster** through Kitty/Sixel when available, with character-art fallback. **When the raster portrait is displayed, click her** to show the happy portrait for a few seconds; the first agent task freezes her reactions. Character-art fallback stays static. The `deepy` and `whaleGirl` skins take the slot instead; Claude uses its own artwork; Codex uses its own raster portrait or the maid character-art fallback. Both brands ignore these settings for splash artwork. See the [precedence table](configuration.en.md).
 - After the first agent task, it freezes to a static frame (`/new` re-enters the welcome period).
 - Text column right of the whale: `✦ dsh-TUI v版本号` →
   `DEEPSEEK / HARNESS` big text (bold glyphs, both rows the same width, one blank row between) →
@@ -552,7 +569,20 @@ An empty session shows the whale logo area at the top (scrolls away with the con
 **Row 1 — context segment bar** (`/settings → statusBar.contextBar`, default on)
 
 - Colored by content type (system / prompt / assistant / thinking / tools).
-- Segment token counts are a **local estimate** (CJK/full-width ≈1.4 chars/token, ASCII ≈4, other scripts ≈2): they describe what the bar is made of and **never** feed the occupancy total — that comes from the ctx reading below.
+- Colored by content type (system / prompt / assistant / thinking / tools). **The used span's length is
+  exactly the reading** (the 13k of `13k/64k`): the five segments only split that span by composition, so
+  an over- or under-estimate can no longer draw the bar short or long.
+- The composition comes from two layers: the harness's `contextBreakdown` projection (system prompt / the
+  request envelope's tool schemas / every other visible node, injected context included) plus this app's
+  local estimate, which alone splits the meter's message side into prompt / assistant / thinking / tool
+  results (ASCII ≈4 chars/token, CJK ≈1.4, other scripts ≈2). A meter that predates the projection leaves
+  the local estimate as the only source.
+- The hover legend reports those same shares, attributed to the occupancy, so **the five segments plus
+  free add up to the window** (`1.2k`-style abbreviations cost at most half a unit each) instead of
+  reporting a second, smaller total. The estimates themselves **never** feed the occupancy total — that
+  comes from the ctx reading below.
+- When no content category can be attributed, the bar keeps one used block and both the bar and ctx
+  hover details report its measured `used` count instead of five zero categories.
 - The only text on the bar is the right-edge reading `13k/64k 19.5%` (narrow screens show only `19.5%`).
 - The reading colors by usage: <80% gray-blue, **≥80% amber, ≥95% red**.
 - Hover the whole bar for the legend: color block + name + token count (narrow screens shorten the names).
@@ -592,6 +622,7 @@ Common items below, full list on the /settings screen. Most topics (**Appearance
 |---|---|
 | lang | UI language zh/en (locked when DSH_TUI_LANG is pinned) |
 | fullscreen | fullscreen mode (default on); takes effect after `/restart` |
+| launchpad | launchpad landing page (default on): an ordinary launch starts on the launchpad where the first sentence gets typed; off boots straight into the chat page (launches with a `--resume` target are unaffected — they open their conversation directly either way). Takes effect after `/restart` |
 | minimal | Minimal UI (default off): hide the header splash, emoji glyphs and decorative colors, and trim the footer to model + cwd; code highlight and tool colors stay. **An interface switch** with no effect on model capability — do not confuse it with the kernel Minimal agent preset in `/preset` |
 | terminalImages | terminal image preview (default on, needs terminal support); takes effect after `/restart`. Off shows text only and skips preview decode, sending images to the model is unaffected |
 | imageBacking | image backing (default `transparent`, same **Rendering** topic as the row above): what sits behind chat photos and illustrations. Transparent paints only the pixels of the image itself — the terminal background or wallpaper shows at anti-aliased edges and transparent corners; Terminal colour composites onto the terminal background for smooth soft edges. Applies immediately |
@@ -599,7 +630,7 @@ Common items below, full list on the /settings screen. Most topics (**Appearance
 | whale | pixel whale header (default on); three intro animations picked per launch (classic/heart/sleep), `/deepseek` egg re-rolls |
 | whaleIdle | whale welcome idle animation (default on): fin/tail/blink, sleeps with Z after 10 s idle; click for a heart. Freezes after the first task |
 | splashFont | big-text face on the header splash: Daily rotation (default, changes with the local date) / bold / square / bevel / wide / dot matrix / stencil / thin (classic) / slab. Picking a face pins it; picking Daily rotation restores the rotation. Applies immediately |
-| whaleGirl | maid portrait (default off): swaps the header's pixel whale for the author-drawn maid as a **real raster** (Kitty/Sixel); falls back to the pixel whale without graphics support |
+| whaleGirl | maid portrait (default off): under the DeepSeek brand, enable with `companion.skin=whale`; the `deepy` and `whaleGirl` skins override it. Claude uses its own artwork; Codex uses its own raster portrait or the maid character-art fallback. Both brands ignore these settings for splash artwork. Real raster (Kitty/Sixel), with character-art fallback. See the [precedence table](configuration.en.md) |
 | diffLayout | Edit/Write diff layout: auto (two columns ≥110 cols) / split / unified |
 | thinkingFold | thinking block: preview (2-3 line preview + folded when settled) / full (expanded to end of turn) |
 | btw.contextBudget | Total character budget of recent Q/A pairs carried into a `/btw` follow-up (default 24000, range 1000-200000); oldest whole pairs are dropped first. Applies immediately |
@@ -618,8 +649,8 @@ Common items below, full list on the /settings screen. Most topics (**Appearance
 | expandEditor | full-screen draft editor (default on): `⛶` at the input line end or `Ctrl+Shift+E` expands to a full-screen editor; `Ctrl+Enter` send, `Esc` collapse (draft kept); off hides both entries |
 | statusBar.* | all status-bar toggles above (compact/model/thinking/cwd/contextUsage/cache/tokens/cost/tps/gitBranch/sessionTitle/sessionId/mode/contextBar/activity/trajectory; statusBar.sessionId is the bottom-bar display toggle, unrelated to cordis startup sessionId) |
 
-**effortDefault**: when the model lacks that level, drop one level and show a notice; priority settings user layer > cordis `effort` >
-last `/effort` (effort.json) > model default.
+**effortDefault**: when the model lacks that level, drop one level and show a notice; priority settings user layer > the last `/effort`
+(effort.json, the level the last session ran) > cordis `effort` (deployment default) > model default.
 
 **scrollGutter**: the scrollbar track can be dragged directly; `Shift`/`Alt`/`Ctrl`+drag is still text selection.
 
@@ -666,10 +697,10 @@ When dsh exits unexpectedly, safe mode gives a **read-only** environment diagnos
 
 | Item | Command | Notes |
 |---|---|---|
-| Model | `/model` | selector; **switching = fork the session** (history kept, routing only); persisted to `~/.dsh-tui/model.json`, reused on restart and `/new`. Never chosen → built-in default (currently `deepseek-flash`) |
+| Model | `/model` | selector; **switch within the same session** (ID and history kept; subsequent requests use the new route); persisted to `~/.dsh-tui/model.json` and reused on restart and `/new` (a resumed session keeps its last recorded request route) — it OUTRANKS a `provider`/`model` pair written in cordis.yml/profile (that pair is only the first-run deployment default). Never chosen → the configured pair, else the harness default (currently `deepseek-flash`) |
 | Reasoning effort | `/effort` | slider (`←/→` live) or `/effort <id>`; `/effort status` for current; new-session default in /settings → default reasoning effort |
 | Agent preset | `/preset` | `standard` / `ptc` (old 0.1.1 name `code`) / `minimal` / `cordis` / **Liangshen mode `liangshen`**; **can't switch an already-started session** |
-| Theme | `/theme` | `auto` (OSC 11 follows terminal background) / `light` / `dark` / `dark-ansi`; `/theme <名>` direct; `/theme status` for the result |
+| Theme | `/theme` | `auto` (OSC 11 follows terminal background) / `light` / `dark` / `dark-ansi` / `pink-day` / `pink-night` / `pink-ansi`; `/theme <名>` direct; `/theme status` for the result |
 | Custom theme | manual | `~/.dsh-tui/themes/<名>.json`, `{base, colors}` format, hot-swap on select; naming it `auto` gets shadowed by the built-in |
 | Language | `/lang` | `en` / `zh` hot switch; priority `DSH_TUI_LANG` > profile config (legacy: settings.yaml user layer > cordis.yml) > persisted |
 | Status animation | `/activity` | selector or `/activity frames <名>`; default `moon8`, `random` randomizes |
@@ -716,7 +747,7 @@ When dsh exits unexpectedly, safe mode gives a **read-only** environment diagnos
 12. Session manager (`/resume`, `/home`, `/agentview`, `/bg`, or `⌸` at the input line start):
     type to filter, `★` pin, `Ctrl+X` stop a background session; switching just parks it.
 13. Mid-turn, `/compact`, `/model`, `/restart` are rejected — `Ctrl+C` first or wait for the turn to end.
-14. `/model` switch = fork (history kept), persisted and reused on restart and `/new`.
+14. `/model` switches subsequent requests in the same session (ID and history kept); the choice is saved as the default for new sessions, while a resumed session keeps its last recorded request route.
 
 **Ask the manual**
 

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

@@ -41,7 +41,7 @@ dsh-tui
    **跳过不记账**（下次启动还会问），最后一步要在**键位卡**上按 `Enter` 才算"完成"并写入记账文件
    （焦点落在命令卡上时 `Enter` 是"试一下"）。之后随时可用 `/setup` 重跑。
 2. **落地页**（**普通启动**的第一屏：没带 `--resume`、没指定工作区、也没带首句提示词；
-   `DSH_TUI_NO_LAUNCHPAD=1` 可整体跳过）：像素鲸鱼顶栏（`✦ dsh-TUI` 版本号、
+   可在 /settings 用 `launchpad` 关掉（默认开，重启生效），`DSH_TUI_NO_LAUNCHPAD=1` 可整体跳过）：像素鲸鱼顶栏（`✦ dsh-TUI` 版本号、
    `DEEPSEEK / HARNESS` 大字、当前模型与 effort、工作目录，及一行**启动提示**；
    这一屏的头部**直接定格**——开场动画留给进入对话后的转录区顶部），
    下面是一个**真输入框**（第一句话在这里打，**回车直接发送**）与框下一行**参数行**
@@ -152,7 +152,7 @@ dsh-tui
 
 | 操作 | 功能 |
 |---|---|
-| 左键拖拽 | 选文本，**松开即复制**（OSC 52 + 系统剪贴板工具兜底），自动取消选区 |
+| 左键拖拽 | 选文本，**松开即复制**（OSC 52 + 系统剪贴板工具兜底），复制后保留选区；重新拖选会替换现有选区 |
 | 双击 / 三击 | 选词 / 选行，即选即复制 |
 | 滚轮 | 滚动消息列表（±3 行/格）；**有文本选区时随内容平移选区** |
 | 输入框内 | 拖拽 / Shift+click / 双击建立选区；`Backspace`/`Delete` 删选区、打字替换、`←/→` 坍缩、`Esc` 仅清选区、`Ctrl+C` 复制选区 |
@@ -251,7 +251,9 @@ dsh-tui
   `z` 或 `Alt+Z` 缩放 · `+`/`-` 调宽（`+` 加宽面板，步长 4 列） · `↑`/`↓`/`PgUp`/`PgDn` 交给活动面板（jobs 用它选择与滚动）；
   面板没吃下的键不会再落到聊天，但 `Ctrl+C`/`Ctrl+D`/`Ctrl+L` 等 Ctrl 组合照旧作用于聊天。
 - **鼠标**：点聊天栏把焦点给聊天，点右栏把焦点给面板；点标签栏上的标签直接切到那个面板（悬停会高亮），
-  点右端的 `⤢` 把当前面板放大成整屏；右栏不参与拖拽选字。
+  点右端的 `⤢` 把当前面板放大成整屏。悬停中缝会提亮，按住鼠标左键左右拖拽即可实时调宽：
+  向左加宽侧栏、向右缩窄，聊天列至少 64 列、侧栏至少 28 列；拖拽会退出 zoom，保留键盘焦点，
+  宽度在当前会话内保留。聊天内起拖只选聊天文字，右栏内起拖可选右栏文字。
 - **面板**：全部 8 个内置面板默认启用，可在 `sidePanel.panels` 调整。`todo`（Goals/Todos，分栏时从输入框上方迁到这里）、`jobs`（后台任务，点转录里的任务卡
   会直接定位到该任务）、`agents`（子代理 Dashboard 与详情：Enter 进详情、Esc 逐级返回）、`companion`
    （宠物：跟随会话状态换心情动画，点击
@@ -271,6 +273,7 @@ dsh-tui
   表情包，22 个动画，被戳/被挠/被拎起来都有对应反应，独有「冒爱心」「举大拇指」）、`whale`（开屏
   同款像素鲸）。**鲸娘在有图像协议（kitty/sixel）的终端里按原帧数 240px 像素级渲染**（267 帧全保留、
   透明悬浮、按需解码），无图像协议自动回退字符画版。
+  开屏仅在 DeepSeek 品牌下使用这些皮肤：`deepy` 和 `whaleGirl` 会取代女仆娘立绘；选择 `whale` 并开启「女仆娘立绘」才会显示女仆娘。Claude 使用自己的图案，Codex 使用自己的真图或女仆娘字符画回退；这两个品牌的开屏图案不受宠物皮肤和女仆娘开关影响。见[优先级表](configuration.md)。
 
 | 子命令 | 作用 |
 |---|---|
@@ -290,7 +293,7 @@ dsh-tui
 
 ## 3. 命令全集
 
-命令菜单 = 内置命令（58 条，含别名） + DSH 注册表命令（`/plan` `/goal` 等） + 技能目录
+命令菜单 = 内置命令（含别名） + DSH 注册表命令（`/plan` `/goal` 等） + 技能目录
 （仅补全，`/help` 菜单隐藏）。`/lang` 可切换中英文界面与命令描述。
 
 ### 3.1 会话
@@ -303,7 +306,8 @@ dsh-tui
 | `/tree` | 无 | 会话分叉树：悬停预览、点击回退 / 分叉 / 切换分支 |
 | `/fork` | 无 | 把当前会话复制成可恢复的副本（原会话不受影响） |
 | `/restart` | 无 | 重启进程并恢复本会话（回合运行中会被拒绝，先 `Ctrl+C`） |
-| `/kernel` | 无 | 内核选择器：在 DSH 与实验性的 Claude 后端之间切换，记住选择并重启进入新会话（回合运行中会被拒绝）；见 [Claude 后端](claude-backend.md) |
+| `/kernel` | 无 | 内核选择器：在 DSH、Codex 与实验性的 Claude 后端之间切换，记住选择并重启进入新会话（回合运行中会被拒绝）；见 [Claude 后端](claude-backend.md) |
+| `/dsh` / `/codex` / `/claude` | 无 | 直接选择对应内核，检查与重启流程同 `/kernel`；选择当前内核不重启，回合运行中不能切换，未安装 Claude 时进入安装向导 |
 | `/rename` | `<新名称>` | 重命名当前会话（无参时显示当前标题与用法） |
 | `/recap` | 无 | 最近活动摘要（一行）+ 建议标题；面板内 `a` 键或点击一键应用标题。设置 `dsh-tui.recapOnOpen`（默认开）开启时，打开/恢复会话自动在底部显示一条分隔线 + `回顾：` 摘要行，悬停可查看操作、点击展开，发送新消息后自动消失 |
 | `/workspace` | `resume` / `rename <名称>` / `open <路径或URI>` | 管理工作区；`open` 支持绝对路径、file URI、插件 scheme |
@@ -338,7 +342,7 @@ dsh-tui
 | 命令 | 参数 | 作用 |
 |---|---|---|
 | `/channel` | 无 | 中转渠道档案（仅 Claude 后端）；**回合运行中导入 / 新建 / 管理，以及需要重启进程的切换会被拒绝**（选择器本身仍可打开），见 [交互与命令](interaction.md#渠道档案channel仅-claude) |
-| `/model` | 无 | 模型选择器；**切换 = fork 会话续聊**（历史保留、仅换路由；还没有人说过话的会话不记分支，保留首个 prompt 的自动标题），选择持久化到 `~/.dsh-tui/model.json` |
+| `/model` | 无 | 模型选择器；**同会话切换模型**（保留 session ID、历史和标题，下一次请求使用新路由），选择持久化到 `~/.dsh-tui/model.json` |
 | `/effort` | `status` / `<id>` | 推理强度：无参滑杆（`←/→` 实时调整）；`status` 当前档位；`<id>` 直接设定。持久化 `~/.dsh-tui/effort.json`；新会话起始档看 /settings 的 `effortDefault`（§5.3） |
 | `/thinking` | 无 | 扩展思考显示开关（流式时思考逐条展开） |
 | `/tokens` | 无 | 分三段报数，不再并列两个不同量：**本次请求**上传量（input + 缓存读 + 缓存写，harness 的四个桶互斥）、**会话累计**（未缓存输入 / 输出 / 缓存读 / 缓存写）、**上下文占用** |
@@ -363,7 +367,7 @@ dsh-tui
 | `/hooks` | 无 | 占位：DSH hooks 未在组合中挂载时给出说明 |
 | `/mcp` | 无 | MCP 连接状态（工具按 `mcp__服务器__工具` 分组）；未配置时给出 `cordis.patch.yml` 插入示例 |
 | `/skills` | 无 | 技能目录选择器（名称+来源+简述），Enter 将可直调技能以 `/name ` 填回输入行 |
-| `/plugins` | `check <dsh-plugin.json 路径>` | 插件诊断：信任横幅 + host 描述符 + 授权矩阵 + 台账；`check` 校验清单文件并给兼容状态 |
+| `/plugin` | `list` · `check <dsh-plugin.json 路径>` · `info <id 或 spec>` · `registries` | `list` 简洁列出你装的额外插件（不含安装自带）；无参给完整诊断：信任横幅 + host 描述符 + 授权矩阵 + 台账 + profile 的 bundle/行（预留为插件管理面板，后续段实现）；`check` 校验清单并给兼容状态，`info` 查已装条目或待装 spec，`registries` 列安装源 |
 | `/update` | 无 | 更新 TUI 并自动重启恢复会话（仅 `dsh --profile` 启动可用；回合运行中会拒绝） |
 | `/terminal-setup` | 无 | 终端配置建议（Windows Terminal ≥110 列、粘贴键位） |
 
@@ -402,7 +406,9 @@ dsh-TUI 不预装通用技能；`/skills` 浏览 DSH 发现的技能，可直调
 | 退出 | `/exit`（或 `/quit` `/q`） | 空闲 `Ctrl+C` 双击或 `Ctrl+D` 双击也可退出；工作中中断迟迟不收敛时再按 `Ctrl+C`/`Ctrl+D` 强制退出 |
 
 命令行恢复：`dsh-tui --resume`（最近会话）/ `dsh-tui --resume <id>`（指定会话）。
-`-c` / `--continue` 等价。
+`-c` / `--continue` 等价。启动恢复只针对**本次启动所选的后端**：该后端没有上次会话，
+或派生出的目标属于别的后端时，启动器明确报错并以退出码 1 收束，不静默冷启动、不新建
+会话（安全模式的「重试正常启动」降级为告警 + 冷启动，见 [README](../README_ZH.md)）。
 
 ### 4.2 时间回溯 rewind（双击 Esc）
 
@@ -436,8 +442,12 @@ dsh-TUI 不预装通用技能；`/skills` 浏览 DSH 发现的技能，可直调
 
 ### 4.6 模型切换与预设
 
-- `/model`：选择器。**切换 = fork 会话续聊**（历史保留、仅换路由，旧会话留在 `/resume`）；
-  持久化 `~/.dsh-tui/model.json`。
+同会话切换需要 DSH `0.1.2-alpha.3` 或更高版本；旧版会提示升级，防止子代理继续使用切换前的模型。停放中的会话保留所选路由。
+
+- `/model`：选择器。**同会话切换模型**（保留 session ID 和历史，下一次请求使用新路由）；
+  持久化 `~/.dsh-tui/model.json`，下次启动直接沿用它（cordis.yml/profile 中的
+  `provider`/`model` 只是首次启动的部署默认值）。
+- DSH 的顶部标签以「最近使用」开头，再列各提供商，`Tab` / `Shift+Tab` 切换提供商；Codex 与 Claude 直接显示模型目录，不显示这些标签。所有后端均用 `↑/↓` 选模型、`←/→` 调推理等级、`Enter` 一并应用、`Esc` 取消草稿，支持点击可用的标签、模型、档位与选择/取消提示，以及滚轮移动模型焦点。点击推理档位会立即应用当前聚焦模型与该强度，并关闭选择器。
 - 回合运行中切换会被拒绝。
 - `/preset` 可选：`standard`（默认全功能）、`ptc`、`minimal`（内核「极简模式」：只暴露一个持久 shell 工具，无 compaction、无计划模式；也因此没有压缩、工具结果不剪枝——长会话可能撞上下文上限，`/compact` 与问卷不可用，Help 与 `/` 补全会标注，进入该预设时提示一次）、
   `cordis`、`liangshen`（梁神模式）。
@@ -460,7 +470,8 @@ dsh-TUI 不预装通用技能；`/skills` 浏览 DSH 发现的技能，可直调
 - `/skills` 浏览技能目录，可直调技能以 `/name` 加入命令菜单（dsh-TUI 不自带通用技能）。
 - `/plan` `/goal` `/feedback` `/permission` 来自 DSH 注册表，随组合并入 `/` 菜单。
 - **Goals/Todos 面板自动出现**：模型写入 goal/todo 时在输入框上方实时渲染（🎯 目标 + phase 徽章 + 树形 todo），
-  无需操作；分栏开启时它迁到右栏的 `todo` 面板（见 §2.8）。
+  无需操作；分栏开启时它迁到右栏的 `todo` 面板（见 §2.8）。目标栏保留单行摘要：悬停被截断的目标正文看全文；
+  裸 `/goal` 把完整状态（目标全文、阶段、轮次或预算、可用命令）打印成 `/plugins` 同款的转录块——inline 没有鼠标指针，长目标靠这个块读。
 
 ### 4.9 MCP / Workspace / 其他
 
@@ -484,7 +495,7 @@ dsh-TUI 不预装通用技能；`/skills` 浏览 DSH 发现的技能，可直调
 
 - **开场动画**（约 3.4 秒，每次启动三选一，`/deepseek` 彩蛋重掷）：经典 / 爱心 / 睡觉。
 - **欢迎期闲置动画**（`whaleIdle`，默认开）：摆鱼鳍、眨眼、拍尾巴，空闲 10 秒入睡冒 Z；**点击冒爱心唤醒**。
-- **女仆娘立绘**（`whaleGirl`，默认关）：把标题的像素鲸鱼换成作者绘制的女仆娘——**最优先**走终端图像协议（Kitty/Sixel）的真图渲染；终端不支持（如内联模式）时回落到字符画版女仆娘。**点她一下**会换成「高兴鲸娘」几秒再自动回安静版；开始第一个任务后定格、不再响应点击。
+- **女仆娘立绘**（`whaleGirl`，默认关）：DeepSeek 品牌下，宠物皮肤设为 `whale` 并开启本项后，显示作者绘制的女仆娘——优先走 Kitty/Sixel 真图，不支持时回落字符画。**显示真图时，点她一下**会换成「高兴鲸娘」几秒，再自动回安静版；第一个任务后定格，不再响应点击。字符画保持静态。`deepy` 和 `whaleGirl` 皮肤会取代立绘；Claude 使用自己的图案，Codex 使用自己的真图或女仆娘字符画回退；这两个品牌的开屏图案不受宠物皮肤和女仆娘开关影响。见[优先级表](configuration.md)。
 - 开始第一个 agent 任务后定格为静态帧（`/new` 重新进入欢迎期）。
 - 鲸鱼右侧文字列：`✦ dsh-TUI v版本号` → 块体大字 `DEEPSEEK / HARNESS`（加粗字形，两行等宽、中间空一行）→
   当前模型 + effort → 工作目录 → 启动提示行。
@@ -510,8 +521,16 @@ dsh-TUI 不预装通用技能；`/skills` 浏览 DSH 发现的技能，可直调
 **Row 1 — 上下文分段进度条**（`/settings → statusBar.contextBar`，默认开）
 
 - 按内容类型分段着色（system / prompt / assistant / thinking / tools）。
-- 分段 token 数是**本地估算**（CJK/全角按 ~1.4 字符/token、ASCII 按 ~4 字符/token、其它脚本按 ~2），
-  只描述这条由什么构成，**不参与占用总量**——占用以 ctx 字段/读数为准（见下）。
+- 分段着色按内容类型（system / prompt / assistant / thinking / tools）。**已用段的长短严格等于读数**
+  （`13k/64k` 里的 13k）：五段只按构成把这个长度切开，估算偏小/偏大都不会再让条画短或画长。
+- 构成分两层：harness 的 `contextBreakdown` 投影（system 提示 / 本次请求信封里的工具 schema /
+  其余可见内容，注入的上下文也在这一项）＋ 本地估算（把 meter 的消息侧再按 prompt / assistant /
+  thinking / 工具结果细分；ASCII ~4 字符/token、CJK ~1.4、其它脚本 ~2）。旧版 meter 不发布该投影时
+  只用本地估算。
+- 悬停图例报的就是条上那批份额（按占用归因），**五段 + free 合起来正好是窗口**（`1.2k` 这类缩写
+  每项最多差半个单位），不再出现「五段加起来只有读数一半」。估算本身**不参与占用总量**——占用以
+  ctx 字段/读数为准（见下）。
+- 构成无法归因到任何类别时，条保持单块已用区域；条和 ctx 字段的悬停明细都报实测 `used`，不列五个零分类。
 - 条上唯一文字是最右缘读数 `13k/64k 19.5%`（窄屏只显示 `19.5%`）。
 - 读数按占用率变色：<80% 灰蓝，**≥80% 琥珀、≥95% 红**。
 - 悬停整条弹出图例：色块 + 名称 + token 数（窄屏自动改用短名）。
@@ -545,6 +564,7 @@ dsh-tui 自身区块在 0.1.7 写入当前 profile 的 `cordis.patch.yml`，旧
 |---|---|
 | lang | 界面语言 zh/en（DSH_TUI_LANG 钉死时不可改） |
 | fullscreen | 全屏模式（默认开）；保存后用 `/restart` 生效 |
+| launchpad | 启动页（落地页，默认开）：普通启动先落启动页输入第一句话；关闭后直接进入聊天页（带 `--resume` 等恢复目标的启动不受影响，仍直接进会话）。保存后用 `/restart` 生效 |
 | minimal | 极简界面 Minimal UI（默认关）：隐藏开屏头部、emoji 状态符与装饰性配色，底栏只留模型与目录；代码高亮与工具配色保留。**这是界面开关**，对模型能力没有任何影响——别和 `/preset` 的内核「极简模式」预设搞混 |
 | terminalImages | 终端图片预览（默认开，需终端支持）；保存后用 `/restart` 生效。关闭后只显示文字信息并跳过预览解码，不影响向模型发送图片 |
 | imageBacking | 图片底色（默认 `transparent`，与上一条同在**图表与图片**主题下）：聊天照片/插图背后垫什么。透明：只画图片自己的像素，抗锯齿边缘和透明圆角透出终端底色或壁纸；终端底色：先合成到终端背景色，柔和边缘更平滑。立即生效 |
@@ -552,7 +572,7 @@ dsh-tui 自身区块在 0.1.7 写入当前 profile 的 `cordis.patch.yml`，旧
 | whale | 开屏头部像素鲸鱼娘（默认开）；每次启动随机三选一开场动画（经典/爱心/睡觉），`/deepseek` 彩蛋重掷 |
 | whaleIdle | 鲸鱼娘欢迎期闲置动画（默认开）：定格后摆鱼鳍/拍尾巴/眨眼，空闲 10 秒入睡冒 Z；点击冒爱心。开始第一个任务后定格 |
 | splashFont | 开屏大字字体：按天轮换（默认，随本地日期换款）/ 加粗 / 方角实心 / 半立体 / 宽体 / 点阵灰度 / 镂空模板 / 细笔 / 方板。选某一款即固定那一款，选回「按天轮换」恢复。立即生效 |
-| whaleGirl | 女仆娘立绘（默认关）：标题像素鲸鱼换成作者绘制的女仆娘**真图**（Kitty/Sixel 图像协议）；不支持时回落像素鲸鱼 |
+| whaleGirl | 女仆娘立绘（默认关）：DeepSeek 品牌下，设 `companion.skin=whale` 并开启本项；`deepy` 和 `whaleGirl` 皮肤会取代立绘。Claude 使用自己的图案，Codex 使用自己的真图或女仆娘字符画回退；这两个品牌的开屏图案不受宠物皮肤和女仆娘开关影响。优先 Kitty/Sixel 真图，不支持时回落字符画。见[优先级表](configuration.md) |
 | diffLayout | Edit/Write diff 布局：auto（≥110 列双栏）/ split / unified |
 | thinkingFold | 思考块：preview（流式 2-3 行预览 + 落定折叠）/ full（展开到轮末） |
 | btw.contextBudget | `/btw` 追问携带的最近问答总字符预算（默认 24000，范围 1000-200000）；超出时从最旧的整组开始裁剪。立即生效 |
@@ -571,8 +591,8 @@ dsh-tui 自身区块在 0.1.7 写入当前 profile 的 `cordis.patch.yml`，旧
 | expandEditor | 全屏草稿编辑（默认开）：输入行尾 `⛶` 或 `Ctrl+Shift+E` 展开成整屏编辑器；`Ctrl+Enter` 发送、`Esc` 收起（草稿还在）；关掉后入口不显示 |
 | statusBar.* | 上表全部状态栏开关（compact/model/thinking/cwd/contextUsage/cache/tokens/cost/tps/gitBranch/sessionTitle/sessionId/mode/contextBar/activity/trajectory；statusBar.sessionId 是底栏显示开关，与 cordis 的启动 sessionId 无关） |
 
-**effortDefault**：模型没有该档时自动就近降级并弹提示；优先级 settings 用户层 > cordis `effort` >
-上次 `/effort`（effort.json）> 模型默认。
+**effortDefault**：模型没有该档时自动就近降级并弹提示；优先级 settings 用户层 > 上次 `/effort`
+（effort.json，即上次实际运行的档位）> cordis `effort`（部署默认值）> 模型默认。
 
 **scrollGutter**：scrollbar 轨道可直接拖；`Shift`/`Alt`/`Ctrl`+拖动仍是文字选择。
 
@@ -618,10 +638,10 @@ dsh 意外退出时，安全模式给出**只读**的环境诊断、profile 插
 
 | 项 | 命令 | 说明 |
 |---|---|---|
-| 模型 | `/model` | 选择器；**切换 = fork 会话续聊**（历史保留、仅换路由）；持久化 `~/.dsh-tui/model.json`，重启与 `/new` 沿用。从没选过的话，用内置默认模型（当前为 `deepseek-flash`） |
-| 推理强度 | `/effort` | 滑杆（←/→ 实时）或 `/effort <id>`；`/effort status` 看当前；新会话默认档在 /settings → 默认推理强度 |
+| 模型 | `/model` | 选择器；**同会话切换模型**（保留 session ID 和历史，仅换后续请求路由）；持久化 `~/.dsh-tui/model.json`，重启与 `/new` 沿用（恢复的会话沿用其最后一次请求的路由）——它**优先于** cordis.yml/profile 里写的 `provider`/`model`（后者只是首次启动的部署默认值）。从没选过的话，用配置值，再没有才用 Harness 默认（当前为 `deepseek-flash`） |
+| 推理强度 | `/effort` | 滑杆（←/→ 实时）或 `/effort <id>`；`/effort status` 看当前；持久化 `~/.dsh-tui/effort.json` 并被下一次启动沿用（优先于 cordis.yml 的 `effort`），新会话默认档在 /settings → 默认推理强度 |
 | Agent 预设 | `/preset` | `standard` / `ptc`（旧 0.1.1 名 `code`）/ `minimal` / `cordis` / **梁神模式 `liangshen`**；**已开始会话不可切换** |
-| 主题 | `/theme` | `auto`（OSC 11 跟随终端背景）/ `light` / `dark` / `dark-ansi`；`/theme <名>` 直接切；`/theme status` 看解析结果 |
+| 主题 | `/theme` | `auto`（OSC 11 跟随终端背景）/ `light` / `dark` / `dark-ansi` / `pink-day` / `pink-night` / `pink-ansi`；`/theme <名>` 直接切；`/theme status` 看解析结果 |
 | 自定义主题 | 手动 | `~/.dsh-tui/themes/<名>.json`，`{base, colors}` 格式，选中即热切换；命名为 `auto` 会被内置遮蔽 |
 | 语言 | `/lang` | `en` / `zh` 热切换；优先级 `DSH_TUI_LANG` > profile 配置（旧版 settings.yaml 用户层 > cordis.yml）> 持久化 |
 | 状态行动画 | `/activity` | 选择器或 `/activity frames <名>`；默认 `moon8`，`random` 随机 |
@@ -667,7 +687,7 @@ dsh 意外退出时，安全模式给出**只读**的环境诊断、profile 插
 12. 会话管理界面（`/resume`、`/home`、`/agentview`、`/bg` 或输入框行首 `⌸`）：
     打字筛选、`★` 固定、`Ctrl+X` 停后台会话；切换只是**停放**。
 13. 回合运行中 `/compact`、`/model`、`/restart` 会被拒绝——先 `Ctrl+C` 或等回合结束。
-14. `/model` 切换 = fork 续聊（历史保留），持久化后重启与 `/new` 沿用。
+14. `/model` 在同一会话内切换后续请求的模型（ID 和历史保留）；选择保存为新会话默认，恢复的会话沿用其最后一次请求的路由。
 
 **问手册**
 

package/lib/settings.json

@@ -1,7 +1,7 @@
 {
   "schemaVersion": 1,
   "package": "@deepseek-harness-tui/dsh-tui",
-  "packageVersion": "0.14.1",
+  "packageVersion": "0.15.0",
   "namespace": "dsh-tui",
   "groups": [
     {
@@ -197,8 +197,8 @@
         "zh": "宠物皮肤"
       },
       "description": {
-        "en": "Look of the companion panel pet (the panel is enabled by default and can be changed in sidePanel.panels): deepy (default, the deepy whale kit), whale (the same layered pixel whale as the splash) or whaleGirl (the user-provided whale-girl sticker pack, 22 animations). Applies immediately.",
-        "zh": "伙伴面板里宠物的外形（面板默认启用，可在 sidePanel.panels 中调整）：deepy（默认，deepy 小鲸鱼素材包）、whale（与开屏同款的分层像素鲸鱼）或 whaleGirl（用户提供的鲸娘表情包，22 个动画）。立即生效。"
+        "en": "DeepSeek brand: whale allows the maid portrait; deepy/whaleGirl replace it. Claude uses its own art; Codex uses its own raster portrait or maid character-art fallback. Look of the companion panel pet (the panel is enabled by default and can be changed in sidePanel.panels): deepy (default, the deepy whale kit), whale (the same layered pixel whale as the splash) or whaleGirl (the user-provided whale-girl sticker pack, 22 animations). Applies immediately.",
+        "zh": "DeepSeek 品牌：whale 才能用女仆娘立绘；deepy/whaleGirl 会替换它。Claude 使用自己的图案；Codex 优先显示自己的真图，不可用时回落女仆娘字符画。伙伴面板里宠物的外形（面板默认启用，可在 sidePanel.panels 中调整）：deepy（默认，deepy 小鲸鱼素材包）、whale（与开屏同款的分层像素鲸鱼）或 whaleGirl（用户提供的鲸娘表情包，22 个动画）。立即生效。"
       },
       "default": "deepy",
       "options": [
@@ -470,6 +470,22 @@
       "restartRequired": false,
       "deprecated": false
     },
+    {
+      "key": "launchpad",
+      "kind": "boolean",
+      "group": "splash",
+      "label": {
+        "en": "Launchpad on boot",
+        "zh": "启动页（落地页）"
+      },
+      "description": {
+        "en": "On: an ordinary launch (no --resume, no first prompt) starts on the launchpad — the landing page where the first sentence gets typed, with the Continue / Sessions / Settings / Kernel row. Off: boots straight into the chat page. A resume target always skips the launchpad either way. On by default. Restart to apply.",
+        "zh": "开启：普通启动（不带 --resume、不带首句）先落启动页——输入第一句话的落地页，带「继续上次 / 会话与工作区 / 设置 / 内核」一行；关闭：直接进入聊天页。无论开关，指定恢复的会话总是直接打开。默认开启。重启生效。"
+      },
+      "default": null,
+      "restartRequired": true,
+      "deprecated": false
+    },
     {
       "key": "mathImageBacking",
       "kind": "select",
@@ -619,6 +635,45 @@
       "restartRequired": false,
       "deprecated": false
     },
+    {
+      "key": "notificationMethod",
+      "kind": "select",
+      "group": "conversation",
+      "label": {
+        "en": "Notification method",
+        "zh": "通知方式"
+      },
+      "description": {
+        "en": "Auto uses separate title/body notifications on Ghostty and WezTerm (OSC 777) and Kitty (OSC 99). iTerm2 and Warp use OSC 9 with a title prefix; other terminals ring the bell. Explicit OSC 9 also uses the title prefix. Delivery depends on terminal settings. In tmux, OSC notifications need allow-passthrough on. Applies immediately.",
+        "zh": "自动：Ghostty、WezTerm 使用 OSC 777，Kitty 使用 OSC 99，分别显示标题与正文；iTerm2、Warp 使用 OSC 9，将标题放在正文前；其他终端响铃。显式 OSC 9 同样使用标题前缀。实际提醒取决于终端设置；tmux 中 OSC 通知需要开启 allow-passthrough。立即生效。"
+      },
+      "default": null,
+      "options": [
+        {
+          "value": "auto",
+          "label": {
+            "en": "Auto",
+            "zh": "自动"
+          }
+        },
+        {
+          "value": "osc9",
+          "label": {
+            "en": "OSC 9",
+            "zh": "OSC 9"
+          }
+        },
+        {
+          "value": "bel",
+          "label": {
+            "en": "Terminal bell",
+            "zh": "终端响铃"
+          }
+        }
+      ],
+      "restartRequired": false,
+      "deprecated": false
+    },
     {
       "key": "pageMargin",
       "kind": "text",
@@ -1049,8 +1104,8 @@
         "zh": "聊天列占比"
       },
       "description": {
-        "en": "Chat column as a fraction of the content width: 0.1-0.95, default 0.68. Type a decimal such as `0.6`; while the panel has focus the +/- shortcuts nudge it live for the current session. Applies immediately.",
-        "zh": "聊天列占内容宽度的比例：0.1-0.95，默认 0.68。输入小数如 `0.6`；面板获得焦点时可用 +/- 在会话内实时微调。立即生效。"
+        "en": "Chat column as a fraction of the content width: 0.1-0.95, default 0.68. Type a decimal such as `0.6`; drag the divider or use +/- while the panel has focus to resize for the current session. Applies immediately.",
+        "zh": "聊天列占内容宽度的比例：0.1-0.95，默认 0.68。输入小数如 `0.6`；拖拽分隔线，或在面板获得焦点时用 +/-，可在当前会话内实时调宽。立即生效。"
       },
       "default": 0.68,
       "restartRequired": false,
@@ -1464,6 +1519,45 @@
       "restartRequired": false,
       "deprecated": false
     },
+    {
+      "key": "taskNotifications",
+      "kind": "select",
+      "group": "conversation",
+      "label": {
+        "en": "Task completion notifications",
+        "zh": "任务完成通知"
+      },
+      "description": {
+        "en": "Notify when successful live work finishes with no queued follow-up or active goal. The title is dsh-TUI · Task complete; the body previews the latest reply as plain text in one line, with Markdown formatting removed, up to 200 characters. OSC 777/9 may shorten it further to fit a 2048-byte sequence budget without splitting characters. No reply shows only the title; BEL only rings. Default: only while the terminal is unfocused. Off disables notifications; Always also notifies while focused or when focus reporting is unavailable. Replay, cancellation and errors stay quiet. Applies immediately.",
+        "zh": "实时任务成功结束、没有排队的后续输入或活动目标时提醒。标题为「dsh-TUI · 任务已完成」，正文显示最新回复的单行纯文本摘要，去掉 Markdown 样式，最多 200 字符；OSC 777/9 还会按完整序列的 2048 字节预算截短，不拆字符；没有回复时只显示标题，BEL 只响铃。默认仅在终端失去焦点时通知；关闭可禁用，每次完成则在终端聚焦或不支持焦点报告时也通知。回放、取消和失败不通知。立即生效。"
+      },
+      "default": null,
+      "options": [
+        {
+          "value": "unfocused",
+          "label": {
+            "en": "When unfocused",
+            "zh": "仅失焦时"
+          }
+        },
+        {
+          "value": "always",
+          "label": {
+            "en": "Always",
+            "zh": "每次完成"
+          }
+        },
+        {
+          "value": "off",
+          "label": {
+            "en": "Off",
+            "zh": "关闭"
+          }
+        }
+      ],
+      "restartRequired": false,
+      "deprecated": false
+    },
     {
       "key": "terminalImages",
       "kind": "boolean",
@@ -1576,8 +1670,8 @@
         "zh": "标题图形 logo"
       },
       "description": {
-        "en": "Show the header splash art — the pixel whale, or the maid portrait when the setting below is on. Off leaves a text-only header.",
-        "zh": "开屏头部显示图形 logo：像素鲸鱼（打开下方「女仆娘立绘」时显示女仆娘）。关闭则只留文字标题。"
+        "en": "Header art. DeepSeek follows Companion skin and the maid toggle; Claude uses its own art; Codex uses its own raster portrait or maid character-art fallback. Off leaves a text-only header.",
+        "zh": "标题图形：DeepSeek 品牌随宠物皮肤与女仆娘开关，Claude 使用自己的图案；Codex 优先显示自己的真图，不可用时回落女仆娘字符画。关闭则只留文字标题。"
       },
       "default": true,
       "restartRequired": false,
@@ -1592,8 +1686,8 @@
         "zh": "女仆娘立绘"
       },
       "description": {
-        "en": "Swap the header splash's pixel whale for the author-designed maid portrait, rendered FIRST as a real raster through the terminal image protocols (Kitty/Sixel); terminals without graphics support fall back to the character-art maid.",
-        "zh": "把开屏头部的像素鲸鱼换成项目作者绘制的女仆娘立绘，最优先走终端图像协议（Kitty/Sixel）的真图渲染；终端不支持时回落到字符画版女仆娘。"
+        "en": "DeepSeek brand: choose whale in Companion skin, then enable this toggle. Claude uses its own art; Codex uses its own raster portrait or maid character-art fallback. Swaps the pixel whale for the author-designed maid portrait, preferring the real raster (Kitty/Sixel) with character-art fallback.",
+        "zh": "DeepSeek 品牌：选 whale 皮肤并开启本项。Claude 使用自己的图案；Codex 优先显示自己的真图，不可用时回落女仆娘字符画。把像素鲸鱼换成项目作者绘制的女仆娘立绘，优先用终端图像协议（Kitty/Sixel）渲染真图，不支持时回落字符画。"
       },
       "default": false,
       "restartRequired": false,

package/lib/types/adapter/channel/ui-policy.d.ts

@@ -132,5 +132,5 @@ export declare const CHANNEL_UI_EFFECTS: Readonly<{
     trajectoryBackendLabel: "read-only";
     subscribe: "subscribe";
 }>;
-export declare const CHANNEL_UI_PROPERTIES: readonly ["version", "rows", "status", "sessionTitle", "sessionColor", "agentId", "sessionId", "agentBindingGeneration", "sessionRef", "backendCapabilities", "costReport", "rateLimit", "olderHistory", "autoRecapOnOpen", "settingsNamespace", "model", "provider", "configuredProvider", "configuredModel", "configuredPreset", "configuredActivityFrames", "configuredLang", "tokens", "mainCost", "subagentCost", "cwd", "displayCwd", "gitBranch", "working", "compaction", "cancelPending", "spinnerMode", "responseChars", "activeToolCount", "turnStart", "lastUserText", "notifications", "contextWindow", "reasoningEffort", "effortLevels", "lastUsage", "turnUsage", "contextOccupancy", "tps", "tpsSamples", "activityFrames", "diffLayout", "thinkingFold", "jobGroupFold", "toolBackground", "scrollGutter", "pageMargin", "foldTerminalCommand", "turnUsageRow", "promptSessionLabel", "expandEditor", "smoothStreaming", "statusBar", "whale", "whaleIdle", "splashFont", "brand", "whaleGirl", "minimalUi", "minimal", "activityEnabled", "contextBarEnabled", "goal", "todos", "loadedContext", "pending", "commandList", "pluginScene", "contextSegments", "subagents", "subagentControl", "backgroundJobs", "jobControl", "mode", "modeIndex", "modelDisplay", "agentPreset", "selection", "attachedContexts"];
+export declare const CHANNEL_UI_PROPERTIES: readonly ["version", "ready", "startupFailure", "rows", "status", "sessionTitle", "sessionColor", "agentId", "sessionId", "agentBindingGeneration", "sessionRef", "backendCapabilities", "costReport", "rateLimit", "olderHistory", "autoRecapOnOpen", "settingsNamespace", "model", "provider", "configuredProvider", "configuredModel", "configuredPreset", "configuredActivityFrames", "configuredLang", "tokens", "mainCost", "subagentCost", "cwd", "displayCwd", "gitBranch", "working", "compaction", "cancelPending", "spinnerMode", "responseChars", "activeToolCount", "turnStart", "lastUserText", "notifications", "contextWindow", "reasoningEffort", "effortLevels", "lastUsage", "turnUsage", "contextOccupancy", "contextBreakdown", "tps", "tpsSamples", "activityFrames", "diffLayout", "thinkingFold", "jobGroupFold", "toolBackground", "scrollGutter", "pageMargin", "foldTerminalCommand", "turnUsageRow", "promptSessionLabel", "expandEditor", "smoothStreaming", "statusBar", "whale", "whaleIdle", "splashFont", "brand", "whaleGirl", "minimalUi", "minimal", "activityEnabled", "contextBarEnabled", "goal", "todos", "loadedContext", "pending", "commandList", "pluginScene", "contextSegments", "subagents", "subagentControl", "backgroundJobs", "jobControl", "mode", "modeIndex", "modelDisplay", "agentPreset", "selection", "attachedContexts"];
 //# sourceMappingURL=ui-policy.d.ts.map

package/lib/types/adapter/channel/ui-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-policy.d.ts","sourceRoot":"","sources":["../../../../src/adapter/channel/ui-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAIvD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAC3C,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,GACjG,eAAe,GAAG,wBAAwB,GAAG,uBAAuB,GACpE,iBAAiB,GAAG,oBAAoB,GAAG,cAAc,GAAG,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,eAAe,GAAG,UAAU,CAC1K,CAAA;AACD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2I4B,CAAA;AAE3D,eAAO,MAAM,qBAAqB,swCAsFe,CAAA"}
+{"version":3,"file":"ui-policy.d.ts","sourceRoot":"","sources":["../../../../src/adapter/channel/ui-policy.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAIvD,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,SAAS,EAC3C,eAAe,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,iBAAiB,GACjG,eAAe,GAAG,wBAAwB,GAAG,uBAAuB,GACpE,iBAAiB,GAAG,oBAAoB,GAAG,cAAc,GAAG,UAAU,GAAG,cAAc,GAAG,cAAc,GAAG,cAAc,GAAG,YAAY,GAAG,eAAe,GAAG,UAAU,CAC1K,CAAA;AACD,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2I4B,CAAA;AAE3D,eAAO,MAAM,qBAAqB,qzCAyFe,CAAA"}