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

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

@@ -11,7 +11,7 @@ dsh-TUI provides three Gentle Mist Blue palettes, plus an `auto` pseudo-theme:
 | `auto` | Pseudo-theme: follows the system/terminal background, resolving to `light` or `dark` |
 | `light` | White panels, ink body text, and mist-blue interaction color |
 | `dark` | Dark-terminal adaptation with warm-gray text and soft blue accents |
-| `dark-ansi` | Compatibility fallback using only the 16 ANSI colors |
+| `dark-ansi` | Compatibility fallback using only the 16 ANSI colors (except the ignition pair) |
 
 Without an explicit choice, the TUI queries the terminal background with OSC
 11 and selects `light` or `dark`. It falls back to `dark` when the terminal
@@ -52,7 +52,7 @@ DSH_TUI_THEME
   diff and tool-card colors before Enter applies anything. Narrower terminals
   stack the preview under the list, and it yields entirely when the height
   budget is short — the list and its focused row always stay visible.
-- `/theme <name>` switches directly to a static or runtime plugin theme.
+- `/theme <name>` switches directly to a built-in, static JSON, or runtime plugin theme.
 - `/theme status` shows the current theme and persistence location.
 
 Confirming a choice hot-switches immediately and writes it to
@@ -110,6 +110,8 @@ Available color keys by purpose:
 - Diff syntax highlighting: `syntaxKeyword`, `syntaxString`, `syntaxComment`, `syntaxNumber`, `syntaxFunction`, `syntaxType`
 - Diff syntax highlighting (cont.): `syntaxVariable`, `syntaxOperator`, `syntaxPunctuation`, `syntaxConstant`
 - Badges/accents: `mascotBody`, `inputBackground`, `professionalBlue`, `chromeYellow`
+- Animated chrome & caret: `contextBarSystem`, `contextBarPrompt`, `contextBarAssistant`
+- Animated chrome & caret (cont.): `contextBarThinking`, `contextBarTools`, `ignition`, `ignitionDim`, `cursor`
 - Messages & input: `userMessageBackground`, `userMessageBackgroundHover`, `messageActionsBackground`, `selectionBg`, `bashMessageBackgroundColor`
 - Messages & input (cont.): `memoryBackgroundColor`, `rate_limit_fill`, `rate_limit_empty`, `fastMode`, `fastModeShimmer`, `userPromptLabel`
 - Subagent messages: `subagentBullet`, `subagentDescription`, `subagentModel`, `subagentElapsed`, `subagentToolName`, `subagentStatusRunning`
@@ -118,6 +120,26 @@ Available color keys by purpose:
 When the file declares `name`, its filename remains a loading alias. See the
 `Theme` type in [`src/theme.ts`](../src/theme.ts) for every color key.
 
+A few keys carry behavior worth knowing:
+
+- `contextBarSystem` … `contextBarTools`: the context progress bar's five segment fills, in bar
+  order (system → prompt → assistant → thinking → tools). Static JSON and plugin themes inherit
+  all five from the `base` they pick; only a legacy resolver's key-less palette keeps the old ramp.
+- `ignition` / `ignitionDim`: the top reasoning tier's ignition colors — the sweep waveform, the
+  `❯` prefix and the tier badge all read the same pair, and `ignitionDim` is the substrate the
+  wave fades into. The wave emits per-column truecolor SGR, so these two want a form with fixed
+  channels (`#rgb`, `#rrggbb`, `#rrggbbaa` with the alpha ignored, or `rgb(r,g,b)`); `ansi:*` /
+  `ansi256(n)` — or a missing key — falls back **per key** to the built-in pair selected by the
+  palette's lightness, so the other key is unaffected.
+- `cursor`: the caret fill in the main prompt, launchpad input and picker search boxes.
+  The glyph on it is whichever of `text` / `inverseText`
+  contrasts better with that fill (a 16-color `ansi:*` fill, or a palette whose `text`/`inverseText`
+  has no parseable channels, cannot be measured and keeps `inverseText`), so a light caret can still
+  carry dark ink. The built-ins leave it empty — empty
+  keeps the inverse-video caret for backwards compatibility; declare it only when the caret must
+  stop following the body text color.
+- Transcript link text follows `accent`; an empty or unparseable accent keeps the old fixed blue.
+
 ## npm plugin themes
 
 An npm plugin registers a runtime theme through the `tuiThemes` service,

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

@@ -11,7 +11,7 @@ dsh-TUI 提供三套 Gentle Mist Blue 色板，外加一个 `auto` 伪主题：
 | `auto` | 伪主题：跟随系统/终端背景，自动解析为 `light` 或 `dark` |
 | `light` | 白色面板、墨色正文、雾蓝交互色 |
 | `dark` | 深色终端适配，暖灰正文与柔雾蓝强调色 |
-| `dark-ansi` | 只依赖 16 色 ANSI 的兼容回退 |
+| `dark-ansi` | 只依赖 16 色 ANSI 的兼容回退（点火色对除外） |
 
 未明确指定主题时，TUI 通过 OSC 11 查询终端背景，
 在 `light` 与 `dark` 之间选择；终端不响应时回退到 `dark`。
@@ -45,7 +45,7 @@ DSH_TUI_THEME
   用**焦点行**主题的调色板实渲染代码块、代码操作工具卡与 diff——移动光标即可
   比较语法色、diff 色与工具卡底色，Enter 才真正应用；窄终端预览堆叠在列表
   下方，浮层高度不够时整块让位，列表与焦点行始终完整。
-- `/theme <name>`：直接切换静态或运行时插件主题。
+- `/theme <name>`：直接切换内置、静态 JSON 或运行时插件主题。
 - `/theme status`：显示当前主题与持久化位置。
 
 选择器确认后立即热切换，并把选择写入 `~/.dsh-tui/theme.json`。
@@ -107,6 +107,8 @@ DSH_TUI_THEME
 - diff 语法高亮（续）：`syntaxFunction`、`syntaxType`、`syntaxVariable`、`syntaxOperator`
 - diff 语法高亮（续）：`syntaxPunctuation`、`syntaxConstant`
 - 徽标/强调：`mascotBody`、`inputBackground`、`professionalBlue`、`chromeYellow`
+- 界面动画与光标：`contextBarSystem`、`contextBarPrompt`、`contextBarAssistant`
+- 界面动画与光标（续）：`contextBarThinking`、`contextBarTools`、`ignition`、`ignitionDim`、`cursor`
 - 消息/输入：`userMessageBackground`、`userMessageBackgroundHover`
 - 消息/输入（续）：`messageActionsBackground`、`selectionBg`、`bashMessageBackgroundColor`
 - 消息/输入（续）：`memoryBackgroundColor`、`rate_limit_fill`、`rate_limit_empty`
@@ -118,6 +120,23 @@ DSH_TUI_THEME
 如果文件声明了 `name`，文件名仍可作为加载别名。完整颜色键见
 [`src/theme.ts`](../src/theme.ts) 中的 `Theme` 类型。
 
+几条键的语义与默认行为：
+
+- `contextBarSystem` … `contextBarTools`：上下文进度条的五个分段填充色，按条上顺序
+  （system → prompt → assistant → thinking → tools）。静态 JSON 与插件主题都从所选
+  `base` 继承这五个键；只有旧运行时解析器直接返回、缺键的色板才沿用写死的深蓝坡道。
+- `ignition` / `ignitionDim`：最高思考强度档的点火动画用色——扫光波形、`❯` 前缀与档位徽标
+  同源，`ignitionDim` 是波形淡出的本底色。波形逐列输出真彩色 SGR，所以这两个键要写成能解析
+  出固定通道的形式（`#rgb`、`#rrggbb`、`#rrggbbaa`（alpha 会被忽略）或 `rgb(r,g,b)`）；
+  写成 `ansi:*` / `ansi256(n)`（或整键缺失）时**逐键**回退到按主题明暗选定的内置点火色对，
+  另一个键不受牵连。
+- `cursor`：主输入框、落地页输入框及选择器搜索框光标的填充色。
+  块上的字形取 `text` 与 `inverseText` 中对该填充对比度更高
+  的一个（16 色的 `ansi:*` 填充，或 `text`/`inverseText` 解析不出通道的调色板，
+  都量不出对比度，仍用 `inverseText`），所以浅色光标也能配深墨字形。
+  内置主题留空——空值表示沿用原来的反色块光标（向后兼容）；只有需要光标独立于正文色时才声明。
+- 正文链接的文字色跟随 `accent`；accent 为空或解析不出时回落到原来的固定蓝。
+
 ## npm 插件主题
 
 npm 插件通过 `tuiThemes` 服务注册运行时主题，不必写入

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

@@ -48,19 +48,26 @@ 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
-   (type your first sentence here; Enter carries it into the chat screen), and a row of
-   **quick actions** (v7 four slots: `Continue "…"` — shortcut `Alt+R`, the slot is simply absent
-   when there is nothing to continue · `Sessions & workspaces` — history and workspaces are the
-   same `/home` screen, merged into one entry · `Settings` · a **conditional slot** — `Background
-   jobs` while jobs are running, `Update available` when a newer release is detected, `Feed us a
-   star` once usage milestones are reached and you never starred, falling back to `Help`).
-   Move with `↑/↓` or `Tab`, activate with `Enter`, or just click;
-   short terminals drop whole blocks (quick actions → hint line → input only) and narrow ones
-   climb down the ladder in 5.1. Full screens opened from this screen (sessions & workspaces /
-   settings / background jobs / the first-run guide) 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. When the dsh engine is out of the verified range, a
-   **⚠ version-drift warning** appears with the align command.
+   (type your first sentence here; Enter carries it into the chat screen), a **parameter row** under
+   the box (model · effort · mode · permission — all four are clickable and open the chat page's
+   pickers in place; all four stay on the row, and when the line does not fit only the over-long
+   segments are truncated at the tail with a trailing `…` — the permission segment is never
+   truncated — and a hover reveals a truncated segment's **full name** (mouse tracking is always on
+   for the launchpad screen, inline mode included); only when the **full permission name does not
+   fit the budget** (widening the terminal past 76 columns changes nothing — a narrower terminal
+   or a longer permission name triggers it earlier) are whole segments dropped from the tail in
+   display order), and a row of **quick actions** (v7 four slots: `Continue "…"` — shortcut `Alt+R`,
+   the slot is simply absent when there is nothing to continue · `Sessions & workspaces` — history
+   and workspaces are the same `/home` screen, merged into one entry · `Settings` · a **conditional
+   slot** — `Background jobs` while jobs are running, `Update available` when a newer release is
+   detected, `Feed us a star` once usage milestones are reached and you never starred, falling back
+   to `Help`). Move with `↑/↓` or `Tab`, activate with `Enter`, or just click; short terminals drop
+   whole blocks (quick actions → hint line → input only) and narrow ones climb down the ladder in
+   5.1. Full screens opened from this screen (sessions & workspaces / settings / background jobs /
+   the first-run guide) 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. When the dsh engine is out of the verified range, a **⚠
+   version-drift warning** appears with the align command.
 3. **Bottom status bar**: working-status row, context bar, TPS gauge, and other live
    indicators (see [5. UI and status bar](#5-ui-and-status-bar)).
 4. **Startup hint line**: one fixed line under the logo:
@@ -88,7 +95,7 @@ dsh-tui
 
 | Key | Action |
 |---|---|
-| `Enter` | idle = send; **model working = steer** (inject a next-step boundary, no interrupt); menu open = confirm selection |
+| `Enter` | idle = send; **a known `/` command (with or without arguments) = run that command** (its own gate decides while a turn is running); model working = steer (inject a next-step boundary, no interrupt); menu open = confirm selection |
 | `Tab` | complete `/` command or `@` file; **model working = follow-up** (queue after the current turn) |
 | `Ctrl+Enter` (⌘Enter) | interrupt the current turn and send the input now |
 | `Shift+Enter` / `Ctrl+J` | newline (`Option+Enter` is the mac Terminal.app fallback) |
@@ -96,6 +103,8 @@ dsh-tui
 | `Esc` (working + pending) | interrupt the turn and re-send the pending message now |
 | `/btw …` while working | Enter runs it directly (side question never interrupts the main turn) |
 
+While a turn is running, the `/` overlay groups commands by their impact on the current conversation: the harmless ones stay on top in their normal style, while commands that are gated, interrupt or replace the conversation, or steer into it sink to the bottom in the theme's grey (`subtle`), with no extra header row. The grey region never blocks use — the gate still gates and the steer still steers. Only two kinds of input steer into the running turn: text that is not a command, and a **direct skill gesture** (`/skill-name …`), which the overlay groups as steering as well.
+
 ### 2.2 Interrupt / exit / system
 
 | Key | Action |
@@ -267,16 +276,16 @@ one-column seam between the two surfaces.
   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.
-- **Panels**: `todo` (Goals/Todos — with a split it moves here from above the input), `jobs`
+- **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`
-  (the pet — off by default; add `companion` to `sidePanel.panels` to enable: its mood follows
+  (the pet — its mood follows
   the session, click for a heart, Enter to poke; the `dsh-tui.companion.skin` setting offers
   deepy (default, the fan-made deepy whale kit) or whale), `info` (model, effort, mode,
   permissions, context usage, cache hit, tokens, TPS, spend, working dir, session title and id),
   `trajectory` (the session's wake band + ledger + inspector: ↑/↓ select, Enter expands, Tab
   switches to the hotspot view — ←/→ always stay the host's panel-cycling keys), `workspace`
-  (working-directory overview; Enter opens the full workspace home).
+  (working-directory overview; Enter opens the full workspace home), `btw` (follow-up threads, also opened by `/btw`).
 - **Pet (companion) details**: the pet sits at the BOTTOM of the panel with a status area above
   it (mood · subagent/session counts · current animation). Interactions: clicking its left/right
   half pokes it (poke-left/right), three rapid clicks tickle it, **holding and dragging walks it
@@ -300,7 +309,7 @@ one-column seam between the two surfaces.
 | `/panel toggle` | Really open / really close (closing returns focus to the chat) |
 | `/panel focus` | Open and focus the panel |
 | `/panel zoom` | Open and zoom the active panel |
-| `/panel <id>` | Open a panel by id: `todo` / `info` / `trajectory` / `jobs` / `agents` / `workspace` / `companion` (completion lists the enabled ids) |
+| `/panel <id>` | Open a panel by id: `todo` / `info` / `trajectory` / `jobs` / `agents` / `workspace` / `btw` / `companion` (completion lists the enabled ids) |
 
 - Views that used to be full-screen-only now also live in the sidebar: with the split up and the
   matching panel enabled, `Ctrl+T` / `/trace` open the trajectory panel and `/home` opens the
@@ -323,11 +332,12 @@ The command menu = built-in commands (58, aliases included) + DSH registry comma
 | Command | Args | Effect |
 |---|---|---|
 | `/new` | none | start a new session (no confirmation; the old session stays under `/resume`) |
-| `/resume` | none | open the **session manager** (workspace + session columns, live filter, pins, cross-workspace): switching just parks the session, the running turn keeps going |
+| `/resume` | none | open the **session manager** (workspace + session columns, live filter, pins, cross-workspace): switching just **parks** the outgoing session — it keeps running in the background and the active turn is not interrupted (like `/tree`: neither browsing nor switching cuts a running turn short; on the Claude backend a mid-turn switch is refused instead) |
 | `/home` / `/agentview` / `/bg` | none | the same session manager (`/home`=workspace view · `/agentview`=hosted session state · `/bg`=send to background and open, alias `/background`) |
 | `/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) |
 | `/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 |
@@ -336,7 +346,7 @@ The command menu = built-in commands (58, aliases included) + DSH registry comma
 | `/export` | none | export the session as Markdown to the working directory |
 | `/btw` | `<问题>` | side question: single turn, no tools, doesn't interrupt the main turn, not written to history |
 | `/trace` | none | open the trace scene (same as `Ctrl+T`) |
-| `/rewind` | none | rewind selector (same as double-press Esc on empty input) |
+| `/rewind` | none | rewind selector (same as double-press Esc on empty input); **a running turn is cancelled first** |
 | `/exit` (alias `/quit` `/q`) | none | exit dsh-tui |
 
 ### 3.2 Status and diagnostics
@@ -361,6 +371,7 @@ 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) |
 | `/thinking` | none | extended-thinking display toggle (thinking expands item by item while streaming) |
@@ -440,7 +451,7 @@ Command-line resume: `dsh-tui --resume` (last session) / `dsh-tui --resume <id>`
 ### 4.3 Message delivery semantics (while the model is working)
 
 Keys are in §2.1:
-- `Enter` = **steer** (inject a next-step boundary, no interrupt)
+- `Enter` = a known `/` command (with or without arguments) runs as a command (its own gate decides while a turn is running); anything else **steers** (inject a next-step boundary, no interrupt)
 - `Tab` = **follow-up** (queue after the turn)
 - `Ctrl+Enter` = **interrupt** (interrupt and send)
 - `Alt+Up` bring the last unhandled message back
@@ -495,7 +506,7 @@ Keys are in §2.7. Key points:
   (open and start a new session).
 - `dsh-tui <路径>` also accepts a workspace target.
 - `/doctor` check: Node/platform, API key, model routing, cwd, context window, session storage, plugin host.
-- `/provider` interactive wizard to manage model providers: add / edit / delete.
+- `/provider` interactive wizard to manage model providers: add / edit / delete. Focus a model and press `Tab` to edit its context window, max output tokens, reasoning efforts, and image input; `Enter` saves to the provider draft, and cancelling the outer wizard leaves it unwritten.
   - The standard profile's built-in OAuth module offers **subscription sign-in** (ChatGPT/Codex / Claude / Grok; OpenAI direct / Meta Muse on newer pi-ai, no API key); `/auth login <provider>` also signs in, and `/auth logout <provider>` removes the stored OAuth credential.
   - DSH 0.2.0-rc.1+ delegates DeepSeek account browser authorization to the Host: run `/auth login deepseek-account`, then select the separate `deepseek-account` route with `/model`; `/auth logout deepseek-account` delegates sign-out to the Host. It does not change the `deepseek-official` API key.
 - Non-env-variable API keys are written to `~/.dsh/.credentials.yaml` (0600), and the UI shows only `••••••`; pi-ai subscription OAuth credentials instead live in `$DSH_HOME/dsh-auth/credentials.json` (`~/.dsh/dsh-auth/credentials.json` when DSH_HOME is unset). The Host credential service owns DeepSeek account grants; they are not written to that OAuth file.
@@ -584,16 +595,20 @@ Common items below, full list on the /settings screen. Most topics (**Appearance
 | 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 |
+| codeFrameStyle | code-frame shape (default `light`): `light` uses an open left rail; `full` adds a continuous right wall and bottom edge. Very narrow terminals show a plain code fence. Applies immediately |
 | 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 |
 | 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 |
+| btw.contextTurns | Number of most recent completed Q/A pairs explicitly carried into a `/btw` follow-up (default 4, range 1-8); older pairs stay in the thread and panel but are omitted from the request. Applies immediately |
 | jobGroupFold | consecutive background-job cards: auto (default — runs of 2+ group, a settled run of 3+ folds into its summary line) / always (any run of 2+ folds right away, live jobs included) / never (never folds on its own, every card stays). The group header summarizes status and total time; click it or press Ctrl+O to expand |
 | effortDefault | default reasoning effort: auto / off / low / high / max. Start level for new sessions (details below) |
 | smoothStreaming | smooth streaming output (default on): replies/thinking/tool-card text reveal at ~30fps; replay/history always direct |
 | toolBackground | tool-card background emphasis: none / subtle / strong |
+| turnUsageRow | Turn-usage row (default off): show a per-turn summary of tokens, cache, duration and retries; `/tokens`, `/status` and the footer token hover are unaffected |
 | mermaidDiagrams | Mermaid diagrams (default on): ```` ```mermaid ```` blocks render as character diagrams, forming while streaming; too-wide or unsupported types keep source with the required columns. Applies immediately |
 | mathRendering | LaTeX math (default `auto`; lives on the **Formula** subpage of `/settings`): how `$…$` / `\(…\)` inline and `$$…$$` / `\[…\]` / bare display-environment (`\begin{align}` …) block formulas in replies show. `auto` uses the best available renderer (today Unicode text, with fractions and limits stacked in blocks), `image` typesets formulas with MathJax as terminal images when the terminal has graphics — the Kitty graphics protocol (Kitty, Ghostty, WezTerm, iTerm2…) or Sixel (Windows Terminal 1.22+, xterm, foot, WezTerm) — in the theme's text color (block formulas up to 16 rows; inline formulas as one-row images when a single row can hold them legibly; still-streaming formulas, dimmed thinking, terminals without graphics, formulas too small on one row, and any render failure fall back to Unicode), `unicode` pins Unicode text, `source` keeps the TeX. Unsupported, still-streaming, or too-wide formulas keep their source (a too-wide block first falls back to one line). Prices (`$5`), shell variables (`$HOME`), and `$` in code are left alone. The older `latexMath: false` still means `source`. **Click a formula image** to open the preview card: it re-typesets at twice the cell size, zooms 100–800%, pans, closes on `Esc` or a click outside, and titles itself with the formula's TeX. On Sixel the formulas carry **no backing** (only their strokes), so the terminal background or wallpaper shows through. Illustrations that ship with their own transparent margins — the `whaleGirl` raster — float the same way; photographs, screenshots, and images inside cards still composite onto a colour, because Sixel cannot express soft alpha. Applies immediately |
 | mathImageScale | formula image size (default `auto`; same **Formula** subpage), used with LaTeX math → Image: `auto` matches the body text, `large` / `xlarge` set **display** formulas bigger. Terminal images are drawn one device pixel per pixel, so "bigger" literally means more pixels per stroke — the only sharpness lever there is. Inline formulas are unaffected (they must fit one row). Applies immediately |
@@ -686,7 +701,7 @@ When dsh exits unexpectedly, safe mode gives a **read-only** environment diagnos
 
 **Efficiency**
 
-4. Three deliveries while the model works: `Enter` inject a next step, `Tab` queue, `Ctrl+Enter` interrupt and send.
+4. Three deliveries while the model works: `Enter` inject a next step (a known `/` command runs as a command instead), `Tab` queue, `Ctrl+Enter` interrupt and send.
 5. `Alt+Up` brings the last unhandled message back to edit and resend, no retyping.
 6. A quick question without interrupting the main turn or writing history:
    `/btw <问题>`.

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

@@ -45,7 +45,10 @@ dsh-tui
    `DEEPSEEK / HARNESS` 大字、当前模型与 effort、工作目录，及一行**启动提示**；
    这一屏的头部**直接定格**——开场动画留给进入对话后的转录区顶部），
    下面是一个**真输入框**（第一句话在这里打，**回车直接发送**）与框下一行**参数行**
-   （模型 · 思考深度 · 模式 · 权限——四段都可点，点开对话页同款选择器就地换值），
+   （模型 · 思考深度 · 模式 · 权限——四段都可点，点开对话页同款选择器就地换值；四段常在，
+   一行装不下时只把超长的段截尾成 `前缀…`（权限段不截断），悬停被截断的段可看**完整名**
+   （落地页这一屏恒启用鼠标跟踪，inline 模式下也是）；其余各段压到下限后**完整权限名放不进预算**时
+   （终端 ≥76 列后，再宽也不改变结果；更窄的终端或更长的权限名都会更早触发）才回落到按显示顺序从尾部整段省掉），
    隔一行留白再一行**快捷入口**（第七版四格：`继续「…」`（快捷键 `Alt+R`，没有可继续会话时整格不画）·
    `会话与工作区`（历史会话与工作区本就是 `/home` 同一个界面，合并成一个入口）· `设置` ·
    **条件位**——有后台任务在跑显 `后台任务`、检测到新版本显 `有新版本`、用量到档且没 star 过显
@@ -80,7 +83,7 @@ dsh-tui
 
 | 键 | 功能 |
 |---|---|
-| `Enter` | 空闲=发送；**模型工作时=steer**（注入下一步边界，不中断）；菜单打开=确认选中项 |
+| `Enter` | 空闲=发送；**已知 `/` 命令（可带参数）=执行该命令**（回合运行中由命令自己的门禁裁决）；模型工作时=steer（注入下一步边界，不中断）；菜单打开=确认选中项 |
 | `Tab` | 补全 `/` 命令或 `@` 文件；**模型工作时=follow-up**（排入当前回合之后） |
 | `Ctrl+Enter`（⌘Enter） | 打断当前回合并立即发送输入 |
 | `Shift+Enter` / `Ctrl+J` | 换行（`Option+Enter` 是 mac Terminal.app 的兜底） |
@@ -88,6 +91,8 @@ dsh-tui
 | `Esc`（工作 + 有 pending） | 中断回合并立即重投 pending 消息 |
 | 工作中的 `/btw …` | Enter 直接执行（侧问永不打断主回合） |
 
+回合运行中的 `/` 浮窗按「对当前对话的影响」分区：不影响的命令在上（原样式），会被门禁拦下 / 会打断或替换对话 / 会 steer 的沉到下方、整行变灰（`subtle`，不额外插标题行）。灰区不阻止使用：选中执行后该门禁的门禁、该 steer 的 steer。回合运行中只有两种输入会加塞：不构成命令的普通文本，以及**直接调用技能**的手势（`/技能名 …`，浮窗里同样按「会 steer」沉到灰区）。
+
 ### 2.2 中断 / 退出 / 系统
 
 | 键 | 功能 |
@@ -247,14 +252,14 @@ dsh-tui
   面板没吃下的键不会再落到聊天，但 `Ctrl+C`/`Ctrl+D`/`Ctrl+L` 等 Ctrl 组合照旧作用于聊天。
 - **鼠标**：点聊天栏把焦点给聊天，点右栏把焦点给面板；点标签栏上的标签直接切到那个面板（悬停会高亮），
   点右端的 `⤢` 把当前面板放大成整屏；右栏不参与拖拽选字。
-- **面板**：`todo`（Goals/Todos，分栏时从输入框上方迁到这里）、`jobs`（后台任务，点转录里的任务卡
+- **面板**：全部 8 个内置面板默认启用，可在 `sidePanel.panels` 调整。`todo`（Goals/Todos，分栏时从输入框上方迁到这里）、`jobs`（后台任务，点转录里的任务卡
   会直接定位到该任务）、`agents`（子代理 Dashboard 与详情：Enter 进详情、Esc 逐级返回）、`companion`
-   （宠物，默认不启用——在 `sidePanel.panels` 加入 `companion` 开启：跟随会话状态换心情动画，点击
+   （宠物：跟随会话状态换心情动画，点击
    比爱心、Enter 戳一戳；皮肤 `dsh-tui.companion.skin` 可选 deepy（默认，非官方粉丝作品 deepy
    小鲸鱼）或 whale）、`info`（信息栏：模型 / 思考深度 / 工作模式 / 权限 / 上下文占用 / 缓存命中 /
   Token / TPS / 消耗 / 工作目录 / 会话标题与 ID）、`trajectory`（会话轨迹：唤醒带 + 账本 + 检视器，
   ↑/↓ 选择、Enter 展开、Tab 切热点视图；←/→ 恒归侧栏切面板，Tab 才是切视图）、`workspace`
-  （工作目录/工作区总览，Enter 打开整屏工作区主页）。
+  （工作目录/工作区总览，Enter 打开整屏工作区主页）、`btw`（追问线程，可从 `/btw` 进入）。
 - **宠物（companion）细节**：宠物锚在面板**底部**，上方是状态区（心情 · 子代理/会话计数 · 当前动作）。
   互动：点它左半/右半会被戳（poke-left/right）、短窗口连点三次是挠痒（tickle）、**按住拖动它就跟着
   指针在整个面板里走（松手弹回底部）**、鼠标悬停它会看向指针；Enter 也算戳一戳。后台任务完成、已打断
@@ -273,7 +278,7 @@ dsh-tui
 | `/panel toggle` | 真开 / 真关（关闭时焦点回聊天） |
 | `/panel focus` | 打开并聚焦右栏 |
 | `/panel zoom` | 打开并缩放当前面板 |
-| `/panel <id>` | 打开指定面板：`todo` / `info` / `trajectory` / `jobs` / `agents` / `workspace` / `companion`（补全列出已启用的 id） |
+| `/panel <id>` | 打开指定面板：`todo` / `info` / `trajectory` / `jobs` / `agents` / `workspace` / `btw` / `companion`（补全列出已启用的 id） |
 
 - 原本只能整屏的视图现在也能进侧栏：分屏开着且对应面板已启用时，`Ctrl+T` / `/trace` 打开轨迹面板、
   `/home` 打开工作区面板；面板栏右端的 `⤢` 再把它们放回整屏（`⤢` 是鼠标入口，键盘等价物就是各自的
@@ -293,11 +298,12 @@ dsh-tui
 | 命令 | 参数 | 作用 |
 |---|---|---|
 | `/new` | 无 | 新开会话（无二次确认；旧会话可 `/resume` 恢复） |
-| `/resume` | 无 | 打开**会话管理界面**（工作区栏 + 会话栏、实时筛选、固定常用、跨工作区）：切换会话只是**停放**，正在跑的回合不中断 |
+| `/resume` | 无 | 打开**会话管理界面**（工作区栏 + 会话栏、实时筛选、固定常用、跨工作区）：切换会话只是**停放**，旧会话转后台继续跑，正在跑的回合不中断（与 `/tree` 同类：浏览与切换都不打断当前回合；仅 Claude 后端例外，回合运行中切换会被拒绝） |
 | `/home` / `/agentview` / `/bg` | 无 | 同一个会话管理界面（`/home`=工作区视角 · `/agentview`=托管会话状态 · `/bg`=转后台并打开，别名 `/background`） |
 | `/tree` | 无 | 会话分叉树：悬停预览、点击回退 / 分叉 / 切换分支 |
 | `/fork` | 无 | 把当前会话复制成可恢复的副本（原会话不受影响） |
 | `/restart` | 无 | 重启进程并恢复本会话（回合运行中会被拒绝，先 `Ctrl+C`） |
+| `/kernel` | 无 | 内核选择器：在 DSH 与实验性的 Claude 后端之间切换，记住选择并重启进入新会话（回合运行中会被拒绝）；见 [Claude 后端](claude-backend.md) |
 | `/rename` | `<新名称>` | 重命名当前会话（无参时显示当前标题与用法） |
 | `/recap` | 无 | 最近活动摘要（一行）+ 建议标题；面板内 `a` 键或点击一键应用标题。设置 `dsh-tui.recapOnOpen`（默认开）开启时，打开/恢复会话自动在底部显示一条分隔线 + `回顾：` 摘要行，悬停可查看操作、点击展开，发送新消息后自动消失 |
 | `/workspace` | `resume` / `rename <名称>` / `open <路径或URI>` | 管理工作区；`open` 支持绝对路径、file URI、插件 scheme |
@@ -306,7 +312,7 @@ dsh-tui
 | `/export` | 无 | 导出会话为 Markdown 到工作目录 |
 | `/btw` | `<问题>` | 侧问：单轮、无工具、不打断主回合、不写历史 |
 | `/trace` | 无 | 打开轨迹场景（同 `Ctrl+T`） |
-| `/rewind` | 无 | 回退选择器（同空输入双击 Esc 的时间回溯） |
+| `/rewind` | 无 | 回退选择器（同空输入双击 Esc 的时间回溯）；**回合运行中会先取消当前回合**再回溯 |
 | `/exit`（别名 `/quit` `/q`） | 无 | 退出 dsh-tui |
 
 ### 3.2 状态与诊断
@@ -331,6 +337,7 @@ dsh-tui
 
 | 命令 | 参数 | 作用 |
 |---|---|---|
+| `/channel` | 无 | 中转渠道档案（仅 Claude 后端）；**回合运行中导入 / 新建 / 管理，以及需要重启进程的切换会被拒绝**（选择器本身仍可打开），见 [交互与命令](interaction.md#渠道档案channel仅-claude) |
 | `/model` | 无 | 模型选择器；**切换 = fork 会话续聊**（历史保留、仅换路由；还没有人说过话的会话不记分支，保留首个 prompt 的自动标题），选择持久化到 `~/.dsh-tui/model.json` |
 | `/effort` | `status` / `<id>` | 推理强度：无参滑杆（`←/→` 实时调整）；`status` 当前档位；`<id>` 直接设定。持久化 `~/.dsh-tui/effort.json`；新会话起始档看 /settings 的 `effortDefault`（§5.3） |
 | `/thinking` | 无 | 扩展思考显示开关（流式时思考逐条展开） |
@@ -410,7 +417,7 @@ dsh-TUI 不预装通用技能；`/skills` 浏览 DSH 发现的技能，可直调
 ### 4.3 消息投递语义（模型工作中）
 
 键位见 §2.1：
-- `Enter` = **steer**（注入下一步边界，不中断）
+- `Enter` = 已知 `/` 命令（可带参数）按命令执行（回合运行中由该命令自己的门禁裁决）；其余文本 **steer**（注入下一步边界，不中断）
 - `Tab` = **follow-up**（排到回合后）
 - `Ctrl+Enter` = **interrupt**（打断并发送）
 - `Alt+Up` 取回最后一条未处理消息
@@ -461,7 +468,7 @@ dsh-TUI 不预装通用技能；`/skills` 浏览 DSH 发现的技能，可直调
 - `/workspace`：`resume` / `rename <名>` / `open <路径|file:// URI>`（打开并新建会话）。
 - `dsh-tui <路径>` 同样接受工作区目标。
 - `/doctor` 自检：Node/平台、API key、模型路由、cwd、上下文窗口、会话存储、插件宿主。
-- `/provider` 交互向导管理模型提供方：添加 / 编辑 / 删除。
+- `/provider` 交互向导管理模型提供方：添加 / 编辑 / 删除。在模型列表聚焦一项后按 `Tab`，可编辑其上下文窗口、最大输出 token、推理档位和图片输入能力；`Enter` 保存到本次 provider 草稿，取消外层向导不会写入。
   - 标准 profile 的内置 OAuth 模块提供 **订阅账号登录**（ChatGPT/Codex / Claude / Grok；较新 pi-ai 另有 OpenAI 直连 / Meta Muse，免 API key）；也可用 `/auth login <provider>`，`/auth logout <provider>` 删除保存的 OAuth 凭据。
   - DSH 0.2.0-rc.1+ 的 DeepSeek 账号经宿主浏览器授权：`/auth login deepseek-account`，随后用 `/model` 选独立的 `deepseek-account` 路由；`/auth logout deepseek-account` 由宿主退登。它不修改 `deepseek-official` 的 API key。
 - 非环境变量 API key 写入 `~/.dsh/.credentials.yaml`（0600），界面只显示 `••••••`；pi-ai 订阅 OAuth 凭据另存于 `$DSH_HOME/dsh-auth/credentials.json`（未设置 DSH_HOME 时为 `~/.dsh/dsh-auth/credentials.json`）。DeepSeek 账号授权记录由宿主凭据服务持有，不写入此 OAuth 文件。
@@ -541,16 +548,20 @@ dsh-tui 自身区块在 0.1.7 写入当前 profile 的 `cordis.patch.yml`，旧
 | minimal | 极简界面 Minimal UI（默认关）：隐藏开屏头部、emoji 状态符与装饰性配色，底栏只留模型与目录；代码高亮与工具配色保留。**这是界面开关**，对模型能力没有任何影响——别和 `/preset` 的内核「极简模式」预设搞混 |
 | terminalImages | 终端图片预览（默认开，需终端支持）；保存后用 `/restart` 生效。关闭后只显示文字信息并跳过预览解码，不影响向模型发送图片 |
 | imageBacking | 图片底色（默认 `transparent`，与上一条同在**图表与图片**主题下）：聊天照片/插图背后垫什么。透明：只画图片自己的像素，抗锯齿边缘和透明圆角透出终端底色或壁纸；终端底色：先合成到终端背景色，柔和边缘更平滑。立即生效 |
+| codeFrameStyle | 代码框样式（默认 `light`）：`light` 左侧开放栏杆；`full` 带连续右边框和底边的封闭边框。终端太窄时显示纯代码围栏。立即生效 |
 | whale | 开屏头部像素鲸鱼娘（默认开）；每次启动随机三选一开场动画（经典/爱心/睡觉），`/deepseek` 彩蛋重掷 |
 | whaleIdle | 鲸鱼娘欢迎期闲置动画（默认开）：定格后摆鱼鳍/拍尾巴/眨眼，空闲 10 秒入睡冒 Z；点击冒爱心。开始第一个任务后定格 |
 | splashFont | 开屏大字字体：按天轮换（默认，随本地日期换款）/ 加粗 / 方角实心 / 半立体 / 宽体 / 点阵灰度 / 镂空模板 / 细笔 / 方板。选某一款即固定那一款，选回「按天轮换」恢复。立即生效 |
 | whaleGirl | 女仆娘立绘（默认关）：标题像素鲸鱼换成作者绘制的女仆娘**真图**（Kitty/Sixel 图像协议）；不支持时回落像素鲸鱼 |
 | diffLayout | Edit/Write diff 布局：auto（≥110 列双栏）/ split / unified |
 | thinkingFold | 思考块：preview（流式 2-3 行预览 + 落定折叠）/ full（展开到轮末） |
+| btw.contextBudget | `/btw` 追问携带的最近问答总字符预算（默认 24000，范围 1000-200000）；超出时从最旧的整组开始裁剪。立即生效 |
+| btw.contextTurns | `/btw` 追问显式携带的最近完成问答组数（默认 4，范围 1-8）；窗口外的问答不进入请求，线程与面板仍保留全文。立即生效 |
 | jobGroupFold | 连续的后台任务卡：auto（默认，≥2 张成组；整组落定且 ≥3 张时折叠成汇总行）/ always（≥2 张立即折叠，含在跑的任务）/ never（从不自动折叠，每张卡都留着）。组头一行汇总状态与合计时长，点组头或 Ctrl+O 展开 |
 | effortDefault | 默认推理强度：auto / off / low / high / max。新会话的起始档位（细节见下） |
 | smoothStreaming | 流式平滑输出（默认开）：回复/思考/工具卡正文按 ~30fps 匀速揭示；回放/历史完整直出 |
 | toolBackground | 工具卡背景强调：none / subtle / strong |
+| turnUsageRow | 回合用量行（默认关闭）：在每回合末显示 token、缓存、耗时与重试摘要；`/tokens`、`/status` 和底栏 token 悬停不受此开关影响 |
 | mermaidDiagrams | Mermaid 图表（默认开）：回复中的 ```` ```mermaid ```` 代码块画成字符图，流式期间逐步成形；比终端宽或类型不支持的图保留源码并注明所需列数。立即生效 |
 | mathRendering | LaTeX 公式（默认 `auto`，在 `/settings` 的**公式设置**子页里）：回复中的 `$…$`、`\(…\)` 行内公式，`$$…$$`、`\[…\]` 与单独成行的 `\begin{align}` 等显示环境块级公式的显示方式。`auto` 用当前最好的渲染方式（目前是 Unicode 文本，块级公式里的分数与上下限竖排），`image` 在支持图形的终端里用 MathJax 把公式排版成图片——Kitty 图形协议（Kitty、Ghostty、WezTerm、iTerm2 等）或 Sixel（Windows Terminal 1.22+、xterm、foot、WezTerm）（颜色跟随主题文字色；块级公式最多 16 行，行内公式在能压成一行且不糊时也显示为一行高的图片；流式中的公式、暗色的思考区、不支持图形的终端、压成一行太小以及任何渲染失败都退回 Unicode），`unicode` 固定用 Unicode 文本，`source` 保留原始 TeX。不支持、仍在流式输出或比终端宽的公式保留源码（过宽的块级公式先退成单行）。价格（`$5`）、shell 变量（`$HOME`）与代码里的 `$` 不受影响。旧的 `latexMath: false` 仍等同 `source`。**点击公式图片**打开预览卡：按 2 倍单元格尺寸重排，可 100%–800% 缩放、拖拽平移，`Esc` 或点击卡片外关闭，标题即该公式的 TeX。Sixel 下公式**不带衬底**（只画笔画），终端底色或壁纸会透出来。标题立绘这类自带透明留白的插图同样不带衬底（`whaleGirl` 的真图就是这个行为）；照片、截图与卡片内的图像仍合成到底色上，因为 Sixel 表达不了软 alpha。立即生效 |
 | mathImageScale | 公式图片大小（默认 `auto`，与上一条同在**公式设置**子页）：配合 LaTeX 公式的「图片」使用——`auto` 与正文同尺寸，`large` / `xlarge` 把**块级**公式排得更大；终端图片是按设备像素 1:1 画的，所以"更大"就等于"每个笔画更多像素"，是唯一的清晰度杠杆。行内公式不受影响（只能占一行）。立即生效 |
@@ -642,7 +653,7 @@ dsh 意外退出时，安全模式给出**只读**的环境诊断、profile 插
 
 **效率**
 
-4. 模型工作中三种投递：`Enter` 注入下一步、`Tab` 排队、`Ctrl+Enter` 打断并发送。
+4. 模型工作中三种投递：`Enter` 注入下一步（已知 `/` 命令除外，按命令执行）、`Tab` 排队、`Ctrl+Enter` 打断并发送。
 5. `Alt+Up` 取回最后一条未处理消息改完重发，不用重打。
 6. 想快速问又不打断主回合、不留历史：`/btw <问题>`。
 7. 打错了想重来：**空输入双击 `Esc` 时间回溯**（或 `/rewind`），改完重发。

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

@@ -280,6 +280,7 @@ The TUI's `Ctrl+G` uses `$VISUAL`/`$EDITOR`. To edit in VS Code, export
 | Mouse wheel / drag selection | Handled by the integrated terminal; "copy on release" surfaces as OS-level copy behavior |
 | Extended keyboard protocol | modifyOtherKeys / win32-input-mode behavior is decided by xterm.js and may differ from kitty / WezTerm |
 | OSC 52 clipboard | First use triggers VS Code's own permission prompt |
+| Image protocol | Portraits/images can stay **permanently blank**: dsh-tui prefers the Kitty graphics protocol over Sixel, while VS Code's `@xterm/addon-image` answers the Kitty query with an `OK` that was never verified against an actual draw, so the image is erased and never redrawn. Fix: turn on `terminal.integrated.enableImages` (off by default) in VS Code settings and **reload the window** (the image addon only loads on the WebGL renderer, so it does nothing when `terminal.integrated.gpuAcceleration` is `off` or the legacy `canvas`); if needed, set `DSH_TUI_IMAGE_PROTOCOL=sixel` (needs dsh-tui ≥ 0.10.0) — the companion extension `dsh-tui-vscode` ≥ 0.7.5 injects that variable automatically, so no manual setup is required |
 
 For the full protocol behavior of a standalone terminal (e.g. complex mouse
 semantics), use an external terminal window (Windows Terminal / kitty /

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

@@ -252,6 +252,7 @@ TUI 的 `Ctrl+G` 走 `$VISUAL`/`$EDITOR`。想让它在 VS Code 里编辑，
 | 鼠标滚轮/拖选 | 由集成终端处理；“松开即复制”表现为 OS 级复制行为 |
 | 扩展键盘协议 | modifyOtherKeys / win32-input-mode 由 xterm.js 决定，可能与 kitty / WezTerm 不完全一致 |
 | OSC 52 剪贴板 | 首次使用弹出权限提示（VS Code 自身的安全设计） |
+| 图像协议 | 立绘/图片可能**永久空白**：dsh-tui 让 Kitty 图形协议优先于 Sixel，而 VS Code 的 `@xterm/addon-image` 对 Kitty 查询回一个从未经真实绘制验证的 `OK`，图片被擦掉后不再重绘。解决：在 VS Code 设置里打开 `terminal.integrated.enableImages`（默认关闭）并**重载窗口**（图像 addon 只挂在 WebGL 渲染器上，`terminal.integrated.gpuAcceleration` 为 `off` 或旧 `canvas` 时开了也不生效）；必要时设 `DSH_TUI_IMAGE_PROTOCOL=sixel`（需 dsh-tui ≥ 0.10.0）——用 companion 扩展 `dsh-tui-vscode` ≥ 0.7.5 时该变量自动注入，无需手动设置 |
 
 需要完全对齐独立终端行为时，请使用独立终端窗口
 （Windows Terminal / kitty / WezTerm / iTerm2 / tmux）。