@deepseek-harness-tui/dsh-tui 0.10.2 → 0.11.0

package/lib/types/sessions/format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/sessions/format.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAChF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYpE;AAED,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAajF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAchE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAc1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,KAAK,CAAA;CAAE,GAAG,SAAS,CAI7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA4B/D;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAInD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,KAAK,CAK7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB/D;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C"}
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/sessions/format.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAA;AAChF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYpE;AAED,6DAA6D;AAC7D,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,4DAA4D;IAC5D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,CAajF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAchE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAc1D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKzE;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,KAAK,CAAA;CAAE,GAAG,SAAS,CAI7F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CA4B/D;AAED,mEAAmE;AACnE,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAInD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,KAAK,CAQ7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAkB/D;AAED,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C"}

package/lib/types/sessions/format.js

@@ -230,8 +230,11 @@ export function kindLabel(kind) {
  * dimmest of all, because it says only "nothing here was readable".
  */
 export function titleColor(source, focused) {
+    // Selection is green (see SessionListRow): blue is reserved for the pointer
+    // hover prompt, so the row under the cursor cannot look like the row the
+    // pointer is merely passing over.
     if (focused)
-        return 'suggestion';
+        return 'success';
     if (source === 'fallback')
         return 'subtle';
     if (source === 'prompt')

package/lib/types/sessions/resumeFailure.d.ts

@@ -0,0 +1,38 @@
+/**
+ * One wording for "why a session could not be mounted".
+ *
+ * Four surfaces can refuse a mount — the supervisor, the session browser, the
+ * workspace home screen and the transcript itself — and each used to spell the
+ * same failures out on its own. That is how `/resume` and `/agentview` ended
+ * up telling the user different things about the same refusal, and it is why a
+ * newly added reason (the cross-process occupancy case) would have been
+ * silently mis-reported as a generic failure on whichever surface was missed.
+ *
+ * The mapping is pure and total: it takes the adapter's discriminated result
+ * and returns the sentence to show, or `undefined` for the outcomes that need
+ * no words. The `cancelled` case is deliberately silent — the user (or a rival
+ * switch) asked for it, so there is nothing to explain.
+ *
+ * @module @deepseek-harness-tui/dsh-tui/sessions/resumeFailure
+ */
+import type { ResumeResult } from '../adapter/ports/channel-view.js';
+import type { MountFailure } from '../sessionMounts.js';
+/**
+ * The message for a failed mount, or undefined when it should stay silent.
+ * @param result - The adapter's mount outcome.
+ * @returns The user-facing sentence, or undefined for `cancelled`.
+ */
+export declare function resumeFailureText(result: ResumeResult): string | undefined;
+/**
+ * The sentence for a ledger refusal that did NOT find a holder.
+ *
+ * A refusal to CHECK is not a refusal by a peer, so it must not borrow the
+ * "another terminal holds it" wording — that would invent a terminal. The
+ * `occupied` case is here too because it is a {@link MountFailure} and its
+ * sentence already exists; {@link resumeFailureText} reaches the same key from
+ * the adapter's own result.
+ * @param failure - Why the session could not be claimed.
+ * @returns The user-facing sentence.
+ */
+export declare function mountFailureText(failure: MountFailure): string;
+//# sourceMappingURL=resumeFailure.d.ts.map

package/lib/types/sessions/resumeFailure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resumeFailure.d.ts","sourceRoot":"","sources":["../../../src/sessions/resumeFailure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAA;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAGvD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAc1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAO9D"}

package/lib/types/sessions/resumeFailure.js

@@ -0,0 +1,58 @@
+/**
+ * One wording for "why a session could not be mounted".
+ *
+ * Four surfaces can refuse a mount — the supervisor, the session browser, the
+ * workspace home screen and the transcript itself — and each used to spell the
+ * same failures out on its own. That is how `/resume` and `/agentview` ended
+ * up telling the user different things about the same refusal, and it is why a
+ * newly added reason (the cross-process occupancy case) would have been
+ * silently mis-reported as a generic failure on whichever surface was missed.
+ *
+ * The mapping is pure and total: it takes the adapter's discriminated result
+ * and returns the sentence to show, or `undefined` for the outcomes that need
+ * no words. The `cancelled` case is deliberately silent — the user (or a rival
+ * switch) asked for it, so there is nothing to explain.
+ *
+ * @module @deepseek-harness-tui/dsh-tui/sessions/resumeFailure
+ */
+import { t } from '../i18n.js';
+/**
+ * The message for a failed mount, or undefined when it should stay silent.
+ * @param result - The adapter's mount outcome.
+ * @returns The user-facing sentence, or undefined for `cancelled`.
+ */
+export function resumeFailureText(result) {
+    if (result.ok)
+        return undefined;
+    switch (result.reason) {
+        case 'cancelled':
+            return undefined;
+        case 'working':
+            return t('resume-while-working');
+        case 'unavailable':
+            return t('resume-unavailable');
+        case 'occupied':
+            return t('resume-session-occupied', { pid: result.pid });
+        case 'failed':
+            return t('session-resume-failed', { err: result.error });
+    }
+}
+/**
+ * The sentence for a ledger refusal that did NOT find a holder.
+ *
+ * A refusal to CHECK is not a refusal by a peer, so it must not borrow the
+ * "another terminal holds it" wording — that would invent a terminal. The
+ * `occupied` case is here too because it is a {@link MountFailure} and its
+ * sentence already exists; {@link resumeFailureText} reaches the same key from
+ * the adapter's own result.
+ * @param failure - Why the session could not be claimed.
+ * @returns The user-facing sentence.
+ */
+export function mountFailureText(failure) {
+    if (failure.reason === 'occupied') {
+        return t('resume-session-occupied', { pid: failure.holders[0] ?? 0 });
+    }
+    return failure.reason === 'busy'
+        ? t('resume-mount-busy')
+        : t('resume-mount-unavailable', { detail: failure.detail });
+}

package/lib/types/terminal-utils/mermaid.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Mermaid fences → Unicode box-drawing art through `lovely-mermaid`.
+ *
+ * The engine is pure TypeScript: no browser, no SVG, no image protocol. It
+ * lays a diagram out at whatever width it needs and reports that width;
+ * fitting it to the viewport (or falling back to the fenced source) is the
+ * component's decision. Parsing is best-effort by design, so a streaming
+ * prefix keeps drawing instead of flipping between art and source.
+ *
+ * Like cli-highlight the module loads lazily on the first mermaid fence —
+ * most sessions never pay for it.
+ */
+import type { MermaidArt } from 'lovely-mermaid';
+import type { Theme } from '../theme.js';
+export type { MermaidArt } from 'lovely-mermaid';
+/** The lovely-mermaid surface dsh-tui consumes. */
+export type MermaidEngine = Pick<typeof import('lovely-mermaid'), 'render'>;
+/**
+ * Return the shared engine load promise, starting the lazy load on first call.
+ * @returns A promise of the engine, or null when the dynamic import fails.
+ */
+export declare function getMermaidEnginePromise(): Promise<MermaidEngine | null>;
+/**
+ * Synchronous view of the load: the engine once loaded, null after a failed
+ * import, undefined while pending. Lets a mounting component draw the
+ * diagram on its first render instead of flashing the source first.
+ */
+export declare function peekMermaidEngine(): MermaidEngine | null | undefined;
+/** Whether a fence info string names mermaid (`mermaid`, `Mermaid`, `mermaid title=…`). */
+export declare function isMermaidLang(lang: string | undefined): boolean;
+/**
+ * Lay out a mermaid source. `null` follows the engine's contract (blank,
+ * unsupported diagram type, nothing parsed) and additionally covers the
+ * source-length guard and any engine exception — a third-party parser
+ * failing on model output must degrade to the fenced source, never take
+ * the transcript down.
+ */
+export declare function renderMermaid(engine: MermaidEngine, source: string): MermaidArt | null;
+/**
+ * Paint the art's rows with the active theme, one string per row.
+ * `styled[i]` joined is exactly `plain[i]`, so widths are unchanged.
+ */
+export declare function paintMermaidArt(art: MermaidArt, theme: Theme): string[];
+//# sourceMappingURL=mermaid.d.ts.map

package/lib/types/terminal-utils/mermaid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mermaid.d.ts","sourceRoot":"","sources":["../../../src/terminal-utils/mermaid.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,UAAU,EAAQ,MAAM,gBAAgB,CAAA;AAEtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAExC,YAAY,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAEhD,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc,gBAAgB,CAAC,EAAE,QAAQ,CAAC,CAAA;AAqB3E;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAMvE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,aAAa,GAAG,IAAI,GAAG,SAAS,CAEpE;AAED,2FAA2F;AAC3F,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAOtF;AAgBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,EAAE,CASvE"}

package/lib/types/terminal-utils/mermaid.js

@@ -0,0 +1,83 @@
+import { colorize } from '../ink/colorize.js';
+/**
+ * Sources above this length skip the engine: the layout has its own node
+ * and edge caps, but the parser still walks every character, and a fence
+ * this long is a paste, not a diagram.
+ */
+const MERMAID_SOURCE_LIMIT = 20_000;
+let enginePromise;
+let loadedEngine;
+async function loadMermaidEngine() {
+    try {
+        const mod = await import('lovely-mermaid');
+        return { render: mod.render };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Return the shared engine load promise, starting the lazy load on first call.
+ * @returns A promise of the engine, or null when the dynamic import fails.
+ */
+export function getMermaidEnginePromise() {
+    enginePromise ??= loadMermaidEngine().then(engine => {
+        loadedEngine = engine;
+        return engine;
+    });
+    return enginePromise;
+}
+/**
+ * Synchronous view of the load: the engine once loaded, null after a failed
+ * import, undefined while pending. Lets a mounting component draw the
+ * diagram on its first render instead of flashing the source first.
+ */
+export function peekMermaidEngine() {
+    return loadedEngine;
+}
+/** Whether a fence info string names mermaid (`mermaid`, `Mermaid`, `mermaid title=…`). */
+export function isMermaidLang(lang) {
+    return lang?.trim().split(/\s+/, 1)[0]?.toLowerCase() === 'mermaid';
+}
+/**
+ * Lay out a mermaid source. `null` follows the engine's contract (blank,
+ * unsupported diagram type, nothing parsed) and additionally covers the
+ * source-length guard and any engine exception — a third-party parser
+ * failing on model output must degrade to the fenced source, never take
+ * the transcript down.
+ */
+export function renderMermaid(engine, source) {
+    if (source.length > MERMAID_SOURCE_LIMIT)
+        return null;
+    try {
+        return engine.render(source);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Theme key per semantic role. `text` (node labels) is deliberately left
+ * unpainted so it inherits the enclosing Text's color — body color in a
+ * reply, the dim color inside a folded thinking block.
+ */
+const ROLE_COLOR = Object.freeze({
+    border: 'subtle',
+    text: undefined,
+    edge: 'permission',
+    edgeLabel: 'inactive',
+    title: 'subtle',
+    none: undefined,
+});
+/**
+ * Paint the art's rows with the active theme, one string per row.
+ * `styled[i]` joined is exactly `plain[i]`, so widths are unchanged.
+ */
+export function paintMermaidArt(art, theme) {
+    return art.styled.map(row => row
+        .map(span => {
+        const key = ROLE_COLOR[span.role];
+        return key === undefined ? span.text : colorize(span.text, theme[key], 'foreground');
+    })
+        .join(''));
+}

package/lib/types/tips.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tips.d.ts","sourceRoot":"","sources":["../../src/tips.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAA;AAEhF,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,QAAQ,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;CACX;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAMzE,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,SAAS,GAAG,EA8sB9B,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAM,MAAoB,GAAG,GAAG,CAErE;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,EAAE,CAElD"}
+{"version":3,"file":"tips.d.ts","sourceRoot":"","sources":["../../src/tips.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAA;AAEhF,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,QAAQ,CAAA;IACf,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;CACX;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAMzE,CAAA;AAED,eAAO,MAAM,IAAI,EAAE,SAAS,GAAG,EA02B9B,CAAA;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,GAAE,MAAM,MAAoB,GAAG,GAAG,CAErE;AAED,0CAA0C;AAC1C,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,EAAE,CAElD"}

package/lib/types/tips.js

@@ -26,8 +26,8 @@ export const TIPS = [
     {
         id: 'keys-esc-levels',
         group: 'keys',
-        zh: 'Esc 逐层关闭：帮助 → 命令/文件菜单 → 清空输入',
-        en: 'Esc closes layers: help → command/file menus → clear input',
+        zh: 'Esc 逐层收：帮助 → 图片预览 → 命令/文件菜单 → 清选区 → 清空',
+        en: 'Esc peels layers: help → image preview → command/file menus → selection → clear input',
     },
     {
         id: 'keys-ctrl-o',
@@ -122,8 +122,8 @@ export const TIPS = [
     {
         id: 'keys-shift-tab',
         group: 'keys',
-        zh: 'Shift+Tab 循环会话模式：默认→计划→完全访问',
-        en: 'Shift+Tab cycles modes: default → plan → full access',
+        zh: 'Shift+Tab 循环会话模式：默认→计划→完全访问（挂了第三方权限预设时按 registry 顺序追加到末尾）',
+        en: 'Shift+Tab cycles modes: default → plan → full access (third-party presets append in registry order)',
     },
     {
         id: 'keys-shift-up',
@@ -161,18 +161,72 @@ export const TIPS = [
         zh: '轨迹与 /settings 支持鼠标：行点击跳转/编辑，滚轮移动光标或焦点',
         en: 'Trajectory and /settings take the mouse: row clicks jump/edit, the wheel moves cursor or focus',
     },
+    {
+        id: 'keys-session-screen',
+        group: 'keys',
+        zh: '会话管理界面：←/→ 切栏，会话栏 Enter 进会话、工作区栏 Enter 开菜单（初始焦点在工作区栏）',
+        en: 'Session manager: ←/→ switch panes; Enter enters a session (list) or opens the workspace menu (rail)',
+    },
+    {
+        id: 'keys-session-actions',
+        group: 'keys',
+        zh: '会话管理界面：Ctrl+N 新建、Ctrl+X 停止后台会话、Ctrl+L 重读列表、打字即筛选',
+        en: 'Session manager: Ctrl+N new · Ctrl+X stop a background session · Ctrl+L reload · type to filter',
+    },
+    {
+        id: 'keys-prompt-background',
+        group: 'keys',
+        zh: '输入框空着按 ←：当前会话转后台并打开会话管理界面（同 /bg）',
+        en: '← on an empty prompt backgrounds this session and opens the session manager (same as /bg)',
+    },
+    {
+        id: 'keys-jobs-esc',
+        group: 'keys',
+        zh: '/jobs 面板里 Esc 只关面板，不会中断正在跑的回合',
+        en: 'In the /jobs panel, Esc only closes the panel — it does not interrupt the turn',
+    },
+    {
+        id: 'keys-settings-arrows',
+        group: 'keys',
+        zh: '/settings 里 ←/→ 在有选项的字段上循环切换；布尔项仍只认 Enter',
+        en: 'In /settings, ←/→ cycle options on fields that have them; booleans still only toggle with Enter',
+    },
+    {
+        id: 'keys-transcript-page',
+        group: 'keys',
+        zh: '全屏下 PgUp/PgDn 按页翻消息列表，跟翻书一样',
+        en: 'Fullscreen: PgUp/PgDn page through the message list like a book',
+    },
+    {
+        id: 'keys-expand-editor',
+        group: 'keys',
+        zh: 'Ctrl+Shift+E 或输入行尾 ⛶ 展开全屏草稿编辑器，写长文更舒服',
+        en: 'Ctrl+Shift+E or the ⛶ button opens the fullscreen draft editor — great for long posts',
+    },
+    {
+        id: 'keys-composer-fold',
+        group: 'keys',
+        zh: '粘贴大段（≥6 行或 ≥600 字）折成 ▸ 小条，点它或 Esc 展开；Enter 提交的还是全文',
+        en: 'Big pastes (≥6 lines or ≥600 chars) fold into a ▸ chip; click or Esc expands, Enter sends it all',
+    },
+    {
+        id: 'keys-image-preview',
+        group: 'keys',
+        zh: '大图预览：←/→ 换张，缩放走底部按钮（适应/100%/200%/400%/800%），拖动或滚轮平移',
+        en: 'Image preview: ←/→ switch, zoom via bottom buttons (fit/100/200/400/800%), drag or wheel to pan',
+    },
     // ── 命令 ──────────────────────────────────────────────────
     {
         id: 'cmd-new-resume',
         group: 'commands',
-        zh: '/new 新会话；/resume 恢复历史会话',
-        en: '/new starts a session; /resume brings back old ones',
+        zh: '/new 开新会话；/resume 打开会话管理界面找回历史会话',
+        en: '/new starts a session; /resume opens the session manager to bring back old ones',
     },
     {
-        id: 'cmd-resume-search',
+        id: 'cmd-session-manager',
         group: 'commands',
-        zh: '/resume 顶部可选工作目录，← 切目录，打字搜索当前层',
-        en: '/resume has a directory selector; ← switches scope, typing searches the active list',
+        zh: '/resume、/home、/agentview、/bg 和输入框行首 ⌸，进的都是同一个会话管理界面',
+        en: '/resume, /home, /agentview, /bg and the ⌸ button all open one session manager',
     },
     {
         id: 'cmd-rename',
@@ -333,8 +387,8 @@ export const TIPS = [
     {
         id: 'cmd-provider',
         group: 'commands',
-        zh: '/provider 交互式添加自己的模型提供方',
-        en: '/provider adds your own model provider interactively',
+        zh: '/provider 交互式管理模型提供方：添加、编辑、删除',
+        en: '/provider adds, edits or deletes model providers interactively',
     },
     {
         id: 'cmd-login',
@@ -416,16 +470,46 @@ export const TIPS = [
         en: '/fork copies the session into a resumable twin; the original is untouched',
     },
     {
-        id: 'flow-resume',
+        id: 'flow-session-park',
+        group: 'workflow',
+        zh: '切换会话只是停放（先放一边），回合照跑不打断；被其他 TUI 终端占用的会标红、进不去',
+        en: 'Switching a session just parks it (the turn keeps running); a session held elsewhere turns red',
+    },
+    {
+        id: 'flow-draft-kept',
+        group: 'workflow',
+        zh: '去 /settings、会话管理界面、轨迹转一圈再回来，草稿（含暂存图片）原样还在',
+        en: 'Leave for /settings, the session manager or trajectory: your draft (images too) is still there',
+    },
+    {
+        id: 'flow-first-launch',
+        group: 'workflow',
+        zh: '首次普通启动（不带 --resume、工作区目标或首条提示词）落在会话管理界面选工作区，之后直接进对话',
+        en: 'First plain launch (no --resume/workspace/prompt) opens the session manager; then straight to chat',
+    },
+    {
+        id: 'flow-prompt-background-return',
+        group: 'workflow',
+        zh: '/bg 或空输入 ← 之后，再按 Esc 回到刚转后台的那个会话',
+        en: 'After /bg (or ← on empty input), Esc takes you back to the session you just backgrounded',
+    },
+    {
+        id: 'flow-dialog-paste',
         group: 'workflow',
-        zh: '/resume 里 Ctrl+S 折叠子 agent 运行',
-        en: 'In /resume, Ctrl+S folds subagent runs',
+        zh: '问卷、计划评审和插件对话框里都能 Ctrl+V 粘贴文本',
+        en: 'Question, plan-review and plugin dialogs all accept Ctrl+V paste',
     },
     {
-        id: 'flow-resume-clean',
+        id: 'flow-ide-selection',
         group: 'workflow',
-        zh: '/resume 里 Ctrl+X 清理空壳会话',
-        en: 'In /resume, Ctrl+X prunes empty sessions',
+        zh: 'VS Code 扩展 ≥0.7.0：选中代码后输入框下方显示 ⧉ N lines selected，发送自动附上选中行',
+        en: 'VS Code extension ≥0.7.0: select code to show ⧉ N lines selected below input; sent with the message',
+    },
+    {
+        id: 'flow-image-adapt',
+        group: 'workflow',
+        zh: '粘贴超尺寸图先等比缩放或转格式；需重编码的动图直接拒绝，不悄悄丢帧',
+        en: 'Oversized images get scaled or converted first; animated ones needing re-encode are refused',
     },
     {
         id: 'flow-search',
@@ -451,6 +535,12 @@ export const TIPS = [
         zh: '问卷选项行直接打字 = 选项 + 自定义文本一起提交',
         en: 'Typing on a question row submits option + custom text',
     },
+    {
+        id: 'flow-question-fold',
+        group: 'workflow',
+        zh: '问卷面板 Ctrl+K 或点标题行折叠；挂起时 Esc/Ctrl+C 先展开，不直接取消',
+        en: 'Fold the question panel with Ctrl+K or its header; when pending, Esc/Ctrl+C expands first',
+    },
     {
         id: 'flow-plan-review',
         group: 'workflow',
@@ -491,8 +581,8 @@ export const TIPS = [
     {
         id: 'disp-statusbar',
         group: 'display',
-        zh: '底栏 TPS、轨迹条、上下文条默认关，/settings 里打开',
-        en: 'TPS, trajectory, context bars are off by default — enable in /settings',
+        zh: '底栏 TPS、轨迹条默认关，上下文条默认开；都在 /settings 逐项开关',
+        en: 'TPS and trajectory bars are off by default, context bar on; all switch in /settings',
     },
     {
         id: 'disp-statusbar-session-id',
@@ -626,6 +716,48 @@ export const TIPS = [
         zh: '首屏鲸鱼动画（终端 ≥64 列才显示）',
         en: 'The whale intro shows on terminals ≥64 columns',
     },
+    {
+        id: 'disp-context-legend',
+        group: 'display',
+        zh: '悬停上下文条看分段图例；读数 ≥80% 琥珀、≥95% 红，该 /compact 了',
+        en: 'Hover the context bar for its legend; ≥80% amber, ≥95% red — time to /compact',
+    },
+    {
+        id: 'disp-long-line',
+        group: 'display',
+        zh: '超过 1000 字符的单行只显示前 1000 字符，行尾标记写明折叠了多少；点它或 Ctrl+O 看全文',
+        en: 'Lines over 1000 chars show the first 1000 plus a folded-count marker; click or Ctrl+O for the rest',
+    },
+    {
+        id: 'disp-gutter',
+        group: 'display',
+        zh: '转录边栏三选一：轮次时间线 / 滚动条 / 隐藏；滚动条能直接拖',
+        en: 'Transcript gutter: timeline, scrollbar or hidden; drag the scrollbar to scroll',
+    },
+    {
+        id: 'disp-mermaid',
+        group: 'display',
+        zh: '回复里的 ```mermaid 代码块直接画成字符图，/settings 里可关',
+        en: '```mermaid fences in replies are drawn as character diagrams; toggle in /settings',
+    },
+    {
+        id: 'disp-whale-click',
+        group: 'display',
+        zh: '开始第一个任务前点鲸鱼冒爱心、唤醒睡着的它；闲置动作可在 /settings 关',
+        en: 'Before your first task, click the whale for hearts and to wake it; idle moves toggle in /settings',
+    },
+    {
+        id: 'disp-smooth',
+        group: 'display',
+        zh: '流式输出默认平滑打出（约 30fps）；嫌慢可在 /settings 关',
+        en: 'Streaming reveals smoothly by default (~30fps); turn it off in /settings',
+    },
+    {
+        id: 'disp-terminal-images',
+        group: 'display',
+        zh: '终端不支持 Kitty/Sixel 时图片只显示文字信息；预览开关在 /settings',
+        en: 'Without Kitty/Sixel, images show text only; the preview toggle lives in /settings',
+    },
     // ── 避坑 ──────────────────────────────────────────────────
     {
         id: 'pit-cost-approx',
@@ -729,6 +861,30 @@ export const TIPS = [
         zh: '需要交互 TTY；推荐 Windows Terminal ≥110 列',
         en: 'An interactive TTY is required; try Windows Terminal ≥110 cols',
     },
+    {
+        id: 'pit-safe-mode',
+        group: 'pitfalls',
+        zh: 'dsh 异常退出会提示进入 dsh-tui safe：只读诊断 + 干净救援 profile',
+        en: 'When dsh exits badly, dsh-tui safe offers read-only diagnostics and a clean rescue profile',
+    },
+    {
+        id: 'pit-effort-fallback',
+        group: 'pitfalls',
+        zh: '偏好的推理档当前模型没有时，自动就近降一级并弹提示说明',
+        en: 'If the model lacks your preferred effort tier, it drops to the nearest lower one and says so',
+    },
+    {
+        id: 'pit-selection-guard',
+        group: 'pitfalls',
+        zh: '选中高亮的内容被就地替换时，复制会被取消，避免复制到过期文本',
+        en: 'If the text under your selection is replaced in place, the copy is cancelled',
+    },
+    {
+        id: 'pit-tooltip-select',
+        group: 'pitfalls',
+        zh: '拖选转录文字时悬浮详情卡不会弹出，免得盖住要复制的格子',
+        en: 'Hover cards stay hidden while you drag-select the transcript, so nothing covers the text you copy',
+    },
 ];
 /**
  * 启动随机轮换选择：每次启动随机取一条，让首屏每次都有新鲜感。

package/lib/types/tuiDisplayPrefs.d.ts

@@ -39,13 +39,11 @@ export declare function resolvePageMargin(setting: PageMarginSetting): {
     readonly x: number;
     readonly y: number;
 };
-/** Subscribe to page-margin setting changes; returns the unsubscribe fn. */
-export declare function subscribePageMargin(listener: () => void): () => void;
-/** Current applied setting (normalized; safe for useSyncExternalStore —
- *  a primitive string identity is stable). */
-export declare function getPageMarginSetting(): PageMarginSetting;
-/** Apply a new setting (normalized, no-op when unchanged). Returns the
- *  value that ended up applied — useful for the plugin to mirror the
- *  channel. */
-export declare function applyPageMargin(setting: unknown): PageMarginSetting;
+export declare const subscribePageMargin: (listener: () => void) => () => void;
+export declare const getPageMarginSetting: () => PageMarginSetting;
+/** Returns the value that ended up applied — the plugin mirrors it into the channel. */
+export declare const applyPageMargin: (value: unknown) => PageMarginSetting;
+export declare const subscribeMermaidDiagrams: (listener: () => void) => () => void;
+export declare const getMermaidDiagrams: () => boolean;
+export declare const applyMermaidDiagrams: (value: unknown) => boolean;
 //# sourceMappingURL=tuiDisplayPrefs.d.ts.map

package/lib/types/tuiDisplayPrefs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tuiDisplayPrefs.d.ts","sourceRoot":"","sources":["../../src/tuiDisplayPrefs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAC9J,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAG9J,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,eAAe,CAuBvD,CAAA;AAMF,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAItE;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAItE;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CASlE;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,UAAO,GACb,MAAM,GAAG,SAAS,CASpB;AAED;;4CAE4C;AAC5C,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAK3G,CAAA;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAAyB,CAAA;AAE3D;4CAC4C;AAC5C,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAClC,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAQlC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED;wBACwB;AACxB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAO5E;AAED;;kCAEkC;AAClC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAOrE;AAED;2EAC2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAWxG;AAUD,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAGpE;AAED;8CAC8C;AAC9C,wBAAgB,oBAAoB,IAAI,iBAAiB,CAExD;AAED;;eAEe;AACf,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAOnE"}
+{"version":3,"file":"tuiDisplayPrefs.d.ts","sourceRoot":"","sources":["../../src/tuiDisplayPrefs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAC9J,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAG9J,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,eAAe,CAuBvD,CAAA;AAMF,0EAA0E;AAC1E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAItE;AAED,4EAA4E;AAC5E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAItE;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CASlE;AASD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,OAAO,UAAO,GACb,MAAM,GAAG,SAAS,CASpB;AAED;;4CAE4C;AAC5C,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAK3G,CAAA;AAEF,eAAO,MAAM,mBAAmB,EAAE,cAAyB,CAAA;AAE3D;4CAC4C;AAC5C,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAClC,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAQlC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED;wBACwB;AACxB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAO5E;AAED;;kCAEkC;AAClC,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAOrE;AAED;2EAC2E;AAC3E,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,GAAG;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAWxG;AAyCD,eAAO,MAAM,mBAAmB,aA5BR,MAAM,IAAI,KAAK,MAAM,IA4Be,CAAA;AAC5D,eAAO,MAAM,oBAAoB,yBAAsB,CAAA;AACvD,wFAAwF;AACxF,eAAO,MAAM,eAAe,UA3BX,OAAO,sBA2B4B,CAAA;AAMpD,eAAO,MAAM,wBAAwB,aArCb,MAAM,IAAI,KAAK,MAAM,IAqCyB,CAAA;AACtE,eAAO,MAAM,kBAAkB,eAA2B,CAAA;AAC1D,eAAO,MAAM,oBAAoB,UAnChB,OAAO,YAmCsC,CAAA"}

package/lib/types/tuiDisplayPrefs.js

@@ -134,32 +134,35 @@ export function resolvePageMargin(setting) {
     }
     return PAGE_MARGIN_PRESETS[DEFAULT_PAGE_MARGIN];
 }
-// ── Live module store ──────────────────────────────────────────────────
-// PageMargin sits ABOVE Chat in the tree, so it cannot observe the
-// channel's version bump used to re-render everything below Chat. The
-// settings watch therefore mirrors the applied setting through this store;
-// PageMargin subscribes with useSyncExternalStore and re-lays out.
-const pageMarginListeners = new Set();
-let pageMarginState = DEFAULT_PAGE_MARGIN;
-/** Subscribe to page-margin setting changes; returns the unsubscribe fn. */
-export function subscribePageMargin(listener) {
-    pageMarginListeners.add(listener);
-    return () => { pageMarginListeners.delete(listener); };
-}
-/** Current applied setting (normalized; safe for useSyncExternalStore —
- *  a primitive string identity is stable). */
-export function getPageMarginSetting() {
-    return normalizePageMargin(pageMarginState);
-}
-/** Apply a new setting (normalized, no-op when unchanged). Returns the
- *  value that ended up applied — useful for the plugin to mirror the
- *  channel. */
-export function applyPageMargin(setting) {
-    const next = normalizePageMargin(setting);
-    if (next !== pageMarginState) {
-        pageMarginState = next;
-        for (const listener of [...pageMarginListeners])
-            listener();
-    }
-    return next;
+function createLiveSetting(initial, normalize) {
+    const listeners = new Set();
+    let state = initial;
+    return {
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => { listeners.delete(listener); };
+        },
+        get: () => state,
+        apply(value) {
+            const next = normalize(value);
+            if (next !== state) {
+                state = next;
+                for (const listener of [...listeners])
+                    listener();
+            }
+            return next;
+        },
+    };
 }
+const pageMarginStore = createLiveSetting(DEFAULT_PAGE_MARGIN, normalizePageMargin);
+export const subscribePageMargin = pageMarginStore.subscribe;
+export const getPageMarginSetting = pageMarginStore.get;
+/** Returns the value that ended up applied — the plugin mirrors it into the channel. */
+export const applyPageMargin = pageMarginStore.apply;
+/** Whether ```mermaid fences render as box-drawing diagrams (settings
+ *  `dsh-tui.mermaidDiagrams`, default on). Only an explicit `false` keeps
+ *  the fenced source. */
+const mermaidDiagramsStore = createLiveSetting(true, value => value !== false);
+export const subscribeMermaidDiagrams = mermaidDiagramsStore.subscribe;
+export const getMermaidDiagrams = mermaidDiagramsStore.get;
+export const applyMermaidDiagrams = mermaidDiagramsStore.apply;