dsh-session-flow 0.1.0 → 1.0.0

package/lib/client.js

@@ -36,6 +36,11 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
 
   const STR = LOCALE === 'zh' ? {
     entry: '会话流', title: '会话流', rescan: '重新扫描', scanning: '扫描中…',
+    pianoTitle: '轮次', pianoNew: '新建会话', pianoFav: '收藏', pianoUnfav: '取消收藏', pianoFavs: '收藏', pianoOpenInFlow: '在会话流中打开',
+    pianoJumpFail: '该轮次尚未加载：请在会话区向上滚动加载历史后再点击',
+    fullText: '全文检索', fullTextSearching: '搜索中…', fullTextPartial: '已扫描 {N}/{M} 个会话（结果未完整）', fullTextNone: '全文无命中', fullTextFail: '全文检索失败',
+    dock: '并入右栏', dockExit: '退出并入', dockHint: '会话流已并入右侧栏 · 随当前会话切换', dockEmpty: '打开会话后可在此查看会话流',
+    rename: '重命名', renamePlaceholder: '输入新标题…', renameFail: '重命名失败', origTitle: '原名',
     search: '搜索标题/工具/文件… 支持 tool: pwsh · file: src · err:', allWorkspaces: '全部工作区',
     sortRecent: '最近运行', sortNewest: '最近创建', sortOldest: '最早创建', sortTools: '工具最多', sortLongest: '耗时最长',
     noMatch: '没有匹配的会话', noData: '暂无会话数据',
@@ -44,10 +49,11 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     duration: '耗时', created: '创建', size: '大小', records: '记录',
     jumpFailed: '无法跳转（会话不在当前列表）', unknownTitle: '（未命名会话）',
     loadFailed: '加载失败',
-    back: '返回', close: '关闭', jumpNative: '跳转原生会话', expandAll: '全部展开', collapseAll: '全部折叠',
+    back: '返回', openWorkbench: '打开完整工作台', close: '关闭', jumpNative: '跳转原生会话', expandAll: '全部展开', collapseAll: '全部折叠',
     exportMd: '导出报告 (ZIP)', exporting: '导出中…', exportFail: '导出失败',
     live: '实时', liveActive: '实时 · 进行中', liveExit: '退出实时', liveLoading: '实时加载…',
     liveFail: '实时不可用', liveUnavailable: '（实时通道不可用：连接不可用）',
+    liveFallbackHint: '会话尚未落盘 · 实时视图（3s 轮询）', retryArchive: '重试档案视图',
     liveEvents: '事件', liveRefreshing: '刷新…', liveLastActive: '最后活动',
     liveTurn: '运行中', liveGenerating: '正在生成…',
     detailLoading: '正在解析会话…', noTimeline: '无可展示的时间线', artifacts: '产物',
@@ -55,8 +61,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     args: '参数', result: '结果', thinking: '思考', expanded: '展开', collapsed: '收起',
     detailFailed: '会话详情加载失败', showEmpty: '显示空会话', emptySession: '空会话',
     emptyHint: '此会话已创建但尚未开始对话', userNav: '用户发言', noUserNav: '（无用户发言）',
-    conclusion: '结论', injected: '注入', lineage: '血缘', noLineage: '（无子代理血缘信息）',
-    liveTree: '运行时血缘', offlineTree: '档案血缘', modeOneShot: '一次性', modeContinuable: '可续',
+    conclusion: '结论', injected: '注入', lineage: '血缘', noLineage: '（无子代理血缘信息）', task: '任务',    liveTree: '运行时血缘', offlineTree: '档案血缘', modeOneShot: '一次性', modeContinuable: '可续',
     subagentDetail: '子代理详情', loadDetail: '加载子代理详情…', noDetail: '该子代理无可见事件',
     viewSubagent: '查看子代理', toolTop: '工具 Top', issues: '问题会话', issuesHint: '只显示有错误记录的会话',
     searchTab: '检索', searchInPlaceholder: '会话内检索…', noMatches: '无匹配位置', matches: '命中', navUsers: '用户',
@@ -69,6 +74,11 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     cacheHint: '仅清理本插件的缓存（可自动重建），不影响 DSH 会话存档与任何其他数据', cacheLimit: '时间线缓存上限',
   } : {
     entry: 'Session Flow', title: 'Session Flow', rescan: 'Rescan', scanning: 'Scanning…',
+    pianoTitle: 'Turns', pianoNew: 'New session', pianoFav: 'Favorite', pianoUnfav: 'Unfavorite', pianoFavs: 'Favorites', pianoOpenInFlow: 'Open in Session Flow',
+    pianoJumpFail: 'Turn not loaded — scroll up in the conversation to load history, then retry',
+    fullText: 'Full-text', fullTextSearching: 'Searching…', fullTextPartial: 'Scanned {N}/{M} sessions (partial)', fullTextNone: 'No full-text matches', fullTextFail: 'Full-text search failed',
+    dock: 'Dock right', dockExit: 'Undock', dockHint: 'Session Flow docked · follows current session', dockEmpty: 'Open a session to view its flow here',
+    rename: 'Rename', renamePlaceholder: 'New title…', renameFail: 'Rename failed', origTitle: 'Original',
     search: 'Search title / tools / files… use tool: · file: · err:', allWorkspaces: 'All workspaces',
     sortRecent: 'Recently run', sortNewest: 'Recently created', sortOldest: 'Oldest first', sortTools: 'Most tools', sortLongest: 'Longest',
     noMatch: 'No matching sessions', noData: 'No session data yet',
@@ -77,10 +87,11 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     duration: 'duration', created: 'created', size: 'size', records: 'records',
     jumpFailed: 'Cannot open (session not in live list)', unknownTitle: '(untitled session)',
     loadFailed: 'Load failed',
-    back: 'Back', close: 'Close', jumpNative: 'Open in native view', expandAll: 'Expand all', collapseAll: 'Collapse all',
+    back: 'Back', openWorkbench: 'Open workbench', close: 'Close', jumpNative: 'Open in native view', expandAll: 'Expand all', collapseAll: 'Collapse all',
     exportMd: 'Export report (ZIP)', exporting: 'Exporting…', exportFail: 'Export failed',
     live: 'Live', liveActive: 'Live · running', liveExit: 'Exit live', liveLoading: 'Loading live…',
     liveFail: 'Live unavailable', liveUnavailable: '(live channel unavailable: no connection)',
+    liveFallbackHint: 'Session not persisted yet · live view (3s poll)', retryArchive: 'Retry archive view',
     liveEvents: 'events', liveRefreshing: 'refreshing…', liveLastActive: 'last active',
     liveTurn: 'Running', liveGenerating: 'Generating…',
     detailLoading: 'Parsing session…', noTimeline: 'No timeline to show', artifacts: 'Artifacts',
@@ -88,7 +99,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     args: 'Args', result: 'Result', thinking: 'Thinking', expanded: 'Expanded', collapsed: 'Collapsed',
     detailFailed: 'Failed to load session detail', showEmpty: 'Show empty sessions', emptySession: 'Empty',
     emptyHint: 'This session was created but has no conversation yet', userNav: 'User turns', noUserNav: '(no user turns)',
-    conclusion: 'Conclusion', injected: 'Injected', lineage: 'Lineage', noLineage: '(no subagent lineage)',
+    conclusion: 'Conclusion', injected: 'Injected', lineage: 'Lineage', noLineage: '(no subagent lineage)', task: 'Task',
     liveTree: 'Live lineage', offlineTree: 'Archive lineage', modeOneShot: 'one-shot', modeContinuable: 'continuable',
     subagentDetail: 'Subagent detail', loadDetail: 'Loading subagent detail…', noDetail: 'No visible events for this subagent',
     viewSubagent: 'View subagent', toolTop: 'Tool Top', issues: 'Problem sessions', issuesHint: 'Only sessions with errors',
@@ -144,6 +155,19 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     `.sf-card:hover{border-color:var(--dsw-specific-accent,#4a7dff);box-shadow:0 1px 4px rgba(0,0,0,.06)}`,
     `.sf-cardTitle{font-weight:600;margin-bottom:4px;display:flex;align-items:center;gap:8px;flex-wrap:wrap}`,
     `.sf-cardText{color:var(--dsw-alias-label-primary,#222)}`,
+    // M8a 会话重命名：hover 显示 ✏️；编辑态行内输入；自定义标题时显示「原名」小字。
+    `.sf-renameBtn{flex:none;border:none;background:none;padding:1px 4px;margin-left:2px;border-radius:6px;cursor:pointer;color:var(--dsw-alias-label-secondary,#888);font-size:11px;line-height:16px;opacity:0;transition:opacity .12s,color .12s}`,
+    `.sf-card:hover .sf-renameBtn,.sf-renameBtn:focus-visible,.sf-renameBtn[data-active='true']{opacity:1}`,
+    `.sf-renameBtn:hover{color:var(--dsw-specific-accent,#4a7dff);background:rgba(90,140,255,.1)}`,
+    `.sf-renameWrap{flex:1 1 100%;min-width:0;display:inline-flex;align-items:center;gap:6px}`,
+    `.sf-renameInput{flex:1 1 auto;min-width:0;border:1px solid var(--dsw-specific-accent,#4a7dff);border-radius:6px;padding:3px 8px;font-size:12.5px;background:var(--dsw-alias-bg-base,#fff);color:var(--dsw-alias-label-primary,#222);outline:none}`,
+    `.sf-renameErr{color:#d43b3b;font-size:11px;white-space:nowrap}`,
+    `.sf-origTitle{flex:none;font-size:11px;color:var(--dsw-alias-label-secondary,#888);font-weight:400;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:180px;margin-left:8px}`,
+    // 候选 B：卡片结论摘要行（最近结论主行 + 首个任务小字，单行 ellipsis，hover 悬浮全文）。
+    `.sf-cardConclusion,.sf-cardTask{display:flex;align-items:center;gap:6px;min-width:0;margin-top:3px;font-size:11.5px;line-height:1.5;color:var(--dsw-alias-label-secondary,#666)}`,
+    `.sf-cardConclusionText,.sf-cardTaskText{flex:1 1 auto;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}`,
+    `.sf-cardTag{flex:none;border-radius:5px;padding:0 5px;font-size:10px;line-height:16px;font-weight:700;background:rgba(90,140,255,.12);color:#4a7dff}`,
+    `.sf-viewTitle .sf-renameBtn{opacity:.55}.sf-viewTitle:hover .sf-renameBtn{opacity:1}`,
     `.sf-muted{color:var(--dsw-alias-label-secondary,#888);font-size:12px}`,
     `.sf-mono{font-family:ui-monospace,Consolas,monospace;font-size:12px}`,
     `.sf-badge{flex:none;border-radius:6px;padding:1px 7px;font-size:11px;line-height:16px}`,
@@ -272,6 +296,31 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     `.sf-cacheRow{display:flex;align-items:center;gap:8px;min-width:0}`,
     `.sf-cacheLabel{flex:none;font-weight:600;color:var(--dsw-alias-label-secondary,#888)}`,
     `.sf-cacheValue{font-variant-numeric:tabular-nums;font-family:ui-monospace,Consolas,monospace}`,
+    // 方向 A：跨会话全文检索结果区（与元数据筛选结果分区展示）。
+    `.sf-fulltext{flex:none;border:1px solid rgba(90,140,255,.3);background:rgba(90,140,255,.05);border-radius:10px;padding:8px 10px;display:flex;flex-direction:column;gap:4px;max-height:220px;overflow:auto}`,
+    `.sf-fulltextHead{display:flex;align-items:center;gap:8px;flex:none}`,
+    `.sf-fulltextTitle{font-weight:700;font-size:12px;color:var(--dsw-alias-label-primary,#222)}`,
+    `.sf-fulltextHit{border-radius:8px;padding:5px 8px;cursor:pointer;display:flex;flex-direction:column;gap:2px;min-width:0}`,
+    `.sf-fulltextHit:hover{background:rgba(90,140,255,.1)}`,
+    `.sf-fulltextHitTitle{display:flex;align-items:center;gap:8px;min-width:0}`,
+    `.sf-fulltextName{flex:1;min-width:0;font-size:12px;font-weight:600;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-primary,#222)}`,
+    `.sf-fulltextCount{flex:none;border-radius:999px;background:rgba(90,140,255,.15);color:#4a7dff;font-size:10px;line-height:15px;min-width:18px;text-align:center;padding:0 5px;font-weight:700}`,
+    `.sf-fulltext .sf-muted{font-size:11px;color:var(--dsw-alias-label-secondary,#666)}`,
+    // M12：详情并入右侧栏（details 槽位轻量视图）。
+    `.dk-root{box-sizing:border-box;height:100%;min-height:0;display:flex;flex-direction:column;gap:8px;padding:10px 12px;overflow:hidden;color:var(--dsw-alias-label-primary,#222);font-family:var(--dsw-font-family,inherit)}`,
+    `.dk-head{flex:none;display:flex;align-items:center;gap:8px;min-width:0}`,
+    `.dk-title{flex:1;min-width:0;font-size:13px;font-weight:700;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}`,
+    `.dk-btn{flex:none;border:1px solid var(--dsw-alias-border-l2,#ddd);background:var(--dsw-alias-bg-layer-1,#f5f5f5);color:var(--dsw-alias-label-primary,#222);border-radius:7px;padding:3px 9px;font-size:11px;cursor:pointer}`,
+    `.dk-btn:hover{border-color:var(--dsw-alias-brand-primary,#4a7dff);color:var(--dsw-alias-brand-primary,#4a7dff)}`,
+    `.dk-body{flex:1;min-height:0;overflow:auto;display:flex;flex-direction:column;gap:6px}`,
+    `.dk-summary{border:1px solid var(--dsw-alias-border-l2,#e4e6eb);border-radius:10px;padding:8px 10px;background:var(--dsw-alias-bg-layer-1,#f8f9fa);flex:none;display:flex;flex-direction:column;gap:4px}`,
+    `.dk-summaryRow{display:flex;gap:6px;font-size:11.5px;line-height:1.5;color:var(--dsw-alias-label-secondary,#666);min-width:0}`,
+    `.dk-summaryTag{flex:none;border-radius:5px;padding:0 5px;font-size:10px;line-height:16px;font-weight:700;background:rgba(90,140,255,.12);color:#4a7dff}`,
+    `.dk-summaryText{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}`,
+    `.dk-summaryFull{font-size:12px;line-height:1.6;color:var(--dsw-alias-label-primary,#222);white-space:pre-wrap;word-break:break-word;max-height:140px;overflow:auto}`,
+    // M12：并入期间禁用 layout grid 列宽过渡——官方会话切换会 closeDetails（宽 360→0），
+    // 守护重开（0→360）若带过渡动画会产生「关→开」闪烁；禁用后切换直接刷新内容（实测踩坑）。
+    `html[data-dsh-dock-active] [class*=frame],html[data-dsh-dock-active] [data-side=details]{transition:none!important}`,
     // ── M5 会话摘要卡 ──
     `.sf-summaryCard{flex:none;display:flex;flex-direction:column;gap:5px;border:1px solid var(--dsw-alias-border-l2,#e5e5e5);border-radius:10px;background:var(--dsw-specific-input-major,#fafafa);padding:9px 12px;font-size:12px}`,
     `.sf-summaryHead{display:flex;align-items:center;gap:8px}`,
@@ -306,14 +355,79 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     `.sf-navKind.assistant{background:rgba(120,120,120,.14);color:#666}`,
     `@keyframes sfFlashBg{0%{background:rgba(90,140,255,.4)}100%{background:transparent}}`,
     `.sf-flash{animation:sfFlashBg 1.5s ease}`,
+    // ── M11 本会话轮次导航（会话页左侧常驻悬浮条目条，DeepSeek 悬浮导航风格）──
+    // 只显示【当前会话】的对话轮次（用户消息），不跨会话/不跨工作区；
+    // DOM 锚点驱动（data-time-hover-root，dsh-navbar 同款，零 RPC）。
+    // 形态：默认收拢为一列短横条（胶囊线，极简不占空间），悬浮/聚焦展开为文字条目卡；
+    // 垂直居中悬浮于会话内容区中间（top 由组件算区中心 + translateY(-50%)）。
+    // 动画体系：一切组件的产生/消失都有「来源与目标」——display 硬切全部改为
+    // transform/opacity/max-height 过渡（实测踩坑：display 切换无动画、视觉突兀）。
+    `[data-dsh-piano-keys]{position:fixed;left:0;top:50%;width:32px;max-height:60vh;z-index:15;display:flex;flex-direction:column;font-family:var(--dsw-font-family,inherit);transition:width .26s cubic-bezier(.3,1.15,.4,1) .22s}`,
+    // 收拢时序：离开时宽度过渡延迟 .22s——信息面板先滑出（.24s），悬浮条主体再收拢
+    // （用户要求：收拢第一步先收起详情信息框）；进入（hover/focus）无延迟即时展开。
+    `[data-dsh-piano-keys]:hover,[data-dsh-piano-keys]:focus-within{width:200px;transition-delay:0s}`,
+    `html[${ACTIVE_ATTR}] [data-dsh-piano-keys]{display:none!important}`,
+    `.pk-strip{flex:1;min-height:0;max-height:calc(60vh - 60px);overflow-y:auto;overflow-x:hidden;display:flex;flex-direction:column;gap:5px;padding:8px 4px;scrollbar-width:none;outline:none}`,
+    `.pk-strip::-webkit-scrollbar{display:none}`,
+    // 收拢态：短横条（胶囊线）；overflow:hidden 使 label 文字被高度裁剪（来源=胶囊）；
+    // ::before 延伸命中区（±4px，点击/悬浮无死区）。
+    `.pk-key{position:relative;flex:none;height:4px;min-height:4px;border-radius:99px;border:none;cursor:pointer;padding:0;margin:0 4px;background:var(--dsw-alias-border-l2,#d7dae0);color:var(--dsw-alias-label-primary,#222);overflow:hidden;transition:height .22s ease,padding .22s ease,margin .22s ease,border-radius .22s ease,background .14s ease,border-color .14s ease,box-shadow .18s ease;outline:none;min-width:0}`,
+    `.pk-key::before{content:'';position:absolute;left:0;right:0;top:-4px;bottom:-4px}`,
+    `.pk-key:hover{background:var(--dsw-alias-brand-primary,#4a7dff)}`,
+    `.pk-key:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4a7dff);outline-offset:-1px}`,
+    `.pk-keyActive{background:var(--dsw-alias-brand-primary,#4a7dff)}`,
+    `.pk-keyFocus{background:var(--dsw-alias-brand-primary,#4a7dff)}`,
+    // 展开态（悬浮/聚焦）：条目变文字卡片；label 常驻（缩略态被条目高度裁剪），
+    // 展开时随高度过渡露出文字（来源=胶囊内部，目标=卡片全文）。
+    `[data-dsh-piano-keys]:hover .pk-key,[data-dsh-piano-keys]:focus-within .pk-key{display:flex;align-items:center;gap:6px;height:auto;min-height:28px;border-radius:10px;border:1px solid var(--dsw-alias-border-l2,#e4e6eb);padding:5px 8px;margin:0;background:color-mix(in srgb,var(--dsw-alias-bg-base,#fff) 80%,transparent);backdrop-filter:blur(10px);-webkit-backdrop-filter:blur(10px);box-shadow:0 1px 3px rgba(0,0,0,.07)}`,
+    `[data-dsh-piano-keys]:hover .pk-key:hover,[data-dsh-piano-keys]:focus-within .pk-key:hover{background:color-mix(in srgb,var(--dsw-alias-bg-base,#fff) 96%,transparent);border-color:var(--dsw-alias-brand-primary,#4a7dff)}`,
+    `[data-dsh-piano-keys]:hover .pk-keyActive,[data-dsh-piano-keys]:focus-within .pk-keyActive{border-color:var(--dsw-alias-brand-primary,#4a7dff);background:color-mix(in srgb,var(--dsw-alias-brand-primary,#4a7dff) 10%,var(--dsw-alias-bg-base,#fff))}`,
+    `.pk-label{flex:1;min-width:0;font-size:12px;line-height:18px;max-height:18px;color:var(--dsw-alias-label-primary,#222);overflow:hidden;text-overflow:ellipsis;white-space:nowrap;user-select:none;opacity:0;transition:opacity .18s ease .06s}`,
+    `[data-dsh-piano-keys]:hover .pk-label,[data-dsh-piano-keys]:focus-within .pk-label{opacity:1}`,
+    // 轮次序号：缩略态折叠（宽度 0 + 透明），展开态从左侧展开露出（来源=左缘）。
+    `.pk-turnNo{flex:none;width:0;min-width:0;overflow:hidden;opacity:0;text-align:left;font-size:9.5px;line-height:16px;font-weight:600;color:var(--dsw-alias-label-tertiary,#999);font-family:ui-monospace,Consolas,monospace;user-select:none;white-space:nowrap;transition:width .22s ease,opacity .16s ease .04s}`,
+    `[data-dsh-piano-keys]:hover .pk-turnNo,[data-dsh-piano-keys]:focus-within .pk-turnNo{width:28px;min-width:28px;opacity:1}`,
+    // hover 条目：在【该条目右侧】展开信息面板（.pk-detail）——absolute 相对悬浮条容器，
+    // 坐标按条目位置换算为容器内偏移（注意：容器有 transform:translateY(-50%)，fixed 子元素
+    // 会被 transform 祖先劫持成相对容器定位——用视口坐标会双重偏移，实测踩坑）。
+    `[data-dsh-piano-keys]:hover .pk-key:hover,[data-dsh-piano-keys]:focus-within .pk-key.pk-keyFocus{position:relative;z-index:2;box-shadow:0 4px 16px rgba(0,0,0,.18)}`,
+    // 展开时序：详情框延迟 .28s 再滑入——等悬浮条展开动画完成、条目就位后，
+    // 位置才准确（第一次展开时条目仍在变形，立即计算会错位，实测踩坑）；
+    // 隐藏则立即（无延迟）。
+    `.pk-detail{position:absolute;left:0;top:0;width:264px;max-height:calc(60vh - 40px);display:flex;flex-direction:column;gap:6px;background:color-mix(in srgb,var(--dsw-alias-bg-base,#fff) 76%,transparent);backdrop-filter:blur(14px);-webkit-backdrop-filter:blur(14px);border:1px solid var(--dsw-alias-border-l2,#e4e6eb);border-radius:12px;box-shadow:0 8px 28px rgba(0,0,0,.18);padding:10px 12px;z-index:6;overflow:hidden;opacity:1;transform:translateX(0);transition:opacity .18s ease .28s,transform .24s cubic-bezier(.25,1.1,.4,1) .28s,visibility .24s .28s}`,
+    `.pk-detail.hidden{opacity:0;transform:translateX(14px);visibility:hidden;pointer-events:none;transition:opacity .18s ease,transform .24s cubic-bezier(.25,1.1,.4,1),visibility .24s}`,
+    `.pk-detailHead{flex:none;font-size:10.5px;font-weight:700;color:var(--dsw-alias-label-secondary,#666);font-family:ui-monospace,Consolas,monospace;letter-spacing:.2px}`,
+    // 面板内容随条目切换：新内容从右轻滑入（key 变化重新挂载触发 animation）。
+    `.pk-detailBody{min-height:0;font-size:12.5px;line-height:1.6;color:var(--dsw-alias-label-primary,#222);white-space:pre-wrap;word-break:break-word;overflow-y:auto;max-height:320px;animation:pkSlideIn .22s ease}`,
+    `@keyframes pkSlideIn{from{opacity:0;transform:translateX(10px)}to{opacity:1;transform:translateX(0)}}`,
+    // 跳转状态提示条（悬浮条下方，与悬浮条等宽）：文字在条宽内换行增高显示完整
+    // 文案（不加宽），从下方淡入/淡出（来源=悬浮条底缘）；毛玻璃。
+    `.pk-status{position:absolute;left:0;right:0;top:calc(100% + 4px);padding:7px 10px;border-radius:8px;background:color-mix(in srgb,var(--dsw-alias-bg-base,#fff) 82%,transparent);backdrop-filter:blur(10px);-webkit-backdrop-filter:blur(10px);border:1px solid var(--dsw-alias-border-l2,#e4e6eb);font-size:11px;line-height:1.5;color:var(--dsw-alias-label-secondary,#666);box-shadow:0 4px 14px rgba(0,0,0,.12);z-index:6;text-align:center;white-space:normal;word-break:break-word;opacity:1;transform:translateY(0);transition:opacity .18s ease,transform .22s ease,visibility .22s}`,
+    `.pk-status.hidden{opacity:0;transform:translateY(8px);visibility:hidden;pointer-events:none}`,
+    `.pk-status.warn{color:#d97706;border-color:rgba(217,119,6,.4)}`,
+    // 展开态显示悬浮条细滚动条（缩略态保持无滚动条）。
+    `[data-dsh-piano-keys]:hover .pk-strip,[data-dsh-piano-keys]:focus-within .pk-strip{scrollbar-width:thin;scrollbar-color:var(--dsw-alias-border-l2,#d7dae0) transparent}`,
+    `[data-dsh-piano-keys]:hover .pk-strip::-webkit-scrollbar,[data-dsh-piano-keys]:focus-within .pk-strip::-webkit-scrollbar{width:6px;display:block}`,
+    `[data-dsh-piano-keys]:hover .pk-strip::-webkit-scrollbar-thumb{background:var(--dsw-alias-border-l2,#d7dae0);border-radius:3px}`,
+    // 头部：从上方滑入（来源=悬浮条顶缘）——max-height/padding/opacity/transform 过渡，
+    // 不占缩略态布局。内容「标题 + ▲▼ 按钮组（并排右上）」。
+    `.pk-head{display:flex;flex:none;align-items:center;gap:4px;padding:0 6px;color:var(--dsw-alias-label-secondary,#666);font-size:10px;line-height:1.2;border-bottom:1px solid var(--dsw-alias-border-l2,#e5e5e5);max-height:0;overflow:hidden;opacity:0;transform:translateY(-6px);transition:max-height .24s ease,padding .24s ease,opacity .18s ease,transform .24s ease}`,
+    `[data-dsh-piano-keys]:hover .pk-head,[data-dsh-piano-keys]:focus-within .pk-head{max-height:30px;padding-top:5px;padding-bottom:5px;opacity:1;transform:translateY(0)}`,
+    `.pk-headLabel{flex:1;min-width:0;font-size:10.5px;font-weight:600;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}`,
+    `.pk-navGroup{flex:none;display:flex;gap:3px}`,
+    `.pk-navBtn{flex:none;width:20px;height:20px;border:1px solid var(--dsw-alias-border-l2,#ddd);background:var(--dsw-alias-bg-layer-1,#f5f5f5);color:var(--dsw-alias-label-primary,#222);border-radius:6px;cursor:pointer;font-size:9px;line-height:1;padding:0;transition:border-color .14s ease,color .14s ease}`,
+    `.pk-navBtn:hover:not(:disabled){border-color:var(--dsw-alias-brand-primary,#4a7dff);color:var(--dsw-alias-brand-primary,#4a7dff)}`,
+    `.pk-navBtn:disabled{opacity:.35;cursor:default}`,
+    `@keyframes sfPianoPulse{0%,100%{opacity:.35}50%{opacity:1}}`,
   ].join('\n')
 
   // ── API ─────────────────────────────────────────────────────────────
-  function api(method, params) {
+  function api(method, params, signal) {
     return fetch('/api/session-flow', {
       method: 'POST',
       headers: { 'Content-Type': 'application/json' },
       body: JSON.stringify(Object.assign({ method }, params || {})),
+      signal,
     }).then((r) => r.json())
   }
 
@@ -404,6 +518,50 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     return (bytes / 1024 / 1024).toFixed(1) + ' MiB'
   }
 
+  // ── M8a 会话重命名：行内编辑（总览卡片 / 详情页标题复用）─────────────
+  // props: { initial, onSave: (title) => Promise, onCancel, placeholder }
+  // 保存成功（ok truthy / 无返回）由父组件退出编辑态；失败（reject / ok===false）留在编辑态显示错误。
+  function RenameInline(props) {
+    const [value, setValue] = useState(props.initial || '')
+    const [saving, setSaving] = useState(false)
+    const [err, setErr] = useState('')
+    const inputRef = useRef(null)
+    useEffect(() => {
+      const el = inputRef.current
+      if (el) { el.focus(); el.select() }
+    }, [])
+    const commit = () => {
+      if (saving) return
+      const v = value.trim()
+      if (v === String(props.initial || '').trim()) { props.onCancel(); return }
+      setSaving(true)
+      setErr('')
+      Promise.resolve(props.onSave(v)).then((ok) => {
+        if (ok === false) setSaving(false)
+      }).catch((e) => {
+        setSaving(false)
+        setErr(String(e && e.message || e))
+      })
+    }
+    return h('span', { className: 'sf-renameWrap' },
+      h('input', {
+        ref: inputRef,
+        className: 'sf-renameInput',
+        value,
+        placeholder: props.placeholder || STR.renamePlaceholder,
+        disabled: saving,
+        onInput: (e) => setValue(e.target.value),
+        onKeyDown: (e) => {
+          if (e.key === 'Enter') commit()
+          else if (e.key === 'Escape') { e.stopPropagation(); props.onCancel() }
+        },
+        onBlur: commit,
+        onClick: (e) => e.stopPropagation(),
+      }),
+      err && h('span', { className: 'sf-renameErr' }, err),
+    )
+  }
+
   // ── 总览页 ──────────────────────────────────────────────────────────
   // props: { onOpen: (session) => void, onClose: () => void }
   function SessionFlowOverview(props) {
@@ -418,6 +576,79 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     const [cacheInfo, setCacheInfo] = useState(null)
     const [cacheBusy, setCacheBusy] = useState(false)
     const [cacheMsg, setCacheMsg] = useState('')
+    // 方向 A：跨会话全文检索（防抖 500ms；AbortController 取消；结果区渲染）。
+    const [fullText, setFullText] = useState(null) // {phase:'searching'|'done'|'error', query, results, scanned, total, hasMore, error}
+    const fullTextAbort = useRef(null)
+    const fullTextTimer = useRef(null)
+    // M8a：当前编辑重命名的会话 id（null = 无编辑态）。
+    const [renamingId, setRenamingId] = useState(null)
+    // M8a：保存自定义标题 → 更新本地列表数据（userTitle 覆盖显示，不整页重刷）。
+    const saveRename = (sid, title) => {
+      return api('rename', { sessionId: sid, title }).then((json) => {
+        if (json && json.ok) {
+          setState((prev) => {
+            if (!prev || !prev.data) return prev
+            return {
+              ...prev,
+              data: {
+                ...prev.data,
+                workspaces: (prev.data.workspaces || []).map((g) => ({
+                  ...g,
+                  sessions: (g.sessions || []).map((s) => (s.id === sid ? { ...s, userTitle: json.userTitle } : s)),
+                })),
+              },
+            }
+          })
+          setRenamingId(null)
+          return true
+        }
+        throw new Error((json && json.error) || STR.renameFail)
+      })
+    }
+    useEffect(() => () => {
+      if (fullTextTimer.current) clearTimeout(fullTextTimer.current)
+      if (fullTextAbort.current) fullTextAbort.current.abort()
+    }, [])
+    useEffect(() => {
+      const q = query.trim()
+      const isStructured = /^(tool|file|path|err|error):/i.test(q)
+      if (fullTextTimer.current) clearTimeout(fullTextTimer.current)
+      if (fullTextAbort.current) { fullTextAbort.current.abort(); fullTextAbort.current = null }
+      // 结构化前缀走元数据筛选（已有）；自由文本 ≥2 字符才触发全文检索。
+      if (q.length < 2 || isStructured) { setFullText(null); return }
+      fullTextTimer.current = setTimeout(() => {
+        const ctrl = new AbortController()
+        fullTextAbort.current = ctrl
+        setFullText({ phase: 'searching', query: q, results: null, scanned: 0, total: 0, hasMore: false, error: '' })
+        api('searchAll', { query: q, workspace: wsFilter || undefined }, ctrl.signal).then((json) => {
+          if (json && json.ok) {
+            setFullText({ phase: 'done', query: q, results: json.results || [], scanned: json.scanned || 0, total: json.total || 0, hasMore: json.hasMore === true, error: '' })
+          } else {
+            setFullText((p) => p && p.query === q ? { phase: 'error', query: q, results: null, scanned: 0, total: 0, hasMore: false, error: (json && json.error) || STR.fullTextFail } : p)
+          }
+        }).catch((e) => {
+          if (e && e.name === 'AbortError') return
+          setFullText((p) => p && p.query === q ? { phase: 'error', query: q, results: null, scanned: 0, total: 0, hasMore: false, error: String(e && e.message || e) } : p)
+        })
+      }, 500)
+    }, [query, wsFilter])
+    // 命中跳转：localStorage 桥（会话流标签页读取后执行会话内检索定位）+ 原生打开会话。
+    const openFullTextHit = (hit) => {
+      try {
+        // 预写目标会话的 chat store view='session-flow'：会话打开时（store 按会话重建并
+        // rehydrate localStorage）自动激活「会话流」标签页，而非停在默认 Chat 标签。
+        const storeKey = 'dsh.conversation.chat.' + hit.sessionId
+        let st = {}
+        try { const raw = localStorage.getItem(storeKey); if (raw) st = JSON.parse(raw) } catch (e) {}
+        st.view = 'session-flow'
+        localStorage.setItem(storeKey, JSON.stringify(st))
+        localStorage.setItem(PENDING_SEARCH_KEY, JSON.stringify({ sessionId: hit.sessionId, query: query.trim() }))
+      } catch (e) {}
+      try { props.sessions.open(hit.sessionId) } catch (e) { console.warn('[dsh-session-flow] open failed', hit.sessionId, e) }
+      // 关闭工作台（中栏交还给会话），用户直接看到目标会话的会话流标签页——
+      // 否则工作台仍覆盖中栏，需手动点侧边栏才可见（实测踩坑）。
+      try { if (props.onClose) props.onClose() } catch (e) {}
+    }
     const fmtBytes = (b) => {
       if (b === null || b === undefined) return '—'
       if (b < 1024) return b + ' B'
@@ -575,6 +806,27 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         h('button', { className: 'sf-btn' + (cacheOpen ? ' sf-btnActive' : ''), onClick: () => setCacheOpen(!cacheOpen) }, STR.cache),
         h('button', { className: 'sf-btn', onClick: props.onClose }, '✕ ' + STR.close),
       ),
+      // 方向 A：跨会话全文检索结果区（防抖触发；与元数据筛选结果分区展示）。
+      fullText && h('div', { className: 'sf-fulltext' },
+        h('div', { className: 'sf-fulltextHead' },
+          h('span', { className: 'sf-fulltextTitle' }, STR.fullText + '「' + fullText.query + '」'),
+          fullText.phase === 'searching' && h('span', { className: 'sf-muted' }, STR.fullTextSearching),
+          fullText.phase === 'done' && fullText.hasMore && h('span', { className: 'sf-muted' },
+            STR.fullTextPartial.replace('{N}', String(fullText.scanned)).replace('{M}', String(fullText.total))),
+        ),
+        fullText.phase === 'error' && h('div', { className: 'sf-hint', style: { color: '#d43b3b' } }, STR.fullTextFail + ': ' + fullText.error),
+        fullText.phase === 'done' && fullText.results.length === 0 && h('div', { className: 'sf-hint' }, STR.fullTextNone),
+        fullText.phase === 'done' && fullText.results.map((hit) =>
+          h('div', { key: hit.sessionId, className: 'sf-fulltextHit', onClick: () => openFullTextHit(hit) },
+            h('div', { className: 'sf-fulltextHitTitle' },
+              h('span', { className: 'sf-fulltextName' }, hit.userTitle || hit.title),
+              h('span', { className: 'sf-fulltextCount' }, hit.matchCount),
+            ),
+            h('div', { className: 'sf-muted', style: { marginTop: 2 } },
+              (hit.matches[0] ? hit.matches[0].preview : '') + ' · ' + hit.workspace),
+          ),
+        ),
+      ),
       // 缓存管理面板：仅本插件缓存，查看体积 + 分类清理（清理后自动重建，无需重启）。
       cacheOpen && h('div', { className: 'sf-cachePanel' },
         h('div', { className: 'sf-muted', style: { flex: 'none' } }, STR.cacheHint),
@@ -650,12 +902,35 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
               h('span', { className: 'sf-cardWsFilter', dangerouslySetInnerHTML: { __html: FILTER_ICON } }),
             ),
             h('div', { className: 'sf-cardTitle' },
-              h('span', { className: 'sf-cardText', style: { overflow: 'hidden', textOverflow: 'ellipsis' } }, s.title || STR.unknownTitle),
+              renamingId === s.id
+                ? h(RenameInline, {
+                    initial: s.userTitle || s.title || '',
+                    onSave: (t) => saveRename(s.id, t),
+                    onCancel: () => setRenamingId(null),
+                  })
+                : h('span', { className: 'sf-cardText', style: { overflow: 'hidden', textOverflow: 'ellipsis' } },
+                    s.userTitle || s.title || STR.unknownTitle,
+                    s.userTitle && h('span', { className: 'sf-origTitle', title: s.title || STR.unknownTitle },
+                      STR.origTitle + ': ' + (s.title || STR.unknownTitle)),
+                    h('button', {
+                      className: 'sf-renameBtn', title: STR.rename,
+                      onClick: (e) => { e.stopPropagation(); setRenamingId(s.id) },
+                    }, '✎'),
+                  ),
               s.isEmpty && h('span', { className: 'sf-badge sf-badgeEnd' }, STR.emptySession),
               s.running ? h('span', { className: 'sf-badge sf-badgeRun' }, STR.running) : h('span', { className: 'sf-badge sf-badgeEnd' }, STR.ended),
               s.delegationDepth > 0 && h('span', { className: 'sf-badge sf-badgeSub' }, STR.subagent + ' · d' + s.delegationDepth),
               s.toolErrors > 0 && h('span', { className: 'sf-badge sf-badgeErr' }, STR.errors + ': ' + s.toolErrors),
             ),
+            // 候选 B：最近结论（主行）+ 首个任务（小字）；无值不渲染；hover 悬浮全文。
+            s.lastConclusion && h('div', { className: 'sf-cardConclusion', title: s.lastConclusion },
+              h('span', { className: 'sf-cardTag' }, STR.conclusion),
+              h('span', { className: 'sf-cardConclusionText' }, s.lastConclusion),
+            ),
+            s.firstTask && h('div', { className: 'sf-cardTask', title: s.firstTask },
+              h('span', { className: 'sf-cardTag' }, STR.task),
+              h('span', { className: 'sf-cardTaskText' }, s.firstTask),
+            ),
             h('div', { className: 'sf-muted' },
               h('span', {}, fmtTime(s.createdAt)),
               h('span', { style: { marginLeft: 8 } }, STR.duration + ' ' + fmtDuration(s.lastEventTime - s.createdAt)),
@@ -1007,7 +1282,8 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     const renderNode = (node, depth, isLive) => {
       const active = selected !== null && selected.id === node.id
       const hasChildren = (node.children && node.children.length > 0)
-      const label = node.label || node.id
+      // M8a：自定义标题优先（离线节点 host 已透传 userTitle；live 节点无此字段）。
+      const label = node.userTitle || node.label || node.title || node.id
       const meta = isLive
         ? ((node.mode === 'continuable' ? STR.modeContinuable : STR.modeOneShot) + ' · ' + (node.activity === 'running' ? STR.running : STR.ended))
         : ((node.toolCalls || 0) + ' ' + STR.tools + (node.toolErrors ? ' · ' + node.toolErrors + ' ' + STR.errors : ''))
@@ -1078,6 +1354,19 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     // 折叠状态：键集合，has(key) = 折叠。turn-N / tool-<callId> / msg-<seq>
     const [collapsed, setCollapsed] = useState(() => new Set())
     const collapsedInit = useRef(false)
+    // M8a：标题重命名（编辑态 + 保存后的显示覆盖，优先于 session.userTitle）。
+    const [renaming, setRenaming] = useState(false)
+    const [titleOverride, setTitleOverride] = useState(null)
+    const saveRename = (title) => {
+      return api('rename', { sessionId: session.id, title }).then((json) => {
+        if (json && json.ok) {
+          setTitleOverride(json.userTitle) // null = 清除恢复原名
+          setRenaming(false)
+          return true
+        }
+        throw new Error((json && json.error) || STR.renameFail)
+      })
+    }
 
     useEffect(() => {
       // 空会话（新建后未对话）：不请求详情，直接显示占位提示。
@@ -1317,6 +1606,61 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       }, 120)
     }
 
+    // ── M7 遗留 L1：跨视图 inspect 握手 ──────────────────────────────
+    // chat 视图工具调用行「Inspect」按钮写入共享 store（{callId}），会话流标签
+    // 作为 conversation.view 占用者收到 owner props：inspect/onInspectDone。
+    // 消费：toolStats 里定位该 callId 所属回合 → 展开回合（按需加载）→ 滚动定位
+    // → 闪烁高亮 → onInspectDone() 清除（参照 ui-trajectory 的 inspect 消费方式）。
+    // 时序处理：inspect 可能在数据未就绪时到达（依赖 phase 重跑）；liveOn/血缘视图
+    // 时先退出再定位；同一 callId 只处理一次（inspectHandled ref，store 清除后重置）。
+    const inspectHandled = useRef(null)
+    const jumpToCall = (turn, callId) => {
+      setActiveTurn(turn)
+      setCollapsed((prev) => {
+        const next = new Set(prev)
+        next.delete('turn-' + turn)
+        return next
+      })
+      ensureTurn(turn)
+      setTimeout(() => {
+        const el = document.getElementById('sf-tc-' + callId)
+        if (el) {
+          el.scrollIntoView({ behavior: 'smooth', block: 'center' })
+          el.classList.add('sf-flash')
+          setTimeout(() => el.classList.remove('sf-flash'), 1600)
+        }
+      }, 120)
+    }
+    const applyInspect = (callId) => {
+      if (!callId) return
+      let turn = null
+      for (const t of toolStats) {
+        const c = (t.calls || []).find((x) => x.callId === callId)
+        if (c) { turn = c.turn; break }
+      }
+      if (turn === null) {
+        // toolStats 未命中（理论上不应发生）：searchIn 按 callId 全文兜底。
+        api('searchIn', { sessionId: session.id, query: callId }).then((json) => {
+          const m = json && json.ok ? (json.matches || []).find((x) => x.callId === callId) : null
+          if (m && typeof m.turn === 'number') jumpToCall(m.turn, callId)
+          if (props.onInspectDone) props.onInspectDone()
+        }).catch(() => { if (props.onInspectDone) props.onInspectDone() })
+        return
+      }
+      jumpToCall(turn, callId)
+      if (props.onInspectDone) props.onInspectDone()
+    }
+    useEffect(() => {
+      // store 清除（inspect → null）后重置防重标记，允许同一 callId 再次检视。
+      if (!props.inspect || !props.inspect.callId) { inspectHandled.current = null; return }
+      if (state.phase !== 'ready') return
+      if (inspectHandled.current === props.inspect.callId) return
+      inspectHandled.current = props.inspect.callId
+      if (liveOn) exitLive()
+      if (view === 'lineage') setView('timeline')
+      applyInspect(props.inspect.callId)
+    }, [props.inspect, state.phase])
+
     // 定位工具/错误调用：展开所在回合（按需加载）→ 滚动到调用行；同一种再次点击循环。
     const locateCall = (list, cursorKey) => {
       if (!list || list.length === 0) return
@@ -1431,12 +1775,32 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
 
     return h('div', { className: 'sf-view' },
       h('div', { className: 'sf-viewHeader' },
-        h('button', { className: 'sf-btn', onClick: props.onBack }, '← ' + STR.back),
+        h('button', { className: 'sf-btn', onClick: props.onBack }, '← ' + (props.backLabel || STR.back)),
         h('h2', { className: 'sf-viewTitle', style: { flex: '1 1 auto', overflow: 'hidden', textOverflow: 'ellipsis' } },
-          session.title || STR.unknownTitle),
+          renaming
+            ? h(RenameInline, {
+                initial: titleOverride || session.userTitle || session.title || '',
+                onSave: saveRename,
+                onCancel: () => setRenaming(false),
+              })
+            : h('span', { style: { display: 'inline-flex', alignItems: 'center', minWidth: 0 } },
+                h('span', { style: { overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }, title: (titleOverride || session.userTitle) ? session.title || STR.unknownTitle : undefined },
+                  titleOverride || session.userTitle || session.title || STR.unknownTitle),
+                h('button', {
+                  className: 'sf-renameBtn', title: STR.rename,
+                  onClick: () => setRenaming(true),
+                }, '✎'),
+              ),
+        ),
         running ? h('span', { className: 'sf-badge sf-badgeRun' }, STR.running) : h('span', { className: 'sf-badge sf-badgeEnd' }, STR.ended),
         session.delegationDepth > 0 && h('span', { className: 'sf-badge sf-badgeSub' }, STR.subagent),
         h('button', { className: 'sf-btn', onClick: () => { setPendingSelect(null); setView('lineage') } }, STR.lineage),
+        // M12：并入右栏（仅工作台详情页；嵌入标签页不显示——避免右栏与标签页重复）。
+        !props.embedded && h('button', {
+          className: 'sf-btn',
+          onClick: () => { if (dockBridge.controller) dockBridge.controller.open() },
+          title: STR.dockHint,
+        }, STR.dock),
         // M6 实时通道：进行中会话可实时查看（sessions.history → derive → 折叠视图）。
         props.connection !== undefined && h('button', {
           className: 'sf-btn' + (liveOn ? ' sf-btnActive' : ''),
@@ -1444,7 +1808,8 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           disabled: liveOn && liveState.phase === 'loading',
         }, liveOn ? STR.liveActive + ' ✕' : STR.live),
         h('button', { className: 'sf-btn', onClick: exportSessionMd, disabled: exporting }, exporting ? STR.exporting : STR.exportMd),
-        h('button', { className: 'sf-btn', onClick: jumpNative }, STR.jumpNative),
+        // 嵌入原生会话页模式：无「跳转原生会话」（本页即原生会话页）。
+        !props.embedded && h('button', { className: 'sf-btn', onClick: jumpNative }, STR.jumpNative),
         h('button', { className: 'sf-btn', onClick: expandAll }, STR.expandAll),
         h('button', { className: 'sf-btn', onClick: collapseAll }, STR.collapseAll),
       ),
@@ -1651,6 +2016,189 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     )
   }
 
+  // ── 二期：嵌入原生会话页（conversation.view 槽位标签页）────────────
+  // 槽位环为会话作用域：每个原生会话页内一个「会话流」标签页，框架按
+  // key={sessionId} 重挂载，天然跟随当前会话切换。组件收到的框架标准
+  // props：sessionId + useSession（会话快照）；数据源与一期详情页一致
+  // （host get/getTurn/searchIn/summarize/exportMd/lineage + 实时通道）。
+  // 先取 host get 的轻量元信息（标题/计数，用于详情页空会话判定），
+  // 再复用 SessionFlowDetail 完整详情视图（摘要/统计/折叠时间线/四标签导航）。
+  // 嵌入模式差异：返回按钮 →「打开完整工作台」（唤起侧边栏工作台）；
+  // 隐藏「跳转原生会话」（本页即原生会话页）；onClose 无操作。
+  function SessionFlowTab(props) {
+    const { sessionId } = props
+    const [meta, setMeta] = useState(null) // {id, title, userMessages, toolCalls, turns}
+    const [loadErr, setLoadErr] = useState('')
+    // M7 遗留 L2：档案未命中（会话尚未落盘）时进入实时兜底视图，而非纯报错。
+    const [liveFallback, setLiveFallback] = useState(false)
+    const [retryKey, setRetryKey] = useState(0) // 「重试档案视图」触发重新 get
+    // 方向 A：全文检索命中跳转——读取 pendingSearch 桥（总览命中点击写入），
+    // 匹配当前会话则把检索词带入详情页（initialSearchQuery → 自动执行会话内 searchIn）。
+    const [pendingQuery, setPendingQuery] = useState('')
+    useEffect(() => {
+      if (!sessionId) return
+      try {
+        const raw = localStorage.getItem(PENDING_SEARCH_KEY)
+        if (!raw) return
+        const p = JSON.parse(raw)
+        if (p && p.sessionId === sessionId && p.query) {
+          localStorage.removeItem(PENDING_SEARCH_KEY)
+          setPendingQuery(p.query)
+        }
+      } catch (e) {}
+    }, [sessionId])
+
+    useEffect(() => {
+      let alive = true
+      setMeta(null)
+      setLoadErr('')
+      setLiveFallback(false)
+      if (!sessionId) return undefined
+      const conn = props.connection
+      const canLive = conn !== undefined && conn.api !== undefined && conn.api.sessions !== undefined
+      const toFallback = () => { if (alive && canLive) setLiveFallback(true) }
+      api('get', { sessionId }).then((json) => {
+        if (!alive) return
+        if (json && json.ok) {
+          const counts = json.counts || {}
+          const t = json.title
+          setMeta({
+            id: sessionId,
+            // entry.parsed.title 是 {title, source} 对象（已知陷阱），取 .title。
+            title: t && typeof t === 'object' ? String(t.title || '') : String(t || ''),
+            // M8a：自定义标题覆盖显示（userTitle || title）。
+            userTitle: json.userTitle || null,
+            userMessages: counts['user/message'] || 0,
+            toolCalls: counts['tool/call'] || 0,
+            turns: counts['turn/start'] || 0,
+          })
+        } else {
+          if (canLive) setLiveFallback(true)
+          else setLoadErr((json && json.error) || STR.detailFailed)
+        }
+      }).catch((e) => {
+        if (!alive) return
+        if (canLive) setLiveFallback(true)
+        else setLoadErr(String(e && e.message || e))
+      })
+      return () => { alive = false }
+    }, [sessionId, retryKey])
+
+    if (liveFallback) {
+      return h(SessionFlowLiveFallback, {
+        sessionId,
+        connection: props.connection,
+        onRetry: () => setRetryKey((k) => k + 1),
+      })
+    }
+    if (loadErr) {
+      return h('div', { className: 'sf-view' },
+        h('div', { className: 'sf-hint', style: { color: '#d43b3b' } }, STR.detailFailed + ': ' + loadErr))
+    }
+    if (meta === null) {
+      return h('div', { className: 'sf-view' }, h('div', { className: 'sf-hint' }, STR.detailLoading))
+    }
+    return h(SessionFlowDetail, {
+      session: meta,
+      sessions: props.sessions,
+      connection: props.connection,
+      onBack: props.onOpenWorkbench,
+      backLabel: STR.openWorkbench,
+      embedded: true,
+      onClose: () => {},
+      initialSearchQuery: pendingQuery,
+      // M7 遗留 L1：透传跨视图 inspect 握手（chat Inspect 按钮 → 会话流定位）。
+      inspect: props.inspect,
+      onInspectDone: props.onInspectDone,
+    })
+  }
+
+  // ── M7 遗留 L2：会话未落盘时的实时兜底视图 ────────────────────────
+  // 档案通道未命中（host get 404）时，用实时通道（sessions.history → derive）
+  // 渲染折叠时间线 + 3s 轮询，并保留「重试档案视图」入口。逻辑与 SessionFlowDetail
+  // 内实时通道同构（结构信号运行判定 / 只折叠新回合 / 不传 hideHead），自包含实现。
+  function SessionFlowLiveFallback(props) {
+    const { sessionId, connection } = props
+    const [state, setState] = useState({ phase: 'loading', error: null, timeline: null, eventCount: 0, running: false })
+    const [collapsed, setCollapsed] = useState(() => new Set())
+    const [activeTurn, setActiveTurn] = useState(null)
+    const liveSeenTurns = useRef(new Set())
+    const timer = useRef(null)
+
+    const fetchLive = useRef(async () => {})
+    fetchLive.current = async () => {
+      if (connection === undefined || connection.api === undefined || connection.api.sessions === undefined) {
+        setState((s) => ({ ...s, phase: 'error', error: STR.liveUnavailable }))
+        return
+      }
+      setState((s) => ({ ...s, phase: s.timeline === null ? 'loading' : 'ready' }))
+      try {
+        const resp = await connection.api.sessions.history({ sessionId, mode: 'full', maxMessages: 400 })
+        const val = resp && resp.result && resp.result.value
+        if (val === undefined || !Array.isArray(val.events)) {
+          setState((s) => ({ ...s, phase: 'error', error: STR.liveFail }))
+          return
+        }
+        const events = val.events.map((entry) => (entry && entry.event) || entry)
+        const derived = await api('derive', { events })
+        if (!derived || !derived.ok) {
+          setState((s) => ({ ...s, phase: 'error', error: (derived && derived.error) || STR.liveFail }))
+          return
+        }
+        const tl = (derived.timeline && derived.timeline.turns) || []
+        setState({
+          phase: 'ready', error: null, timeline: tl, eventCount: events.length,
+          running: derived.running === true,
+        })
+        // 只折叠新出现的回合（默认折叠），已展开的保持用户状态（M6 经验）。
+        const newTurns = tl.filter((t) => !liveSeenTurns.current.has(t.turn))
+        for (const t of tl) liveSeenTurns.current.add(t.turn)
+        if (newTurns.length > 0) {
+          setCollapsed((prev) => {
+            const next = new Set(prev)
+            for (const t of newTurns) next.add('turn-' + t.turn)
+            return next
+          })
+        }
+      } catch (e) {
+        setState((s) => ({ ...s, phase: 'error', error: STR.liveFail + ': ' + String(e && e.message || e) }))
+      }
+    }
+
+    useEffect(() => {
+      liveSeenTurns.current.clear()
+      fetchLive.current()
+      if (timer.current === null) timer.current = setInterval(() => { fetchLive.current() }, 3000)
+      return () => { if (timer.current !== null) { clearInterval(timer.current); timer.current = null } }
+    }, [sessionId])
+
+    const toggle = (key) => {
+      setCollapsed((prev) => {
+        const next = new Set(prev)
+        if (next.has(key)) next.delete(key)
+        else next.add(key)
+        return next
+      })
+    }
+
+    return h('div', { className: 'sf-view' },
+      h('div', { className: 'sf-viewHeader' },
+        h('span', { className: 'sf-badge sf-badgeRun', style: { flex: 'none' } }, STR.liveActive),
+        h('span', { className: 'sf-liveText' }, STR.liveFallbackHint),
+        h('button', { className: 'sf-btn sf-liveExitBtn', onClick: props.onRetry }, STR.retryArchive),
+      ),
+      state.phase === 'loading' && h('div', { className: 'sf-hint' }, STR.liveLoading),
+      state.phase === 'error' && h('div', { className: 'sf-hint', style: { color: '#d43b3b' } }, state.error),
+      state.phase === 'ready' && state.timeline !== null && state.timeline.length === 0 && h('div', { className: 'sf-hint' }, STR.noTimeline),
+      state.phase === 'ready' && state.timeline !== null && state.timeline.length > 0 && h(TimelineTurns, {
+        // 不传 hideHead：折叠回合需保留展开入口（M6 经验）。
+        turns: state.timeline, collapsed, toggle,
+        liveActive: state.running === true,
+        activeTurn, setActiveTurn,
+      }),
+    )
+  }
+
   // ── 主视图（总览 ⇄ 详情）───────────────────────────────────────────
   function SessionFlowView(props) {
     const [detail, setDetail] = useState(null) // { session, searchQuery }
@@ -1660,6 +2208,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           // M5c 方案C：总览检索词随会话带入详情页，自动执行会话内检索。
           onOpen: (session, searchQuery) => setDetail({ session, searchQuery }),
           onClose: props.onClose,
+          sessions: props.sessions,
         })
       : h(SessionFlowDetail, {
           session: detail.session,
@@ -1671,9 +2220,522 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         })
   }
 
+  // ── M11：钢琴键会话快切（会话页左侧常驻竖条）─────────────────────
+  // 数据：ctx.sessions.list（ObservableSnapshot 订阅）→ 过滤（排除 subagent、隐藏 blank）
+  // → 排序（updatedAt 降序，收藏置顶）→ 分组（连续 cwd 同段，段间黑白交替）。
+  // 点击 sessions.open(id) 切换；会话切换由框架重挂载会话组件（M7 已验证）。
+  // 错误角标：挂载时拉一次 host list 索引（toolErrors 映射）。
+  // 预览卡：hover 200ms 防抖 → host get 单个会话（缓存秒回）→ fixed 浮层（不裁剪）。
+  // 交互：滚轮/箭头滚动窗口（默认 15 键，兼容大量会话）、键盘 ↑↓/Enter、
+  // 收藏星标（localStorage）、右键「在会话流中打开」（工作台唤起）。
+  const PIANO_FAVS_KEY = 'dsh.sessionFlow.pianoFavs' // 预留（收藏键 v2 迁移用；当前轮次导航不使用）
+  const PENDING_SEARCH_KEY = 'dsh.sessionFlow.pendingSearch' // 方向 A：全文命中跳转桥
+  // M12：并入右栏状态桥——挂 window 全局共享（跨 factory 实例/热重载稳定；
+  // 曾用模块闭包 const dockState，热重载后新 apply 闭包访问不到 → ReferenceError 踩坑）。
+  const dockBridge = (typeof window !== 'undefined' && window.__dshSessionFlowDock__) ||
+    (typeof window !== 'undefined'
+      ? (window.__dshSessionFlowDock__ = { open: false, listeners: new Set(), controller: null })
+      : { open: false, listeners: new Set(), controller: null })
+  const PIANO_WINDOW = 15
+
+  // 定位目标：会话内容区。注意必须选**滚动容器** scrollBody（data-conversation-scroll）：
+  // viewArea 在滚动场景下 rect 是「内容全尺寸」（如 y=-25687, h=26823），用它定位会把
+  // 竖条甩到视口外（实测踩坑）。scrollBody 才有正确的视口内矩形。
+  // 优先级：scrollBody（滚动容器）→ viewArea（仅无 scrollBody 时兜底）。
+  function pianoViewArea() {
+    const col = document.querySelector(CONVERSATION_SELECTOR)
+    if (col === null) return undefined
+    const body = col.querySelector('[data-conversation-scroll]')
+    if (body instanceof Element) return body
+    const area = col.querySelector('[class*=viewArea]')
+    if (area instanceof Element) return area
+    return undefined
+  }
+
+  // ── M11：本会话轮次导航（会话页左侧常驻悬浮条目条，v3）──────────
+  // 范围：只显示【当前会话】的对话轮次（用户消息），不跨会话/不跨工作区。
+  // 数据：官方消息行锚点 DOM 驱动（data-time-hover-root，dsh-navbar 同款机制，
+  // 零 RPC 实时）：用户行 = 无 data-turn-tail + 含 [class*=bubble]。
+  // 轮次 → 结论预览：按顺序索引映射 host get 的 lightTurns（用户消息摊平）。
+  // 交互：点击滚动定位该轮、active 跟随视口第一条、窗口裁剪 + 滚轮/▲▼、
+  // 键盘 ↑↓/Enter、hover 预览卡（该轮用户消息 + 结论）、右键唤起会话流工作台。
+  // 样式：DeepSeek 网页版右侧悬浮消息导航风格（圆角卡片 + 单行截断文字），移到左侧。
+  function TurnKeys(props) {
+    const { sessions, onOpenWorkbench } = props
+    const [entries, setEntries] = useState([]) // [{turn, seq, preview}] host 全量用户轮次
+    const [activeIdx, setActiveIdx] = useState(-1)
+    const [winOffset, setWinOffset] = useState(0)
+    const [kbGlobal, setKbGlobal] = useState(null)
+    const [detailIdx, setDetailIdx] = useState(null) // 右侧信息面板显示的条目索引
+    const detailTimer = useRef(null)
+    const rootRef = useRef(null) // 悬浮条根容器（面板定位换算基准）
+    const [jumpFail, setJumpFail] = useState(false) // 未加载轮次提示
+    const [, force] = useState(0)
+
+    // 定位自管理：垂直居中悬浮于会话内容区（scrollBody 矩形中心 + translateY(-50%)）。
+    const [pos, setPos] = useState(null) // {left, top(区中心)}
+    useEffect(() => {
+      const compute = () => {
+        const area = pianoViewArea()
+        if (area === undefined) { setPos(null); return }
+        const r = area.getBoundingClientRect()
+        if (r.width === 0 && r.height === 0) return
+        const seat = area.querySelector('[data-composer-seat]')
+        const seatH = seat ? seat.getBoundingClientRect().height : 0
+        setPos({ left: r.left, top: r.top + Math.max(0, r.height - seatH) / 2 })
+      }
+      compute()
+      window.addEventListener('resize', compute)
+      const iv = setInterval(compute, 2000)
+      return () => { window.removeEventListener('resize', compute); clearInterval(iv) }
+    }, [])
+
+    // 订阅会话列表变化：切换会话（current 变化）→ 重渲染刷新条目。
+    useEffect(() => {
+      if (sessions && sessions.list && typeof sessions.list.subscribe === 'function') {
+        return sessions.list.subscribe(() => force((n) => n + 1))
+      }
+      return undefined
+    }, [sessions])
+
+    // 默认定位到【最新一轮】：首次拿到条目后窗口初始 offset 指向末尾
+    // （此前默认从最旧开始，看最新轮次需翻页——已修正）。之后用户手动
+    // 翻页/新消息到达都不再重置（不打断用户当前窗口位置）。
+    const initTailDone = useRef(false)
+    useEffect(() => {
+      if (initTailDone.current || entries.length <= WINDOW) return
+      initTailDone.current = true
+      setWinOffset(entries.length - WINDOW)
+    }, [entries])
+
+    // 当前会话 id（仅取 current，不展示跨会话列表）。
+    const currentId = (() => {
+      try {
+        const s = sessions && sessions.list && typeof sessions.list.getSnapshot === 'function' ? sessions.list.getSnapshot() : null
+        return s && s.current ? s.current : null
+      } catch (e) { return null }
+    })()
+
+    // 条目数据：host get lightTurns 全量用户轮次（含往期，不受 DOM 虚拟列表窗口限制）。
+    // 轮询降载（PERF-ANALYSIS §4.1）：大会话 get 每轮 ~383ms（缓存 JSON.parse）——
+    // 观察消息流 DOM 变化（新消息/流式渲染）→ 立即刷新并切高频（3s）；
+    // 空闲时低频兜底（15s），避免常驻高频轮询空转。
+    useEffect(() => {
+      if (!currentId) { setEntries([]); return undefined }
+      let alive = true
+      // 切换会话后重置「已定位」标记，下次加载重新定位到新会话末尾。
+      initTailDone.current = false
+      const refresh = () => {
+        api('get', { sessionId: currentId }).then((json) => {
+          if (!alive || !json || !json.ok) return
+          const flat = []
+          for (const lt of json.lightTurns || []) {
+            for (const u of lt.userMessages || []) {
+              flat.push({ turn: lt.turn, seq: u.seq, preview: u.preview })
+            }
+          }
+          // 防御：同一 seq 只保留一条（避免同一条消息重复渲染 = 「最后一条显示两次」）。
+          const seen = new Set()
+          const dedup = flat.filter((e) => {
+            if (seen.has(e.seq)) return false
+            seen.add(e.seq)
+            return true
+          })
+          setEntries((prev) => {
+            if (prev.length === dedup.length && prev.length > 0 && prev[prev.length - 1].seq === dedup[dedup.length - 1].seq) return prev
+            return dedup
+          })
+        }).catch(() => {})
+      }
+      const ACTIVE_MS = 3000
+      const IDLE_MS = 15000
+      let iv = null
+      const schedule = (delay) => {
+        if (iv) clearInterval(iv)
+        iv = setInterval(refresh, delay)
+      }
+      // DOM 变化（新消息/流式渲染）：立即刷新 + 切高频；1s 节流防虚拟列表滚动刷屏。
+      let flowObs = null
+      let lastDomRefresh = 0
+      const onDomChange = () => {
+        if (!alive) return
+        const now = Date.now()
+        if (now - lastDomRefresh < 1000) return
+        lastDomRefresh = now
+        refresh()
+        schedule(ACTIVE_MS)
+      }
+      const flowEl = document.querySelector('[data-chat-flow=""]') || document.querySelector('[data-focus-flow=""]')
+      if (flowEl) {
+        flowObs = new MutationObserver(onDomChange)
+        flowObs.observe(flowEl, { childList: true, subtree: true })
+      }
+      refresh()
+      schedule(IDLE_MS)
+      return () => { alive = false; if (iv) clearInterval(iv); if (flowObs) flowObs.disconnect() }
+    }, [currentId])
+
+    // DOM 行工具：官方消息行锚点（dsh-navbar 同款）。
+    const domRows = () => [...document.querySelectorAll('[data-time-hover-root]')]
+      .filter((r) => !r.hasAttribute('data-pending-steering'))
+      .filter((r) => !r.hasAttribute('data-turn-tail') && r.querySelector('[class*=bubble]') !== null)
+    const textOf = (row) => {
+      const b = row.querySelector('[class*=bubble]')
+      return b ? String(b.textContent || '').replace(/\s+/g, ' ').trim() : ''
+    }
+    // 归一化：剥离 markdown 标记（**加粗**/行内代码/链接/符号），使 host 原始
+    // preview 与 DOM 渲染后的 textContent 可比（否则 startsWith 永远失败 →
+    // 近轮次误判「未找到」+ 加载循环误匹配其他轮次，实测踩坑）。
+    const norm = (s) => String(s || '')
+      .replace(/`{1,3}[^`]*`{1,3}/g, ' ')
+      .replace(/\[([^\]]*)\]\([^)]*\)/g, '$1')
+      .replace(/[*_#>|~-]{1,3}/g, ' ')
+      .replace(/\s+/g, ' ')
+      .trim()
+    // 条目 → DOM 行匹配：preview 归一化截断前缀与行文本归一化后 includes 比较。
+    const findRow = (entry) => {
+      const core = norm(String(entry.preview || '').replace(/…+$/u, '')).slice(0, 50)
+      if (!core) return null // 无文字内容（纯图片/文件消息）无法文本定位
+      for (const row of domRows()) {
+        const t = norm(textOf(row))
+        if (t && t.includes(core.slice(0, 30))) return row
+      }
+      return null
+    }
+
+    // 点击定位：先查该轮次是否已加载（DOM 中能否匹配到对应行）——
+    // 已加载 → 平滑滚动定位；未加载 → 只提示、不跳转（自动加载循环会让消息流
+    // 乱滚/跳错位置，实测踩坑；用户需先在会话区向上滚动加载历史再点击）。
+    const open = (entry) => {
+      const row = findRow(entry)
+      if (row) { row.scrollIntoView({ behavior: 'smooth', block: 'start' }); return }
+      setJumpFail(true)
+      setTimeout(() => setJumpFail(false), 2600)
+    }
+
+    // active：视口内第一条 DOM 用户行 → 文本匹配条目索引高亮（阅读位置跟随）。
+    useEffect(() => {
+      const compute = () => {
+        if (entries.length === 0) { setActiveIdx(-1); return }
+        const rows = domRows()
+        let target = null
+        let bestTop = Number.POSITIVE_INFINITY
+        for (const row of rows) {
+          const top = row.getBoundingClientRect().top
+          if (top >= 0 && top < bestTop) { bestTop = top; target = row }
+        }
+        if (!target) { setActiveIdx(entries.length - 1); return }
+        const t = norm(textOf(target))
+        const idx = entries.findIndex((e) => {
+          const core = norm(String(e.preview || '').replace(/…+$/u, '')).slice(0, 50)
+          return core && t.includes(core.slice(0, 30))
+        })
+        setActiveIdx(idx)
+      }
+      compute()
+      const iv = setInterval(compute, 800)
+      return () => clearInterval(iv)
+    }, [entries])
+
+    const WINDOW = 12
+    const hidden = entries.length < 2
+    const windowed = entries.slice(winOffset, winOffset + WINDOW)
+    const canUp = winOffset > 0
+    const canDown = winOffset + WINDOW < entries.length
+
+    // 悬浮条滚轮/▲▼：只翻悬浮条自身窗口，绝不影响会话区滚动（用户明确要求）。
+    const onKeyDown = (e) => {
+      if (entries.length === 0) return
+      if (e.key === 'ArrowDown' || e.key === 'ArrowUp') {
+        e.preventDefault()
+        const dir = e.key === 'ArrowDown' ? 1 : -1
+        setKbGlobal((prev) => {
+          const base = prev === null ? (dir > 0 ? -1 : entries.length) : prev
+          return Math.max(0, Math.min(entries.length - 1, base + dir))
+        })
+      } else if (e.key === 'Enter' && kbGlobal !== null && entries[kbGlobal]) {
+        e.preventDefault()
+        open(entries[kbGlobal])
+      }
+    }
+    useEffect(() => {
+      if (kbGlobal === null) return
+      if (kbGlobal < winOffset) setWinOffset(kbGlobal)
+      else if (kbGlobal >= winOffset + WINDOW) setWinOffset(kbGlobal - WINDOW + 1)
+    }, [kbGlobal])
+
+    // 滚轮翻页：React onWheel 是被动监听器（passive: true），内部 preventDefault
+    // 无效并刷屏告警（实测踩坑）——改原生 addEventListener('wheel', {passive:false})。
+    const stripRef = useRef(null)
+    useEffect(() => {
+      const el = stripRef.current
+      if (el === null) return undefined
+      const onNativeWheel = (e) => {
+        e.preventDefault()
+        e.stopPropagation()
+        if (e.deltaY > 0) setWinOffset((o) => Math.min(Math.max(0, entries.length - WINDOW), o + 1))
+        else setWinOffset((o) => Math.max(0, o - 1))
+      }
+      el.addEventListener('wheel', onNativeWheel, { passive: false })
+      return () => el.removeEventListener('wheel', onNativeWheel)
+    }, [entries.length])
+
+    // 右侧信息面板：hover 条目/键盘聚焦时弹出该轮信息（保留弹出面板、移除原生
+    // tooltip——tooltip 与面板重复且视觉凌乱）；鼠标在条目与面板间移动 150ms 宽限。
+    const showDetail = (idx) => {
+      if (detailTimer.current) clearTimeout(detailTimer.current)
+      setDetailIdx(idx)
+    }
+    const hideDetail = () => {
+      if (detailTimer.current) clearTimeout(detailTimer.current)
+      detailTimer.current = setTimeout(() => setDetailIdx(null), 150)
+    }
+    useEffect(() => () => { if (detailTimer.current) clearTimeout(detailTimer.current) }, [])
+    // 键盘聚焦跟随显示面板。
+    useEffect(() => {
+      if (kbGlobal !== null && entries[kbGlobal]) showDetail(kbGlobal)
+    }, [kbGlobal])
+
+    const rootStyle = pos === null ? { display: 'none' } : {
+      left: pos.left + 'px',
+      top: pos.top + 'px',
+      transform: 'translateY(-50%)',
+      display: hidden ? 'none' : undefined,
+    }
+
+    const detailEntry = detailIdx !== null ? entries[detailIdx] : null
+    // 面板位置：absolute 相对悬浮条容器（容器有 translateY(-50%) transform，fixed
+    // 会退化为相对容器——必须按容器内偏移计算）。条目 = strip 直接子元素，
+    // 索引 = detailIdx - winOffset；越界修正按视口坐标换算回容器内。
+    let detailPos = null
+    const rootRect = rootRef.current ? rootRef.current.getBoundingClientRect() : null
+    if (detailEntry && rootRect) {
+      const el = stripRef.current ? stripRef.current.children[detailIdx - winOffset] : null
+      if (el instanceof Element) {
+        const r = el.getBoundingClientRect()
+        const topV = Math.min(r.top, Math.max(4, window.innerHeight - 320))
+        detailPos = { left: r.right - rootRect.left + 8, top: topV - rootRect.top }
+      }
+    }
+
+    return h('div', { 'data-dsh-piano-keys': '', ref: rootRef, style: rootStyle },
+      h('div', { className: 'pk-head' },
+        h('span', { className: 'pk-headLabel' }, STR.pianoTitle),
+        h('div', { className: 'pk-navGroup' },
+          h('button', { className: 'pk-navBtn', disabled: !canUp, onClick: () => setWinOffset((o) => Math.max(0, o - 1)), title: STR.expanded }, '▲'),
+          h('button', { className: 'pk-navBtn', disabled: !canDown, onClick: () => setWinOffset((o) => Math.min(Math.max(0, entries.length - WINDOW), o + 1)), title: STR.collapsed }, '▼'),
+        ),
+      ),
+      h('div', { className: 'pk-strip', ref: stripRef, tabIndex: 0, onKeyDown, onMouseDown: (e) => { if (e.target === e.currentTarget) e.preventDefault() }, 'aria-label': STR.pianoTitle },
+        windowed.map((entry, idx) => {
+          const gi = winOffset + idx
+          const act = activeIdx === gi
+          return h('button', {
+            key: 'turn-' + gi + '-' + entry.seq,
+            type: 'button',
+            className: 'pk-key' + (act ? ' pk-keyActive' : '') + (kbGlobal === gi ? ' pk-keyFocus' : ''),
+            // 点击后主动失焦：避免 button 焦点让 :focus-within 常驻展开
+            // （鼠标移开后悬浮条收不拢，箭头「残留」——实测踩坑）。
+            onClick: (e) => { open(entry); e.currentTarget.blur() },
+            onMouseEnter: () => showDetail(gi),
+            onMouseLeave: hideDetail,
+            onContextMenu: (e) => {
+              e.preventDefault()
+              if (onOpenWorkbench) onOpenWorkbench()
+            },
+          },
+            // 轮次序号：展开态常驻【最左侧】独立模块（与文本模块分离，互不侵占）。
+            h('span', { className: 'pk-turnNo' }, 'T' + entry.turn),
+            h('span', { className: 'pk-label' }, entry.preview || '（空）'),
+          )
+        }),
+      ),
+      // 信息面板：跟随 hover 条目右侧展开（fixed，位置由 detailPos 控制）；
+      // 常驻渲染 + hidden 类做滑入/滑出；内容 key 变化触发 pkSlideIn。
+      h('div', { className: 'pk-detail' + (detailEntry ? '' : ' hidden'), style: detailPos, onMouseEnter: () => showDetail(detailIdx), onMouseLeave: hideDetail },
+        detailEntry && h('div', { key: 'h' + detailEntry.turn, className: 'pk-detailHead' }, 'T' + detailEntry.turn + ' · ' + STR.user),
+        detailEntry && h('div', { key: 'b' + detailEntry.turn, className: 'pk-detailBody' }, detailEntry.preview || '（空）'),
+      ),
+      // 跳转状态提示：常驻渲染 + hidden 类（从下方淡入/淡出）；未加载轮次提示。
+      h('div', { className: 'pk-status' + (jumpFail ? '' : ' hidden') + (jumpFail ? ' warn' : '') },
+        jumpFail ? STR.pianoJumpFail : '',
+      ),
+    )
+  }
+
+  // ── M12：详情并入右侧栏（details 槽位轻量视图）────────────────────
+  // 随会话自动切换（槽位 session 作用域 key 重挂载）；数据复用 host get/getTurn；
+  // 回合列表直接复用 TurnList（展开 → TimelineTurns 完整渲染）。
+  function DetailsDockView(props) {
+    const { sessionId, connection, onExit } = props
+    const [state, setState] = useState({ phase: 'loading', error: null, data: null })
+    const [collapsed, setCollapsed] = useState(() => new Set())
+    const collapsedInit = useRef(false)
+    const [turnItems, setTurnItems] = useState(() => new Map())
+    const loadingTurns = useRef(new Set())
+
+    useEffect(() => {
+      let alive = true
+      setState({ phase: 'loading', error: null, data: null })
+      setTurnItems(new Map())
+      collapsedInit.current = false
+      if (!sessionId) { setState({ phase: 'empty', error: null, data: null }); return }
+      api('get', { sessionId }).then((json) => {
+        if (!alive) return
+        if (json && json.ok) {
+          setState({ phase: 'ready', error: null, data: json })
+        } else {
+          setState({ phase: 'error', error: (json && json.error) || 'get failed', data: null })
+        }
+      }).catch((e) => { if (alive) setState({ phase: 'error', error: String(e), data: null }) })
+      return () => { alive = false }
+    }, [sessionId])
+
+    useEffect(() => {
+      if (state.phase !== 'ready' || collapsedInit.current) return
+      collapsedInit.current = true
+      const all = new Set()
+      for (const lt of state.data.lightTurns || []) all.add('turn-' + lt.turn)
+      setCollapsed(all)
+    }, [state.phase])
+
+    const toggle = (key) => {
+      setCollapsed((prev) => {
+        const next = new Set(prev)
+        if (next.has(key)) next.delete(key)
+        else next.add(key)
+        return next
+      })
+    }
+    const ensureTurn = async (turnNo) => {
+      if (turnItems.has(turnNo) || loadingTurns.current.has(turnNo)) return
+      loadingTurns.current.add(turnNo)
+      try {
+        const json = await api('getTurn', { sessionId, turn: turnNo })
+        if (json && json.ok && json.turn) {
+          setTurnItems((prev) => new Map(prev).set(turnNo, json.turn))
+        }
+      } catch (e) {
+        console.warn('[dsh-session-flow] getTurn failed', turnNo, e)
+      } finally {
+        loadingTurns.current.delete(turnNo)
+      }
+    }
+
+    const data = state.data
+    const lightTurns = (data && data.lightTurns) || []
+    const toolStats = (data && data.toolStats) || []
+    // 规则摘要（与详情页同口径，精简版）。
+    const ruleTaskCount = lightTurns.filter((lt) => lt.userMessages && lt.userMessages.length > 0).length
+    const ruleGoal = (() => {
+      for (const lt of lightTurns) {
+        if (lt.userMessages && lt.userMessages.length > 0) return String(lt.userMessages[0].preview).slice(0, 150)
+      }
+      return ''
+    })()
+    const ruleConclusion = (() => {
+      for (let i = lightTurns.length - 1; i >= 0; i--) {
+        if (lightTurns[i].conclusionPreview) return String(lightTurns[i].conclusionPreview).slice(0, 220)
+      }
+      return ''
+    })()
+    const ruleTools = toolStats.slice(0, 6).map((t) => t.name + '·' + t.count).join('  ')
+
+    return h('div', { className: 'dk-root' },
+      h('div', { className: 'dk-head' },
+        h('span', { className: 'dk-title' }, STR.dockHint),
+        h('button', { className: 'dk-btn', onClick: onExit }, STR.dockExit),
+      ),
+      h('div', { className: 'dk-body' },
+        state.phase === 'loading' && h('div', { className: 'sf-hint' }, STR.detailLoading),
+        state.phase === 'empty' && h('div', { className: 'sf-hint' }, STR.dockEmpty),
+        state.phase === 'error' && h('div', { className: 'sf-hint', style: { color: '#d43b3b' } }, STR.detailFailed + ': ' + String(state.error)),
+        state.phase === 'ready' && h('div', { className: 'dk-summary' },
+          ruleTaskCount > 0 && h('div', { className: 'dk-summaryRow' },
+            h('span', { className: 'dk-summaryTag' }, STR.summaryTaskCount),
+            h('span', { className: 'dk-summaryText' }, ruleTaskCount),
+          ),
+          ruleGoal && h('div', { className: 'dk-summaryRow' },
+            h('span', { className: 'dk-summaryTag' }, STR.summaryGoal),
+            h('span', { className: 'dk-summaryText' }, ruleGoal),
+          ),
+          ruleConclusion && h('div', { className: 'dk-summaryRow' },
+            h('span', { className: 'dk-summaryTag' }, STR.summaryConclusion),
+            h('span', { className: 'dk-summaryText' }, ruleConclusion),
+          ),
+          ruleTools && h('div', { className: 'dk-summaryRow' },
+            h('span', { className: 'dk-summaryTag' }, STR.summaryTools),
+            h('span', { className: 'dk-summaryText' }, ruleTools),
+          ),
+          data.summary && h('div', { className: 'dk-summaryFull' }, data.summary),
+        ),
+        state.phase === 'ready' && lightTurns.length === 0 && h('div', { className: 'sf-hint' }, STR.noTimeline),
+        state.phase === 'ready' && h(TurnList, {
+          sessionId,
+          lightTurns,
+          collapsed,
+          toggle,
+          ensureTurn,
+          turnItems,
+        }),
+      ),
+    )
+  }
+
+  // ── M11：钢琴键竖条挂载（DOM 注入 + 自愈）────────────────────────
+  // 容器挂 document.body（dsh-navbar 同款模式）：完全脱离会话区布局树，
+  // 不干扰 conversation 的 flex/grid 布局；fixed 定位由组件自管理。
+  // MutationObserver 自愈：容器丢失（布局重建）时自动恢复。
+  function mountPianoKeys(controller, sessions, connection) {
+    let root = undefined
+    let container = undefined
+    let waitObserver = null
+
+    // M11×视图：轮次条只在「对话」tab（ChatView）激活时显示——官方 viewArea
+    // 只渲染激活视图（only: active.id），轨迹/Plan图/会话流 tab 下 ChatView 卸载，
+    // `[data-chat-flow]` 随之消失（会话流标签页有自己的 sf-view，不冲突）。
+    const syncChatVisibility = () => {
+      if (container === undefined) return
+      const chatFlow = document.querySelector('[data-chat-flow]')
+      container.style.display = chatFlow !== null ? '' : 'none'
+    }
+
+    const ensure = () => {
+      if (container !== undefined) {
+        if (container.isConnected) return
+        if (root) { try { root.unmount() } catch (e) {} root = undefined }
+        container = undefined
+      }
+      container = document.createElement('div')
+      document.body.appendChild(container)
+      try {
+        root = createRoot(container)
+        root.render(h(TurnKeys, {
+          sessions,
+          connection,
+          onOpenWorkbench: () => controller.open(),
+        }))
+        syncChatVisibility()
+      } catch (e) {
+        console.error('[dsh-session-flow:piano] render failed:', e)
+        if (root) { try { root.unmount() } catch (e2) {} root = undefined }
+        if (container) { container.remove(); container = undefined }
+      }
+    }
+
+    waitObserver = new MutationObserver(() => { ensure(); syncChatVisibility() })
+    waitObserver.observe(document.body, { childList: true, subtree: true })
+    ensure()
+
+    return () => {
+      waitObserver.disconnect()
+      if (root) { try { root.unmount() } catch (e) {} root = undefined }
+      if (container) { container.remove(); container = undefined }
+    }
+  }
+
   // ── 侧边栏入口（DOM 级注入 + 自愈）────────────────────────────────
   const ICON = `<svg viewBox="0 0 16 16" width="14" height="14" fill="none" stroke="currentColor" stroke-width="1.3" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M2.5 3.5h11M2.5 8h11M2.5 12.5h7"/></svg>`
-
   function sidebarRoot() {
     const column = document.querySelector('[data-pane="sidebar"], [class*="sidebarCol"]')
     if (column === null) return undefined
@@ -1818,7 +2880,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
   }
 
   // ── 插件体 ─────────────────────────────────────────────────────────
-  const inject = ['sessions', 'connection']
+  const inject = ['sessions', 'connection', 'slots', 'layout']
 
   function apply(ctx) {
     try {
@@ -1850,6 +2912,13 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
             for (const fn of state.listeners) fn()
           }
         },
+        open: () => {
+          // 二期：嵌入标签页「打开完整工作台」→ 唤起侧边栏工作台。
+          if (!state.open) {
+            state.open = true
+            for (const fn of state.listeners) fn()
+          }
+        },
       }
 
       const onActivate = (event) => {
@@ -1857,6 +2926,166 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       }
       document.addEventListener(ACTIVATE_EVENT, onActivate)
 
+      // 二期：嵌入原生会话页 —— conversation.view 槽位环（会话作用域标签页）。
+      // 参照 ui-trajectory(order 10) / plan-graph(order 20) 的注册模式：
+      // slots.inject 自带生命周期（插件卸载自动移除标签页），无需手动清理。
+      // label 支持字符串或惰性求值函数；order 越大越靠后（对话/轨迹/Plan图 之后）。
+      const slots = ctx.get('slots')
+      if (slots !== undefined && typeof slots.inject === 'function' && typeof slots.register === 'function') {
+        try {
+          slots.inject('conversation.view', () => slots.register({
+            name: 'conversation.view',
+            id: 'session-flow',
+            order: 30,
+            label: STR.entry,
+          }, (props) => h(SessionFlowTab, {
+            sessionId: props ? props.sessionId : undefined,
+            sessions,
+            connection,
+            onOpenWorkbench: () => controller.open(),
+          })))
+        } catch (error) {
+          console.error('[dsh-session-flow] conversation.view registration failed:', error)
+        }
+      }
+
+      // M12：详情并入右侧栏 —— details 槽位动态占用（priority -1 低于官方 tool-details）。
+      // 并入开启时注册 + **打开官方 details 列（layout.openDetails——列默认宽度 0 不可见，
+      // plan-graph 同款；曾漏开列导致「无响应」，实测踩坑）**；退出/卸载注销 + closeDetails。
+      // 官方在会话切换时自动 closeDetails（无法阻止）——并入期间：
+      //  ① html 打 data-dsh-dock-active 标记 → CSS 禁用 grid 列宽过渡（切换无「关→开」动画）；
+      //  ② 高频守护（150ms）快速重开列 → 视觉上右栏内容直接刷新为新会话。
+      const layout = ctx.get('layout')
+      let detailsRegistration = null
+      let detailsGuard = null
+      const setDockActive = (on) => {
+        try {
+          if (on) document.documentElement.setAttribute('data-dsh-dock-active', '')
+          else document.documentElement.removeAttribute('data-dsh-dock-active')
+        } catch (e) {}
+      }
+
+      // M12×aionui 兼容层：官方 details 把手按 3 轨模型定位（left = frameWidth - details，
+      // 假设 details 是最后一轨）；aionui-panel 把 frame grid 扩为 5 轨
+      // （sidebar|center|details|preview|explorer）后，真实边界左移 preview+explorer px，
+      // 把手却停在旧位置（悬浮于预览列上方，见 docs/02-design/LAYOUT-COEXIST.md）。
+      // dock 激活期间按实际轨宽重算把手位置：三方写 frame style → MutationObserver；
+      // 纯缩放（grid 字符串不变）→ ResizeObserver。3 轨时公式退化为官方原值，无副作用。
+      const parseGridTracksCompat = (input) => {
+        const tracks = []
+        let depth = 0
+        let current = ''
+        for (const ch of String(input)) {
+          if (ch === '(') depth += 1
+          if (ch === ')') depth = Math.max(0, depth - 1)
+          if (ch === ' ' && depth === 0) {
+            if (current !== '') { tracks.push(current); current = '' }
+            continue
+          }
+          current += ch
+        }
+        if (current !== '') tracks.push(current)
+        return tracks
+      }
+      const detailsHandleCompat = {
+        frame: null,
+        observer: null,
+        sizeObserver: null,
+        start() {
+          if (this.observer !== null) return
+          const frame = document.querySelector('[data-dsh-frame]') ||
+            (document.querySelector('[class*="sidebarCol"]') || {}).parentElement || null
+          if (frame === null) return
+          this.frame = frame
+          this.observer = new MutationObserver(() => this.apply())
+          this.observer.observe(frame, { attributes: true, attributeFilter: ['style'] })
+          this.sizeObserver = new ResizeObserver(() => this.apply())
+          this.sizeObserver.observe(frame)
+          this.apply()
+        },
+        stop() {
+          if (this.observer !== null) { this.observer.disconnect(); this.observer = null }
+          if (this.sizeObserver !== null) { this.sizeObserver.disconnect(); this.sizeObserver = null }
+          this.frame = null
+        },
+        apply() {
+          const frame = this.frame
+          if (frame === null) return
+          const tracks = parseGridTracksCompat(frame.style.gridTemplateColumns)
+          if (tracks.length < 3) return
+          const trackPx = (t) => {
+            const m = /^(-?[\d.]+)px$/.exec(String(t).trim())
+            return m === null ? 0 : Number(m[1])
+          }
+          const details = trackPx(tracks[2])
+          const preview = tracks.length >= 4 ? trackPx(tracks[3]) : 0
+          const explorer = tracks.length >= 5 ? trackPx(tracks[4]) : 0
+          const handle = frame.querySelector('[data-side="details"]')
+          if (handle === null) return
+          handle.style.left = `${Math.round(frame.getBoundingClientRect().width - details - preview - explorer)}px`
+        },
+      }
+      const ensureColumn = () => {
+        if (dockBridge.open && layout !== undefined && typeof layout.openDetails === 'function') {
+          try { layout.openDetails() } catch (e) {}
+        }
+      }
+      const syncDetails = () => {
+        if (dockBridge.open && detailsRegistration === null && slots !== undefined && typeof slots.inject === 'function') {
+          try {
+            detailsRegistration = slots.inject('details', () => slots.register({
+              name: 'details',
+              priority: -1,
+            }, (props) => h(DetailsDockView, {
+              sessionId: props ? props.sessionId : undefined,
+              connection,
+              onExit: () => dockBridge.controller.close(),
+            })))
+            setDockActive(true)
+            ensureColumn()
+          } catch (error) {
+            console.error('[dsh-session-flow] details dock registration failed:', error)
+            detailsRegistration = null
+          }
+        } else if (!dockBridge.open && detailsRegistration !== null) {
+          try { detailsRegistration() } catch (e) {}
+          detailsRegistration = null
+          setDockActive(false)
+          if (layout !== undefined && typeof layout.closeDetails === 'function') {
+            try { layout.closeDetails() } catch (e) {}
+          }
+        }
+      }
+      dockBridge.controller = {
+        getSnapshot: () => ({ open: dockBridge.open }),
+        subscribe: (fn) => {
+          dockBridge.listeners.add(fn)
+          return () => dockBridge.listeners.delete(fn)
+        },
+        open: () => {
+          if (!dockBridge.open) {
+            dockBridge.open = true
+            syncDetails()
+            detailsHandleCompat.start()
+            // 会话切换时官方会自动 closeDetails —— 高频守护快速重开（无动画，内容直接刷新）。
+            if (detailsGuard === null) {
+              detailsGuard = setInterval(() => { ensureColumn() }, 150)
+            }
+            for (const fn of dockBridge.listeners) fn()
+          }
+        },
+        close: () => {
+          if (dockBridge.open) {
+            dockBridge.open = false
+            syncDetails()
+            detailsHandleCompat.stop()
+            if (detailsGuard !== null) { clearInterval(detailsGuard); detailsGuard = null }
+            for (const fn of dockBridge.listeners) fn()
+          }
+        },
+      }
+      syncDetails()
+
       // 点击侧边栏会话/工作区行 → 交还中栏给会话。
       const onClickSidebarRow = (event) => {
         if (!state.open) return
@@ -1889,11 +3118,25 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       try {
         disposers.push(mountSidebarEntry(controller))
         disposers.push(mountBoard(controller, sessions, connection))
+        // M11：钢琴键会话快切（会话页左侧常驻竖条）；挂载失败不影响其他功能。
+        disposers.push(mountPianoKeys(controller, sessions, connection))
       } catch (error) {
         console.error('[dsh-session-flow] mount failed:', error)
       }
 
       const teardown = () => {
+        // M12：卸载时注销 details 槽位占用（恢复官方 tool-details）+ 关列 + 清守护 + 移除标记。
+        if (detailsRegistration) {
+          try { detailsRegistration() } catch (e) {}
+          detailsRegistration = null
+        }
+        if (detailsGuard !== null) { clearInterval(detailsGuard); detailsGuard = null }
+        setDockActive(false)
+        detailsHandleCompat.stop()
+        if (layout !== undefined && typeof layout.closeDetails === 'function') {
+          try { layout.closeDetails() } catch (e) {}
+        }
+        dockBridge.open = false
         document.removeEventListener(ACTIVATE_EVENT, onActivate)
         document.removeEventListener('click', onClickSidebarRow, true)
         document.removeEventListener('scroll', onAnyScroll, true)