dsh-session-flow 1.1.0 → 1.3.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 {
@@ -69,17 +70,77 @@ function sendJson(res, status, obj) {
 // ── 卡死监控（stall-monitor）：健康分类 ─────────────────────────────
 // 「进行中但长时间无输出」≠ 卡死（模型长思考/长工具执行都静默）。
 // 分类只看结构事实：运行中 + 无流式 chunk + 无未闭合工具 + 静默超阈值 → 疑似卡死。
-// TODO(设置页待办)：STALL_THRESHOLD_MS 待插件设置页落地后可配置化（见 docs HANDOVER §7）。
+// 阈值可在设置页配置（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,   // 疑似卡死阈值（分钟）
+  railEnhance: true,      // 官方轮次导航（TurnNavigatorRail）增强层开关（v0.1.2+）
+  railHideOfficial: false, // 完全屏蔽官方轮次导航（只留我们的悬浮条）
+  pianoClassicStrip: true, // 经典左侧轮次悬浮条（默认开，与官方 rail 并存；用户裁定 2026-09-05）
+}
+
+/** 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),
+  railEnhance: z.boolean().default(SETTINGS_DEFAULTS.railEnhance),
+  railHideOfficial: z.boolean().default(SETTINGS_DEFAULTS.railHideOfficial),
+  pianoClassicStrip: z.boolean().default(SETTINGS_DEFAULTS.pianoClassicStrip),
+})
+
+/** 解析后的当前设置值（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) {
+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 }
@@ -88,7 +149,7 @@ export function classifyHealth(facts, now) {
   // 有未闭合工具调用 → 静默是工具在执行（长跑命令正常），不算卡死。
   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 }
+  if (idleMs >= stallMs) return { kind: 'stalled', idleMs }
   return { kind: 'quiet', idleMs }
 }
 
@@ -630,6 +691,9 @@ export function apply(ctx) {
     return
   }
 
+  // 插件设置命名空间（软依赖；卡死阈值等 host 侧参数经 liveSettings 下发）。
+  installSettings(ctx)
+
   webServer.register({
     kind: 'exact',
     path: '/api/session-flow',
@@ -1040,7 +1104,7 @@ export function apply(ctx) {
             counts,
             timeline,
             running,
-            health: { ...healthFacts, ...classifyHealth(healthFacts, now) },
+            health: { ...healthFacts, ...classifyHealth(healthFacts, now, liveSettings.stallThresholdMin * 60000) },
           })
         }
 

package/package.json

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