dsh-plugin-core 0.33.3 → 0.35.0

package/dist/adv/session/SessionViewModal.d.ts

@@ -1,11 +1,29 @@
-import { createElement as h } from 'react';
+import { createElement as h, type ReactNode } from 'react';
 import { type Translate } from '../../utils/i18n.js';
 import type { SessionViewTarget } from './open-session-view.js';
 import { type ChangedFileReviewLocator } from './mirror/ChangedFilesCard.js';
 export interface SessionViewModalProps {
     t?: Translate;
-    /** 弹窗标题：**会话自己的标题**（宿主 sessions.list 的 displayTitle）；缺省用「会话预览」。 */
+    /**
+     * 标题行（第一级）：核心画在标题位，下方 sessionId 副标题行与归档徽标不受影响。
+     * 想在标题后跟标签 / 按钮 / 自己的一段节点，塞进这里。
+     * 缺省 = `heading`，再缺省 =「会话预览」。
+     */
+    title?: ReactNode;
+    /** @deprecated 0.34 的旧名（只收字符串），等价 `title`；两者都给时以 `title` 为准。 */
     heading?: string;
+    /**
+     * 整块替换左侧标题区（第二级：标题行 + sessionId 行 + 归档徽标）。传了则 `title` / `heading` 不生效；
+     * 归档徽标改挂到右侧动作区最前（归档是数据事实，不能因为自定义标题就消失）。
+     * 右侧「继续对话」与关闭 ✕ 不受影响。
+     */
+    header?: ReactNode;
+    /** 头部右侧追加动作：排在核心「继续对话」之后、关闭 ✕ 之前。 */
+    headerActions?: ReactNode;
+    /** 会话内容最顶端（滚动容器内、所有节点与「加载更早」之前）；随会话一起滚。 */
+    bodyHeader?: ReactNode;
+    /** 会话内容最底端（滚动容器内、最后一条内容与运行中行之后）；随会话一起滚。 */
+    bodyFooter?: ReactNode;
     sessionId: string;
     view: SessionViewTarget;
     onClose: () => void;

package/dist/adv/session/SessionViewModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionViewModal.d.ts","sourceRoot":"","sources":["../../../src/adv/session/SessionViewModal.ts"],"names":[],"mappings":"AAUA,OAAO,EAAY,aAAa,IAAI,CAAC,EAA4F,MAAM,OAAO,CAAA;AAI9I,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAUhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAgB/D,OAAO,EAAoB,KAAK,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAgqB9F,MAAM,WAAW,qBAAqB;IACpC,CAAC,CAAC,EAAE,SAAS,CAAA;IACb,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACpE,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C;;qDAEiD;IACjD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACnF;mEAC+D;IAC/D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAA;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAgcnF"}
+{"version":3,"file":"SessionViewModal.d.ts","sourceRoot":"","sources":["../../../src/adv/session/SessionViewModal.ts"],"names":[],"mappings":"AAUA,OAAO,EAAY,aAAa,IAAI,CAAC,EAA4F,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAI9J,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAYhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAiB/D,OAAO,EAAoB,KAAK,wBAAwB,EAAE,MAAM,8BAA8B,CAAA;AAguB9F,MAAM,WAAW,qBAAqB;IACpC,CAAC,CAAC,EAAE,SAAS,CAAA;IACb;;;;OAIG;IACH,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,qCAAqC;IACrC,aAAa,CAAC,EAAE,SAAS,CAAA;IACzB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,2CAA2C;IAC3C,UAAU,CAAC,EAAE,SAAS,CAAA;IACtB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,iBAAiB,CAAA;IACvB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,8EAA8E;IAC9E,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IACpE,uDAAuD;IACvD,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7C;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C;;qDAEiD;IACjD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACnF;mEAC+D;IAC/D,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAA;CAC3D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CA4enF"}

package/dist/adv/session/SessionViewModal.js

@@ -13,11 +13,12 @@ import { IconArchiveOutlineRegular, IconBranchOutlineRegular, IconNewChatOutline
 import { Modal } from '../../ui/feedback/Modal.js';
 import { Button } from '../../ui/actions/Button.js';
 import { t as coreT } from '../../utils/i18n.js';
-import { ChatHint, ChatNodeListMirror, ChatOlderButton, ChatViewFrame } from './mirror/ChatView.js';
-import { GenericCommandCard } from './mirror/GenericCommandCard.js';
+import { ChatCallRow, ChatHint, ChatNodeListMirror, ChatOlderButton, ChatOpenError, ChatViewFrame } from './mirror/ChatView.js';
+import { GenericCommandCard, imageCardFace } from './mirror/GenericCommandCard.js';
 import { CommandCard } from './mirror/CommandCard.js';
 import { MessageIconActionsMirror } from './mirror/MessageIconActions.js';
-import { AssistantMarkdown, CompactionItemMirror, ModelRetryItemMirror, TurnErrorItemMirror, TurnMaxTokensItemMirror, UserMessage } from './mirror/MessageItem.js';
+import { AssistantMarkdown, AssistantStoppedBadge, CompactionItemMirror, ModelRetryItemMirror, TurnErrorItemMirror, TurnMaxTokensItemMirror, UserMessage } from './mirror/MessageItem.js';
+import { ImageGalleryMirror } from './mirror/MessageImage.js';
 import { BashRowMirror } from './mirror/BashRow.js';
 import { SkillRowMirror } from './mirror/SkillRow.js';
 import { ContextInjectionRowMirror } from './mirror/ContextInjectionRow.js';
@@ -55,19 +56,39 @@ function safeJson(value) {
         return String(value);
     }
 }
-/** 提取内容块的可读文本：text 拼接、图片占位（官方 ContentBlock 是 merge-extensible map）。 */
-function contentText(blocks) {
+/**
+ * 提取内容块的可读文本：text 拼接、图片占位（官方 ContentBlock 是 merge-extensible map）。
+ * @param imagePlaceholder 图片块是否退化成「[图片]」文本：图片能真渲染时传 false（官方文本里没有图片）。
+ */
+function contentText(blocks, imagePlaceholder = true) {
     if (blocks === undefined)
         return '';
     const parts = blocks.map((block) => {
         if (block !== null && typeof block === 'object' && block.type === 'text' && typeof block.text === 'string')
             return block.text;
-        if (block !== null && typeof block === 'object' && block.type === 'image')
+        if (imagePlaceholder && block !== null && typeof block === 'object' && block.type === 'image')
             return coreT('sessionImage');
         return '';
     }).filter(part => part !== '');
     return parts.join('\n');
 }
+/** 内容块里的官方 image 块（`{ type:'image', attachment: ImageAttachmentRef }`）→ 图片组。 */
+function contentImages(blocks) {
+    if (blocks === undefined)
+        return [];
+    const out = [];
+    for (const block of blocks) {
+        if (block === null || typeof block !== 'object' || block.type !== 'image')
+            continue;
+        const attachment = block.attachment;
+        if (typeof attachment !== 'object' || attachment === null)
+            continue;
+        if (typeof attachment.attachmentId !== 'string' || attachment.attachmentId === '')
+            continue;
+        out.push({ attachment });
+    }
+    return out;
+}
 /**
  * 提取内容块里的**官方 file 块**（2026-10-03 核实）：随附文件以官方附件形式发进会话后，
  * 会话快照的 user 节点 content 里就是它 ⇒ 弹窗里照样渲染成附件卡（与官方页一致）。
@@ -119,24 +140,31 @@ function blocksOf(value) {
  * 官方 ToolCallBlock（uic contract/records.d.ts:140）→ 工具卡 props。
  * running 半截（phase: preparing/start）只有 name/argsRaw；settled（kind: tool-result）带输出与错误。
  */
-function toolCallCard(node, t, onOpenFile) {
+function toolCallCard(node, t, onOpenFile, loadImage) {
     const root = dataOf(node).root;
     if (root === undefined || root === null)
         return null;
     const settled = root.kind === 'tool-result';
     const call = settled ? root.call : root;
     const error = root.error;
+    const name = typeof call?.name === 'string' ? call.name : 'tool';
+    const argsRaw = typeof call?.argsRaw === 'string' ? call.argsRaw : '';
+    const isError = root.isError === true;
+    const content = settled ? root.content : undefined;
     return {
-        name: typeof call?.name === 'string' ? call.name : 'tool',
-        argsRaw: typeof call?.argsRaw === 'string' ? call.argsRaw : '',
-        output: settled ? contentText(root.content) : '',
-        isError: root.isError === true,
+        name,
+        argsRaw,
+        output: settled ? contentText(content, false) : '',
+        isError,
         errorName: error?.name,
         meta: root.meta,
         settled,
         phase: settled ? undefined : root.phase === 'preparing' ? 'preparing' : 'start',
         interrupted: error?.code === 'interrupted',
         errorCode: error?.code,
+        // 官方 read_image 专属卡：图片来自结果内容块的附件引用，不是文本。
+        image: imageCardFace(name, argsRaw, content, root.meta, isError, settled) ?? undefined,
+        loadImage,
         onOpenFile,
         t,
     };
@@ -204,7 +232,13 @@ sessionId,
 /** 变更文件点击出口（官方 openReview 等价）：带改动身份；undefined = 变更卡不可点。 */
 onOpenReview, 
 /** 官方 endsWithResponse / hasLaterChatNode（尾部操作行常显与分支可用性）。 */
-tailFacts) {
+tailFacts, 
+/** 图片 loader（view.loadImage）；缺席 = 图片块退回「[图片]」文本。 */
+loadImage, 
+/** 底端插槽：挂在最后一条 tail 之前（复制 / 分支 / 用量操作行之上）。 */
+footerSlot, 
+/** 该挂到哪个节点的 key 上（最后一条带回复的 turn-tail；undefined = 不挂）。 */
+footerKey) {
     switch (node.kind) {
         case 'turn-trigger':
             return h(TurnTriggerNodeViewMirror, { data: node.data, t });
@@ -230,13 +264,14 @@ tailFacts) {
             const changesCard = atLastTail && changesSeq !== undefined && sessionId !== undefined
                 ? h(ChangedFilesCard, { sessionId, seq: changesSeq, onOpenReview, t })
                 : null;
-            const tailSlot = changesCard === null && !showGrid
+            // 底端插槽 = tailSlot 的最后一项 ⇒ 在交付文件 / 变更卡**下面**、复制/分支/用量操作行**上面**。
+            const atFooter = footerKey !== undefined && node.key === footerKey;
+            const tailSlot = changesCard === null && !showGrid && !atFooter
                 ? null
-                : h(Fragment, null, changesCard, showGrid ? h(DeliverablesGridMirror, { files: deliverFiles, onOpen: fileOpen?.open, t }) : null);
-            const tail = data === undefined || data.closing === null || data.closing === undefined
+                : h(Fragment, null, changesCard, showGrid ? h(DeliverablesGridMirror, { files: deliverFiles, onOpen: fileOpen?.open, t }) : null, atFooter ? footerSlot : null);
+            return data === undefined || data.closing === null || data.closing === undefined
                 ? null
                 : h(TurnTailNodeViewMirror, { data, onBranchAt, tailSlot, facts: tailFacts, t });
-            return tail;
         }
         case 'assistant-step': {
             // 官方块渲染器（lib/client.js:5818-5871）：
@@ -256,7 +291,12 @@ tailFacts) {
                 : groupPart === 'response'
                     ? contentBlocks.filter(block => block.kind !== 'reasoning')
                     : contentBlocks;
-            const parts = assistantBlocks(visible, t, fileOpen?.mentions, streaming);
+            const parts = assistantBlocks(visible, t, fileOpen?.mentions, streaming, loadImage);
+            // 官方 AssistantMarkdown.stopped：被中断的整步末尾一枚「已停止」；只画思考块的组内不重复画。
+            const stopped = interrupted
+                && (groupPart !== 'reasoning' || !blocks.some(block => block.kind !== 'reasoning' && block.kind !== 'tool-call'));
+            if (stopped)
+                parts.push(h(AssistantStoppedBadge, { key: 'stopped', t }));
             return parts.length === 0 ? null : h('div', { className: 'dshpc-sv-assistant' }, parts);
         }
         case 'tool-call': {
@@ -265,7 +305,7 @@ tailFacts) {
             const root = dataOf(node).root;
             if (isPresentRoot(root))
                 return h(PresentRowMirror, { block: root, t });
-            const card = toolCallCard(node, t, fileOpen?.open);
+            const card = toolCallCard(node, t, fileOpen?.open, loadImage);
             if (card === null)
                 return null;
             // 官方 tool.call.toolview 槽位按工具名分派：bash / pwsh 走专属 BashRow（独立卡片，无 DisclosureRow）；
@@ -280,19 +320,23 @@ tailFacts) {
             // 官方 CommandNodeView → GenericCommandCard（ui-chat/chat/GenericCommandCard.tsx 原样复刻）。
             // 斜杠命令生命周期节点（records.d.ts：name/args/outcome）；走 CommandCard：标题=裸命令名、
             // 摘要=outcome 落定 text、仅多行才展开。之前漏接 ⇒ 落 default 显示「未支持的节点类型： command」。
-            return h(CommandCard, { node: dataOf(node), t });
+            return h(ChatCallRow, null, h(CommandCard, { node: dataOf(node), t }));
         }
         case 'user':
         case 'steering': {
             const blocks = dataOf(node).content;
-            const text = contentText(blocks);
+            const images = loadImage === undefined ? [] : contentImages(blocks);
+            // 官方文本里没有图片：能真出图时不再塞「[图片]」。
+            const text = contentText(blocks, loadImage === undefined || images.length === 0);
             // 随附文件（官方 file 块）：没有文本但有附件时**照样渲染**（不能整条消失）。
             const { files, hadFiles } = contentFiles(blocks);
-            if (text === '' && !hadFiles)
+            if (text === '' && !hadFiles && images.length === 0)
                 return null;
             return h(UserMessage, {
                 text,
                 files,
+                images,
+                loadImage,
                 referenceLabels: dataOf(node).referenceLabels,
                 skillNames: dataOf(node).skillNames,
                 t,
@@ -318,15 +362,18 @@ tailFacts) {
         // 决策 28：context（系统注入）/ unknown 仍默认过滤；
         // 0.2.x compaction 节点走官方 CompactionItem（此前漏渲染 ⇒ 压缩段整段消失）。
         case 'compaction':
-        case 'manual-compaction':
             return h(CompactionItemMirror, { node: dataOf(node), t });
+        case 'manual-compaction':
+            // 官方 ManualCompactionNodeView 同样套 callRow 外壳。
+            return h(ChatCallRow, null, h(CompactionItemMirror, { node: dataOf(node), t }));
         case 'context':
             return h(ContextInjectionRowMirror, { node: dataOf(node), t });
         case 'unknown':
             return null;
         default:
             // 决策 28：不认识的 kind 一律 fallback（折叠原文），升级不白屏。
-            return h('details', { className: 'dshpc-sv-tool' }, h('summary', { className: 'dshpc-sv-notice' }, `${t('sessionUnknownKind')} ${node.kind}`), h('pre', null, safeJson(node.data)));
+            // 外壳 = 官方 MessageItem.contextRow（官方 UnknownNodeView 的同一个容器类）。
+            return h('div', { className: officialClass('MessageItem', 'contextRow') ?? '' }, h('details', { className: 'dshpc-sv-tool' }, h('summary', { className: 'dshpc-sv-notice' }, `${t('sessionUnknownKind')} ${node.kind}`), h('pre', null, safeJson(node.data))));
     }
 }
 /**
@@ -337,7 +384,9 @@ tailFacts) {
  */
 function assistantBlocks(blocks, t, fileMentions, 
 /** 官方 streaming（节点 data.status === 'running'）：正文按流式尾渲染、末块思考行走 shimmer。 */
-streaming = false) {
+streaming = false, 
+/** 图片 loader；缺席 = 图片块退回「[图片]」文本占位。 */
+loadImage) {
     if (blocks === undefined)
         return [];
     const parts = [];
@@ -355,9 +404,28 @@ streaming = false) {
                     parts.push(h(ReasoningRowMirror, { key: `r${index}`, text: block.text, running: streaming && index === last, t }));
                 }
                 break;
-            case 'image':
-                parts.push(h('div', { key: `i${index}`, className: 'dshpc-sv-image' }, t('sessionImage')));
+            case 'image': {
+                // 官方：连续 image 块并成一组推一次（conversation.chat.message.images，align='start'）。
+                const previous = blocks[index - 1];
+                if (previous !== undefined && previous.kind === 'image')
+                    break;
+                const images = [];
+                for (const candidate of blocks.slice(index)) {
+                    if (candidate.kind !== 'image')
+                        break;
+                    const attachment = candidate.attachment;
+                    if (attachment !== null && typeof attachment === 'object' && typeof attachment.attachmentId === 'string') {
+                        images.push({ attachment });
+                    }
+                }
+                if (loadImage !== undefined && images.length > 0) {
+                    parts.push(h(ImageGalleryMirror, { key: `i${index}`, images, load: loadImage, align: 'start', t }));
+                }
+                else {
+                    parts.push(h('div', { key: `i${index}`, className: 'dshpc-sv-image' }, t('sessionImage')));
+                }
                 break;
+            }
             case 'tool-call':
                 break;
             default:
@@ -376,6 +444,7 @@ function renderLegacyNode(node, t, fileOpen) {
     switch (node.kind) {
         case 'user':
         case 'steering': {
+            // shortcut: legacy 兜底路径不带图片 loader（图片仍是「[图片]」占位）；keyed 主路已出真图。
             const text = contentText(node.content);
             const { files, hadFiles } = contentFiles(node.content);
             if (text === '' && !hadFiles)
@@ -695,11 +764,13 @@ export function SessionViewModal(props) {
     const isArchived = useSyncExternalStore(workspaceList.subscribe, archivedNow, NOT_ARCHIVED);
     const subscribe = useMemo(() => (onChange) => view.target.subscribe(onChange), [view]);
     const getSnapshot = useMemo(() => () => view.target.getSnapshot(), [view]);
-    const chat = useSyncExternalStore(subscribe, getSnapshot);
+    // 第三参 = 同一个快照函数：React 要求 SSR 必给，缺了直接抛错。这里的数据挂在 props 的 view 上
+    // （不是全局 store），服务端读同一个快照不会串数据；纯全局 store 才需要单独的空快照。
+    const chat = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
     // 会话生命周期（加载态 / 向前翻页按钮），同样只读订阅。
     const sessionSub = useMemo(() => (onChange) => view.session.subscribe(onChange), [view]);
     const sessionGet = useMemo(() => () => view.session.getSnapshot(), [view]);
-    const sessionSnap = useSyncExternalStore(sessionSub, sessionGet);
+    const sessionSnap = useSyncExternalStore(sessionSub, sessionGet, sessionGet);
     // host `inbox` 投影（faceOf('inbox')）：首轮 durable 事件落盘前用户消息的权威来源，
     // 冷读 / 新打开预览时也拿得到；本地回显被 retire 后靠它继续画气泡。
     const inboxSub = useMemo(() => (onChange) => view.inbox.subscribe(onChange), [view]);
@@ -729,6 +800,8 @@ export function SessionViewModal(props) {
     const [forkTarget, setForkTarget] = useState(null);
     const [forking, setForking] = useState(false);
     const [forkErr, setForkErr] = useState(null);
+    /** 官方 ChatView.modalAction（弹窗脚按钮 min-width 72px）；官方样式未注入时为 undefined。 */
+    const modalActionClass = officialClass('ChatView', 'modalAction') ?? undefined;
     const aliveRef = useRef(true);
     useEffect(() => () => { aliveRef.current = false; }, []);
     // 取消归档时收掉「因为归档才弹的」fork 确认框（atSeq 缺省 = 头部按钮触发）；
@@ -988,7 +1061,28 @@ export function SessionViewModal(props) {
     const tailFacts = useMemo(() => (keyed && store !== undefined
         ? buildTurnTailFacts({ order, store, lastTurn: lastTailTurn })
         : undefined), [keyed, order, store, lastTailTurn]);
-    const renderNode = useCallback((node, turnProcess, groupPart) => renderKeyedNode(node, turnProcess, tt, onBranchAt, fileOpen, groupPart, deliverFiles, lastTailTurn, lastTailChangesSeq, sessionId, props.onOpenReview, tailFacts), [tt, onBranchAt, fileOpen, deliverFiles, lastTailTurn, lastTailChangesSeq, sessionId, props.onOpenReview, tailFacts]);
+    // 底端插槽挂点：末尾是**带回复的 turn-tail** 时挂在它之前（最后那条回复之后、复制 / 分支 /
+    // 用量操作行之上）；没有回复（closing 为空）或末尾不是 tail ⇒ 退回流的末尾。
+    const footerAnchorKey = useMemo(() => {
+        if (!keyed || store === undefined)
+            return undefined;
+        const lastKey = order[order.length - 1];
+        const last = lastKey === undefined ? undefined : store.get(lastKey);
+        if (last?.kind !== 'turn-tail')
+            return undefined;
+        const closing = last.data?.closing;
+        return closing === null || closing === undefined ? undefined : lastKey;
+    }, [keyed, order, store]);
+    // 内容两端插槽（调用方自绘）：不传 = 不渲染元素（少一层空容器多吃一个 gap）；四态都渲染。
+    // 顶端槽的**下边距由自己的类固定**（见 session.css）：不依赖相邻项自己的 margin，
+    // 否则相邻项换一种（turn-trigger / 用户气泡 / 提示条）间距就跟着变。
+    const bodyHeaderRow = props.bodyHeader === undefined
+        ? null
+        : h('div', { key: 'bodyHeader', className: 'dshpc-sv-body-header' }, props.bodyHeader);
+    const bodyFooterRow = props.bodyFooter === undefined
+        ? null
+        : h('div', { key: 'bodyFooter', className: 'dshpc-sv-body-footer' }, props.bodyFooter);
+    const renderNode = useCallback((node, turnProcess, groupPart) => renderKeyedNode(node, turnProcess, tt, onBranchAt, fileOpen, groupPart, deliverFiles, lastTailTurn, lastTailChangesSeq, sessionId, props.onOpenReview, tailFacts, props.view.loadImage, bodyFooterRow, footerAnchorKey), [tt, onBranchAt, fileOpen, deliverFiles, lastTailTurn, lastTailChangesSeq, sessionId, props.onOpenReview, tailFacts, props.view.loadImage, bodyFooterRow, footerAnchorKey]);
     // 官方 grouped('chat')：把 keyed 流切成「独立条目 + 过程分组」（二级收折）。
     const isTurnClosed = useCallback((turn) => (turns?.get(turn) ?? turns?.get(String(turn)))?.status !== 'open', [turns]);
     const groupedView = useMemo(() => keyed ? buildProcessGroups(order, key => store?.get(key), isTurnClosed) : undefined, [keyed, order, store, isTurnClosed]);
@@ -1036,64 +1130,82 @@ export function SessionViewModal(props) {
         : h(RunningStatusMirror, { key: 'running', startTime: runningStartTime, t: tt });
     const body = rendered.length === 0 && pendingRows.length === 0
         ? [
-            h(ChatHint, {
-                key: 'hint',
-                text: openState === 'error' ? tt('sessionFailed')
-                    : openState === 'loading' || openState === 'cold' ? tt('sessionLoading')
-                        : tt('sessionEmpty'),
-            }),
+            bodyHeaderRow,
+            // 官方三态各走各的类：error = openError（错误色），loading / 空 = hint。
+            openState === 'error'
+                ? h(ChatOpenError, { key: 'hint', text: tt('sessionFailed') })
+                : h(ChatHint, {
+                    key: 'hint',
+                    text: openState === 'loading' || openState === 'cold' ? tt('sessionLoading') : tt('sessionEmpty'),
+                }),
             runningRow,
+            // 已挂在最后一条 tail 上的话这里不再画（否则同一个槽出现两次）。
+            footerAnchorKey === undefined ? bodyFooterRow : null,
         ]
         : [
+            bodyHeaderRow,
             showLoadOlder
                 ? h(ChatOlderButton, { key: 'older', label: tt('sessionLoadOlder'), onClick: () => { view.loadOlder(); } })
                 : null,
             ...rendered,
             ...pendingRows,
             runningRow,
+            footerAnchorKey === undefined ? bodyFooterRow : null,
         ];
     const flowChildren = Array.isArray(body) ? body : [body];
+    // 头部两槽：标题区整块替换（`header`）与右侧动作追加（`headerActions`）。
+    // 自定义标题区时归档徽标挪到动作区最前 —— 归档是数据事实，不能因为自定义标题就消失。
+    const customHeader = props.header !== undefined;
+    const archivedBadge = isArchived
+        ? h('span', { className: 'dshpc-sv-archived', title: tt('sessionArchived') }, h(IconArchiveOutlineRegular, { size: 12 }), tt('sessionArchived'))
+        : undefined;
+    // 「继续对话」：已归档 = 开分支图标 + 确认框；未归档 = 会话图标直跳官方会话页。
+    const continueAction = showContinue
+        ? h(Button, {
+            variant: 'outline',
+            size: 'sm',
+            disabled: forking,
+            title: tt('continueBranch'),
+            icon: isArchived
+                ? h(IconBranchOutlineRegular, { size: 14 })
+                : h(IconNewChatOutlineRegular, { size: 14 }),
+            onClick: () => {
+                // 官方 openForkSource 判据：动作前读权威快照（client 内存，零远端 IO），
+                // 避免渲染与快照之间的竞态把已归档会话直开。
+                if (archivedNow()) {
+                    setForkErr(null);
+                    setForkTarget({});
+                }
+                else if (openHostSession !== undefined) {
+                    onClose();
+                    openHostSession(sessionId);
+                }
+            },
+        }, tt('continueBranch'))
+        : undefined;
+    // 动作区顺序（都靠右，「继续对话」与 ✕ 恒在最右）：归档徽标 → 调用方动作 → 继续对话 → ✕。
+    const headActions = continueAction === undefined && props.headerActions === undefined && !(customHeader && archivedBadge !== undefined)
+        ? undefined
+        : h(Fragment, null, customHeader ? archivedBadge : null, props.headerActions, continueAction);
     // 外壳 = **核心 Modal**（size lg：min(1120px,100vw-32px) × calc(100%-80px)，兄弟项目大弹窗同值）；
     // 「继续对话」与确认框按钮一律**核心 Button**，不就地自绘（用户 2026-10-22 拍板）。
     // 会话中间部分 = mirror/ 官方 1:1 复刻（ChatViewFrame：官方类优先，缺失回退自绘）。
     return h(Fragment, null, h(Modal, {
         size: 'lg',
-        // 标题 = 调用方给的人话标题（可自定义）；会话 id 是**标识**，放标题下方副标题行，不占正文
-        // （用户 2026-10-22：一串 MD5 不该出现在正文里）。
-        title: heading ?? tt('sessionHeading'),
-        subtitle: h(Fragment, null, h('span', null, sessionId), 
-        // 可见探针：官方样式未命中时直接显示（省得翻控制台）。命中则不显示。
-        officialCount === 0
-            ? h('span', { className: 'dshpc-sv-probe' }, ' ⚠ ', tt('sessionProbeStyle'))
-            : null),
-        // 归档标识（官方归档图标 + 「已归档」）走头部右侧小块。
-        headerExtra: isArchived
-            ? h('span', { className: 'dshpc-sv-archived', title: tt('sessionArchived') }, h(IconArchiveOutlineRegular, { size: 12 }), tt('sessionArchived'))
-            : undefined,
-        // 「继续对话」：已归档 = 开分支图标 + 确认框；未归档 = 会话图标直跳官方会话页。
-        headerActions: showContinue
-            ? h(Button, {
-                variant: 'outline',
-                size: 'sm',
-                disabled: forking,
-                title: tt('continueBranch'),
-                icon: isArchived
-                    ? h(IconBranchOutlineRegular, { size: 14 })
-                    : h(IconNewChatOutlineRegular, { size: 14 }),
-                onClick: () => {
-                    // 官方 openForkSource 判据：动作前读权威快照（client 内存，零远端 IO），
-                    // 避免渲染与快照之间的竞态把已归档会话直开。
-                    if (archivedNow()) {
-                        setForkErr(null);
-                        setForkTarget({});
-                    }
-                    else if (openHostSession !== undefined) {
-                        onClose();
-                        openHostSession(sessionId);
-                    }
-                },
-            }, tt('continueBranch'))
-            : undefined,
+        // 二级：整块标题区交给调用方（含 sessionId 行）；一级：只换标题行，副标题仍由核心画。
+        // 会话 id 是**标识**，放标题下方副标题行，不占正文（用户 2026-10-22：一串 MD5 不该出现在正文里）。
+        header: props.header,
+        title: customHeader ? undefined : (props.title ?? heading ?? tt('sessionHeading')),
+        subtitle: customHeader
+            ? undefined
+            : h(Fragment, null, h('span', null, sessionId), 
+            // 可见探针：官方样式未命中时直接显示（省得翻控制台）。命中则不显示。
+            officialCount === 0
+                ? h('span', { className: 'dshpc-sv-probe' }, ' ⚠ ', tt('sessionProbeStyle'))
+                : null),
+        // 归档标识（官方归档图标 + 「已归档」）走头部右侧小块；自定义标题区时改挂动作区最前。
+        headerExtra: customHeader ? undefined : archivedBadge,
+        headerActions: headActions,
         onClose,
         translate: tt,
         // 底部暂存输入框走 footer（不随会话区滚动）：打字 → 确定 → onContinue 带话开分支跳官方视图。
@@ -1127,9 +1239,10 @@ export function SessionViewModal(props) {
             setForkTarget(null); },
         title: tt('forkConfirmTitle'),
         translate: tt,
+        // 弹窗脚按钮宽度与官方对话框对齐（官方 ChatView.modalAction：min-width 72px）。
         footer: [
-            h(Button, { key: 'cancel', variant: 'outline', disabled: forking, onClick: () => { setForkTarget(null); } }, tt('cancel')),
-            h(Button, { key: 'accept', variant: 'primary', disabled: forking || !canFork, onClick: onForkAccept }, forking ? tt('forkWorking') : tt('forkConfirmAccept')),
+            h(Button, { key: 'cancel', variant: 'outline', className: modalActionClass, disabled: forking, onClick: () => { setForkTarget(null); } }, tt('cancel')),
+            h(Button, { key: 'accept', variant: 'primary', className: modalActionClass, disabled: forking || !canFork, onClick: onForkAccept }, forking ? tt('forkWorking') : tt('forkConfirmAccept')),
         ],
     }, h('p', { className: 'dshpc-sv-forktext' }, tt('forkConfirmText')), canFork ? null : h('p', { className: 'dshpc-sv-forkerr' }, tt('forkUnavailable')), forkErr !== null ? h('p', { className: 'dshpc-sv-forkerr' }, tt('forkFailed', { error: forkErr })) : null));
 }