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

package/lib/types/components/launchpadLayout.d.ts

@@ -1,4 +1,13 @@
 import type { SplashFont } from './splashFonts.js';
+/**
+ * 块体大字的行数：上排 5 + 空 1 + 下排 5。
+ *
+ * 导出是给回归钉的：`portrait` 立绘槽高（`splashArtRows.ts` 的
+ * `PORTRAIT_ART_ROWS`）**等于这个数**——`LogoV2` 把娘立绘钳在与文字列等高的
+ * 槽里（`textColumnRows` = 两排大字 + 空行），落地页是 `chrome="minimal"`，
+ * 槽高就是大字块的行数。两处一漂移，预算就重新和渲染分叉。
+ */
+export declare const BIG_TITLE_ROWS = 11;
 /** 输入框卡片占的行数：边框 2 + 输入 1（第三版：参数行移出框外）。 */
 export declare const CARD_ROWS = 3;
 /** 框下参数行的行数（模型/思考深度/模式/权限全空时整行不画）。 */
@@ -50,7 +59,9 @@ export interface LaunchpadLayout {
  * @param rows - 内容区行数。
  * @param options - whale / whaleGirl 对应设置项；font 是当天那款字体（字身宽度
  *   不同，宽轴阈值也跟着不同）；params 是框下有没有参数行（模型/思考深度/模式/
- *   权限全拿不到时为 false，成组行矮一行）。
+ *   权限全拿不到时为 false，成组行矮一行）；`artRows` 是**当天真正上场的立绘**
+ *   占的行数（`splashArtRows.ts` 解，缺省按像素鲸鱼 13 行）；`cornerRows` 是
+ *   右下角铭牌自身的行数（第一行 + 内核数，缺省按老口径 2 行）。
  * @returns 该尺寸下要渲染的部件。
  */
 export declare function resolveLaunchpadLayout(columns: number, rows: number, options: {
@@ -58,5 +69,7 @@ export declare function resolveLaunchpadLayout(columns: number, rows: number, op
     whaleGirl?: boolean;
     font: SplashFont;
     params?: boolean;
+    artRows?: number;
+    cornerRows?: number;
 }): LaunchpadLayout;
 //# sourceMappingURL=launchpadLayout.d.ts.map

package/lib/types/components/launchpadLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launchpadLayout.d.ts","sourceRoot":"","sources":["../../../src/components/launchpadLayout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AA0ClD,0CAA0C;AAC1C,eAAO,MAAM,SAAS,IAAI,CAAA;AAC1B,sCAAsC;AACtC,eAAO,MAAM,UAAU,IAAI,CAAA;AAwC3B,iBAAiB;AACjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAA;AAErF,yBAAyB;AACzB,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GACnF,eAAe,CA2FjB"}
+{"version":3,"file":"launchpadLayout.d.ts","sourceRoot":"","sources":["../../../src/components/launchpadLayout.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAyClD;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,KAAK,CAAA;AAIhC,0CAA0C;AAC1C,eAAO,MAAM,SAAS,IAAI,CAAA;AAC1B,sCAAsC;AACtC,eAAO,MAAM,UAAU,IAAI,CAAA;AA2C3B,iBAAiB;AACjB,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAA;AAErF,yBAAyB;AACzB,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,kCAAkC;IAClC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;IAC9B,+BAA+B;IAC/B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,0BAA0B;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,6BAA6B;IAC7B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,yCAAyC;IACzC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,6BAA6B;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,UAAU,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GACA,eAAe,CA6FjB"}

package/lib/types/components/launchpadLayout.js

@@ -1,5 +1,6 @@
 import { bigTextWidth } from './bigfont.js';
 import { WHALE_BOX_WIDTH } from './splashLayout.js';
+import { WHALE_ART_ROWS } from './splashArtRows.js';
 /**
  * 落地页的降级阶梯——两个轴一起解：
  *
@@ -32,10 +33,21 @@ import { WHALE_BOX_WIDTH } from './splashLayout.js';
  * 所有列数按**内容区**算（PageMargin 已经把 TerminalSizeContext 收窄）；行数
  * 同理。落地页不自己减页边距。
  */
-/** 鲸鱼/女仆娘立绘（含盒）的行数。 */
-const WHALE_ART_ROWS = 13;
-/** 块体大字的行数：上排 5 + 空 1 + 下排 5。 */
-const BIG_TITLE_ROWS = 11;
+/**
+ * 立绘槽的默认行数（像素鲸鱼 13 行）。**真实行数由调用方传 `artRows`**——
+ * 槽高随形态变（女仆娘/Claude 娘 11、吉祥物 15），写死 13 会让默认的吉祥物
+ * 路径少算 2 行（见 `splashArtRows.ts` 的表与那段修复说明）。
+ */
+const DEFAULT_ART_ROWS = WHALE_ART_ROWS;
+/**
+ * 块体大字的行数：上排 5 + 空 1 + 下排 5。
+ *
+ * 导出是给回归钉的：`portrait` 立绘槽高（`splashArtRows.ts` 的
+ * `PORTRAIT_ART_ROWS`）**等于这个数**——`LogoV2` 把娘立绘钳在与文字列等高的
+ * 槽里（`textColumnRows` = 两排大字 + 空行），落地页是 `chrome="minimal"`，
+ * 槽高就是大字块的行数。两处一漂移，预算就重新和渲染分叉。
+ */
+export const BIG_TITLE_ROWS = 11;
 /** 只留文字的档位：一行纯标题。 */
 const PLAIN_TITLE_ROWS = 1;
 /** 输入框卡片占的行数：边框 2 + 输入 1（第三版：参数行移出框外）。 */
@@ -73,18 +85,23 @@ const TIP_BLOCK_ROWS = 3;
 /** 矮屏撤呼吸后的紧档（自身 1 + 留白 1）。 */
 const TIP_BLOCK_ROWS_TIGHT = 2;
 /**
- * 双角铭牌：自身 2 行 + 上方 1 行留白。自身 2 行是第七版**版本号竖排**带来
- * 的——右下角两行（`dsh-tui v…` 在上、`dsh-core v…` 在下），左下目录铭牌仍
- * 1 行、与第一行顶对齐。内核版本读不到时右侧只画 1 行（预算按 2 行上限算，
- * 矮屏阶梯的取舍顺序不变：先撤装饰、绝不让输入框被挤掉）。
+ * 双角铭牌：自身行数 + 上方 1 行留白。自身 = 第一行（`工作目录:分支` 与
+ * `dsh-tui v…` 共用底边）+ **一行一个内核**——第八版给右下角扩了内核区，
+ * 行数随内核数变，所以**由调用方传 `cornerRows`**；写死 2 行时，装了多个
+ * 内核的机器（DSH + Claude + Codex）会少算两行，和立绘槽那处是同一类账
+ * 不平（矮屏阶梯以为放得下、实际溢出）。
  */
-const CORNERS_BLOCK_ROWS = 3;
+const CORNERS_TOP_GAP_ROWS = 1;
+/** 铭牌自身行数的老口径（第一行 + 一个内核行）：内核数拿不到时的上限估算。 */
+const DEFAULT_CORNER_ROWS = 2;
 /**
  * @param columns - 内容区列数。
  * @param rows - 内容区行数。
  * @param options - whale / whaleGirl 对应设置项；font 是当天那款字体（字身宽度
  *   不同，宽轴阈值也跟着不同）；params 是框下有没有参数行（模型/思考深度/模式/
- *   权限全拿不到时为 false，成组行矮一行）。
+ *   权限全拿不到时为 false，成组行矮一行）；`artRows` 是**当天真正上场的立绘**
+ *   占的行数（`splashArtRows.ts` 解，缺省按像素鲸鱼 13 行）；`cornerRows` 是
+ *   右下角铭牌自身的行数（第一行 + 内核数，缺省按老口径 2 行）。
  * @returns 该尺寸下要渲染的部件。
  */
 export function resolveLaunchpadLayout(columns, rows, options) {
@@ -100,21 +117,23 @@ export function resolveLaunchpadLayout(columns, rows, options) {
     const showPlainTitle = !showBigTitle && !showWhale;
     const showHero = showWhale || showBigTitle || showPlainTitle;
     // 上下排布时头部 = 立绘 + 间隔 1 + 大字；退化档位取各自实际行数。
-    const artRows = showWhale ? WHALE_ART_ROWS : 0;
+    // 立绘行数按**当天上场的形态**算（鲸鱼 13 / 娘与吉祥物 15），不写死。
+    const artRows = showWhale ? (options.artRows ?? DEFAULT_ART_ROWS) : 0;
     const titleRows = showBigTitle ? BIG_TITLE_ROWS : PLAIN_TITLE_ROWS;
     const heroRows = showHero ? (artRows > 0 ? artRows + 1 + titleRows : titleRows) : 0;
     // 头部整块（含根盒 marginTop）实际占的行数：阶梯与 totalRows 都按它算。
     const heroBlockRows = showHero ? heroRows + HERO_TOP_MARGIN : 0;
     // 第六版行数预算：输入框（恒 3）+ 框下成组行（参数 1 + 呼吸留白 0/1 +
-    // 键帽 1 + Tips 3）+ 双角铭牌 2。撤的顺序「从最可省到最不可省」：
-    // 新增的两处呼吸（词标↔输入框、入口行↔Tips）→ 参数行呼吸留白 → Tips 行
-    // 本身 → 键帽行 → 立绘（**所有留白永远排在 Tips/入口行之前撤**，
-    // 绝不让呼吸把输入框挤掉）。
+    // 键帽 1 + Tips 3）+ 双角铭牌（自身行数 + 上方留白）。撤的顺序「从最可省
+    // 到最不可省」：新增的两处呼吸（词标↔输入框、入口行↔Tips）→ 参数行呼吸
+    // 留白 → Tips 行本身 → 键帽行 → 立绘（**所有留白永远排在 Tips/入口行之
+    // 前撤**，绝不让呼吸把输入框挤掉）。
     const paramRows = options.params === true ? PARAM_ROWS : 0;
     const gapRows = paramRows > 0 ? PARAM_HINTS_GAP_ROWS : 0;
     const cardRows = CARD_ROWS;
+    const cornersBlockRows = (options.cornerRows ?? DEFAULT_CORNER_ROWS) + CORNERS_TOP_GAP_ROWS;
     const withArt = artRows > 0 ? artRows + 1 : 0;
-    const core = heroBlockRows + cardRows + paramRows + CORNERS_BLOCK_ROWS;
+    const core = heroBlockRows + cardRows + paramRows + cornersBlockRows;
     // 每一档的总行数。顺序即从最全的往下掉：先试最全的，放不下就往下掉。
     // full 带 4 个变体（呼吸×参数留白的紧/松组合）、no-tip 带 3 个：
     // 呼吸在（默认 2/2）→ 撤呼吸（紧档 1/1）→ 撤参数留白，全部都矮于撤 Tips。
@@ -154,7 +173,7 @@ export function resolveLaunchpadLayout(columns, rows, options) {
     const heroGapRows = keepBreath ? HERO_TO_CARD_GAP : HERO_TO_CARD_GAP_TIGHT;
     const tipGapRows = keepBreath ? TIP_BLOCK_ROWS - 1 : TIP_BLOCK_ROWS_TIGHT - 1;
     const total = (showTip ? 1 + tipGapRows : 0) + hintsGapRows + (showHints ? HINTS_ROWS : 0) + heroBlockFinal
-        + heroGapRows + cardRows + paramRows + CORNERS_BLOCK_ROWS;
+        + heroGapRows + cardRows + paramRows + cornersBlockRows;
     return {
         stage,
         // dropArt 只撤立绘——`heroRowsFinal`/`totalRows` 都按「撤立绘、留大字」算，

package/lib/types/components/messages/TeamMessageBubble.d.ts

@@ -0,0 +1,20 @@
+import React from 'react';
+type Props = {
+    /** The sending team member's name. */
+    sender: string;
+    text: string;
+    /** Adds the top margin between turns. */
+    marginTopOnTurn: boolean;
+    /** Message-selection mode highlight. */
+    isSelected?: boolean;
+};
+/**
+ * An Agent Teams peer message delivered to this session: a `✉ <sender>` line
+ * in the agent tint, then the body in plain text with a hanging indent — it
+ * reads apart from the human's bold `❯` prompt it shares a log role with.
+ * The body wraps in its own flex column, so it fits whatever column hosts it
+ * (the main list, a child scene's padded page, a split with the workbench).
+ */
+export declare function TeamMessageBubble({ sender, text, marginTopOnTurn, isSelected }: Props): React.ReactNode;
+export {};
+//# sourceMappingURL=TeamMessageBubble.d.ts.map

package/lib/types/components/messages/TeamMessageBubble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TeamMessageBubble.d.ts","sourceRoot":"","sources":["../../../../src/components/messages/TeamMessageBubble.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,KAAK,KAAK,GAAG;IACX,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAA;IACxB,wCAAwC;IACxC,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAID;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,UAAkB,EAAE,EAAE,KAAK,GAAG,KAAK,CAAC,SAAS,CAmB/G"}

package/lib/types/components/messages/TeamMessageBubble.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from '../../ui.js';
+import { stringWidth } from '../../ink/stringWidth.js';
+import { t } from '../../i18n.js';
+const MARK = '✉ ';
+/**
+ * An Agent Teams peer message delivered to this session: a `✉ <sender>` line
+ * in the agent tint, then the body in plain text with a hanging indent — it
+ * reads apart from the human's bold `❯` prompt it shares a log role with.
+ * The body wraps in its own flex column, so it fits whatever column hosts it
+ * (the main list, a child scene's padded page, a split with the workbench).
+ */
+export function TeamMessageBubble({ sender, text, marginTopOnTurn, isSelected = false }) {
+    return (_jsxs(Box, { flexDirection: "column", marginTop: marginTopOnTurn ? 1 : 0, backgroundColor: isSelected ? 'messageActionsBackground' : undefined, paddingRight: 1, children: [_jsxs(Text, { color: "toolDotTask", wrap: "truncate-end", children: [MARK, _jsx(Text, { bold: true, children: sender }), _jsx(Text, { dimColor: true, children: ` · ${t('team-message-label')}` })] }), _jsxs(Box, { flexDirection: "row", children: [_jsx(Box, { width: stringWidth(MARK), flexShrink: 0 }), _jsx(Box, { flexGrow: 1, flexShrink: 1, children: _jsx(Text, { wrap: "wrap", children: text }) })] })] }));
+}

package/lib/types/components/sidePanel/PanelHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PanelHost.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/PanelHost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAKnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,qCAAqC,EAAE,YAAY,CAAA;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E,yCAAyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,uCAAuC,EAAE,SAAS,CAAA;IAC/E,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD;AA4BD,wBAAgB,SAAS,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,cAAc,GAAG,KAAK,CAAC,SAAS,CAiFlJ"}
+{"version":3,"file":"PanelHost.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/PanelHost.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAKzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAKnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,qCAAqC,EAAE,YAAY,CAAA;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E,yCAAyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,uCAAuC,EAAE,SAAS,CAAA;IAC/E,oDAAoD;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD;AA4BD,wBAAgB,SAAS,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,cAAc,GAAG,KAAK,CAAC,SAAS,CAqFlJ"}

package/lib/types/components/sidePanel/PanelHost.js

@@ -59,7 +59,11 @@ export function PanelHost({ controller, channel, width, height, activity, attent
             panelStore.clearBadge(activeId);
     }, [activeId]);
     const mode = controller.zoom ? 'zoom' : 'split';
-    const runtimeContext = React.useMemo(() => ({ runtime: controller.runtime, channel, activity, attention, trajectory, openFullscreen }), [controller.runtime, channel, activity, attention, trajectory, openFullscreen]);
+    // focusChat 从控制器注入：面板送聊天后要能把列焦点交回聊天（见
+    // SidePanelRuntimeContext 的出口注释）。控制器对象每次渲染都是新的，
+    // 但 focusChat 本身是空依赖 useCallback，引用稳定。
+    const focusChat = controller.focusChat;
+    const runtimeContext = React.useMemo(() => ({ runtime: controller.runtime, channel, activity, attention, trajectory, openFullscreen, focusChat }), [controller.runtime, channel, activity, attention, trajectory, openFullscreen, focusChat]);
     return (_jsx(SidePanelRuntimeContext.Provider, { value: runtimeContext, children: visibleEntries.map(entry => {
             const def = entry.definition;
             const isActive = activeEntry !== undefined && def.id === activeEntry.definition.id;

package/lib/types/components/sidePanel/PanelStore.d.ts

@@ -25,6 +25,9 @@ export type PanelStoreEvent = {
 } | {
     readonly type: 'badge';
     readonly id: string;
+} | {
+    readonly type: 'hint';
+    readonly id: string;
 } | {
     readonly type: 'error';
     readonly id: string;
@@ -47,6 +50,11 @@ export declare class PanelStore {
      *  level/unread 都没变时不通知：适配器在每次 channel 变化（流式时每个
      *  delta）都会调这里，每次通知都会让订阅 list() 的宿主重渲染。 */
     setBadge(id: string, badge: Omit<PanelBadge, 'latestAt'> | null): void;
+    /**
+     * 面板广告自己当前的键位片段（见 PanelEntry.hint）。每次 channel delta 都会
+     * 有适配器调 setBadge，这里同理按值短路：没变就不通知宿主重渲染。
+     */
+    setHint(id: string, hint: string): void;
     clearBadge(id: string): void;
     reportError(id: string, error: unknown): void;
     subscribe: (listener: (event: PanelStoreEvent) => void) => (() => void);

package/lib/types/components/sidePanel/PanelStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PanelStore.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/PanelStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAErF,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC,uCAAuC;AACvC,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAC9C,kBAAkB;AAClB,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C;;4CAE4C;AAC5C,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAatD,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,QAAQ,CAAI;IACpB,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAA8B;IAEhD,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI;IA0BpE,IAAI,IAAI,SAAS,UAAU,EAAE;IAI7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvC;;+CAE2C;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,IAAI;IAWtE,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO5B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAsB7C,SAAS,GAAI,UAAU,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGrE;IAED,OAAO,CAAC,IAAI;CAIb;AAED,0DAA0D;AAC1D,eAAO,MAAM,UAAU,YAAmB,CAAA"}
+{"version":3,"file":"PanelStore.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/PanelStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAErF,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC,uCAAuC;AACvC,eAAO,MAAM,6BAA6B,IAAI,CAAA;AAC9C,kBAAkB;AAClB,eAAO,MAAM,qBAAqB,QAAS,CAAA;AAE3C;;4CAE4C;AAC5C,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAatD,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,SAAS,CAA8C;IAC/D,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,QAAQ,CAAI;IACpB,+CAA+C;IAC/C,OAAO,CAAC,UAAU,CAA8B;IAEhD,2DAA2D;IAC3D,QAAQ,CAAC,UAAU,EAAE,eAAe,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,IAAI;IA0BpE,IAAI,IAAI,SAAS,UAAU,EAAE;IAI7B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIvC;;+CAE2C;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,IAAI,GAAG,IAAI;IAWtE;;;OAGG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAOvC,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAO5B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAsB7C,SAAS,GAAI,UAAU,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC,CAGrE;IAED,OAAO,CAAC,IAAI;CAIb;AAED,0DAA0D;AAC1D,eAAO,MAAM,UAAU,YAAmB,CAAA"}

package/lib/types/components/sidePanel/PanelStore.js

@@ -69,6 +69,17 @@ export class PanelStore {
         this.entries.set(id, { ...entry, badge: next });
         this.emit({ type: 'badge', id });
     }
+    /**
+     * 面板广告自己当前的键位片段（见 PanelEntry.hint）。每次 channel delta 都会
+     * 有适配器调 setBadge，这里同理按值短路：没变就不通知宿主重渲染。
+     */
+    setHint(id, hint) {
+        const entry = this.entries.get(id);
+        if (entry === undefined || entry.hint === hint)
+            return;
+        this.entries.set(id, { ...entry, hint });
+        this.emit({ type: 'hint', id });
+    }
     clearBadge(id) {
         const entry = this.entries.get(id);
         if (entry === undefined || entry.badge === null)

package/lib/types/components/sidePanel/SidePanelColumn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SidePanelColumn.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/SidePanelColumn.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAMnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAI5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,qCAAqC,EAAE,YAAY,CAAA;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,uCAAuC,EAAE,SAAS,CAAA;CAChF;AAoCD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CAuEhJ"}
+{"version":3,"file":"SidePanelColumn.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/SidePanelColumn.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AAMnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAI5D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IACxC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,qCAAqC,EAAE,YAAY,CAAA;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,uCAAuC,EAAE,SAAS,CAAA;CAChF;AAoCD,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,oBAAoB,GAAG,KAAK,CAAC,SAAS,CAmFhJ"}

package/lib/types/components/sidePanel/SidePanelColumn.js

@@ -55,6 +55,18 @@ export function SidePanelColumn({ width, controller, channel, activity, attentio
     // oxlint-disable-next-line typescript/no-unnecessary-condition -- runtime guard: partial fixture channels
     const trajectoryUnsupported = controller.activePanelId === 'trajectory' && channel.trajectorySource?.() === 'unsupported';
     const canExpand = activeEntry?.definition.capabilities?.fullscreen === true && onExpand !== undefined && !trajectoryUnsupported;
+    // 底栏拼序 = 重要性：导航 → 面板自己绑的键 → 列控制。宿主不点名任何面板：
+    // 面板经 panelStore 广告自己此刻的键位（例如 btw 在编辑层只说「↑ 回标题」、
+    // 在列表层才说 s/c），没广告过的才退回能力位那一段。窄面板从尾部截断，所以
+    // 面板键排在列控制前；未聚焦时面板收不到按键，那一格继续只说怎么把焦点拿过来。
+    const panelSegment = activeEntry === undefined
+        ? ''
+        : activeEntry.hint !== undefined
+            ? activeEntry.hint
+            : activeEntry.definition.capabilities?.sendToChat === true ? t('panel-hint-send-to-chat') : '';
+    const focusedHint = t('panel-hint-focused')
+        + (panelSegment === '' ? '' : ' · ' + panelSegment)
+        + ' · ' + t('panel-hint-zoom-width');
     // 标签点击与 ←/→ 宿主键走同一条路（openPanel 会顺带把焦点给右栏）。
     const onSelectPanel = React.useCallback((id) => { controller.openPanel(id, { focus: true }); }, 
     // openPanel 在 useSidePanel 里是空依赖 useCallback（引用稳定）；
@@ -64,5 +76,5 @@ export function SidePanelColumn({ width, controller, channel, activity, attentio
     const hostHeight = Math.max(1, rows - 4);
     return (_jsxs(Box, { flexDirection: "column", width: width, flexGrow: 1, children: [_jsx(PanelBar, { tabs: tabs, activeId: controller.activePanelId, width: width - 2, focused: focused, canExpand: canExpand, onExpand: canExpand ? () => onExpand?.(controller.activePanelId ?? '') : undefined, onSelect: onSelectPanel }), _jsx(Rule, { focused: focused }), _jsx(Box, { flexDirection: "column", flexGrow: 1, overflow: "hidden", children: anyRegistered
                     ? (_jsx(PanelHost, { controller: controller, channel: channel, width: width, height: hostHeight, activity: activity, attention: attention, trajectory: trajectory, openFullscreen: onExpand }))
-                    : _jsx(EmptyNone, {}) }), _jsx(Rule, { focused: focused }), _jsx(Box, { height: 1, flexShrink: 0, paddingX: 1, overflow: "hidden", children: _jsx(Text, { dimColor: true, wrap: "truncate-end", children: focused ? t('panel-hint-focused') : t('panel-hint-unfocused') }) })] }));
+                    : _jsx(EmptyNone, {}) }), _jsx(Rule, { focused: focused }), _jsx(Box, { height: 1, flexShrink: 0, paddingX: 1, overflow: "hidden", children: _jsx(Text, { dimColor: true, wrap: "truncate-end", children: focused ? focusedHint : t('panel-hint-unfocused') }) })] }));
 }

package/lib/types/components/sidePanel/SidePanelRuntimeContext.d.ts

@@ -30,6 +30,11 @@ export interface SidePanelRuntimeContextValue {
      *  未接（或该 Panel 没有整屏形态）时 undefined，按钮照画但点击无效——
      *  宿主是否可展开由 PanelDefinition.capabilities.fullscreen 决定。 */
     readonly openFullscreen?: (panelId: string) => void;
+    /** 「回主输入框」出口：Panel 把内容送聊天（attachContext）后把列焦点交回
+     *  聊天——chip 就在眼前、可直接接着打字，toast 里的「Esc 可撤」也立刻
+     *  成立（剥 chip 的那把 Esc 只有主输入框有焦点时才收得到）。宿主
+     *  （PanelHost）从 controller.focusChat 注入；未接时送完焦点不动。 */
+    readonly focusChat?: () => void;
 }
 export declare const SidePanelRuntimeContext: React.Context<SidePanelRuntimeContextValue | null>;
 export declare function useSidePanelChannel(): ChannelUi;
@@ -37,6 +42,8 @@ export declare function useSidePanelChannel(): ChannelUi;
 export declare function useSidePanelTrajectory(): TrajBuild | undefined;
 /** 「全屏」出口：宿主没接时返回 undefined（按钮点击静默无效）。 */
 export declare function useSidePanelFullscreen(): ((panelId: string) => void) | undefined;
+/** 「回主输入框」出口：宿主没接时返回 undefined（送聊天后焦点不动）。 */
+export declare function useSidePanelFocusChat(): (() => void) | undefined;
 export declare const PanelContext: React.Context<{
     readonly panelId: string;
 } | null>;

package/lib/types/components/sidePanel/SidePanelRuntimeContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SidePanelRuntimeContext.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/SidePanelRuntimeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAA;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B;sDACkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;IAChC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E;6CACyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAA;IAC/B;;+DAE2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACpD;AAED,eAAO,MAAM,uBAAuB,oDAAiE,CAAA;AAErG,wBAAgB,mBAAmB,IAAI,SAAS,CAI/C;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,IAAI,SAAS,GAAG,SAAS,CAE9D;AAED,0CAA0C;AAC1C,wBAAgB,sBAAsB,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAEhF;AAED,eAAO,MAAM,YAAY;sBAA2C,MAAM;SAAgB,CAAA"}
+{"version":3,"file":"SidePanelRuntimeContext.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/SidePanelRuntimeContext.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAA;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAA;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uCAAuC,CAAA;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAA;IAC3B;sDACkD;IAClD,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAA;IAChC,oDAAoD;IACpD,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/E;6CACyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAA;IAC/B;;+DAE2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IACnD;;;0DAGsD;IACtD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAA;CAChC;AAED,eAAO,MAAM,uBAAuB,oDAAiE,CAAA;AAErG,wBAAgB,mBAAmB,IAAI,SAAS,CAI/C;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,IAAI,SAAS,GAAG,SAAS,CAE9D;AAED,0CAA0C;AAC1C,wBAAgB,sBAAsB,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAEhF;AAED,6CAA6C;AAC7C,wBAAgB,qBAAqB,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAEhE;AAED,eAAO,MAAM,YAAY;sBAA2C,MAAM;SAAgB,CAAA"}

package/lib/types/components/sidePanel/SidePanelRuntimeContext.js

@@ -23,4 +23,8 @@ export function useSidePanelTrajectory() {
 export function useSidePanelFullscreen() {
     return React.useContext(SidePanelRuntimeContext)?.openFullscreen;
 }
+/** 「回主输入框」出口：宿主没接时返回 undefined（送聊天后焦点不动）。 */
+export function useSidePanelFocusChat() {
+    return React.useContext(SidePanelRuntimeContext)?.focusChat;
+}
 export const PanelContext = React.createContext(null);

package/lib/types/components/sidePanel/btw/BtwComposer.d.ts

@@ -32,6 +32,9 @@ type BtwKeyFlags = SidePanelKeyFlags & {
 /**
  * 单行 composer 的键语义。返回 null = 未消费（面板形态交宿主回退键，
  * 全屏形态交场景其余分支）；返回对象按 exitFocus > submit > 编辑 写回。
+ * ←/→ 先移光标，贴到行首/行尾后返回未消费——面板形态据此切面板。
+ * ↑ 让位给列表（选中轮，见 BtwPanelAdapter 的选中态）；↓ 在单行框里没有
+ * 语义，吃掉即可，免得漏给主聊天去滚 transcript。
  */
 export declare function btwComposerKey(state: BtwComposerState, input: string, key: BtwKeyFlags): BtwComposerKeyResult | null;
 export declare function BtwComposer({ state, focused, busy, notice, onActivate, }: {

package/lib/types/components/sidePanel/btw/BtwComposer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BtwComposer.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/btw/BtwComposer.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGpD,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,wCAAwC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,qDAAqD;AACrD,KAAK,WAAW,GAAG,iBAAiB,GAAG;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,oBAAoB,GAAG,IAAI,CA0BpH;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,OAAO,EACP,IAAI,EACJ,MAAM,EACN,UAAU,GACX,EAAE;IACD,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAA;IAClF,iCAAiC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CA6ClB"}
+{"version":3,"file":"BtwComposer.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/btw/BtwComposer.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAGzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAGpD,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,8DAA8D;AAC9D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,wCAAwC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,qDAAqD;AACrD,KAAK,WAAW,GAAG,iBAAiB,GAAG;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,oBAAoB,GAAG,IAAI,CAsCpH;AAED,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,OAAO,EACP,IAAI,EACJ,MAAM,EACN,UAAU,GACX,EAAE;IACD,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAA;IAChC,2BAA2B;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,6BAA6B;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAA;IAClF,iCAAiC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;CACjC,GAAG,KAAK,CAAC,SAAS,CA6ClB"}

package/lib/types/components/sidePanel/btw/BtwComposer.js

@@ -5,6 +5,9 @@ import { nextCodePoint, previousCodePoint } from '../../AgentMessageComposer.js'
 /**
  * 单行 composer 的键语义。返回 null = 未消费（面板形态交宿主回退键，
  * 全屏形态交场景其余分支）；返回对象按 exitFocus > submit > 编辑 写回。
+ * ←/→ 先移光标，贴到行首/行尾后返回未消费——面板形态据此切面板。
+ * ↑ 让位给列表（选中轮，见 BtwPanelAdapter 的选中态）；↓ 在单行框里没有
+ * 语义，吃掉即可，免得漏给主聊天去滚 transcript。
  */
 export function btwComposerKey(state, input, key) {
     if (key.escape === true)
@@ -19,6 +22,11 @@ export function btwComposerKey(state, input, key) {
     // Tab 离开编辑层去列表（与 TrajectoryPanel 同款双形态判定）。
     if (key.tab === true || input === '\t')
         return { exitFocus: true };
+    // ↑ 也从编辑层上到列表：光标落在本轮标题上（列表形态默认选中最后一条）。
+    if (key.upArrow === true)
+        return { exitFocus: true };
+    if (key.downArrow === true)
+        return {};
     if (key.backspace === true || key.delete === true) {
         if (caret <= 0)
             return { state: { ...state, caret } };
@@ -29,10 +37,17 @@ export function btwComposerKey(state, input, key) {
     // leftArrow 判定不看 shift）——编辑中途也能一键换面板，不必先 Esc 收起。
     if ((key.leftArrow === true || key.rightArrow === true) && key.shift === true)
         return null;
-    if (key.leftArrow === true)
-        return { state: { ...state, caret: previousCodePoint(state.text, caret) } };
-    if (key.rightArrow === true)
-        return { state: { ...state, caret: nextCodePoint(state.text, caret) } };
+    // 光标先走、到头让位：还能移就移一格，已经贴着行首/行尾则返回未消费——
+    // 面板形态下落宿主切面板，底栏「←/→ 切换」因此在编辑层同样成立；场景
+    // 形态下无人接管，等于空操作。
+    if (key.leftArrow === true) {
+        const previous = previousCodePoint(state.text, caret);
+        return previous === caret ? null : { state: { ...state, caret: previous } };
+    }
+    if (key.rightArrow === true) {
+        const next = nextCodePoint(state.text, caret);
+        return next === caret ? null : { state: { ...state, caret: next } };
+    }
     if (key.home === true)
         return { state: { ...state, caret: 0 } };
     if (key.end === true)
@@ -46,8 +61,5 @@ export function BtwComposer({ state, focused, busy, notice, onActivate, }) {
     const { text, caret } = state;
     const shown = Math.min(caret, text.length);
     const afterCaret = nextCodePoint(text, shown);
-    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [_jsx(Box, { width: "100%", flexShrink: 0, borderStyle: "round", borderColor: focused ? 'accent' : undefined, onClick: onActivate === undefined ? undefined : event => {
-                    event.stopImmediatePropagation();
-                    onActivate();
-                }, children: _jsxs(Box, { flexDirection: "row", flexShrink: 0, paddingLeft: 1, paddingRight: 1, children: [_jsx(Text, { color: focused ? 'accent' : undefined, bold: true, children: '›' }), _jsx(Text, { children: ' ' }), focused ? (_jsxs(_Fragment, { children: [_jsxs(Box, { flexDirection: "row", flexShrink: 1, minWidth: 0, children: [_jsx(Text, { wrap: "truncate", children: text.slice(0, shown) }), _jsx(InputCaret, { children: text.slice(shown, afterCaret) || ' ' }), text.slice(afterCaret) !== '' ? _jsx(Text, { wrap: "truncate", children: text.slice(afterCaret) }) : null] }), _jsx(Box, { flexGrow: 1, flexShrink: 0, children: _jsx(Text, { children: " " }) }), _jsx(Box, { flexShrink: 0, children: _jsxs(Text, { dimColor: true, children: [" ", t('btw-input-hint-edit')] }) })] })) : (_jsx(Text, { dimColor: true, wrap: "truncate", children: text === '' ? t('btw-input-placeholder') : text }))] }) }), notice !== undefined && (_jsx(Text, { color: notice.failure ? 'error' : undefined, wrap: "truncate", children: notice.text }))] }));
+    return (_jsxs(Box, { flexDirection: "column", flexShrink: 0, children: [_jsx(Box, { width: "100%", flexShrink: 0, borderStyle: "round", borderColor: focused ? 'accent' : undefined, onClick: onActivate === undefined ? undefined : () => onActivate(), children: _jsxs(Box, { flexDirection: "row", flexShrink: 0, paddingLeft: 1, paddingRight: 1, children: [_jsx(Text, { color: focused ? 'accent' : undefined, bold: true, children: '›' }), _jsx(Text, { children: ' ' }), focused ? (_jsxs(_Fragment, { children: [_jsxs(Box, { flexDirection: "row", flexShrink: 1, minWidth: 0, children: [_jsx(Text, { wrap: "truncate", children: text.slice(0, shown) }), _jsx(InputCaret, { children: text.slice(shown, afterCaret) || ' ' }), text.slice(afterCaret) !== '' ? _jsx(Text, { wrap: "truncate", children: text.slice(afterCaret) }) : null] }), _jsx(Box, { flexGrow: 1, flexShrink: 0, children: _jsx(Text, { children: " " }) }), _jsx(Box, { flexShrink: 0, children: _jsxs(Text, { dimColor: true, children: [" ", t('btw-input-hint-edit')] }) })] })) : (_jsx(Text, { dimColor: true, wrap: "truncate", children: text === '' ? t('btw-input-placeholder') : text }))] }) }), notice !== undefined && (_jsx(Text, { color: notice.failure ? 'error' : undefined, wrap: "truncate", children: notice.text }))] }));
 }

package/lib/types/components/sidePanel/btw/BtwPanelAdapter.d.ts

@@ -1,7 +1,8 @@
 /**
  * btw 侧栏面板：线程滚动 + Markdown + 底部 composer 连续追问。Esc 先退出
  * composer 编辑（草稿保留），列表层不消费 Esc，再交宿主回聊天；Tab 在列表
- * 与 composer 间切焦点；未消费的键交宿主（←/→ 仍切面板）。
+ * 与 composer 间切焦点；未消费的键交宿主（←/→ 切面板——编辑层里光标贴到
+ * 行首/行尾后也让位）。
  *
  * badge 派生（镜像 jobs/agents 适配器）：面板不可见期间完成的新 answer
  * 增 info unread、失败 error level 计未读、运行中只亮点不计未读；进入

package/lib/types/components/sidePanel/btw/BtwPanelAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BtwPanelAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/btw/BtwPanelAdapter.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAazB,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,aAAa,CAAA;AAY9D,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAsLhG"}
+{"version":3,"file":"BtwPanelAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/btw/BtwPanelAdapter.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAazB,OAAO,KAAK,EAAmB,UAAU,EAAE,MAAM,aAAa,CAAA;AAY9D,wBAAgB,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,UAAU,GAAG,KAAK,CAAC,SAAS,CAiRhG"}