dsh-session-flow 1.0.0 → 1.2.0

package/lib/host.js

@@ -10,10 +10,11 @@
 //   searchAll { query, workspace? } → 跨会话全文检索（最近 20 会话/总 5s 预算/取消支持）
 //   stats                     → 环境信息（dsh home、索引目录、各工作区缓存状态）
 //
-// 依赖 cordis 服务：webServer（HTTP 载体）。
+// 依赖 cordis 服务：webServer（HTTP 载体）；settings（插件设置命名空间，软依赖）。
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFile } from 'node:fs'
 import { join } from 'node:path'
 import { deflateRawSync } from 'node:zlib'
+import z from 'schemastery'
 import { decodeFile, listSessionDirs, listWorkspaces, looksLikePath, parseSession, summarizeParsed } from './archive.js'
 import { deriveTimeline } from './timeline.js'
 import {
@@ -66,6 +67,97 @@ function sendJson(res, status, obj) {
   res.end(JSON.stringify(obj))
 }
 
+// ── 卡死监控（stall-monitor）：健康分类 ─────────────────────────────
+// 「进行中但长时间无输出」≠ 卡死（模型长思考/长工具执行都静默）。
+// 分类只看结构事实：运行中 + 无流式 chunk + 无未闭合工具 + 静默超阈值 → 疑似卡死。
+// 阈值可在设置页配置（settings 命名空间 session-flow / stallThresholdMin，分钟）；
+// STALL_THRESHOLD_MS 保留为默认值（verify 引用）。
+export const STALL_THRESHOLD_MS = 3 * 60 * 1000
+export const HEALTH_ACTIVE_WINDOW_MS = 60 * 1000
+
+// ── 插件设置（settings 命名空间 'session-flow'）────────────────────
+// 默认值必须与 client.js 的 SETTINGS_DEFAULTS 完全一致（无用户设置时行为零变化）。
+export const SETTINGS_DEFAULTS = {
+  pianoWindow: 12,        // 轮次悬浮条可见行数
+  pianoWheelSpeed: 0.012, // 滚轮灵敏度（行/px）
+  pianoSnapMs: 170,       // 静止吸附延迟（ms）
+  livePollMs: 3000,       // 实时轮询间隔（ms）
+  liveFollowPx: 40,       // 实时吸底阈值（px）
+  liveHistoryTurns: 3,    // 详情页实时模式保留的历史回合数
+  stallThresholdMin: 3,   // 疑似卡死阈值（分钟）
+}
+
+/** schemastery schema：settings 服务 resolve 时调用 schema(merged)，并需要 toJSON()（describe 用）。 */
+const SETTINGS_SCHEMA = z.object({
+  pianoWindow: z.number().step(1).min(6).max(18).default(SETTINGS_DEFAULTS.pianoWindow),
+  pianoWheelSpeed: z.number().min(0.005).max(0.03).default(SETTINGS_DEFAULTS.pianoWheelSpeed),
+  pianoSnapMs: z.number().step(1).min(100).max(400).default(SETTINGS_DEFAULTS.pianoSnapMs),
+  livePollMs: z.number().step(1).min(1500).max(10000).default(SETTINGS_DEFAULTS.livePollMs),
+  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),
+})
+
+/** 解析后的当前设置值（base + user 层）；host 侧消费点（卡死阈值）从这里读。 */
+const liveSettings = { ...SETTINGS_DEFAULTS }
+
+/**
+ * 注册 settings 命名空间（软依赖：宿主无 settings 服务时跳过，行为回退默认值）。
+ * 模式参照 aionui-panel installSettingsSection：ctx.inject(['settings'], ...) +
+ * scope.watch 同步当前值。客户端经 settingsScope 直接读写（pet 同款），无需额外路由。
+ */
+function installSettings(ctx) {
+  try {
+    if (typeof ctx.inject !== 'function') return
+    ctx.inject(['settings'], (sctx) => {
+      try {
+        const scope = sctx.settings.register('session-flow', SETTINGS_SCHEMA, { base: SETTINGS_DEFAULTS })
+        const sync = () => {
+          const value = scope.get()
+          if (value && typeof value === 'object') Object.assign(liveSettings, SETTINGS_DEFAULTS, value)
+        }
+        sync()
+        scope.watch(sync)
+      } catch (error) {
+        console.error('[dsh-session-flow] settings registration failed:', error)
+      }
+    })
+  } catch (error) {
+    console.error('[dsh-session-flow] settings service unavailable:', error)
+  }
+}
+
+/**
+ * 健康分类（纯函数，verify 可测）。
+ * @param {{running:boolean,lastEventTime:number|null,openTool:boolean,inflight:boolean}} facts
+ * @param {number} now - 调用方时间戳（client 传 Date.now()，避免 host/client 时钟偏差语义混乱）。
+ * @param {number} [stallMs] - 卡死阈值（缺省 STALL_THRESHOLD_MS；设置页 stallThresholdMin 下发）。
+ * @returns {{kind:'active'|'tool-wait'|'quiet'|'stalled'|'ended'|'unknown', idleMs:number|null}}
+ */
+export function classifyHealth(facts, now, stallMs = STALL_THRESHOLD_MS) {
+  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 >= stallMs) 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
@@ -593,6 +685,9 @@ export function apply(ctx) {
     return
   }
 
+  // 插件设置命名空间（软依赖；卡死阈值等 host 侧参数经 liveSettings 下发）。
+  installSettings(ctx)
+
   webServer.register({
     kind: 'exact',
     path: '/api/session-flow',
@@ -629,7 +724,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 +812,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 +969,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 +1032,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 +1080,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, liveSettings.stallThresholdMin * 60000) },
           })
         }
 
@@ -1149,18 +1260,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.2.0",
   "type": "module",
   "main": "lib/host.js",
   "exports": {
@@ -42,6 +42,9 @@
       "platform": "web"
     }
   },
+  "dependencies": {
+    "schemastery": "^3.18.0"
+  },
   "peerDependencies": {
     "react": "^18.2.0",
     "react-dom": "^18.2.0",