dsh-manage-session 0.4.8 → 0.5.3

package/locale/de.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Sitzungs-Verwalter",
+    "description": "Sitzungsverlaufsdateien (Archivansicht und Bereinigung) und Sitzungs-Health-Check (Untersuchung → Rezept → Entlassung); keine Eingriffe in Sitzungsprotokolle, nur umkehrbare Vorgänge."
+  }
+}

package/locale/en.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Session Steward",
+    "description": "Session history files (archive browsing & cleanup) and session health checks (checkup → prescription → discharge) — reversible operations only, no touching of session logs."
+  }
+}

package/locale/es.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Mayordomo de sesión",
+    "description": "Archivos de historial de sesión (visualización y limpieza del archivo) y comprobación de salud de las sesiones (revisión → receta → alta); no toca los registros de sesión, solo operaciones reversibles."
+  }
+}

package/locale/fr.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Intendant de session",
+    "description": "Fichiers d'historique de session (consultation et nettoyage des archives) et contrôle de santé des sessions (examen → ordonnance → sortie) ; aucune modification des journaux de session, opérations réversibles uniquement."
+  }
+}

package/locale/it.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Amministratore di sessione",
+    "description": "File della cronologia delle sessioni (consultazione e pulizia degli archivi) e controllo di salute delle sessioni (visita → prescrizione → dimissione); non tocca i log di sessione, solo operazioni reversibili."
+  }
+}

package/locale/ja.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "セッションスチュワード",
+    "description": "セッション履歴ファイル（アーカイブの閲覧とクリーンアップ）とセッションのヘルスチェック（健診 → 処方 → 退院）。セッションログには触れず、可逆的な操作のみを行います。"
+  }
+}

package/locale/ko.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "세션 스튜어드",
+    "description": "세션 기록 파일(아카이브 탐색 및 정리)과 세션 건강 점검(진료 → 처방 → 퇴원). 세션 로그는 건드리지 않으며 되돌릴 수 있는 작업만 수행합니다."
+  }
+}

package/locale/ru.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "Распорядитель сессий",
+    "description": "Файлы истории сессий (просмотр и очистка архивов) и проверка здоровья сессий (осмотр → рецепт → выписка); не затрагивает журналы сессий, только обратимые операции."
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "会话管家",
+    "description": "会话历史文件（归档浏览与清理）与会话健康检查（体检 → 处方 → 出院），不碰会话日志、只做可逆处置。"
+  }
+}

package/package.json

@@ -1,18 +1,24 @@
 {
   "name": "dsh-manage-session",
-  "version": "0.4.8",
+  "version": "0.5.3",
   "publishConfig": {
-    "tag": "dsh-0.1.7"
+    "registry": "https://registry.npmjs.org",
+    "tag": "latest",
+    "access": "public"
   },
-  "description": "DSH Web 插件（DSH 0.1.5 专线）：会话管家 —— 会话历史文件（归档浏览与清理）与会话健康检查（体检 → 处方 → 出院），不碰会话日志、只做可逆处置",
+  "description": "DSH Web 插件：会话管家（合并包）—— 会话历史文件（归档浏览与清理）与健康检查（体检 → 处方 → 出院），外加独立 FTS5 会话内容搜索索引（标题/内容双模式、增量同步、非破坏性整理与快照导入导出）。不碰会话日志、只做可逆处置。",
   "keywords": [
+    "archive",
     "deepseek-harness",
+    "doctor",
     "dsh",
     "dsh-plugin",
-    "session",
-    "archive",
+    "fts5",
     "health",
-    "doctor"
+    "index",
+    "search",
+    "session",
+    "sqlite"
   ],
   "repository": {
     "type": "git",
@@ -30,6 +36,7 @@
       "default": "./lib/client.js"
     },
     "./cordis.patch.yml": "./cordis.patch.yml",
+    "./locale/*.json": "./locale/*.json",
     "./package.json": "./package.json"
   },
   "dsh": {
@@ -47,46 +54,47 @@
   },
   "scripts": {
     "build": "node -e \"require('fs').rmSync('lib',{recursive:true,force:true})\" && tsc -b && tsdown",
-    "prepublishOnly": "npm run build",
+    "prepack": "npm run build",
+    "prepublishOnly": "npm run build && node scripts/check-release.mjs",
     "typecheck": "tsc -b --pretty false",
     "test": "vitest run",
-    "release:015": "npm publish --tag dsh-0.1.5"
+    "test:client": "node tests/client-store.test.mjs && node tests/client-panel-key.test.mjs && node tests/client-styles.test.mjs && node --import tsx tests/client-platform.test.mjs && node --import tsx tests/client-host-api.test.mjs && node --import tsx tests/client-locales.test.mjs && node --import tsx tests/client-open-session.test.mjs",
+    "test:release": "node scripts/check-release.mjs"
   },
   "files": [
-    "lib/index.js",
-    "lib/index.d.ts",
-    "lib/client.js",
-    "src",
-    "cordis.patch.yml",
-    "dsh.plugin.json",
-    "screenshots.json",
-    "README.md",
+    "CHANGELOG.ja.md",
+    "CHANGELOG.ko.md",
+    "CHANGELOG.md",
+    "INSTALL.ja.md",
+    "INSTALL.ko.md",
+    "INSTALL.md",
+    "INSTALL.zh.md",
+    "LICENSE",
     "README.en.md",
     "README.ja.md",
     "README.ko.md",
-    "INSTALL.md",
-    "INSTALL.zh.md",
-    "INSTALL.ja.md",
-    "INSTALL.ko.md",
-    "CHANGELOG.md",
-    "CHANGELOG.ja.md",
-    "CHANGELOG.ko.md",
-    "LICENSE"
+    "README.md",
+    "cordis.patch.yml",
+    "dsh.plugin.json",
+    "lib",
+    "locale",
+    "screenshots.json",
+    "src"
   ],
   "engines": {
     "node": ">=20",
-    "dsh": ">=0.1.7-rc.1 <0.1.8-0"
+    "dsh": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1"
   },
   "license": "MIT",
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": ">=0.1.7-rc.1 <0.1.8-0",
-    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-rc.1 <0.1.8-0",
-    "@deepseek-ai/dsh-client-ui-settings-general": ">=0.1.7-rc.1 <0.1.8-0",
-    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.1 <0.1.8-0",
+    "@deepseek-ai/dsh-client-locale": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-settings-general": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1",
     "@deepseek-ai/schemastery": "^3.18.4",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-session": ">=0.1.7-rc.1 <0.1.8-0"
+    "@deepseek-ai/dsh-session": "0.1.0-rc.2 || 0.1.0-rc.3 || 0.1.0-rc.6 || 0.1.0-rc.7 || 0.1.0-rc.8 || 0.1.1-rc.1 || 0.1.1-rc.2 || 0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-rc.1"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-client-locale": {
@@ -107,7 +115,7 @@
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-rc.1",
     "@deepseek-ai/schemastery": "^3.18.4",
     "@types/node": "^24.0.0",
     "@types/react": "~18.3.1",
@@ -120,6 +128,9 @@
     "typescript": "^5.6.0",
     "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^4.1.1",
-    "@deepseek-ai/dsh-session": "^0.1.7-rc.1"
+    "@deepseek-ai/dsh-session": "0.2.1-rc.1"
+  },
+  "optionalDependencies": {
+    "better-sqlite3": "12.11.1"
   }
 }

package/src/client/bridge-scope.ts

@@ -0,0 +1,213 @@
+/**
+ * Legacy 设置桥 scope（客户端半身，≤0.1.5 专用）。
+ *
+ * 为什么存在：旧宿主的 `settingsScope.bind()` 是数据死路（台账 A2——scope
+ * status 永远 'unavailable'，永不就绪），卡在老线上只剩「不可用」空壳。本
+ * 模块把卡片数据面改走自家 webServer 桥（`settings-describe`/`settings-mutate`，
+ * 宿主半落在 legacy settings 租约上，context-compression 六格实证的持久化
+ * 写路径）。0.1.7+ 不走此路——client/index.ts 的回退链里 configForms 原生
+ * 句柄优先，桥只是 legacy 兜底。
+ *
+ * 形状纪律：快照对象只在状态真正变化时更换引用（useSyncExternalStore 的
+ * getSnapshot 缓存语义）；describe 在首个 subscribe 时才发起（bundle 级
+ * 无头测试只调 getSnapshot、不 subscribe，绝不触发 fetch）。
+ */
+import type { StewardConfig } from '../config.ts'
+import type { SwitchSearchConfig } from '../config.ts'
+import { callHostAny } from './host-api.ts'
+
+/** 与宿主 settings-bridge.ts 的命名空间键一致（存储键稳定承诺）。 */
+const STEWARD_NS = 'session-steward'
+const SEARCH_NS = 'switch-search'
+
+/** 单视图快照（StewardCardScope / SwitchCardScope 的结构交集）。 */
+export interface BridgeSnapshot<V> {
+  status: 'loading' | 'ready' | 'unavailable'
+  value: V | undefined
+  revision: number | undefined
+  writable: boolean
+}
+
+/** 卡片 scope 面（两张卡各自的结构化镜像的交集）。 */
+export interface BridgeScope<V> {
+  getSnapshot(): BridgeSnapshot<V>
+  subscribe(listener: () => void): () => void
+  set(field: string, value: unknown): Promise<void>
+}
+
+/** 共享文档仓：两视图读同一份 describe/mutate 结果。 */
+interface SharedDoc {
+  steward: Record<string, unknown>
+  search: Record<string, unknown>
+  status: 'loading' | 'ready' | 'unavailable'
+  writable: boolean
+  revision: number | undefined
+}
+
+const shared: SharedDoc = {
+  steward: {},
+  search: {},
+  status: 'loading',
+  writable: false,
+  revision: undefined,
+}
+
+const listeners = new Set<() => void>()
+let describeInFlight: Promise<void> | undefined
+
+function notify(): void {
+  for (const listener of [...listeners]) {
+    try {
+      listener()
+    } catch {
+      /* 单个订阅者异常绝不破坏其余通知 */
+    }
+  }
+}
+
+function replaceDoc(next: Partial<SharedDoc>): void {
+  Object.assign(shared, next)
+  notify()
+}
+
+/** 首个订阅触发一次 describe；并发调用共享同一 in-flight promise。 */
+function ensureDescribe(): Promise<void> {
+  if (describeInFlight !== undefined) return describeInFlight
+  describeInFlight = callHostAny<{ ok?: boolean; writable?: boolean; revision?: number; namespaces?: Record<string, Record<string, unknown>>; error?: string }>(
+    'settings-describe',
+    {},
+  )
+    .then((res) => {
+      if (res.ok === true && res.namespaces !== null && typeof res.namespaces === 'object') {
+        replaceDoc({
+          steward: res.namespaces[STEWARD_NS] ?? {},
+          search: res.namespaces[SEARCH_NS] ?? {},
+          status: 'ready',
+          writable: res.writable === true,
+          revision: typeof res.revision === 'number' ? res.revision : undefined,
+        })
+      } else {
+        replaceDoc({ status: 'unavailable', writable: false })
+      }
+    })
+    .catch(() => {
+      replaceDoc({ status: 'unavailable', writable: false })
+    })
+    .finally(() => {
+      describeInFlight = undefined
+    })
+  return describeInFlight
+}
+
+/** 组装一个视图 scope。`ns` 决定读/写哪个命名空间文档。 */
+function makeBridgeScope<V extends object>(
+  ns: string,
+  keyOf: (doc: SharedDoc) => Record<string, unknown>,
+): BridgeScope<V> {
+  let snapshot: BridgeSnapshot<V> = { status: 'loading', value: undefined, revision: undefined, writable: false }
+
+  const refresh = (): void => {
+    const next: BridgeSnapshot<V> = {
+      status: shared.status,
+      value: (shared.status === 'ready' ? { ...keyOf(shared) } : undefined) as V | undefined,
+      revision: shared.revision,
+      writable: shared.writable,
+    }
+    const changed =
+      next.status !== snapshot.status ||
+      next.writable !== snapshot.writable ||
+      next.revision !== snapshot.revision ||
+      JSON.stringify(next.value ?? null) !== JSON.stringify(snapshot.value ?? null)
+    if (changed) {
+      snapshot = next
+    }
+  }
+
+  return {
+    getSnapshot: () => {
+      // 每次读取都先对账共享仓再回缓存（引用稳定性由 refresh 的变更检测保证）；
+      // 裸读（无 subscribe）只重算缓存，绝不触发 fetch。
+      refresh()
+      return snapshot
+    },
+    subscribe: (listener) => {
+      listeners.add(listener)
+      void ensureDescribe()
+      return () => {
+        listeners.delete(listener)
+      }
+    },
+    set: async (field, value) => {
+      if (shared.status !== 'ready' || shared.writable === false) {
+        throw new Error('设置桥不可写（describe 未就绪或宿主只读）')
+      }
+      const before = keyOf(shared)[field]
+      // 乐观回显：开关即时翻转，权威值由 mutate 响应修正。
+      keyOf(shared)[field] = value
+      refresh()
+      const res = await callHostAny<{ ok?: boolean; revision?: number; namespaces?: Record<string, Record<string, unknown>>; error?: string }>(
+        'settings-mutate',
+        { ns, fields: { [field]: value } },
+      )
+      if (res.ok === true && res.namespaces !== null && typeof res.namespaces === 'object') {
+        replaceDoc({
+          steward: res.namespaces[STEWARD_NS] ?? shared.steward,
+          search: res.namespaces[SEARCH_NS] ?? shared.search,
+          revision: typeof res.revision === 'number' ? res.revision : shared.revision,
+        })
+      } else {
+        // 失败回滚：开关弹回 = 用户可见的失败信号。
+        keyOf(shared)[field] = before
+        refresh()
+        throw new Error(res.error ?? '设置写入失败')
+      }
+    },
+  }
+}
+
+let stewardScope: BridgeScope<StewardConfig> | undefined
+let searchScope: BridgeScope<SwitchSearchConfig> | undefined
+
+/** 管家卡/管家入口的桥 scope（命名空间 session-steward）。 */
+export function stewardBridgeScope(): BridgeScope<StewardConfig> {
+  stewardScope ??= makeBridgeScope<StewardConfig>(STEWARD_NS, (doc) => doc.steward)
+  return stewardScope
+}
+
+/** 搜索卡/搜索入口的桥 scope（命名空间 switch-search）。 */
+export function searchBridgeScope(): BridgeScope<SwitchSearchConfig> {
+  searchScope ??= makeBridgeScope<SwitchSearchConfig>(SEARCH_NS, (doc) => doc.search)
+  return searchScope
+}
+
+/**
+ * 原生句柄 + 桥的合成 scope：原生快照**在任意时刻**观测到 unavailable（出生
+ * 死或 loading→死，0.1.7 上 steward 条目的 configForms 实测后者）就地读桥，
+ * 不做 apply 期时序猜测。写侧同理：原生 unavailable 即走桥（桥在无 legacy
+ * settings 服务的宿主上 set 会显式拒绝，卡片保持只读真值）。双订阅：桥的
+ * describe 全页一次（模块单例），代价可忽略。
+ */
+export function withBridgeFallback<V extends object>(
+  native: BridgeScope<V> | undefined,
+  bridge: BridgeScope<V>,
+): BridgeScope<V> {
+  if (native === undefined) return bridge
+  return {
+    getSnapshot: () => {
+      const snap = native.getSnapshot()
+      return snap.status === 'unavailable' ? bridge.getSnapshot() : snap
+    },
+    subscribe: (listener) => {
+      const offNative = native.subscribe(listener)
+      const offBridge = bridge.subscribe(listener)
+      return () => {
+        offNative()
+        offBridge()
+      }
+    },
+    set: async (field, value) => {
+      if (native.getSnapshot().status === 'unavailable') return bridge.set(field, value)
+      return native.set(field, value)
+    },
+  }
+}