dsh-session-flow 0.1.0 → 1.1.0

package/lib/host.js

@@ -7,13 +7,14 @@
 //   get     { sessionId }     → 轻量详情（回合摘要 + 工具统计，秒开）
 //   getTurn { sessionId, turn } → 展开回合时按需取完整时间线
 //   searchIn { sessionId, query } → 会话内全文检索（匹配位置列表）
+//   searchAll { query, workspace? } → 跨会话全文检索（最近 20 会话/总 5s 预算/取消支持）
 //   stats                     → 环境信息（dsh home、索引目录、各工作区缓存状态）
 //
 // 依赖 cordis 服务：webServer（HTTP 载体）。
 import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFile } from 'node:fs'
 import { join } from 'node:path'
 import { deflateRawSync } from 'node:zlib'
-import { decodeFile, listWorkspaces, looksLikePath, parseSession, summarizeParsed } from './archive.js'
+import { decodeFile, listSessionDirs, listWorkspaces, looksLikePath, parseSession, summarizeParsed } from './archive.js'
 import { deriveTimeline } from './timeline.js'
 import {
   dshHome,
@@ -24,6 +25,7 @@ import {
   workspaceIndexFile,
   writeIndex,
 } from './index-store.js'
+import { applyRename, MAX_RENAME_LENGTH, saveRenames, userTitleOf } from './renames.js'
 
 export const name = 'dsh-session-flow'
 
@@ -64,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
@@ -627,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(sessionView)
+              .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({
@@ -653,6 +692,27 @@ export function apply(ctx) {
           })
         }
 
+        if (method === 'rename') {
+          // M8a 会话重命名：私有 userTitle 显示层覆盖（不动原始存档）。
+          // 空标题 = 清除恢复原名；超长 400；会话不存在 404；落盘失败回滚 + 500。
+          const sessionId = String(body.sessionId || '')
+          if (!sessionId) return sendJson(res, 400, { ok: false, error: 'sessionId required' })
+          const found = findWorkspaceOfSession(home, sessionId)
+          if (found === null) return sendJson(res, 404, { ok: false, error: `session ${sessionId} not found in archives` })
+          const raw = typeof body.title === 'string' ? body.title : ''
+          const trimmed = raw.trim()
+          if (trimmed.length > MAX_RENAME_LENGTH) {
+            return sendJson(res, 400, { ok: false, error: `title too long (max ${MAX_RENAME_LENGTH} chars)` })
+          }
+          const previous = userTitleOf(home, sessionId)
+          const userTitle = applyRename(home, sessionId, trimmed)
+          if (!saveRenames(home)) {
+            applyRename(home, sessionId, previous || '')
+            return sendJson(res, 500, { ok: false, error: 'failed to persist renames.json' })
+          }
+          return sendJson(res, 200, { ok: true, userTitle })
+        }
+
         if (method === 'get') {
           // 轻量详情（秒开）：只返回回合摘要 + 工具统计；完整时间线由 getTurn 按需取。
           const sessionId = String(body.sessionId || '')
@@ -694,6 +754,7 @@ export function apply(ctx) {
             workspaceLabel: wsMeta.label,
             workspaceCwd: wsMeta.cwd,
             session: sessionView(sum),
+            userTitle: effectiveUserTitle(home, sum, sessionId),
             counts,
             lightTurns: entry.lightTurns,
             toolStats: entry.toolStats,
@@ -850,7 +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 })
-          const rawTitle = 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') }]
@@ -909,6 +974,7 @@ export function apply(ctx) {
           const buildNode = (s) => ({
             id: s.id,
             title: s.title || null,
+            userTitle: effectiveUserTitle(home, s, s.id),
             delegationDepth: s.delegationDepth || 0,
             createdAt: s.createdAt || null,
             lastEventTime: s.lastEventTime || null,
@@ -956,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) },
           })
         }
 
@@ -1036,6 +1115,122 @@ export function apply(ctx) {
           return sendJson(res, 200, { ok: true, query, count: matches.length, matches })
         }
 
+        if (method === 'searchAll') {
+          // 方向 A：跨会话全文检索（内容级召回，复用 searchIn 的扫描语义）。
+          // 约束（PERF-ANALYSIS §2A）：按 lastEventTime（文件 mtime）取最近 SEARCH_MAX_SESSIONS
+          // 个会话；超大文件跳过；总时间预算 SEARCH_TIME_BUDGET_MS，超时返回已扫部分 + hasMore；
+          // 请求中止（req aborted）即停；搜索词 ≥2 字符；workspace 可选过滤。
+          // 每会话：cachedSession（缓存优先）→ 自由文本扫描（用户/助手/思考/工具名/参数/结果）
+          // → matchCount 全量统计（排序依据）+ 返回前 SEARCH_MATCHES_PER_SESSION 条命中。
+          const query = String(body.query || '').trim()
+          if (query.length < 2) return sendJson(res, 400, { ok: false, error: 'query must be at least 2 characters' })
+          const q = query.toLowerCase()
+          const wsFilter = body.workspace ? String(body.workspace) : ''
+          const SEARCH_MAX_SESSIONS = 20
+          const SEARCH_MATCHES_PER_SESSION = 5
+          const SEARCH_TIME_BUDGET_MS = 5000
+          const SEARCH_MAX_FILE_MB = 50
+
+          // 枚举会话（mtime 降序 = 最近活动优先）。
+          const candidates = []
+          for (const ws of listWorkspaces(home)) {
+            if (wsFilter && ws.name !== wsFilter) continue
+            for (const s of listSessionDirs(ws.dir)) {
+              candidates.push({ id: s.id, file: s.file, mtimeMs: s.mtimeMs, sizeBytes: s.sizeBytes, workspace: ws.name })
+            }
+          }
+          candidates.sort((a, b) => b.mtimeMs - a.mtimeMs)
+          const selected = candidates.slice(0, SEARCH_MAX_SESSIONS)
+
+          const started = Date.now()
+          const results = []
+          let scanned = 0
+          let aborted = false
+          req.on('aborted', () => { aborted = true })
+
+          for (const c of selected) {
+            if (aborted) break
+            if (Date.now() - started > SEARCH_TIME_BUDGET_MS) break
+            // 超大文件跳过（异常会话，避免单会话拖垮总预算）。
+            if (c.sizeBytes > SEARCH_MAX_FILE_MB * 1024 * 1024) continue
+            let turns
+            try {
+              const entry = cachedSession(home, c.id, c.file, c.mtimeMs, c.sizeBytes)
+              turns = entry.turns
+            } catch {
+              continue
+            }
+            if (!Array.isArray(turns) || turns.length === 0) continue
+            scanned++
+            const matches = []
+            const snippet = (text, needle) => {
+              const t = String(text || '')
+              const i = t.toLowerCase().indexOf(needle)
+              if (i < 0) return t.slice(0, 100)
+              const start = Math.max(0, i - 30)
+              return (start > 0 ? '…' : '') + t.slice(start, i + needle.length + 60) + (i + needle.length + 60 < t.length ? '…' : '')
+            }
+            for (const t of turns) {
+              for (const u of t.userMessages) {
+                if (u.text.toLowerCase().includes(q)) {
+                  matches.push({ kind: 'user', turn: t.turn, seq: u.seq, preview: snippet(u.text, q) })
+                }
+              }
+              for (const a of t.assistantMessages) {
+                if (a.hasThinking && a.thinking.toLowerCase().includes(q)) {
+                  matches.push({ kind: 'thinking', turn: t.turn, seq: a.seq, preview: snippet(a.thinking, q) })
+                }
+                if (a.hasText && a.text.toLowerCase().includes(q)) {
+                  matches.push({ kind: 'assistant', turn: t.turn, seq: a.seq, preview: snippet(a.text, q) })
+                }
+              }
+              for (const s of t.steps) {
+                for (const call of s.toolCalls) {
+                  const argsLower = call.argumentsText.toLowerCase()
+                  const resLower = call.resultText.toLowerCase()
+                  if (call.name.toLowerCase().includes(q) || argsLower.includes(q) || resLower.includes(q)) {
+                    const inArgs = argsLower.includes(q)
+                    matches.push({
+                      kind: call.isError === true ? 'error' : 'tool',
+                      turn: t.turn, callId: call.callId, name: call.name,
+                      preview: snippet(inArgs ? call.argumentsText : call.resultText, q) || call.resultPreview,
+                    })
+                  }
+                }
+              }
+            }
+            if (matches.length === 0) continue
+            // 标题：索引优先（{title, source} 对象取 .title），无索引时用会话 id。
+            let title = c.id
+            let entry = null
+            try {
+              const index = readIndex(home, c.workspace)
+              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: effectiveUserTitle(home, entry, c.id),
+              matchCount: matches.length,
+              matches: matches.slice(0, SEARCH_MATCHES_PER_SESSION),
+            })
+          }
+          results.sort((a, b) => b.matchCount - a.matchCount)
+          const hasMore = scanned < selected.length && !aborted
+          return sendJson(res, 200, {
+            ok: true,
+            query,
+            scanned,
+            total: selected.length,
+            hasMore,
+            results,
+          })
+        }
+
         if (method === 'cacheInfo') {
           // 缓存管理：统计索引与时间线缓存的体积/数量。
           const root = indexRoot(home)

package/lib/index-store.js

@@ -23,7 +23,7 @@ export function workspaceIndexFile(home, wsName) {
 }
 
 /** 索引格式版本：升级时旧缓存会被自动全量重扫一次（避免字段缺失）。 */
-const INDEX_VERSION = 3
+const INDEX_VERSION = 4
 
 export function readIndex(home, wsName) {
   try {

package/lib/renames.js

@@ -0,0 +1,80 @@
+// lib/renames.js — M8a 会话重命名存储：<indexRoot>/renames.json
+//
+// 与索引/时间线缓存生命周期**解耦**（缓存管理「清理全部缓存」会重建索引，
+// 重命名是用户资产不能丢——设计见 docs/02-design/RENAME.md）。
+// 格式：{ version: 1, items: { [sessionId]: { title, updatedAt } } }
+// 原子写（tmp + rename）+ 损坏容错（空表 + 警告，不阻塞任何接口）。
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { indexRoot } from './index-store.js'
+
+export const RENAMES_VERSION = 1
+export const MAX_RENAME_LENGTH = 120
+
+const renames = new Map() // sessionId -> { title, updatedAt }
+let loaded = false
+
+export function renamesFile(home) {
+  return join(indexRoot(home), 'renames.json')
+}
+
+/** 惰性加载：首次访问读盘；损坏 → 空表 + 警告（不抛，不阻塞）。 */
+export function loadRenames(home) {
+  if (loaded) return renames
+  loaded = true
+  try {
+    if (!existsSync(renamesFile(home))) return renames
+    const raw = JSON.parse(readFileSync(renamesFile(home), 'utf8'))
+    if (raw && typeof raw === 'object' && raw.items && typeof raw.items === 'object') {
+      for (const [id, item] of Object.entries(raw.items)) {
+        if (item && typeof item.title === 'string' && item.title) {
+          renames.set(id, { title: item.title, updatedAt: Number(item.updatedAt) || 0 })
+        }
+      }
+    }
+  } catch (error) {
+    console.warn('[dsh-session-flow] renames.json 读取失败，按空表处理:', error && error.message)
+  }
+  return renames
+}
+
+/** 原子写盘；失败仅告警（内存态保留，由调用方决定是否回滚）。 */
+export function saveRenames(home) {
+  try {
+    const dir = indexRoot(home)
+    if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
+    const file = renamesFile(home)
+    const tmp = `${file}.tmp`
+    writeFileSync(tmp, JSON.stringify({ version: RENAMES_VERSION, items: Object.fromEntries(renames) }, null, 2))
+    renameSync(tmp, file)
+    return true
+  } catch (error) {
+    console.warn('[dsh-session-flow] renames.json 写盘失败:', error && error.message)
+    return false
+  }
+}
+
+/** 设置/清除自定义标题：title 为 null/空 → 清除；返回新值（string|null）。 */
+export function applyRename(home, sessionId, title) {
+  loadRenames(home)
+  const trimmed = typeof title === 'string' ? title.trim() : ''
+  if (trimmed === '') {
+    renames.delete(sessionId)
+  } else {
+    renames.set(sessionId, { title: trimmed, updatedAt: Date.now() })
+  }
+  return trimmed === '' ? null : trimmed
+}
+
+/** 取自定义标题（string|null）。 */
+export function userTitleOf(home, sessionId) {
+  loadRenames(home)
+  const item = renames.get(sessionId)
+  return item && item.title ? item.title : null
+}
+
+/** 供 verify 直连测试：重置模块态。 */
+export function _resetRenamesForTest() {
+  renames.clear()
+  loaded = false
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-session-flow",
-  "description": "会话信息流重设计插件：折叠汇总 + 会话总览归档 + 深链跳转 + 子代理血缘树 + 摘要引擎（规则/LLM 双模式），实时复用原生轨迹数据",
-  "version": "0.1.0",
+  "description": "DSH 会话回顾与归档插件：可折叠信息流 + 会话级汇总——总览工作台、折叠时间线、血缘树、双模式摘要、全文检索、ZIP 导出、实时跟踪、会话重命名（官方数据源对齐）、健康监控",
+  "version": "1.1.0",
   "type": "module",
   "main": "lib/host.js",
   "exports": {
@@ -14,7 +14,8 @@
     "lib/",
     "cordis.patch.yml",
     "README.md",
-    "README.en.md"
+    "README.en.md",
+    "assets/screenshots/"
   ],
   "keywords": [
     "dsh",