dsh-session-flow 1.2.0 → 1.4.0

package/lib/archive.js

@@ -1,7 +1,10 @@
 // lib/archive.js — 会话存档核心：扫描 / 解码 / 解析 / 统计。
 //
-// 数据来源：~/.dsh/sessions/<workspace>/session-<uuid>/session.jsonl.zstd
+// 数据来源：~/.dsh/sessions/<workspace>/session-<uuid>/session[.v2].jsonl.zstd
 // （zstd 压缩的多帧 JSONL；compression: none 时为明文 session.jsonl）。
+// dsh v0.1.3 起存档升级 v2（session.v2.jsonl.zstd，行信封 {type,seq,time,data} 不变，
+// header version:2 + 新增 session/end-seed 等事件）：v1 文件冻结在迁移时刻、v2 持续
+// 写入——读取必须优先 v2，否则读到冻结旧数据、纯 v2 新会话不可见（0.1.3 适配）。
 //
 // 解码使用 Node 内置 node:zlib 的 zstd 支持（Node >= 22.19），零第三方依赖；
 // 帧扫描算法借鉴自 @deepseek-ai/dsh-session-persistence-jsonl (MIT)。
@@ -246,8 +249,12 @@ export function summarizeParsed({ header, title, events }) {
   }
 }
 
-/** 定位一个会话目录里的存档文件（优先 zstd，回退明文）。 */
+/** 定位一个会话目录里的存档文件（优先 v2，回退 v1 zstd，再回退明文）。
+ * dsh v0.1.3 起 v2 存档与 v1 并存：v1 冻结在迁移时刻、v2 持续写入——
+ * 必须优先 v2，否则老会话读到冻结数据、纯 v2 新会话直接漏掉（0.1.3 适配）。 */
 export function sessionFileOf(sessionDir) {
+  const v2 = join(sessionDir, 'session.v2.jsonl.zstd')
+  if (existsSync(v2)) return v2
   const zstd = join(sessionDir, 'session.jsonl.zstd')
   if (existsSync(zstd)) return zstd
   const plain = join(sessionDir, 'session.jsonl')

package/lib/client.js

@@ -24,7 +24,10 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
   const OTHER_ACTIVE_ATTRS = ['data-dsh-taskboard-active', 'data-dsh-ssh-active']
   const ACTIVATE_EVENT = 'dsh-panel-activate'
   const PANEL_NAME = 'sessionflow'
-  const CONVERSATION_SELECTOR = '[data-pane="conversation"]'
+  // 会话面板容器选择器：dsh v0.1.2 起官方移除 data-pane="conversation"（会话流
+  // 重构进 dsh-client-ui-chat），兜底命中布局中栏（CenterColumn，类名含 centerCol
+  // 哈希后缀稳定片段）。工作台/标签切换/钢琴键定位共用此锚。
+  const CONVERSATION_SELECTOR = '[data-pane="conversation"], [class*=centerCol]'
   const SIDEBAR_ROW_SELECTOR = '[class*="sessionRow"], [class*="projectRow"], [class*="searchResultRow"], [class*="searchResultWorkspace"], [class*="newSession"]'
   const ACTIVE_WINDOW_MS = 15 * 60 * 1000 // 最近 15 分钟有事件 → 视为进行中（归档/总览徽标用）
 
@@ -44,7 +47,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     dockPinNotice: '📌 直播已钉住原会话（当前已切换会话）', dockPinRebind: '转播当前会话',
     rename: '重命名', renamePlaceholder: '输入新标题…', renameFail: '重命名失败', origTitle: '原名',
     search: '搜索标题/工具/文件… 支持 tool: pwsh · file: src · err:', allWorkspaces: '全部工作区',
-    sortRecent: '最近运行', sortNewest: '最近创建', sortOldest: '最早创建', sortTools: '工具最多', sortLongest: '耗时最长',
+    sortRecent: '最近运行', sortNewest: '最近创建', sortOldest: '最早创建', sortTools: '工具最多', sortLongest: '耗时最长', sortSize: '占用最大',
     noMatch: '没有匹配的会话', noData: '暂无会话数据',
     running: '进行中', ended: '已结束', subagent: '子代理',
     turns: '回合', steps: '步骤', tools: '工具', errors: '错误', msgs: '消息',
@@ -65,7 +68,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     emptyHint: '此会话已创建但尚未开始对话', userNav: '用户发言', noUserNav: '（无用户发言）',
     conclusion: '结论', injected: '注入', lineage: '血缘', noLineage: '（无子代理血缘信息）', task: '任务',    liveTree: '运行时血缘', offlineTree: '档案血缘', modeOneShot: '一次性', modeContinuable: '可续',
     subagentDetail: '子代理详情', loadDetail: '加载子代理详情…', noDetail: '该子代理无可见事件',
-    viewSubagent: '查看子代理', toolTop: '工具 Top', issues: '问题会话', issuesHint: '只显示有错误记录的会话',
+    viewSubagent: '查看子代理', toolTop: '工具 Top', issues: '问题会话', issuesHint: '只显示有错误记录的会话', storage: '存储', storageHint: '当前范围会话存档总占用（只读）',
     searchTab: '检索', searchInPlaceholder: '会话内检索…', noMatches: '无匹配位置', matches: '命中', navUsers: '用户',
     cache: '缓存管理', cacheTotal: '缓存总量', cacheIndex: '会话索引', cacheTimeline: '时间线缓存',
     cleanTimeline: '清理时间线缓存', cleanAll: '清理全部缓存', cacheDone: '已清理', cacheEmpty: '（无缓存文件）',
@@ -74,12 +77,13 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     summaryStale: '⚠ 摘要生成后有新对话，内容可能已不准确，建议重新生成',
     llmSummary: '生成 LLM 摘要', llmGenerating: '生成中…', llmFail: '生成失败', summaryRuleTag: '规则', summaryLlmTag: 'LLM',
     cacheHint: '仅清理本插件的缓存（可自动重建），不影响 DSH 会话存档与任何其他数据', cacheLimit: '时间线缓存上限',
-    healthActive: '活跃', healthToolWait: '工具执行中', healthQuiet: '静默中', healthStalled: '疑似卡死',
+    healthActive: '活跃', healthToolWait: '工具执行中', healthQuiet: '静默中', healthStalled: '疑似卡死', healthIdle: '空闲',
+    agoJustNow: '刚刚', agoMin: '{N} 分钟前', agoHour: '{N} 小时前', agoDay: '{N} 天前',
     healthSilentMin: '静默 {N} 分钟', healthSilentSec: '静默 {N} 秒',
     healthChipTitle: '会话健康状态（会话流）· 点击打开详情',
     renameClearBlocked: '该会话标题由官方会话管理：请输入新标题（不支持清空）',
-    settingsTitle: '会话流', settingsDesc: '调整轮次悬浮条与实时跟踪的行为参数。保存后立即生效（轮次悬浮条行数在重进会话页后完全生效）。',
-    setGroupPiano: '轮次悬浮条', setGroupLive: '实时跟踪', setGroupHealth: '健康监控',
+    settingsTitle: '会话流', settingsDesc: '调整轮次导航、实时跟踪与健康监控的行为参数。保存后立即生效（轮次悬浮条行数在重进会话页后完全生效）。',
+    setGroupPiano: '轮次悬浮条', setGroupLive: '实时跟踪', setGroupHealth: '健康监控', setGroupNav: '轮次导航（v0.1.2+）',
     setPianoWindow: '可见行数', setPianoWindowHint: '悬浮条同时显示的轮次条数（6–18）',
     setPianoWheelSpeed: '滚轮灵敏度', setPianoWheelSpeedHint: '每像素滚动的行数（0.005–0.03），越大滚得越快',
     setPianoSnapMs: '静止吸附延迟（ms）', setPianoSnapMsHint: '滚轮停止多少毫秒后吸附到整行（100–400）',
@@ -87,6 +91,10 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     setLiveFollowPx: '吸底阈值（px）', setLiveFollowPxHint: '距底部多少像素内视为「在底部」并跟随滚动（20–120）',
     setLiveHistoryTurns: '保留历史回合', setLiveHistoryTurnsHint: '实时模式下保留的历史回合数（0–10），下次开播生效',
     setStallThresholdMin: '卡死阈值（分钟）', setStallThresholdMinHint: '运行中但静默超过该时长判定为疑似卡死（1–10）',
+    setRailEnhance: '官方轮次导航增强', setRailEnhanceHint: '在官方右侧轮次导航上叠加：预览卡内追加结论摘要、右键唤起工作台',
+    setPianoClassic: '经典左侧悬浮条', setPianoClassicHint: '插件自带的左侧轮次悬浮条（默认开，与官方右侧导航并存；点击未载入轮次可委托官方引擎自动加载跳转）',
+    setRailHide: '隐藏官方轮次导航', setRailHideHint: '完全屏蔽官方右侧刻度条，只保留我们的悬浮条（开启后「官方轮次导航增强」自动不生效）',
+    railMetaCalls: '{tools} 次工具', railMetaErrors: '{errors} 错误', railThinking: '含思考',
     setSave: '保存', setDiscard: '放弃更改', setSaveFail: '部分设置未保存成功，请检查后重试',
     setReset: '恢复默认', setOverridden: '已修改', setInvalid: '超出范围或格式无效',
     setUnavailable: '当前环境未暴露设置服务，无法编辑（请升级 dsh 后重试）',
@@ -100,7 +108,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     dockPinNotice: '📌 Live pinned to previous session (session switched)', dockPinRebind: 'Follow current session',
     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',
+    sortRecent: 'Recently run', sortNewest: 'Recently created', sortOldest: 'Oldest first', sortTools: 'Most tools', sortLongest: 'Longest', sortSize: 'Largest',
     noMatch: 'No matching sessions', noData: 'No session data yet',
     running: 'Running', ended: 'Ended', subagent: 'subagent',
     turns: 'turns', steps: 'steps', tools: 'tools', errors: 'errors', msgs: 'msgs',
@@ -122,7 +130,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     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',
+    viewSubagent: 'View subagent', toolTop: 'Tool Top', issues: 'Problem sessions', issuesHint: 'Only sessions with errors', storage: 'Storage', storageHint: 'Total archive size of sessions in scope (read-only)',
     searchTab: 'Search', searchInPlaceholder: 'Search in session…', noMatches: 'No matches', matches: 'matches', navUsers: 'User',
     cache: 'Cache Mgmt', cacheTotal: 'Cache total', cacheIndex: 'Index', cacheTimeline: 'Timeline cache',
     cleanTimeline: 'Clean timeline cache', cleanAll: 'Clean all cache', cacheDone: 'Cleaned', cacheEmpty: '(no cache files)',
@@ -131,12 +139,13 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     summaryStale: '⚠ New conversation since summary was generated; content may be outdated — regenerate',
     llmSummary: 'Generate LLM summary', llmGenerating: 'Generating…', llmFail: 'Failed', summaryRuleTag: 'rule', summaryLlmTag: 'LLM',
     cacheHint: "Only this plugin's cache (auto-rebuilds); never touches DSH session archives or other data", cacheLimit: 'Timeline cache limit',
-    healthActive: 'Active', healthToolWait: 'Tool running', healthQuiet: 'Quiet', healthStalled: 'Likely stalled',
+    healthActive: 'Active', healthToolWait: 'Tool running', healthQuiet: 'Quiet', healthStalled: 'Likely stalled', healthIdle: 'Idle',
+    agoJustNow: 'just now', agoMin: '{N}m ago', agoHour: '{N}h ago', agoDay: '{N}d ago',
     healthSilentMin: 'silent {N} min', healthSilentSec: 'silent {N} s',
     healthChipTitle: 'Session health (Session Flow) · click to open detail',
     renameClearBlocked: 'Title is managed by the official session: enter a new title (clearing unsupported)',
-    settingsTitle: 'Session Flow', settingsDesc: 'Tune the piano-keys strip and live-tracking behavior. Applies on save (strip row count fully applies after re-entering a session page).',
-    setGroupPiano: 'Turn strip', setGroupLive: 'Live tracking', setGroupHealth: 'Health monitor',
+    settingsTitle: 'Session Flow', settingsDesc: 'Tune turn navigation, live-tracking, and health-monitor behavior. Applies on save (strip row count fully applies after re-entering a session page).',
+    setGroupPiano: 'Turn strip', setGroupLive: 'Live tracking', setGroupHealth: 'Health monitor', setGroupNav: 'Turn navigation (v0.1.2+)',
     setPianoWindow: 'Visible rows', setPianoWindowHint: 'How many turn keys the strip shows at once (6–18)',
     setPianoWheelSpeed: 'Wheel speed', setPianoWheelSpeedHint: 'Rows scrolled per pixel (0.005–0.03); larger scrolls faster',
     setPianoSnapMs: 'Snap delay (ms)', setPianoSnapMsHint: 'Delay after the wheel stops before snapping to a whole row (100–400)',
@@ -144,6 +153,10 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     setLiveFollowPx: 'Follow threshold (px)', setLiveFollowPxHint: 'Distance from the bottom that still counts as "at bottom" and follows (20–120)',
     setLiveHistoryTurns: 'History turns kept', setLiveHistoryTurnsHint: 'History turns kept in live mode (0–10); applies to the next live session',
     setStallThresholdMin: 'Stall threshold (min)', setStallThresholdMinHint: 'Running but silent beyond this counts as likely stalled (1–10)',
+    setRailEnhance: 'Enhance official turn navigator', setRailEnhanceHint: 'Overlay on the official right-side rail: conclusion section inside its preview card, right-click to open the workbench',
+    setPianoClassic: 'Classic left strip', setPianoClassicHint: 'The plugin\'s own left turn strip (on by default, coexists with the official right rail; clicking an unloaded turn delegates to the official auto-load navigation)',
+    setRailHide: 'Hide official turn navigator', setRailHideHint: 'Fully hide the official right-side rail and keep only our strip (the rail enhancement is inert while this is on)',
+    railMetaCalls: '{tools} tools', railMetaErrors: '{errors} errors', railThinking: 'thinking',
     setSave: 'Save', setDiscard: 'Discard', setSaveFail: 'Some settings were not saved — check and retry',
     setReset: 'Reset', setOverridden: 'Modified', setInvalid: 'Out of range or invalid format',
     setUnavailable: 'The settings service is not exposed in this environment (upgrade dsh and retry)',
@@ -153,12 +166,13 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
   // Host 注册 settings 命名空间 'session-flow'（lib/host.js SETTINGS_DEFAULTS 同源）；
   // client 经 settingsScope 读写（pet 同款：优先 webUiSettings 桥，回退 ctx.settingsScope）。
   // 全部消费点读 sfSettings.current.xxx，缺省 = 原硬编码值——无设置时行为零变化。
-  const SETTINGS_DEFAULTS = { pianoWindow: 12, pianoWheelSpeed: 0.012, pianoSnapMs: 170, livePollMs: 3000, liveFollowPx: 40, liveHistoryTurns: 3, stallThresholdMin: 3 }
+  const SETTINGS_DEFAULTS = { pianoWindow: 12, pianoWheelSpeed: 0.012, pianoSnapMs: 170, livePollMs: 3000, liveFollowPx: 40, liveHistoryTurns: 3, stallThresholdMin: 3, railEnhance: true, railHideOfficial: false, pianoClassicStrip: true }
   const sfSettings = { current: { ...SETTINGS_DEFAULTS } }
   const SETTING_GROUPS = [
     { titleKey: 'setGroupPiano', fields: ['pianoWindow', 'pianoWheelSpeed', 'pianoSnapMs'] },
     { titleKey: 'setGroupLive', fields: ['livePollMs', 'liveFollowPx', 'liveHistoryTurns'] },
     { titleKey: 'setGroupHealth', fields: ['stallThresholdMin'] },
+    { titleKey: 'setGroupNav', fields: ['railEnhance', 'railHideOfficial', 'pianoClassicStrip'] },
   ]
   const SETTING_FIELD_SPECS = {
     pianoWindow: { min: 6, max: 18, integer: true, labelKey: 'setPianoWindow', hintKey: 'setPianoWindowHint' },
@@ -168,9 +182,16 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     liveFollowPx: { min: 20, max: 120, integer: true, labelKey: 'setLiveFollowPx', hintKey: 'setLiveFollowPxHint' },
     liveHistoryTurns: { min: 0, max: 10, integer: true, labelKey: 'setLiveHistoryTurns', hintKey: 'setLiveHistoryTurnsHint' },
     stallThresholdMin: { min: 1, max: 10, integer: true, labelKey: 'setStallThresholdMin', hintKey: 'setStallThresholdMinHint' },
+    railEnhance: { kind: 'bool', labelKey: 'setRailEnhance', hintKey: 'setRailEnhanceHint' },
+    pianoClassicStrip: { kind: 'bool', labelKey: 'setPianoClassic', hintKey: 'setPianoClassicHint' },
+    railHideOfficial: { kind: 'bool', labelKey: 'setRailHide', hintKey: 'setRailHideHint' },
   }
   function formatSettingValue(v) { return v === undefined || v === null ? '' : String(v) }
   function parseSettingValue(spec, text) {
+    if (spec.kind === 'bool') {
+      const t = String(text).trim()
+      return t === 'true' ? true : t === 'false' ? false : undefined
+    }
     const n = Number(String(text).trim())
     if (!Number.isFinite(n) || n < spec.min || n > spec.max) return undefined
     if (spec.integer && !Number.isInteger(n)) return undefined
@@ -298,12 +319,18 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
               field.overridden ? h('span', { className: 'sfset-overridden' }, STR.setOverridden) : null),
             h('div', { className: 'sfset-hint' }, STR[spec.hintKey])),
           h('div', { className: 'sfset-controls' },
-            h('input', {
-              className: 'sfset-input', type: 'number',
-              min: spec.min, max: spec.max, step: spec.integer ? 1 : 0.001,
-              value: field.text, disabled,
-              onChange: (e) => controller.edit(key, e.target.value),
-            }),
+            spec.kind === 'bool'
+              ? h('input', {
+                  className: 'sfset-check', type: 'checkbox',
+                  checked: field.text === 'true', disabled,
+                  onChange: (e) => controller.edit(key, String(e.target.checked)),
+                })
+              : h('input', {
+                  className: 'sfset-input', type: 'number',
+                  min: spec.min, max: spec.max, step: spec.integer ? 1 : 0.001,
+                  value: field.text, disabled,
+                  onChange: (e) => controller.edit(key, e.target.value),
+                }),
             h('button', { type: 'button', className: 'sfset-reset', disabled, onClick: () => controller.resetField(key) }, STR.setReset))))
       }
     }
@@ -340,6 +367,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     `.sfset-discard:hover:not(:disabled){color:var(--dsw-alias-label-primary);border-color:var(--dsw-alias-label-dimmed)}`,
     `.sfset-discard:disabled{opacity:.4;cursor:default}`,
     `.sfset-error{font-size:12px;line-height:1.5;color:var(--dsw-alias-label-error)}`,
+    `.sfset-check{width:16px;height:16px;accent-color:var(--dsw-alias-label-primary);cursor:pointer}`,
     `.sfset-unavailable{font-size:13px;line-height:1.5;color:var(--dsw-alias-state-warn-primary)}`,
   ].join('\n')
 
@@ -358,6 +386,13 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
   // 这样 top 栏（flex:none + sticky）天然固定，不会随内容滚出视口。
   const STYLE = [
     `[data-pane=conversation]{position:relative}`,
+    `[class*=centerCol]{position:relative}`,
+    `.sf-rail-conclusion{margin-top:8px;padding-top:8px;border-top:1px solid var(--dsw-alias-border-l2,rgba(128,128,128,.25));font-size:12px;line-height:1.5;color:var(--dsw-alias-label-primary,#222)}`,
+    `.sf-turnMeta{display:flex;flex-wrap:wrap;gap:3px 10px;font-size:11px;font-weight:600;color:var(--dsw-alias-label-secondary,#555)}`,
+    `.sf-turnMetaChip{display:inline-flex;align-items:center;gap:3px}`,
+    `.sf-turnMetaChip.err{color:var(--dsw-alias-label-error,#d43b3b)}`,
+    `.sf-ico{display:inline-flex}`,
+    `.sf-rail-conclusionTools{margin-top:3px;font-size:11px;color:var(--dsw-alias-label-tertiary,#999);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}`,
     `${VIEW_SELECTOR}{z-index:60;background:var(--dsw-alias-bg-base,#fff);display:none!important;position:absolute;inset:0;overflow:hidden}`,
     `html[${ACTIVE_ATTR}]:not([data-dsh-taskboard-active]):not([data-dsh-ssh-active]) ${VIEW_SELECTOR}{display:block!important}`,
     `html[${ACTIVE_ATTR}]:not([data-dsh-taskboard-active]):not([data-dsh-ssh-active]) [data-pane=conversation]>:not(${VIEW_SELECTOR}),html[${ACTIVE_ATTR}]:not([data-dsh-taskboard-active]):not([data-dsh-ssh-active]) [class*=centerCol]>:not(${VIEW_SELECTOR}){display:none!important}`,
@@ -438,6 +473,9 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     `.sf-healthChip.hc-wait .sf-hcLabel{color:#a87b00}`,
     `.sf-healthChip.hc-stall .sf-hcBar{background:#d43b3b;animation:sfBadgePulse 2.8s ease-in-out infinite}`,
     `.sf-healthChip.hc-stall .sf-hcLabel{color:#d43b3b}`,
+    `.sf-healthChip.hc-idle .sf-hcBar{background:var(--dsw-alias-label-tertiary,#b8bcc4);opacity:.55}`,
+    `.sf-healthChip.hc-idle .sf-hcLabel{color:var(--dsw-alias-label-tertiary,#999)}`,
+    `.sf-healthChip.hc-idle:hover,.sf-healthChip.hc-idle:focus-visible{background:color-mix(in srgb,var(--dsw-alias-bg-base,#fff) 72%,rgba(128,128,128,.12));border-color:color-mix(in srgb,var(--dsw-alias-border-l2,#e4e6eb) 60%,#9aa0a8)}`,
     `.sf-statsRow{display:flex;gap:12px;flex-wrap:wrap;margin-top:3px}`,
     `.sf-hint{color:var(--dsw-alias-label-secondary,#888);font-size:12px;padding:2px 2px 0}`,
     // ── 工作区筛选 tabs（独立一行，醒目）──
@@ -703,6 +741,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     `.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}`,
+    `.pk-detailMeta{flex:none;margin:3px 0 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)}}`,
@@ -875,6 +914,79 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
   }
   const canOfficialRename = (conn) =>
     conn !== undefined && conn.api !== undefined && conn.api.sessions !== undefined && typeof conn.api.sessions.rename === 'function'
+  // ── v0.1.2 兼容（三）：session RPC 双面适配器 ─────────────────────
+  // 新面：ctx.remote.session.*（inject 需声明 remote/remote.session，否则代理抛
+  // 「cannot get property remote.session without inject」）；信封顶层 {ok,value}；
+  // history 改名 page({address, maxMessages,...}) → {records, hasMore}；rename/list
+  // 仍在。旧面：connection.api.sessions.*（{result:{ok,value}}；subagents.history）。
+  // apply 时探测（ctx.get('remote') 旧宿主抛错 → 回退旧面）。
+  const sfRemoteRef = { current: null }
+  const sfBuildRemote = (ctx, connection) => {
+    try {
+      const remote = ctx && typeof ctx.get === 'function' ? ctx.get('remote') : null
+      const sess = remote && remote.session
+      if (sess && typeof sess.page === 'function') {
+        // 宿主硬校验：throughSeq > 日志 cursor 直接 gateway/bad-request——不存在
+        // 「取最新」的大数哨兵。cursor 来源 = list items[].projections.asOfSeq
+        //（投影截至 seq，恒 ≤ 真实日志 cursor，安全）。2s TTL 缓存防探测并发打爆 list。
+        let listCache = null
+        const cursorOf = async (sessionId) => {
+          const now = Date.now()
+          if (listCache === null || now - listCache.at > 2000) {
+            const r = await sess.list({})
+            listCache = { at: now, items: r && r.ok && r.value && Array.isArray(r.value.items) ? r.value.items : [] }
+          }
+          const it = listCache.items.find((x) => x.sessionId === sessionId)
+          return it && it.projections && typeof it.projections.asOfSeq === 'number' ? it.projections.asOfSeq : -1
+        }
+        return {
+          kind: 'remote',
+          async pageBySession(sessionId, maxMessages) {
+            const throughSeq = await cursorOf(sessionId)
+            if (throughSeq < 0) return undefined
+            const r = await sess.page({ address: { kind: 'session', sessionId }, throughSeq, maxMessages })
+            return r && r.ok ? r.value : undefined
+          },
+          async pageBySub(parentSessionId, childSessionId, mode, maxMessages) {
+            const throughSeq = await cursorOf(childSessionId)
+            if (throughSeq < 0) return undefined
+            const r = await sess.page({ address: { kind: 'subagent', parentSessionId, childSessionId, mode }, throughSeq, maxMessages })
+            return r && r.ok ? r.value : undefined
+          },
+          async listSessions() { if (typeof sess.list !== 'function') return undefined; const r = await sess.list({}); return r && r.ok ? r.value : undefined },
+          canRename: typeof sess.rename === 'function',
+          async rename(sessionId, title) { const r = await sess.rename({ sessionId, title }); return r && r.ok && r.value && typeof r.value.title === 'string' ? r.value.title : undefined },
+        }
+      }
+    } catch (e) {}
+    if (connection && connection.api && connection.api.sessions && typeof connection.api.sessions.history === 'function') {
+      const envVal = (r) => (r && r.result && r.result.ok ? r.result.value : (r && r.ok ? r.value : undefined))
+      return {
+        kind: 'legacy',
+        async pageBySession(sessionId, maxMessages) { return envVal(await connection.api.sessions.history({ sessionId, maxMessages })) },
+        async pageBySub(parentSessionId, childSessionId, mode, maxMessages) { return envVal(await connection.api.subagents.history({ parentSessionId, childSessionId, mode, maxMessages })) },
+        async listSessions() { return envVal(await connection.api.sessions.list({})) },
+        canRename: canOfficialRename(connection),
+        async rename(sessionId, title) { const t = await renameViaOfficial(connection, sessionId, title).catch(() => undefined); return t },
+      }
+    }
+    return null
+  }
+  // v0.1.2 兼容（一）：sessions.history 返回值从 {events} 改为 {records, hasMore}
+  //（记录 = {type:'event', event} 或 chunk 行 {type:'chunks', event:{type:'chunkrow/…'}}）。
+  // 旧版 {events} 每项亦可能包 {event}。统一解析为事件数组；丢弃 chunkrow 合成
+  // 事件（derive 只认真实事件类型，混入会污染分类）。全部 6 个消费点共用。
+  const historyEventsOf = (val) => {
+    if (!val) return []
+    const list = Array.isArray(val.events) ? val.events : (Array.isArray(val.records) ? val.records : [])
+    const out = []
+    for (const r of list) {
+      const e = (r && r.event) || r
+      if (!e || typeof e.type !== 'string' || e.type.startsWith('chunkrow/')) continue
+      out.push(e)
+    }
+    return out
+  }
   /** 静默时长文本（{N} 占位）。 */
   const fmtSilent = (idleMs) => {
     if (idleMs === null || idleMs === undefined) return ''
@@ -883,6 +995,16 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       ? STR.healthSilentMin.replace('{N}', String(min))
       : STR.healthSilentSec.replace('{N}', String(Math.max(1, Math.round(idleMs / 1000))))
   }
+  /** 相对时间文本（空闲胶囊「N 分钟前」；分钟粒度足够，不追秒级新鲜度）。 */
+  const fmtAgo = (ms) => {
+    if (!ms || ms < 0) return ''
+    const min = Math.floor(ms / 60000)
+    if (min < 1) return STR.agoJustNow
+    if (min < 60) return STR.agoMin.replace('{N}', String(min))
+    const h = Math.floor(min / 60)
+    if (h < 24) return STR.agoHour.replace('{N}', String(h))
+    return STR.agoDay.replace('{N}', String(Math.floor(h / 24)))
+  }
   /** 健康徽标（详情实时条 / 总览卡片共用）；active/ended/unknown 不渲染（已有进行中/已结束徽标）。 */
   const healthBadge = (health) => {
     if (!health) return null
@@ -893,24 +1015,41 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     return null
   }
 
-  // ── 会话页头部健康芯片（官方 conversation.session.header.actions 槽位）──
+  // ── 会话页头部健康胶囊（官方 conversation.session.header.actions 槽位）──
   // 位置：官方模式标识（agent-preset label, order -10）右侧（order -9）。
-  // 数据：sessions.list 快照跟踪 running（官方真实状态，随 host 流即时翻转）→
-  // running 时 10s 轮询 tail history → host derive 健康分类（与总览探测同管线）。
+  // 常驻四态（用户需求 2026-09-05：非运行也展示）：
+  //   空闲（灰条 +「N 分钟前」相对时间，零 RPC，来自 byId.updatedAt）
+  //   运行·活跃（绿）/ 运行·工具执行中·静默中（黄）/ 运行·疑似卡死（红，脉冲）
+  //   —— 运行时 10s 轮询 tail history → host derive 健康分类；probe 未返回前
+  //   乐观显示「活跃」（避免胶囊闪烁）。空白新会话不显示。
   // 点击：唤起会话流工作台并直达该会话详情（workbenchBridge 意图桥）。
+  // 槽位 props 兜底：v0.1.2 若 sessionId 标准 prop 管道变化，退回 sessions.list
+  // 快照的 current（头部胶囊面对的就是当前会话）。
+  const currentSessionIdOf = (sessions) => {
+    try {
+      const snap = sessions && sessions.list && typeof sessions.list.getSnapshot === 'function' ? sessions.list.getSnapshot() : null
+      return snap && snap.current ? snap.current : undefined
+    } catch (e) { return undefined }
+  }
+  // 【临时诊断】chipDbg 已于 v1.3.0 验收后撤除；probe error 静默（与总览探测同口径）。
   function SessionHealthChip(props) {
-    const { sessionId, connection, sessions } = props
+    const { connection, sessions } = props
+    const sid = props.sessionId || currentSessionIdOf(sessions)
+    const sessionId = sid
     const [running, setRunning] = useState(false)
+    const [meta, setMeta] = useState({ updatedAt: 0, blank: false })
     const [health, setHealth] = useState(null)
     useEffect(() => {
       if (!sessionId || !sessions || !sessions.list || typeof sessions.list.getSnapshot !== 'function') return undefined
       const compute = () => {
         try {
-          // sessions.list 快照 = { ids, current, byId }（byId[id] 含 running）——
-          // 不是 { items }（那是 workspace 浏览器用的另一个视图快照，曾误用导致芯片恒 null）。
+          // sessions.list 快照 = { ids, current, byId }（byId[id] 含 running/updatedAt/blank）。
           const snap = sessions.list.getSnapshot()
           const it = snap && snap.byId ? snap.byId[sessionId] : undefined
           setRunning(it ? it.running === true : false)
+          const u = it && typeof it.updatedAt === 'number' ? it.updatedAt : 0
+          const b = it ? it.blank === true : false
+          setMeta((prev) => (prev.updatedAt === u && prev.blank === b ? prev : { updatedAt: u, blank: b }))
         } catch (e) { setRunning(false) }
       }
       compute()
@@ -918,13 +1057,12 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       return undefined
     }, [sessions, sessionId])
     useEffect(() => {
-      if (!running || !sessionId || !canOfficialRename(connection)) { setHealth(null); return undefined }
+      if (!running || !sessionId || !sfRemoteRef.current) { setHealth(null); return undefined }
       let alive = true
       const probe = async () => {
         try {
-          const hr = await connection.api.sessions.history({ sessionId, maxMessages: 3 })
-          const val = hr && hr.result && hr.result.value
-          const events = val && Array.isArray(val.events) ? val.events.map((e) => (e && e.event) || e) : []
+          const val = await sfRemoteRef.current.pageBySession(sessionId, 3)
+          const events = historyEventsOf(val)
           if (events.length === 0) { if (alive) setHealth(null); return }
           const d = await api('derive', { events, now: Date.now(), assumeRunning: true })
           if (alive && d && d.ok) setHealth(d.health || null)
@@ -934,22 +1072,61 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       const iv = setInterval(probe, 10000)
       return () => { alive = false; clearInterval(iv) }
     }, [running, sessionId, connection])
-    if (!running || !health) return null
-    const kind = health.kind
-    const silent = fmtSilent(health.idleMs)
-    // 收拢态胶囊条颜色语义：绿=活跃 / 黄=工具执行中·静默中 / 红=疑似卡死（脉冲）。
-    let text = STR.healthActive, cls = 'hc-active'
-    if (kind === 'tool-wait') { text = STR.healthToolWait; cls = 'hc-wait' }
-    else if (kind === 'quiet') { text = STR.healthQuiet; cls = 'hc-wait' }
-    else if (kind === 'stalled') { text = STR.healthStalled; cls = 'hc-stall' }
-    else if (kind !== 'active') return null // ended/unknown 不显示
+    // 空闲态每 30s 轻 tick 一次，驱动「N 分钟前」相对时间保鲜。
+    const [, setTick] = useState(0)
+    useEffect(() => {
+      if (running) return undefined
+      const iv = setInterval(() => setTick((n) => n + 1), 30000)
+      return () => clearInterval(iv)
+    }, [running])
+    // 空闲计时基准 = 最后一条事件的 time（= 会话结束时刻）。byId.updatedAt 是
+    // 「列表投影上次变化」时间戳——运行中投影值不变就停在上次用户消息，语义不对
+    //（用户实测裁定）。空闲期间该时刻不再变化 → 会话切入空闲时拉一次即可。
+    const [idleSince, setIdleSince] = useState(0)
+    useEffect(() => {
+      if (running || !sessionId || !sfRemoteRef.current) { setIdleSince(0); return undefined }
+      let alive = true
+      ;(async () => {
+        try {
+          const val = await sfRemoteRef.current.pageBySession(sessionId, 3)
+          const events = historyEventsOf(val)
+          const last = events.length > 0 ? events[events.length - 1] : null
+          const t = last && typeof last.time === 'number' ? last.time : 0
+          if (alive) setIdleSince(t)
+        } catch (e) { if (alive) setIdleSince(0) }
+      })()
+      return () => { alive = false }
+    }, [running, sessionId])
+    if (!sessionId) return null
+    // 空闲常驻态：灰条 + 「距最后事件」相对时间。空白新会话不显示（避免噪音）。
+    if (!running) {
+      if (meta.blank) return null
+      const ago = idleSince > 0 ? fmtAgo(Date.now() - idleSince) : ''
+      return h('button', {
+        className: 'sf-healthChip hc-idle',
+        title: STR.healthChipTitle,
+        onClick: (e) => { e.stopPropagation(); if (props.onOpen) props.onOpen() },
+      },
+        h('span', { className: 'sf-hcBar' }),
+        h('span', { className: 'sf-hcLabel' }, STR.healthIdle + (ago ? ' · ' + ago : '')),
+      )
+    }
+    // 运行态：probe 未返回前乐观显示「活跃」（防闪烁）；derive ended/unknown 亦按活跃渲染。
+    let text = STR.healthActive, cls = 'hc-active', silent = ''
+    if (health) {
+      const kind = health.kind
+      silent = fmtSilent(health.idleMs)
+      if (kind === 'tool-wait') { text = STR.healthToolWait; cls = 'hc-wait' }
+      else if (kind === 'quiet') { text = STR.healthQuiet; cls = 'hc-wait' }
+      else if (kind === 'stalled') { text = STR.healthStalled; cls = 'hc-stall' }
+    }
     return h('button', {
       className: 'sf-healthChip ' + cls,
       title: STR.healthChipTitle,
       onClick: (e) => { e.stopPropagation(); if (props.onOpen) props.onOpen() },
     },
       h('span', { className: 'sf-hcBar' }),
-      h('span', { className: 'sf-hcLabel' }, text + (silent && kind !== 'active' ? ' · ' + silent : '')),
+      h('span', { className: 'sf-hcLabel' }, text + (silent && cls !== 'hc-active' ? ' · ' + silent : '')),
     )
   }
 
@@ -1015,8 +1192,9 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         const target = all.find((x) => x.id === sid)
         if (target && target.titleSource === 'user') return Promise.reject(new Error(STR.renameClearBlocked))
       }
-      if (trimmed !== '' && canOfficialRename(conn)) {
-        return renameViaOfficial(conn, sid, trimmed)
+      if (trimmed !== '' && sfRemoteRef.current && sfRemoteRef.current.canRename) {
+        return sfRemoteRef.current.rename(sid, trimmed)
+          .then((accepted) => { if (typeof accepted !== 'string') throw new Error(STR.renameFail); return accepted })
           .then((accepted) => applyLocal(accepted))
           .catch(() => legacy())
       }
@@ -1028,16 +1206,15 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     const [healthMap, setHealthMap] = useState({})
     const [liveRunning, setLiveRunning] = useState(null) // null=未探测；Set<sessionId>
     useEffect(() => {
-      const conn = props.connection
-      if (!canOfficialRename(conn) || state.phase !== 'ready') return undefined
+      if (!sfRemoteRef.current || state.phase !== 'ready') return undefined
       let alive = true
       let probing = false
       const probe = async () => {
         if (probing) return
         probing = true
         try {
-          const resp = await conn.api.sessions.list({})
-          const items = (resp && resp.result && resp.result.value && resp.result.value.items) || []
+          const val = await sfRemoteRef.current.listSessions()
+          const items = (val && val.items) || []
           const runningIds = items.filter((i) => i.running === true).map((i) => i.sessionId)
           if (!alive) return
           setLiveRunning(new Set(runningIds))
@@ -1045,9 +1222,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           for (let i = 0; i < Math.min(runningIds.length, 8); i += 3) {
             await Promise.all(runningIds.slice(i, i + 3).map(async (sid) => {
               try {
-                const hr = await conn.api.sessions.history({ sessionId: sid, maxMessages: 3 })
-                const val = hr && hr.result && hr.result.value
-                const events = val && Array.isArray(val.events) ? val.events.map((e) => (e && e.event) || e) : []
+                const events = historyEventsOf(await sfRemoteRef.current.pageBySession(sid, 3))
                 if (events.length === 0) return
                 const d = await api('derive', { events, now: Date.now(), assumeRunning: true })
                 if (d && d.ok && d.health) next[sid] = d.health
@@ -1223,6 +1398,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         if (sort === 'oldest') return r.createdAt || 0
         if (sort === 'tools') return r.toolCalls || 0
         if (sort === 'longest') return (r.lastEventTime || 0) - (r.createdAt || 0)
+        if (sort === 'size') return r.sizeBytes || 0
         return 0
       }
       const ascending = sort === 'oldest'
@@ -1235,17 +1411,19 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       const toolAgg = new Map()
       let issues = 0
       let roots = 0
+      let totalSize = 0
       for (const g of (state.data && state.data.workspaces) || []) {
         if (wsFilter !== '' && wsFilter !== g.name) continue // 统计范围 = 当前选中的工作区
         for (const s of g.sessions) {
           if (s.parentSession) continue
           roots++
           if (s.toolErrors > 0) issues++
+          totalSize += s.sizeBytes || 0
           for (const n of s.toolNames || []) toolAgg.set(n, (toolAgg.get(n) || 0) + 1)
         }
       }
       const topTools = [...toolAgg.entries()].sort((a, b) => b[1] - a[1]).slice(0, 6)
-      return { topTools, issues, roots }
+      return { topTools, issues, roots, totalSize }
     }, [state.data, wsFilter])
 
     const wsNames = ((state.data && state.data.workspaces) || []).map((g) => g.name)
@@ -1270,6 +1448,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           h('option', { value: 'oldest' }, STR.sortOldest),
           h('option', { value: 'tools' }, STR.sortTools),
           h('option', { value: 'longest' }, STR.sortLongest),
+          h('option', { value: 'size' }, STR.sortSize),
         ),
         h('label', { className: 'sf-muted', style: { display: 'inline-flex', alignItems: 'center', gap: 4, cursor: 'pointer', whiteSpace: 'nowrap' } },
           h('input', { type: 'checkbox', checked: showEmpty, onChange: (e) => setShowEmpty(e.target.checked) }),
@@ -1356,6 +1535,10 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           h('span', {}, '⚠ ' + STR.issues),
           h('span', { className: 'sf-statCount err' }, stats.issues),
         ),
+        h('span', { className: 'sf-statChip', title: STR.storageHint },
+          h('span', {}, STR.storage),
+          h('span', { className: 'sf-statCount' }, fmtSize(stats.totalSize)),
+        ),
       ),
       state.phase === 'loading' && h('div', { className: 'sf-hint' }, STR.scanning),
       state.phase === 'error' && h('div', { className: 'sf-hint', style: { color: '#d43b3b' } }, STR.loadFailed + ': ' + String(state.error)),
@@ -1721,16 +1904,12 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         }
       } catch (e) {}
       // 2) 运行时 history 桥接（在线子代理）→ host derive 得 light 结构
-      if (connection !== undefined && node.parentId !== undefined) {
+      if (node.parentId !== undefined && sfRemoteRef.current) {
         try {
-          const resp = await connection.api.subagents.history({
-            parentSessionId: node.parentId,
-            childSessionId: node.id,
-            mode: node.mode,
-            maxMessages: 120,
-          })
-          if (resp && resp.result && resp.result.ok && resp.result.value && Array.isArray(resp.result.value.events)) {
-            const events = resp.result.value.events.map((entry) => entry.event)
+          const subVal = await sfRemoteRef.current.pageBySub(node.parentId, node.id, node.mode, 120)
+          const subEvents = historyEventsOf(subVal)
+          if (subEvents.length > 0) {
+            const events = subEvents
             const derived = await api('derive', { events })
             if (derived && derived.ok) {
               // derive 返回完整 timeline——转成 light 结构
@@ -1848,8 +2027,9 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       })
       const trimmed = String(title || '').trim()
       if (trimmed === '' && session.titleSource === 'user') return Promise.reject(new Error(STR.renameClearBlocked))
-      if (trimmed !== '' && canOfficialRename(conn)) {
-        return renameViaOfficial(conn, session.id, trimmed)
+      if (trimmed !== '' && sfRemoteRef.current && sfRemoteRef.current.canRename) {
+        return sfRemoteRef.current.rename(session.id, trimmed)
+          .then((accepted) => { if (typeof accepted !== 'string') throw new Error(STR.renameFail); return accepted })
           .then((accepted) => { setTitleOverride(accepted); setRenaming(false); return true })
           .catch(() => legacy())
       }
@@ -1990,18 +2170,13 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       }
       setLiveState((s) => ({ ...s, phase: 'loading' }))
       try {
-        // 会话地址未知时走普通 sessions 通道（当前会话）；若连接层要求显式地址则回退。
-        const resp = await conn.api.sessions.history({
-          sessionId: session.id,
-          mode: 'full',
-          maxMessages: 400,
-        })
-        const val = resp && resp.result && resp.result.value
-        if (val === undefined || !Array.isArray(val.events)) {
+        // v0.1.2：session RPC 经双面适配器（remote.session.page / 旧 history）。
+        const val = sfRemoteRef.current ? await sfRemoteRef.current.pageBySession(session.id, 400) : undefined
+        if (val === undefined) {
           setLiveState((s) => ({ ...s, phase: 'error', error: STR.liveFail }))
           return
         }
-        const events = val.events.map((entry) => (entry && entry.event) || entry)
+        const events = historyEventsOf(val)
         const derived = await api('derive', { events, now: Date.now() })
         if (!derived || !derived.ok) {
           setLiveState((s) => ({ ...s, phase: 'error', error: (derived && derived.error) || STR.liveFail }))
@@ -2638,19 +2813,18 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
 
     const fetchLive = useRef(async () => {})
     fetchLive.current = async () => {
-      if (connection === undefined || connection.api === undefined || connection.api.sessions === undefined) {
+      if (!sfRemoteRef.current) {
         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)) {
+        const val = await sfRemoteRef.current.pageBySession(sessionId, 400)
+        if (val === undefined) {
           setState((s) => ({ ...s, phase: 'error', error: STR.liveFail }))
           return
         }
-        const events = val.events.map((entry) => (entry && entry.event) || entry)
+        const events = historyEventsOf(val)
         const derived = await api('derive', { events, now: Date.now() })
         if (!derived || !derived.ok) {
           setState((s) => ({ ...s, phase: 'error', error: (derived && derived.error) || STR.liveFail }))
@@ -2741,6 +2915,33 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       })()
       return () => ac.abort()
     }, [props.connection])
+    // v0.1.2 起 events.mux 消费面移除 → 改用 sessions.list 订阅：官方 rename 后
+    // 列表行 byId[sessionId].title 由 title projection 即时更新（新控制器
+    // dsh-api-session-controller rename 后 projections.apply('title') 即落列表），
+    // 订阅回调秒级收集全量标题快照，浅比较防抖。与 mux 路径并存（旧版 dsh 仍走 mux）。
+    useEffect(() => {
+      const svc = props.sessions
+      const list = svc && svc.list
+      if (!list || typeof list.getSnapshot !== 'function' || typeof list.subscribe !== 'function') return undefined
+      const collect = () => {
+        const snap = list.getSnapshot()
+        const byId = snap && snap.byId
+        if (!byId) return
+        const map = {}
+        for (const id of Object.keys(byId)) {
+          const t = byId[id] && byId[id].title
+          if (typeof t === 'string' && t !== '') map[id] = t
+        }
+        setLiveTitles((prev) => {
+          const pk = Object.keys(prev)
+          const nk = Object.keys(map)
+          if (pk.length === nk.length && nk.every((k) => prev[k] === map[k])) return prev
+          return map
+        })
+      }
+      collect()
+      return list.subscribe(collect)
+    }, [props.sessions])
 
     return detail === null
       ? h(SessionFlowOverview, {
@@ -2826,17 +3027,74 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     return undefined
   }
 
+  // ── 共享：纯色矢量图标 + 轮次 meta chips（rail 增强层与钢琴键详情框共用）──
+  // stroke=currentColor 随主题取色；不用 emoji（用户裁定 2026-09-05）。
+  const SF_ICON_PATHS = {
+    clock: '<circle cx="8" cy="8" r="6.3"/><path d="M8 4.6V8l2.4 1.5"/>',
+    tool: '<rect x="2.4" y="3" width="11.2" height="10" rx="1.6"/><path d="M5 7l2.2 2L5 11M8.6 11h2.6"/>',
+    alert: '<circle cx="8" cy="8" r="6.3"/><path d="M8 5.2v3.2M8 11.2h.01"/>',
+    think: '<path d="M8 2.2a4 4 0 0 0-4 4c0 1.7.9 2.7 1.6 3.5.3.4.4 1.3.4 1.3h4s.1-.9.4-1.3c.7-.8 1.6-1.8 1.6-3.5a4 4 0 0 0-4-4z"/><path d="M6.4 13.6h3.2"/>',
+  }
+  const sfIcon = (name) => {
+    const span = document.createElement('span')
+    span.className = 'sf-ico'
+    span.innerHTML = '<svg viewBox="0 0 16 16" width="11" height="11" fill="none" stroke="currentColor" stroke-width="1.6" stroke-linecap="round" stroke-linejoin="round">' + SF_ICON_PATHS[name] + '</svg>'
+    return span
+  }
+  // 时长格式化（ms → 42s / 2m 14s；与 host 导出 fmtDur 同风格）。
+  const sfFmtDur = (ms) => {
+    if (!ms || ms <= 0) return ''
+    const s = Math.round(ms / 1000)
+    if (s < 60) return s + 's'
+    const m = Math.floor(s / 60)
+    return s % 60 === 0 ? m + 'm' : m + 'm ' + (s % 60) + 's'
+  }
+  // meta chips：耗时 / 工具调用 / 错误（红）/ 思考标记。无任何信息时返回 null。
+  const buildTurnMeta = (entry) => {
+    const meta = document.createElement('div')
+    meta.className = 'sf-turnMeta'
+    const chip = (icon, text, cls) => {
+      const c = document.createElement('span')
+      c.className = 'sf-turnMetaChip' + (cls ? ' ' + cls : '')
+      c.appendChild(sfIcon(icon))
+      const t = document.createElement('span')
+      t.textContent = text
+      c.appendChild(t)
+      meta.appendChild(c)
+    }
+    if (entry.durMs > 0) chip('clock', sfFmtDur(entry.durMs))
+    if (entry.tools > 0) chip('tool', STR.railMetaCalls.replace('{tools}', String(entry.tools)))
+    if (entry.errors > 0) chip('alert', STR.railMetaErrors.replace('{errors}', String(entry.errors)), 'err')
+    if (entry.thinking) chip('think', STR.railThinking)
+    return meta.childNodes.length > 0 ? meta : null
+  }
+  // lightTurn → 共享字段（tools/errors/durMs/thinking/conclusion）。
+  const ltMeta = (lt) => ({
+    tools: lt.toolCount || 0,
+    errors: lt.errorCount || 0,
+    durMs: (typeof lt.startTime === 'number' && typeof lt.endTime === 'number' && lt.endTime > lt.startTime) ? lt.endTime - lt.startTime : 0,
+    thinking: lt.hasThinking === true,
+  })
+  // getTurn → 工具分布文本（top4：pwsh ×6 · edit ×3）；共享给 rail 与钢琴键。
+  const toolDistOf = (turn) => {
+    const counts = new Map()
+    for (const st of (turn && turn.steps) || []) for (const c of st.toolCalls || []) counts.set(c.name, (counts.get(c.name) || 0) + 1)
+    return [...counts.entries()].sort((a, b) => b[1] - a[1]).slice(0, 4).map(([n, c]) => n + ' ×' + c).join(' · ')
+  }
+
   // ── M11：本会话轮次导航（会话页左侧常驻悬浮条目条，v3）──────────
   // 范围：只显示【当前会话】的对话轮次（用户消息），不跨会话/不跨工作区。
-  // 数据：官方消息行锚点 DOM 驱动（data-time-hover-root，dsh-navbar 同款机制，
-  // 零 RPC 实时）：用户行 = 无 data-turn-tail + 含 [class*=bubble]。
+  // 数据：官方消息行锚点 DOM 驱动（v0.1.2 起 [data-chat-flow] [data-chat-flow-kind=user]，
+  // 旧版回退 data-time-hover-root；零 RPC 实时）。
   // 轮次 → 结论预览：按顺序索引映射 host get 的 lightTurns（用户消息摊平）。
   // 交互：点击滚动定位该轮、active 跟随视口第一条、窗口裁剪 + 滚轮/▲▼、
   // 键盘 ↑↓/Enter、hover 预览卡（该轮用户消息 + 结论）、右键唤起会话流工作台。
   // 样式：DeepSeek 网页版右侧悬浮消息导航风格（圆角卡片 + 单行截断文字），移到左侧。
   function TurnKeys(props) {
     const { sessions, onOpenWorkbench } = props
-    const [entries, setEntries] = useState([]) // [{turn, seq, preview}] host 全量用户轮次
+    const [entries, setEntries] = useState([]) // [{turn, seq, preview, tools, errors, durMs, thinking}] host 全量用户轮次
+    const distCache = useRef(new Map()) // turn → 工具分布文本（getTurn 懒加载缓存）
+    const [, setDistTick] = useState(0) // distCache 到位后触发详情框重渲染
     const [activeIdx, setActiveIdx] = useState(-1)
     // T5 平滑滚动：连续滚动位置（浮点，单位=行）。替代原整数 winOffset 的「每格硬跳
     // 1 条」——滚轮增量累积（deltaMode 归一）+ 列表 transform 百分比位移（transition
@@ -2918,7 +3176,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           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 })
+              flat.push({ turn: lt.turn, seq: u.seq, preview: u.preview, ...ltMeta(lt) })
             }
           }
           // 防御：同一 seq 只保留一条（避免同一条消息重复渲染 = 「最后一条显示两次」）。
@@ -2962,10 +3220,18 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       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)
+    // DOM 行工具：用户消息行锚点。v0.1.2 起官方会话流重构进 dsh-client-ui-chat：
+    // data-time-hover-root 移除，行结构 = [data-chat-flow] > [data-chat-flow-key]
+    // （data-chat-flow-kind 区分 user/steering/turn-process/…，官方内部查行同款
+    // 选择器）；旧版 dsh 回退 data-time-hover-root 锚点（dsh-navbar 同款机制）。
+    // 零 RPC 实时。steering（随转消息）不算新轮次，不计入。
+    const domRows = () => {
+      const next = document.querySelectorAll('[data-chat-flow] [data-chat-flow-kind="user"]')
+      if (next.length > 0) return [...next]
+      return [...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() : ''
@@ -3010,16 +3276,74 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       return null
     }
 
+    // 未加载轮次 → 委托官方轮次导航引擎（v0.1.2+ 吸收官方独有能力）：合成 click
+    // 命中目标刻度，官方 navigate 自动加载未载入页并跳转（其引擎含 busy 态/加载锚定，
+    // 优于我们的「只提示」）。合成事件 clientY 按官方 itemAtPointer 几何反解
+    // （offset = clientY - rect.top + scrollTop - 6 = idx*10）；官方处理挂在 nav 的
+    // onClick 且只读 event.clientY，与事件落在哪个子元素无关（刻度按钮
+    // pointer-events:none，不能直接 btn.click()——clientY=0 会误算成第一条）。
+    const delegateToRail = (entry) => {
+      try {
+        const nav = document.querySelector(RAIL_SELECTOR)
+        if (!nav) return false
+        const turns = [...nav.querySelectorAll('button[aria-label]')]
+          .map((b) => { const m = /(\d+)/.exec(b.getAttribute('aria-label') || ''); return m ? Number(m[1]) : null })
+        const idx = turns.indexOf(entry.turn)
+        if (idx < 0) return false
+        const rect = nav.getBoundingClientRect()
+        const scroller = nav.firstElementChild
+        const st = scroller ? scroller.scrollTop : 0
+        const y = rect.top + (idx * 10 + 6) - st
+        nav.dispatchEvent(new MouseEvent('click', { bubbles: true, clientX: rect.left + 10, clientY: y }))
+        return true
+      } catch (e) { return false }
+    }
     // 点击定位：先查该轮次是否已加载（DOM 中能否匹配到对应行）——
-    // 已加载 → 平滑滚动定位；未加载 → 只提示、不跳转（自动加载循环会让消息流
-    // 乱滚/跳错位置，实测踩坑；用户需先在会话区向上滚动加载历史再点击）。
+    // 已加载 → 平滑滚动定位；未加载 → 委托官方 rail 引擎加载跳转（v0.1.2+）；
+    // rail 缺席（旧版 dsh）→ 只提示、不跳转（自动加载循环会让消息流乱滚/跳错
+    // 位置，实测踩坑；用户需先在会话区向上滚动加载历史再点击）。
     const open = (entry) => {
       const row = findRow(entry)
       if (row) { row.scrollIntoView({ behavior: 'smooth', block: 'start' }); return }
+      if (delegateToRail(entry)) return
       setJumpFail(true)
       setTimeout(() => setJumpFail(false), 2600)
     }
 
+    // 详情框 meta 注入（与 rail 增强层同款信息：矢量 chips + 工具分布行；
+    // imperative ref 填充，data-sig 幂等）。工具分布懒加载：详情驻留 200ms 拉
+    // getTurn 聚合（distCache 跨 hover 缓存，到位后 tick 触发 ref 重填）。
+    const fillDetailMeta = (el, entry) => {
+      if (!el) return
+      const dist = distCache.current.get(entry.turn) || ''
+      const sig = entry.turn + '|' + dist
+      if (el.dataset.sig === sig) return
+      el.dataset.sig = sig
+      el.replaceChildren()
+      const meta = buildTurnMeta(entry)
+      if (meta) el.appendChild(meta)
+      if (dist !== '') {
+        const tools = document.createElement('div')
+        tools.className = 'sf-rail-conclusionTools'
+        tools.textContent = dist
+        el.appendChild(tools)
+      }
+    }
+    useEffect(() => {
+      if (detailIdx === null || !currentId) return undefined
+      const entry = entries[detailIdx]
+      if (!entry || entry.tools === 0 || distCache.current.has(entry.turn)) return undefined
+      const turn = entry.turn
+      const timer = setTimeout(() => {
+        api('getTurn', { sessionId: currentId, turn }).then((json) => {
+          if (!json || !json.ok || !json.turn) return
+          distCache.current.set(turn, toolDistOf(json.turn))
+          setDistTick((n) => n + 1)
+        }).catch(() => {})
+      }, 200)
+      return () => clearTimeout(timer)
+    }, [detailIdx, currentId, entries])
+
     // active：视口内最靠上的可见行 → 映射条目索引高亮（阅读位置跟随）。
     // 可见判定用 bottom 进入视口（含被顶部裁切一半的行）——此前 top>=0 会
     // 跳过被裁切行导致高亮偏晚一轮（T1 修复点二）。
@@ -3328,6 +3652,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       // 常驻渲染 + 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: 'm' + detailEntry.turn, className: 'pk-detailMeta', ref: (el) => fillDetailMeta(el, detailEntry) }),
         detailEntry && h('div', { key: 'b' + detailEntry.turn, className: 'pk-detailBody' }, detailEntry.preview || '（空）'),
       ),
       // 跳转状态提示：常驻渲染 + hidden 类（从下方淡入/淡出）；未加载轮次提示。
@@ -3380,14 +3705,13 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       }
       if (liveStore.emit !== null) liveStore.emit({ ...liveStateKeep(), phase: 'loading' })
       try {
-        const resp = await conn.api.sessions.history({ sessionId: sid, mode: 'full', maxMessages: 400 })
-        const val = resp && resp.result && resp.result.value
-        if (val === undefined || !Array.isArray(val.events)) {
+        const val = sfRemoteRef.current ? await sfRemoteRef.current.pageBySession(sid, 400) : undefined
+        if (val === undefined) {
           liveStore.lastState = { ...liveStateKeep(), phase: 'error', error: STR.liveFail }
           if (liveStore.emit !== null) liveStore.emit(liveStore.lastState)
           return
         }
-        const events = val.events.map((entry) => (entry && entry.event) || entry)
+        const events = historyEventsOf(val)
         const derived = await api('derive', { events, now: Date.now() })
         if (!derived || !derived.ok) {
           liveStore.lastState = { ...liveStateKeep(), phase: 'error', error: (derived && derived.error) || STR.liveFail }
@@ -3626,11 +3950,233 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     )
   }
 
+  // ── M11×v0.1.2：官方轮次导航（TurnNavigatorRail）增强层 ─────────────
+  // 官方 rail 无扩展槽位（chat 槽位仅 node/turnTail/assistant-actions/commandview），
+  // 本层走 DOM 观察（家族传统：观察器 + 自愈重挂），挂载我们的独有增量：
+  //   1) hover 结论段注入官方预览卡：该轮「结论摘要」（官方预览只有 prompt/response
+  //      片段）+ 工具统计（错误角标方案已撤——开发会话多数轮次都有工具错误，
+  //      刻度全员红点等于无信息，用户实机裁定 2026-09-05）；
+  //   2) 右键 rail → 唤起会话流工作台。
+  // 定位：nav[aria-label=轮次导航|Turn navigation]；几何换算复刻官方 itemAtPointer
+  // （TURN_SPACING 10px / RAIL_INSET 6px + scroller.scrollTop）；turn 号从刻度按钮
+  // aria-label（跳转到第 N 轮 / Jump to turn N）提取，索引↔turn 精确映射，不依赖
+  // 「index+1 == turn」假设。官方 navigate 引擎（含未载入轮次自动加载跳转）原样保留，
+  // 我们不拦截点击。
+  const RAIL_SELECTOR = 'nav[aria-label="轮次导航"], nav[aria-label="Turn navigation"]'
+  function RailEnhancer(props) {
+    const { sessions, railEl, onOpenWorkbench } = props
+    const [turnData, setTurnData] = useState([]) // [{turn, preview, conclusion, tools, errors}]
+    const [hoverInfo, setHoverInfo] = useState(null) // {turn, clientY, railLeft}
+    const [, force] = useState(0)
+
+    // 订阅会话列表变化：切换会话 → 重拉条目。
+    useEffect(() => {
+      if (sessions && sessions.list && typeof sessions.list.subscribe === 'function') {
+        return sessions.list.subscribe(() => force((n) => n + 1))
+      }
+      return undefined
+    }, [sessions])
+
+    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（每轮一条，对齐官方 rail item 粒度）。
+    // 轮询节奏同钢琴键：DOM 变化切 3s 高频，空闲 15s 兜底。
+    useEffect(() => {
+      if (!currentId) { setTurnData([]); return undefined }
+      let alive = true
+      const refresh = () => {
+        api('get', { sessionId: currentId }).then((json) => {
+          if (!alive || !json || !json.ok) return
+          const rows = (json.lightTurns || []).map((lt) => ({
+            turn: lt.turn,
+            preview: lt.userMessages && lt.userMessages[0] ? String(lt.userMessages[0].preview || '') : '',
+            conclusion: String(lt.conclusionPreview || ''),
+            tools: lt.toolCount || 0,
+            errors: lt.errorCount || 0,
+            durMs: (typeof lt.startTime === 'number' && typeof lt.endTime === 'number' && lt.endTime > lt.startTime) ? lt.endTime - lt.startTime : 0,
+            thinking: lt.hasThinking === true,
+          }))
+          setTurnData((prev) => {
+            if (prev.length === rows.length && prev.length > 0 && prev[prev.length - 1].turn === rows[rows.length - 1].turn) return prev
+            return rows
+          })
+        }).catch(() => {})
+      }
+      const ACTIVE_MS = 3000
+      const IDLE_MS = 15000
+      let iv = null
+      const schedule = (delay) => { if (iv) clearInterval(iv); iv = setInterval(refresh, delay) }
+      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-chat-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])
+
+    // rail 交互：hover 几何换算 + 右键唤起工作台。
+    useEffect(() => {
+      if (!railEl) { setHoverInfo(null); return undefined }
+      const scroller = railEl.firstElementChild // 官方结构：nav.frame > div.scroller
+      const railTurns = () => [...railEl.querySelectorAll('button[aria-label]')]
+        .map((b) => { const m = /(\d+)/.exec(b.getAttribute('aria-label') || ''); return m ? Number(m[1]) : null })
+        .filter((n) => n !== null)
+      const onMove = (e) => {
+        const rect = railEl.getBoundingClientRect()
+        const st = scroller ? scroller.scrollTop : 0
+        const idx = Math.max(0, Math.round((e.clientY - rect.top + st - 6) / 10))
+        const turns = railTurns()
+        const turn = idx < turns.length ? turns[idx] : null
+        setHoverInfo((prev) => {
+          const prevTurn = prev === null ? null : prev.turn
+          return prevTurn === turn ? prev : (turn === null ? null : { turn })
+        })
+      }
+      const onLeave = () => setHoverInfo(null)
+      const onContext = (e) => { e.preventDefault(); onOpenWorkbench() }
+      railEl.addEventListener('pointermove', onMove)
+      railEl.addEventListener('pointerleave', onLeave)
+      railEl.addEventListener('contextmenu', onContext)
+      return () => {
+        railEl.removeEventListener('pointermove', onMove)
+        railEl.removeEventListener('pointerleave', onLeave)
+        railEl.removeEventListener('contextmenu', onContext)
+      }
+    }, [railEl, onOpenWorkbench])
+
+    // 工具分布懒加载（独特信息维度，官方 preview 只有 prompt/response 片段）：
+    // hover 驻留 250ms 后拉 getTurn，聚合工具名 ×次数 top4（防扫过时每刻度一请求）。
+    const [toolDist, setToolDist] = useState(null) // {turn, text}
+    useEffect(() => {
+      if (!railEl || hoverInfo === null || !currentId) { setToolDist(null); return undefined }
+      const turn = hoverInfo.turn
+      const timer = setTimeout(() => {
+        api('getTurn', { sessionId: currentId, turn }).then((json) => {
+          if (!json || !json.ok || !json.turn) return
+          const text = toolDistOf(json.turn)
+          setToolDist((prev) => (prev && prev.turn === turn && prev.text === text) ? prev : { turn, text })
+        }).catch(() => {})
+      }, 250)
+      return () => clearTimeout(timer)
+    }, [railEl, hoverInfo, currentId])
+
+    // hover 增强段注入官方预览卡内部（单卡融合——另起一卡会与官方预览上下堆叠成
+    // 两大块，实测很丑）。官方 preview 容器 = rail 内 class 以 _preview 结尾的元素
+    //（CSS module hash 前缀 + preview/previewPrompt/previewResponse 三段，用
+    // /(?:^|_)preview(?:$|\s)/ 精确命中容器）；React 复用 preview 元素跨轮次渲染 →
+    // data-sig 核对（轮次+工具分布到位状态），变化即重建；observer 监视 rail 子树，
+    // preview 出现/消失/被重渲染时自愈。**独特性原则（用户裁定 2026-09-05）：只给
+    // 官方 preview 没有的信息维度——耗时 / 工具统计与分布 / 错误 / 思考标记；
+    // 结论不再展示（与官方 response 片段重复，用户二次裁定撤下）；图标一律纯色
+    // 矢量（stroke=currentColor），不用 emoji**。
+    // 高度解禁：官方 preview 固定 --turn-preview-height:100px 且溢出裁剪——注入段
+    // 会被裁成「残缺卡」（实测踩坑）；注入期间内联 height:auto + maxHeight 放开，
+    // 撤注入时还原内联样式。
+    useEffect(() => {
+      if (!railEl) return undefined
+      const findPreview = () => [...railEl.querySelectorAll('[class*=preview]')]
+        .find((el) => /(?:^|_)preview(?:$|\s)/.test(String(el.className)))
+      const cleanup = () => {
+        for (const n of railEl.querySelectorAll('.sf-rail-conclusion')) n.remove()
+        const p = findPreview()
+        if (p) { p.style.height = ''; p.style.maxHeight = ''; p.style.overflow = '' }
+      }
+      const enhance = () => {
+        const preview = findPreview()
+        const turn = hoverInfo === null ? null : hoverInfo.turn
+        const entry = turn === null ? undefined : turnData.find((t) => t.turn === turn)
+        if (!preview || !entry || (entry.durMs === 0 && entry.tools === 0)) { cleanup(); return }
+        preview.style.height = 'auto'
+        preview.style.maxHeight = '280px'
+        preview.style.overflow = 'hidden'
+        let node = preview.querySelector(':scope > .sf-rail-conclusion')
+        if (!node) {
+          node = document.createElement('div')
+          node.className = 'sf-rail-conclusion'
+          preview.appendChild(node)
+        }
+        const dist = toolDist !== null && toolDist.turn === entry.turn ? toolDist.text : ''
+        const sig = entry.turn + '|' + dist
+        if (node.dataset.sig === sig) return
+        node.dataset.sig = sig
+        node.replaceChildren()
+        // meta chips 行（纯色矢量图标）：耗时 · n 次工具 · m 错误（红）· 含思考
+        const meta = buildTurnMeta(entry)
+        if (meta) node.appendChild(meta)
+        // 工具分布行（懒加载到位后经 sig 变化重建本节点）
+        if (dist !== '') {
+          const tools = document.createElement('div')
+          tools.className = 'sf-rail-conclusionTools'
+          tools.textContent = dist
+          node.appendChild(tools)
+        }
+      }
+      enhance()
+      const obs = new MutationObserver(enhance)
+      obs.observe(railEl, { childList: true, subtree: true })
+      return () => { obs.disconnect(); cleanup() }
+    }, [railEl, hoverInfo, turnData, toolDist])
+
+    return null
+  }
+
+  // ── 导航总挂载：官方 rail 增强层 ⇄ 经典钢琴键悬浮条 ────────────────
+  // 默认（v0.1.2+，用户裁定 2026-09-05）：经典悬浮条默认开启（pianoClassicStrip
+  // 默认 true），与官方 rail 增强层并存——左右双导航各司其职（我们：预览卡/右键
+  // 工作台/滚轮窗口/键盘；官方：完整历史刻度）；设置里可各自关闭。旧版 dsh
+  // （无官方 rail）railEl=null 时 classic 恒 true，功能不丢。
+  function NavRoot(props) {
+    const { settingsCtrl } = props
+    const [, force] = useState(0)
+    const [railEl, setRailEl] = useState(null)
+    useEffect(() => (settingsCtrl ? settingsCtrl.subscribe(() => force((n) => n + 1)) : undefined), [settingsCtrl])
+    useEffect(() => {
+      const find = () => {
+        const nav = document.querySelector(RAIL_SELECTOR)
+        setRailEl((prev) => (prev === nav || (prev === null && nav === null) ? prev : nav))
+      }
+      find()
+      const obs = new MutationObserver(find)
+      obs.observe(document.body, { childList: true, subtree: true })
+      return () => obs.disconnect()
+    }, [])
+    const classicWanted = sfSettings.current.pianoClassicStrip === true
+    const enhanceWanted = sfSettings.current.railEnhance !== false
+    // railHideOfficial：完全屏蔽官方刻度条（只留我们的悬浮条）；隐藏期间增强层不挂。
+    const hideOfficial = sfSettings.current.railHideOfficial === true
+    useEffect(() => {
+      if (railEl) railEl.style.display = hideOfficial ? 'none' : ''
+      return () => { if (railEl) railEl.style.display = '' }
+    }, [railEl, hideOfficial])
+    const showClassic = classicWanted || railEl === null
+    const showEnhance = enhanceWanted && railEl !== null && !hideOfficial
+    return h(React.Fragment, null,
+      showClassic ? h(TurnKeys, { sessions: props.sessions, connection: props.connection, onOpenWorkbench: props.onOpenWorkbench }) : null,
+      showEnhance ? h(RailEnhancer, { sessions: props.sessions, railEl, onOpenWorkbench: props.onOpenWorkbench }) : null)
+  }
+
   // ── M11：钢琴键竖条挂载（DOM 注入 + 自愈）────────────────────────
   // 容器挂 document.body（dsh-navbar 同款模式）：完全脱离会话区布局树，
   // 不干扰 conversation 的 flex/grid 布局；fixed 定位由组件自管理。
   // MutationObserver 自愈：容器丢失（布局重建）时自动恢复。
-  function mountPianoKeys(controller, sessions, connection) {
+  function mountPianoKeys(controller, sessions, connection, settingsCtrl) {
     let root = undefined
     let container = undefined
     let waitObserver = null
@@ -3654,9 +4200,10 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       document.body.appendChild(container)
       try {
         root = createRoot(container)
-        root.render(h(TurnKeys, {
+        root.render(h(NavRoot, {
           sessions,
           connection,
+          settingsCtrl: settingsCtrl || null,
           onOpenWorkbench: () => controller.open(),
         }))
         syncChatVisibility()
@@ -3824,7 +4371,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
   }
 
   // ── 插件体 ─────────────────────────────────────────────────────────
-  const inject = ['sessions', 'connection', 'slots', 'layout']
+  const inject = ['sessions', 'connection', 'slots', 'layout', 'remote', 'remote.session']
 
   function apply(ctx) {
     try {
@@ -3838,6 +4385,11 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
 
       const sessions = ctx.get('sessions')
       const connection = ctx.get('connection')
+      // v0.1.2 RPC 双面适配（remote.session 新面优先，connection 旧面回退）。
+      sfRemoteRef.current = sfBuildRemote(ctx, connection)
+      // 设置控制器引用：settings.section 注册块内创建，挂载钢琴键/导航增强层时
+      // 传给 NavRoot 做设置变更即时切换（不可用则为 null，走默认值）。
+      let sfSettingsCtrl = null
 
       const state = { open: false, listeners: new Set() }
       const controller = {
@@ -3919,7 +4471,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         try {
           const settingsBinder = ctx.get('webUiSettings') ?? ctx.get('settingsScope')
           if (settingsBinder !== undefined && settingsBinder !== null && typeof settingsBinder.bind === 'function') {
-            const sfSettingsCtrl = new SfSettingsController(settingsBinder.bind({ namespace: 'session-flow' }))
+            sfSettingsCtrl = new SfSettingsController(settingsBinder.bind({ namespace: 'session-flow' }))
             slots.inject('settings.section', () => {
               const unregister = slots.register({
                 name: 'settings.section',
@@ -4047,7 +4599,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         disposers.push(mountSidebarEntry(controller))
         disposers.push(mountBoard(controller, sessions, connection))
         // M11：钢琴键会话快切（会话页左侧常驻竖条）；挂载失败不影响其他功能。
-        disposers.push(mountPianoKeys(controller, sessions, connection))
+        disposers.push(mountPianoKeys(controller, sessions, connection, sfSettingsCtrl))
       } catch (error) {
         console.error('[dsh-session-flow] mount failed:', error)
       }

package/lib/host.js

@@ -85,6 +85,9 @@ export const SETTINGS_DEFAULTS = {
   liveFollowPx: 40,       // 实时吸底阈值（px）
   liveHistoryTurns: 3,    // 详情页实时模式保留的历史回合数
   stallThresholdMin: 3,   // 疑似卡死阈值（分钟）
+  railEnhance: true,      // 官方轮次导航（TurnNavigatorRail）增强层开关（v0.1.2+）
+  railHideOfficial: false, // 完全屏蔽官方轮次导航（只留我们的悬浮条）
+  pianoClassicStrip: true, // 经典左侧轮次悬浮条（默认开，与官方 rail 并存；用户裁定 2026-09-05）
 }
 
 /** schemastery schema：settings 服务 resolve 时调用 schema(merged)，并需要 toJSON()（describe 用）。 */
@@ -96,6 +99,9 @@ const SETTINGS_SCHEMA = z.object({
   liveFollowPx: z.number().step(1).min(20).max(120).default(SETTINGS_DEFAULTS.liveFollowPx),
   liveHistoryTurns: z.number().step(1).min(0).max(10).default(SETTINGS_DEFAULTS.liveHistoryTurns),
   stallThresholdMin: z.number().step(1).min(1).max(10).default(SETTINGS_DEFAULTS.stallThresholdMin),
+  railEnhance: z.boolean().default(SETTINGS_DEFAULTS.railEnhance),
+  railHideOfficial: z.boolean().default(SETTINGS_DEFAULTS.railHideOfficial),
+  pianoClassicStrip: z.boolean().default(SETTINGS_DEFAULTS.pianoClassicStrip),
 })
 
 /** 解析后的当前设置值（base + user 层）；host 侧消费点（卡死阈值）从这里读。 */

package/lib/index-store.js

@@ -5,7 +5,7 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, statSync, writeFileSync } from 'node:fs'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
-import { listSessionDirs, summarizeSessionFile } from './archive.js'
+import { listSessionDirs, sessionFileOf, summarizeSessionFile } from './archive.js'
 
 export function dshHome() {
   return process.env.DSH_HOME || join(homedir(), '.dsh')
@@ -22,8 +22,10 @@ export function workspaceIndexFile(home, wsName) {
   return join(indexRoot(home), `index-${safe}.json`)
 }
 
-/** 索引格式版本：升级时旧缓存会被自动全量重扫一次（避免字段缺失）。 */
-const INDEX_VERSION = 4
+/** 索引格式版本：升级时旧缓存会被自动全量重扫一次（避免字段缺失）。
+ * 5（2026-09-08）：dsh v0.1.3 存档 v2 布局适配——存档文件改为 session.v2.jsonl.zstd
+ * （v1 冻结），强制全量重扫让摘要/统计全部来自 v2。 */
+const INDEX_VERSION = 5
 
 export function readIndex(home, wsName) {
   try {
@@ -107,7 +109,9 @@ export function scanWorkspaceIndex(home, wsName, options = {}) {
   return { index, scanned, skipped, removed }
 }
 
-/** 按会话 id 在所有工作区中定位存档（返回 { workspace, dir, file } 或 null）。 */
+/** 按会话 id 在所有工作区中定位存档（返回 { workspace, dir, file } 或 null）。
+ * 文件定位统一走 sessionFileOf（v2 优先，0.1.3 适配——此前硬编码 v1 文件名，
+ * 纯 v2 新会话全部 404「not found in archives」，钢琴条/详情/检索静默失效）。 */
 export function findWorkspaceOfSession(home, sessionId) {
   const root = join(home, 'sessions')
   if (!existsSync(root)) return null
@@ -115,10 +119,8 @@ export function findWorkspaceOfSession(home, sessionId) {
     const wsDir = join(root, wsName)
     try { if (!statSync(wsDir).isDirectory()) continue } catch { continue }
     const dir = join(wsDir, sessionId)
-    const zstd = join(dir, 'session.jsonl.zstd')
-    if (existsSync(zstd)) return { workspace: wsName, dir, file: zstd }
-    const plain = join(dir, 'session.jsonl')
-    if (existsSync(plain)) return { workspace: wsName, dir, file: plain }
+    const file = sessionFileOf(dir)
+    if (file !== null) return { workspace: wsName, dir, file }
   }
   return null
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-session-flow",
   "description": "DSH 会话回顾与归档插件：可折叠信息流 + 会话级汇总——总览工作台、折叠时间线、血缘树、双模式摘要、全文检索、ZIP 导出、实时跟踪、会话重命名（官方数据源对齐）、健康监控",
-  "version": "1.2.0",
+  "version": "1.4.0",
   "type": "module",
   "main": "lib/host.js",
   "exports": {