dsh-session-flow 1.0.0 → 1.1.0

package/README.en.md

@@ -33,7 +33,9 @@ Restructures DSH session message streams into a **foldable information flow with
 | Dual-mode summary | Rule summary (zero cost, assembled live) + LLM summary (cached, prompts regeneration) |
 | Live tracking | 3s polling for running sessions, breathing highlight + generating indicator |
 | ZIP export | Overview + chunked timeline as a Markdown report |
-| Session rename | Custom titles as a display-layer overlay, restore anytime |
+| Session rename | Same data source as the official title (log-backed), synced both ways in real time |
+| Health monitor | Four-level classification: active / tool-running / quiet / likely stalled; overview badges + detail live bar |
+| Header health chip | Next to the mode label in the session header; a vertical bar that expands into a status card on hover, click to open detail |
 | Session Flow tab | Embedded tab on the native conversation page, cross-navigates with the workbench |
 | Turn rail | Turn jumps on the left of the Chat tab (Chat tab only) |
 | Cross-session full-text search | Content-level recall, hits jump into the Session Flow tab and locate |
@@ -56,7 +58,8 @@ Requirements: DSH Web GUI (latest stable); Node.js ≥ 22.19 (built-in zstd deco
 
 - **Overview**: sidebar "Session Flow" → all session cards. Search supports `tool:` / `file:` / `err:` prefixes; free text of ≥2 characters additionally triggers cross-session full-text search.
 - **Detail**: click a card. Turns are folded by default — click a turn header to expand; the four-tab navigation locates entries; the header offers LLM summary, ZIP export, dock right, and lineage.
-- **Native conversation page**: the "Session Flow" tab reviews the current session in place; the turn rail on the Chat tab jumps to any turn; hover the title for ✎ rename.
+- **Native conversation page**: the "Session Flow" tab reviews the current session in place; the turn rail on the Chat tab jumps to any turn; hover the title for ✎ rename (synced with the official title in real time).
+- **Health status**: the health chip right of the mode label in the header (vertical bar: green = active / amber = tool running / red = likely stalled) expands on hover; click to open the Session Flow detail. Overview cards and the live bar show the same badges.
 - **Live**: click "Live" on a running session, auto-refresh every 3 seconds.
 
 ## Acknowledgements

package/README.md

@@ -33,7 +33,9 @@
 | 双模式摘要 | 规则摘要（零开销实时组装）+ LLM 摘要（落盘复用、新对话提示重生成） |
 | 实时跟踪 | 运行中会话 3 秒轮询，呼吸高亮 + 生成标志 |
 | ZIP 导出 | 概览 + 时间线分卷 Markdown 报告 |
-| 会话重命名 | 自定义标题显示层覆盖，随时恢复原名 |
+| 会话重命名 | 与官方标题同一数据源（log-backed），双向实时同步，随时改名 |
+| 健康监控 | 活跃 / 工具执行中 / 静默中 / 疑似卡死四级分类；总览徽标 + 详情实时条 |
+| 头部健康芯片 | 会话页顶栏模式标识右侧，竖条收拢 ⇄ 悬浮展开状态卡，点击直达详情 |
 | 会话流标签页 | 原生会话页内嵌标签，与工作台互跳 |
 | 轮次悬浮条 | 对话页左侧轮次跳转（仅对话页显示） |
 | 跨会话全文检索 | 内容级召回，命中直达会话流标签页定位 |
@@ -56,7 +58,8 @@ dsh plugin add github:YeqingTang/dsh-session-flow
 
 - **总览**：侧边栏「会话流」→ 全部会话卡片。搜索支持 `tool:` / `file:` / `err:` 前缀；自由文本 ≥2 字符自动追加跨会话全文检索结果。
 - **详情**：点卡片进入。回合默认折叠，点回合头展开；右侧四标签导航定位；顶部可生成 LLM 摘要、导出 ZIP、并入右栏、查看血缘。
-- **原生会话页**：会话顶部「会话流」标签直接回顾当前会话；对话页左侧轮次悬浮条跳转任意轮次；标题 hover ✎ 重命名。
+- **原生会话页**：会话顶部「会话流」标签直接回顾当前会话；对话页左侧轮次悬浮条跳转任意轮次；标题 hover ✎ 重命名（与官方标题实时同步）。
+- **健康状态**：顶栏模式标识右侧的健康芯片（竖条：绿=活跃 / 黄=工具执行中 / 红=疑似卡死），悬浮展开看详情，点击直达会话流详情页；总览卡片与详情实时条同步显示徽标。
 - **实时**：运行中会话点「实时」，3 秒自动刷新。
 
 ## 致谢

package/lib/client.js

@@ -72,6 +72,10 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     summaryStale: '⚠ 摘要生成后有新对话，内容可能已不准确，建议重新生成',
     llmSummary: '生成 LLM 摘要', llmGenerating: '生成中…', llmFail: '生成失败', summaryRuleTag: '规则', summaryLlmTag: 'LLM',
     cacheHint: '仅清理本插件的缓存（可自动重建），不影响 DSH 会话存档与任何其他数据', cacheLimit: '时间线缓存上限',
+    healthActive: '活跃', healthToolWait: '工具执行中', healthQuiet: '静默中', healthStalled: '疑似卡死',
+    healthSilentMin: '静默 {N} 分钟', healthSilentSec: '静默 {N} 秒',
+    healthChipTitle: '会话健康状态（会话流）· 点击打开详情',
+    renameClearBlocked: '该会话标题由官方会话管理：请输入新标题（不支持清空）',
   } : {
     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',
@@ -111,6 +115,10 @@ 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',
+    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)',
   }
 
   // ── 右侧导航图标（组件级共享，定义在顶层避免作用域问题）───────────
@@ -179,6 +187,29 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     `.sf-badgeEnd{background:rgba(120,120,120,.12);color:#888}`,
     `.sf-badgeSub{background:rgba(240,150,60,.15);color:#d97706}`,
     `.sf-badgeErr{background:rgba(230,80,80,.13);color:#d43b3b}`,
+    // 卡死监控徽标：疑似卡死（红，呼吸动画引起注意）/ 工具执行中·静默中（黄）。
+    `.sf-badgeStall{background:rgba(230,80,80,.16);color:#d43b3b;animation:sfBadgePulse 2.8s ease-in-out infinite}`,
+    `.sf-badgeWait{background:rgba(220,170,40,.15);color:#a87b00}`,
+    // 会话页头部健康芯片（官方 header.actions 槽位，模式标识右侧）。
+    // 钢琴键同款语言：收拢态 = 彩色短胶囊条（语义色保留：绿/黄/红，卡死带呼吸脉冲）；
+    // 悬浮/聚焦展开为毛玻璃文字标签（backdrop-filter + color-mix，与 pk-key 展开态同构）。
+    `.sf-healthChip{display:inline-flex;align-items:center;gap:6px;height:20px;padding:0 3px;margin-left:2px;border:none;border-radius:99px;background:transparent;cursor:pointer;font-family:inherit;overflow:hidden;outline:none;transition:padding .22s ease,background .18s ease,border-color .18s ease,box-shadow .18s ease}`,
+    `.sf-healthChip .sf-hcBar{flex:none;width:4px;height:16px;border-radius:99px;transition:width .22s ease,height .22s ease}`,
+    `.sf-healthChip .sf-hcLabel{font-size:11px;line-height:16px;white-space:nowrap;max-width:0;opacity:0;overflow:hidden;user-select:none;transition:max-width .24s ease,opacity .16s ease .05s}`,
+    // 展开态：毛玻璃底（blur 10px）+ 同色系淡 tint 背景（状态色 14% 透明混入 72% 基底色），
+    // 边框带 40% 状态色呼应；tint 淡雅、毛玻璃质感保留。
+    `.sf-healthChip:hover,.sf-healthChip:focus-visible{padding:3px 9px;border:1px solid var(--dsw-alias-border-l2,#e4e6eb);backdrop-filter:blur(10px);-webkit-backdrop-filter:blur(10px);box-shadow:0 1px 3px rgba(0,0,0,.07)}`,
+    `.sf-healthChip.hc-active:hover,.sf-healthChip.hc-active:focus-visible{background:color-mix(in srgb,var(--dsw-alias-bg-base,#fff) 72%,rgba(28,158,90,.14));border-color:color-mix(in srgb,var(--dsw-alias-border-l2,#e4e6eb) 60%,#1c9e5a)}`,
+    `.sf-healthChip.hc-wait:hover,.sf-healthChip.hc-wait:focus-visible{background:color-mix(in srgb,var(--dsw-alias-bg-base,#fff) 72%,rgba(217,165,20,.14));border-color:color-mix(in srgb,var(--dsw-alias-border-l2,#e4e6eb) 60%,#d9a514)}`,
+    `.sf-healthChip.hc-stall:hover,.sf-healthChip.hc-stall:focus-visible{background:color-mix(in srgb,var(--dsw-alias-bg-base,#fff) 72%,rgba(212,59,59,.14));border-color:color-mix(in srgb,var(--dsw-alias-border-l2,#e4e6eb) 60%,#d43b3b)}`,
+    `.sf-healthChip:hover .sf-hcBar,.sf-healthChip:focus-visible .sf-hcBar{width:6px;height:6px;border-radius:99px}`,
+    `.sf-healthChip:hover .sf-hcLabel,.sf-healthChip:focus-visible .sf-hcLabel{max-width:200px;opacity:1}`,
+    `.sf-healthChip.hc-active .sf-hcBar{background:#1c9e5a}`,
+    `.sf-healthChip.hc-active .sf-hcLabel{color:#1c9e5a}`,
+    `.sf-healthChip.hc-wait .sf-hcBar{background:#d9a514}`,
+    `.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-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（独立一行，醒目）──
@@ -562,6 +593,104 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     )
   }
 
+  // ── 重命名对齐官方 + 卡死监控 共享辅助 ─────────────────────────────
+  /** 官方 rename RPC（log-backed session/title user 事件）：本插件与官方侧栏同一数据源。 */
+  const renameViaOfficial = (conn, sessionId, title) => {
+    return conn.api.sessions.rename({ sessionId, title }).then((resp) => {
+      const res = resp && resp.result
+      if (res && res.ok === true && res.value && typeof res.value.title === 'string') return res.value.title
+      throw new Error((res && res.error && res.error.message) || STR.renameFail)
+    })
+  }
+  const canOfficialRename = (conn) =>
+    conn !== undefined && conn.api !== undefined && conn.api.sessions !== undefined && typeof conn.api.sessions.rename === 'function'
+  /** 静默时长文本（{N} 占位）。 */
+  const fmtSilent = (idleMs) => {
+    if (idleMs === null || idleMs === undefined) return ''
+    const min = Math.floor(idleMs / 60000)
+    return min >= 1
+      ? STR.healthSilentMin.replace('{N}', String(min))
+      : STR.healthSilentSec.replace('{N}', String(Math.max(1, Math.round(idleMs / 1000))))
+  }
+  /** 健康徽标（详情实时条 / 总览卡片共用）；active/ended/unknown 不渲染（已有进行中/已结束徽标）。 */
+  const healthBadge = (health) => {
+    if (!health) return null
+    const silent = fmtSilent(health.idleMs)
+    if (health.kind === 'stalled') return h('span', { className: 'sf-badge sf-badgeStall' }, '🔴 ' + STR.healthStalled + (silent ? ' · ' + silent : ''))
+    if (health.kind === 'tool-wait') return h('span', { className: 'sf-badge sf-badgeWait' }, '🟡 ' + STR.healthToolWait + (silent ? ' · ' + silent : ''))
+    if (health.kind === 'quiet') return h('span', { className: 'sf-badge sf-badgeWait' }, '🟡 ' + STR.healthQuiet + (silent ? ' · ' + silent : ''))
+    return null
+  }
+
+  // ── 会话页头部健康芯片（官方 conversation.session.header.actions 槽位）──
+  // 位置：官方模式标识（agent-preset label, order -10）右侧（order -9）。
+  // 数据：sessions.list 快照跟踪 running（官方真实状态，随 host 流即时翻转）→
+  // running 时 10s 轮询 tail history → host derive 健康分类（与总览探测同管线）。
+  // 点击：唤起会话流工作台并直达该会话详情（workbenchBridge 意图桥）。
+  function SessionHealthChip(props) {
+    const { sessionId, connection, sessions } = props
+    const [running, setRunning] = useState(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）。
+          const snap = sessions.list.getSnapshot()
+          const it = snap && snap.byId ? snap.byId[sessionId] : undefined
+          setRunning(it ? it.running === true : false)
+        } catch (e) { setRunning(false) }
+      }
+      compute()
+      if (typeof sessions.list.subscribe === 'function') return sessions.list.subscribe(compute)
+      return undefined
+    }, [sessions, sessionId])
+    useEffect(() => {
+      if (!running || !sessionId || !canOfficialRename(connection)) { 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) : []
+          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)
+        } catch (e) {}
+      }
+      probe()
+      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 不显示
+    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 : '')),
+    )
+  }
+
+  // 工作台打开意图桥：头部芯片点击 → 唤起工作台并直达该会话详情。
+  // （工厂作用域：芯片渲染于官方槽位，与本插件视图分属不同 React 子树。）
+  const workbenchBridge = {
+    intent: null,
+    listeners: new Set(),
+    open(sid) { this.intent = sid; for (const fn of [...this.listeners]) fn(sid) },
+    subscribe(fn) { this.listeners.add(fn); return () => this.listeners.delete(fn) },
+  }
+
   // ── 总览页 ──────────────────────────────────────────────────────────
   // props: { onOpen: (session) => void, onClose: () => void }
   function SessionFlowOverview(props) {
@@ -583,28 +712,93 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     // M8a：当前编辑重命名的会话 id（null = 无编辑态）。
     const [renamingId, setRenamingId] = useState(null)
     // M8a：保存自定义标题 → 更新本地列表数据（userTitle 覆盖显示，不整页重刷）。
+    // 对齐官方（2026-08 起）：非空标题且连接可用时优先走官方 session.rename RPC
+    // （log-backed，官方侧栏同步）；空标题（清除）/官方拒绝（子代理 agent-busy 等）回退 legacy renames.json。
     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
-        }
+      const conn = props.connection
+      const applyLocal = (userTitle) => {
+        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 } : s)),
+              })),
+            },
+          }
+        })
+        setRenamingId(null)
+        return true
+      }
+      const legacy = () => api('rename', { sessionId: sid, title }).then((json) => {
+        if (json && json.ok) return applyLocal(json.userTitle)
         throw new Error((json && json.error) || STR.renameFail)
       })
+      const trimmed = String(title || '').trim()
+      // 官方 user 标题不可经本插件清空（官方服务无删除语义）：阻止并提示。
+      if (trimmed === '') {
+        const all = ((state.data && state.data.workspaces) || []).flatMap((g) => g.sessions || [])
+        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)
+          .then((accepted) => applyLocal(accepted))
+          .catch(() => legacy())
+      }
+      return legacy()
     }
+    // ── 卡死监控：总览探测 ─────────────────────────────────────────────
+    // 官方 sessions.list 的 running（attached agent 真实状态，比 15 分钟启发式准）+
+    // tail history → host derive 健康分类。30s 轮询，上限 8 个、并发 3。
+    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
+      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 runningIds = items.filter((i) => i.running === true).map((i) => i.sessionId)
+          if (!alive) return
+          setLiveRunning(new Set(runningIds))
+          const next = {}
+          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) : []
+                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
+              } catch {}
+            }))
+            if (!alive) return
+          }
+          if (alive) setHealthMap(next)
+        } catch {} finally { probing = false }
+      }
+      probe()
+      const iv = setInterval(probe, 30000)
+      return () => { alive = false; clearInterval(iv) }
+    }, [props.connection, state.phase])
+    // 头部芯片直达：工作台打开意图 → 列表就绪后自动进入该会话详情（每个意图只消费一次）。
+    const intentConsumed = useRef(null)
+    useEffect(() => {
+      if (!props.intentId || intentConsumed.current === props.intentId || state.phase !== 'ready') return
+      const all = ((state.data && state.data.workspaces) || []).flatMap((g) => g.sessions || [])
+      const target = all.find((x) => x.id === props.intentId)
+      if (target) { intentConsumed.current = props.intentId; props.onOpen(target) }
+    }, [props.intentId, state.phase])
     useEffect(() => () => {
       if (fullTextTimer.current) clearTimeout(fullTextTimer.current)
       if (fullTextAbort.current) fullTextAbort.current.abort()
@@ -738,7 +932,11 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
             }
           }
           const now = Date.now()
-          const running = s.lastEventTime !== null && s.lastEventTime !== undefined && (now - s.lastEventTime) < ACTIVE_WINDOW_MS
+          // 卡死监控：官方探测过（liveRunning 非 null）则以 attached agent 真实状态为准，
+          // 否则回退 15 分钟活动窗口启发式。
+          const running = liveRunning === null
+            ? s.lastEventTime !== null && s.lastEventTime !== undefined && (now - s.lastEventTime) < ACTIVE_WINDOW_MS
+            : liveRunning.has(s.id)
           out.push({ ...s, workspace: group.name, workspaceLabel: wsLabelOf(group), workspaceCwd: wsCwdOf(group), running, isEmpty: isSessionEmpty(s) })
         }
       }
@@ -754,7 +952,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
       const ascending = sort === 'oldest'
       out.sort((a, b) => (ascending ? key(a) - key(b) : key(b) - key(a)))
       return out
-    }, [state.data, query, wsFilter, sort, showEmpty, showIssues])
+    }, [state.data, query, wsFilter, sort, showEmpty, showIssues, liveRunning])
 
     // M5b 档案统计：聚合工具出现热度与问题会话数，跟随选中的工作区（wsFilter）变化。
     const stats = useMemo(() => {
@@ -904,13 +1102,14 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
             h('div', { className: 'sf-cardTitle' },
               renamingId === s.id
                 ? h(RenameInline, {
-                    initial: s.userTitle || s.title || '',
+                    initial: (props.liveTitles && props.liveTitles[s.id]) || 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 },
+                    // 显示优先级：mux 近实时官方标题 > userTitle（档案 user/遗留 overlay）> 自动标题。
+                    (props.liveTitles && props.liveTitles[s.id]) || s.userTitle || s.title || STR.unknownTitle,
+                    (s.userTitle || (props.liveTitles && props.liveTitles[s.id])) && h('span', { className: 'sf-origTitle', title: s.title || STR.unknownTitle },
                       STR.origTitle + ': ' + (s.title || STR.unknownTitle)),
                     h('button', {
                       className: 'sf-renameBtn', title: STR.rename,
@@ -919,6 +1118,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
                   ),
               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),
+              healthBadge(healthMap[s.id]),
               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),
             ),
@@ -1357,8 +1557,12 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     // M8a：标题重命名（编辑态 + 保存后的显示覆盖，优先于 session.userTitle）。
     const [renaming, setRenaming] = useState(false)
     const [titleOverride, setTitleOverride] = useState(null)
+    // mux 近实时官方标题（SessionFlowView 订阅 session/projection(title) 帧传入）。
+    const liveTitleOf = (id) => (props.liveTitles && props.liveTitles[id]) || null
+    // 对齐官方：优先官方 session.rename RPC（log-backed，双向一致）；空标题/官方拒绝回退 legacy。
     const saveRename = (title) => {
-      return api('rename', { sessionId: session.id, title }).then((json) => {
+      const conn = props.connection
+      const legacy = () => api('rename', { sessionId: session.id, title }).then((json) => {
         if (json && json.ok) {
           setTitleOverride(json.userTitle) // null = 清除恢复原名
           setRenaming(false)
@@ -1366,6 +1570,14 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         }
         throw new Error((json && json.error) || STR.renameFail)
       })
+      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)
+          .then((accepted) => { setTitleOverride(accepted); setRenaming(false); return true })
+          .catch(() => legacy())
+      }
+      return legacy()
     }
 
     useEffect(() => {
@@ -1514,7 +1726,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           return
         }
         const events = val.events.map((entry) => (entry && entry.event) || entry)
-        const derived = await api('derive', { events })
+        const derived = await api('derive', { events, now: Date.now() })
         if (!derived || !derived.ok) {
           setLiveState((s) => ({ ...s, phase: 'error', error: (derived && derived.error) || STR.liveFail }))
           return
@@ -1537,6 +1749,8 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           // 运行中 = 事件结构信号（未闭合回合/步骤/工具调用或流式中间态），
           // 不依赖时间戳：输出间隔长（模型思考/长工具执行）时不会误判停止。
           running: liveRunning,
+          // 卡死监控：host 分类（active/tool-wait/quiet/stalled/ended）。
+          health: derived.health || null,
         })
         // 只把「新出现的回合」并入折叠集合（默认折叠）；已展开的回合不被收拢。
         const newTurns = displayTl.filter((t) => !liveSeenTurns.current.has(t.turn))
@@ -1563,7 +1777,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     const exitLive = () => {
       setLiveOn(false)
       liveSeenTurns.current.clear()
-      setLiveState({ phase: 'idle', error: null, timeline: null, eventCount: 0, lastActive: null, running: false })
+      setLiveState({ phase: 'idle', error: null, timeline: null, eventCount: 0, lastActive: null, running: false, health: null })
       if (liveTimer.current !== null) { clearInterval(liveTimer.current); liveTimer.current = null }
     }
     useEffect(() => () => { if (liveTimer.current !== null) clearInterval(liveTimer.current) }, [])
@@ -1779,13 +1993,13 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         h('h2', { className: 'sf-viewTitle', style: { flex: '1 1 auto', overflow: 'hidden', textOverflow: 'ellipsis' } },
           renaming
             ? h(RenameInline, {
-                initial: titleOverride || session.userTitle || session.title || '',
+                initial: titleOverride || liveTitleOf(session.id) || 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('span', { style: { overflow: 'hidden', textOverflow: 'ellipsis', whiteSpace: 'nowrap' }, title: (titleOverride || liveTitleOf(session.id) || session.userTitle) ? session.title || STR.unknownTitle : undefined },
+                  titleOverride || liveTitleOf(session.id) || session.userTitle || session.title || STR.unknownTitle),
                 h('button', {
                   className: 'sf-renameBtn', title: STR.rename,
                   onClick: () => setRenaming(true),
@@ -1889,6 +2103,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           // M6 实时模式：sessions.history → derive 的完整折叠时间线（轮询刷新）。
           liveOn && h('div', { className: 'sf-liveBar', style: { flex: 'none' } },
             h('span', { className: 'sf-badge sf-badgeRun', style: { flex: 'none' } }, STR.liveActive),
+            healthBadge(liveState.health),
             h('span', { className: 'sf-liveText' },
               h('span', { className: 'sf-muted', style: { flex: 'none' } }, (liveState.eventCount || 0) + ' ' + STR.liveEvents),
               liveState.lastActive && h('span', { className: 'sf-muted', style: { flex: 'none' } }, STR.liveLastActive + ' ' + fmtTime(liveState.lastActive)),
@@ -2119,7 +2334,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
   // 内实时通道同构（结构信号运行判定 / 只折叠新回合 / 不传 hideHead），自包含实现。
   function SessionFlowLiveFallback(props) {
     const { sessionId, connection } = props
-    const [state, setState] = useState({ phase: 'loading', error: null, timeline: null, eventCount: 0, running: false })
+    const [state, setState] = useState({ phase: 'loading', error: null, timeline: null, eventCount: 0, running: false, health: null })
     const [collapsed, setCollapsed] = useState(() => new Set())
     const [activeTurn, setActiveTurn] = useState(null)
     const liveSeenTurns = useRef(new Set())
@@ -2140,7 +2355,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           return
         }
         const events = val.events.map((entry) => (entry && entry.event) || entry)
-        const derived = await api('derive', { events })
+        const derived = await api('derive', { events, now: Date.now() })
         if (!derived || !derived.ok) {
           setState((s) => ({ ...s, phase: 'error', error: (derived && derived.error) || STR.liveFail }))
           return
@@ -2149,6 +2364,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         setState({
           phase: 'ready', error: null, timeline: tl, eventCount: events.length,
           running: derived.running === true,
+          health: derived.health || null,
         })
         // 只折叠新出现的回合（默认折叠），已展开的保持用户状态（M6 经验）。
         const newTurns = tl.filter((t) => !liveSeenTurns.current.has(t.turn))
@@ -2184,6 +2400,7 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
     return h('div', { className: 'sf-view' },
       h('div', { className: 'sf-viewHeader' },
         h('span', { className: 'sf-badge sf-badgeRun', style: { flex: 'none' } }, STR.liveActive),
+        healthBadge(state.health),
         h('span', { className: 'sf-liveText' }, STR.liveFallbackHint),
         h('button', { className: 'sf-btn sf-liveExitBtn', onClick: props.onRetry }, STR.retryArchive),
       ),
@@ -2202,6 +2419,32 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
   // ── 主视图（总览 ⇄ 详情）───────────────────────────────────────────
   function SessionFlowView(props) {
     const [detail, setDetail] = useState(null) // { session, searchQuery }
+    // 头部芯片直达意图（workbenchBridge）：收到会话 id → 总览数据就绪后自动进详情。
+    const [intentId, setIntentId] = useState(workbenchBridge.intent)
+    useEffect(() => workbenchBridge.subscribe((sid) => { setDetail(null); setIntentId(sid) }), [])
+    // ── 官方标题近实时同步（rename 对齐增强）──────────────────────────
+    // 自建 mux 下行流监听 session/projection(title) 帧：官方 rename / 自动标题生成后
+    // host 向每个 mux 消费者即时广播（value 为标题字符串），秒级同步、免等重扫。
+    const [liveTitles, setLiveTitles] = useState({}) // sessionId -> 最新官方标题
+    useEffect(() => {
+      const conn = props.connection
+      if (conn === undefined || conn.api === undefined || conn.api.events === undefined || typeof conn.api.events.mux !== 'function') return undefined
+      const ac = new AbortController()
+      ;(async () => {
+        try {
+          for await (const envelope of conn.api.events.mux({}, ac.signal)) {
+            const f = (envelope && envelope.payload) || envelope
+            if (!f || f.type !== 'session/projection' || f.key !== 'title') continue
+            const title = typeof f.value === 'string' ? f.value : (f.value && typeof f.value.title === 'string' ? f.value.title : '')
+            if (f.sessionId && title !== '') {
+              const sid = f.sessionId
+              setLiveTitles((prev) => (prev[sid] === title ? prev : { ...prev, [sid]: title }))
+            }
+          }
+        } catch (e) { /* 流断开/中止：静默（组件卸载或下次挂载时重建） */ }
+      })()
+      return () => ac.abort()
+    }, [props.connection])
 
     return detail === null
       ? h(SessionFlowOverview, {
@@ -2209,12 +2452,16 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
           onOpen: (session, searchQuery) => setDetail({ session, searchQuery }),
           onClose: props.onClose,
           sessions: props.sessions,
+          connection: props.connection,
+          liveTitles,
+          intentId,
         })
       : h(SessionFlowDetail, {
           session: detail.session,
           initialSearchQuery: detail.searchQuery || '',
           sessions: props.sessions,
           connection: props.connection,
+          liveTitles,
           onBack: () => setDetail(null),
           onClose: props.onClose,
         })
@@ -2947,6 +3194,27 @@ window.__ModuleLoader__.load({ id: 'dsh-session-flow', factory: (require) => {
         } catch (error) {
           console.error('[dsh-session-flow] conversation.view registration failed:', error)
         }
+        // 会话健康芯片：官方 conversation.session.header.actions 槽位（ui-jobs/ui-subagent 同款），
+        // order -9 紧随官方模式标识（agent-preset label, order -10）右侧。
+        // 点击芯片 → workbenchBridge 意图桥直达该会话详情。
+        try {
+          slots.inject('conversation.session.header.actions', () => slots.register({
+            name: 'conversation.session.header.actions',
+            id: 'session-flow-health',
+            order: -9,
+          }, (slotProps) => h(SessionHealthChip, {
+            sessionId: slotProps ? slotProps.sessionId : undefined,
+            sessions,
+            connection,
+            onOpen: () => {
+              const sid = slotProps && slotProps.sessionId
+              if (sid) workbenchBridge.open(sid)
+              controller.open()
+            },
+          })))
+        } catch (error) {
+          console.error('[dsh-session-flow] header health chip registration failed:', error)
+        }
       }
 
       // M12：详情并入右侧栏 —— details 槽位动态占用（priority -1 低于官方 tool-details）。

package/lib/host.js

@@ -66,6 +66,43 @@ function sendJson(res, status, obj) {
   res.end(JSON.stringify(obj))
 }
 
+// ── 卡死监控（stall-monitor）：健康分类 ─────────────────────────────
+// 「进行中但长时间无输出」≠ 卡死（模型长思考/长工具执行都静默）。
+// 分类只看结构事实：运行中 + 无流式 chunk + 无未闭合工具 + 静默超阈值 → 疑似卡死。
+// TODO(设置页待办)：STALL_THRESHOLD_MS 待插件设置页落地后可配置化（见 docs HANDOVER §7）。
+export const STALL_THRESHOLD_MS = 3 * 60 * 1000
+export const HEALTH_ACTIVE_WINDOW_MS = 60 * 1000
+
+/**
+ * 健康分类（纯函数，verify 可测）。
+ * @param {{running:boolean,lastEventTime:number|null,openTool:boolean,inflight:boolean}} facts
+ * @param {number} now - 调用方时间戳（client 传 Date.now()，避免 host/client 时钟偏差语义混乱）。
+ * @returns {{kind:'active'|'tool-wait'|'quiet'|'stalled'|'ended'|'unknown', idleMs:number|null}}
+ */
+export function classifyHealth(facts, now) {
+  if (!facts || typeof facts !== 'object') return { kind: 'unknown', idleMs: null }
+  const idleMs = typeof facts.lastEventTime === 'number' ? Math.max(0, now - facts.lastEventTime) : null
+  if (facts.running !== true) return { kind: 'ended', idleMs }
+  // 有流式中间态或 60s 内有事件 → 确实在跑。
+  if (facts.inflight === true || (idleMs !== null && idleMs < HEALTH_ACTIVE_WINDOW_MS)) return { kind: 'active', idleMs }
+  // 有未闭合工具调用 → 静默是工具在执行（长跑命令正常），不算卡死。
+  if (facts.openTool === true) return { kind: 'tool-wait', idleMs }
+  if (idleMs === null) return { kind: 'unknown', idleMs }
+  if (idleMs >= STALL_THRESHOLD_MS) return { kind: 'stalled', idleMs }
+  return { kind: 'quiet', idleMs }
+}
+
+/**
+ * 对齐官方重命名（官方 rename 为 log-backed session/title user 事件，同一数据源）。
+ * 显示优先级：档案 user 源标题（官方唯一真源）> renames.json 遗留 overlay（自然淘汰）。
+ */
+function effectiveUserTitle(home, entry, sessionId) {
+  if (entry && entry.titleSource === 'user' && typeof entry.title === 'string' && entry.title !== '') {
+    return entry.title
+  }
+  return userTitleOf(home, sessionId)
+}
+
 /** 汇总输出视图（去掉 counts 细节，浏览器更轻）。 */
 function sessionView(summary) {
   if (!summary) return summary
@@ -629,7 +666,7 @@ export function apply(ctx) {
             if (requested !== null && ws.name !== requested) continue
             const result = scanWorkspaceIndex(home, ws.name, { force })
             const sessions = Object.values(result.index.sessions)
-              .map((s) => ({ ...sessionView(s), userTitle: userTitleOf(home, s.id) }))
+              .map((s) => ({ ...sessionView(s), userTitle: effectiveUserTitle(home, s, s.id) }))
               .sort((a, b) => (b.createdAt || 0) - (a.createdAt || 0))
             const meta = workspaceLabelOf(ws.name, sessions)
             workspaces.push({
@@ -717,7 +754,7 @@ export function apply(ctx) {
             workspaceLabel: wsMeta.label,
             workspaceCwd: wsMeta.cwd,
             session: sessionView(sum),
-            userTitle: userTitleOf(home, sessionId),
+            userTitle: effectiveUserTitle(home, sum, sessionId),
             counts,
             lightTurns: entry.lightTurns,
             toolStats: entry.toolStats,
@@ -874,8 +911,11 @@ export function apply(ctx) {
           const chunks = chunkTurns(entry.turns, EXPORT_CHUNK_TARGET)
           // 概览（含分卷指引）。
           const overview = renderOverviewMd({ entry, sum, found, title, llmText, chunkCount: chunks.length })
-          // 文件名用自定义标题优先（M8a：导出在 host 端合并，前端无法覆盖）。
-          const rawTitle = userTitleOf(home, sessionId) || title || sessionId
+          // 文件名用自定义标题优先（档案 user 源标题 = 官方真源优先；renames.json 遗留回退）。
+          const parsedTitle = entry.parsed.title
+          const archiveUserTitle = parsedTitle && parsedTitle.source && parsedTitle.source.kind === 'user'
+            ? parsedTitle.title : null
+          const rawTitle = archiveUserTitle || userTitleOf(home, sessionId) || title || sessionId
           const safeTitle = String(rawTitle).replace(/[\\/:*?"<>|\r\n]/g, '_').slice(0, 60)
           // 组装 ZIP 文件清单：概览 + 时间线分卷（00-概览.md / 01-时间线-回合X-Y.md …）。
           const zipFiles = [{ name: '00-概览.md', data: Buffer.from(overview, 'utf8') }]
@@ -934,7 +974,7 @@ export function apply(ctx) {
           const buildNode = (s) => ({
             id: s.id,
             title: s.title || null,
-            userTitle: userTitleOf(home, s.id),
+            userTitle: effectiveUserTitle(home, s, s.id),
             delegationDepth: s.delegationDepth || 0,
             createdAt: s.createdAt || null,
             lastEventTime: s.lastEventTime || null,
@@ -982,12 +1022,25 @@ export function apply(ctx) {
           }
           const STREAM_MID_TYPES = new Set(['assistant/chunk', 'assistant/message', 'tool/call', 'step/start', 'turn/start', 'user/message', 'request/header'])
           const running = openTurns > 0 || openSteps > 0 || openTools > 0 || STREAM_MID_TYPES.has(lastType)
+          // 卡死监控：健康事实 + 分类。assumeRunning：总览探测以官方 sessions.list 的
+          // running 为准（tail 窗口可能不含 turn/start，结构信号会漏判），此时结构信号只供
+          // openTool/inflight 事实；now 由 client 传入（缺省 host 本地时间）。
+          const now = typeof body.now === 'number' ? body.now : Date.now()
+          const effectiveRunning = running || body.assumeRunning === true
+          const healthFacts = {
+            running: effectiveRunning,
+            lastEventTime: summary.lastEventTime !== undefined ? summary.lastEventTime : null,
+            lastEventType: lastType,
+            openTool: openTools > 0,
+            inflight: lastType === 'assistant/chunk',
+          }
           return sendJson(res, 200, {
             ok: true,
             session: sessionView(summary),
             counts,
             timeline,
             running,
+            health: { ...healthFacts, ...classifyHealth(healthFacts, now) },
           })
         }
 
@@ -1149,18 +1202,19 @@ export function apply(ctx) {
             if (matches.length === 0) continue
             // 标题：索引优先（{title, source} 对象取 .title），无索引时用会话 id。
             let title = c.id
+            let entry = null
             try {
               const index = readIndex(home, c.workspace)
-              const ent = index.sessions && index.sessions[c.id]
-              if (ent && ent.title) {
-                title = typeof ent.title === 'object' ? String(ent.title.title || c.id) : String(ent.title)
+              entry = (index.sessions && index.sessions[c.id]) || null
+              if (entry && entry.title) {
+                title = typeof entry.title === 'object' ? String(entry.title.title || c.id) : String(entry.title)
               }
             } catch {}
             results.push({
               sessionId: c.id,
               workspace: c.workspace,
               title,
-              userTitle: userTitleOf(home, c.id),
+              userTitle: effectiveUserTitle(home, entry, c.id),
               matchCount: matches.length,
               matches: matches.slice(0, SEARCH_MATCHES_PER_SESSION),
             })

package/package.json

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