dsh-session-steward（会话管家 / Session Steward）

DSH Web 插件：会话历史文件 + 会话健康检查。它只做两件事，且都不碰会话数据本身：

• 病案室（会话历史文件）：浏览官方归档集合、批量清理（备份 + 原子替换，需重启宿主生效）。
• 体检（健康检查 / 会话医生）：四门体检 → 处方（命令清单）→ 出院（可逆处置 + before/after 对照）。

命名边界：本插件不提供搜索与索引。搜索/独立索引属于另一片（dsh-search-index）， 两侧互不出现对方的子域字眼，也不互相解释对方字段。

安装

dsh plugin --profile web add dsh-session-steward
# 或本地开发目录
dsh plugin --profile web add "link:E:/test/rewrite-agently/mine-dsh-plugins/dsh-session-steward"

安装后必须重启宿主进程（仅刷新页面无效）。

路由契约

前缀 /session-steward/api，方法名一律 session-*（不得与搜索索引的 index-* 混用）； 未识别的方法返回显式错误，绝不静默。

方法	子域	作用
session-history-list	history	列出官方归档集合（含来源与降级标注）
session-history-prune	history	从归档数组批量移除 id（自动备份，需重启）
session-health-status	health	开关状态与方法表（面板轮询用）
session-health-scan	health	批量体检（默认只返回非 ok 的会话）
session-health-session	health	单会话四门报告 + 处方
session-health-repair	health	可逆处置（隔离投影缓存记录）+ before/after

设置命名空间：session-steward；侧边栏入口 id：dsh-session-steward。

两个开关（feature gate）

开关	字段	关闭效果
会话历史文件	historyFiles（默认 true）	不注册 session-history-*，不渲染「病案室」页签
健康检查	healthCheck（默认 true）	不注册 session-health-*，不渲染「体检」页签

关闭时对应方法返回 { ok: false, error: '子域已关闭（…=false）：<method> 未注册' }，不留空壳。

四门体检

gate	判据	level
log-integrity	zstd 多帧扫描 → provenance 展开 → 打包行解包；seq 连续、无撕裂尾帧	有读取问题 fail；仅撕裂尾帧 warn
projection-cache	~/.dsh/storages/session_projcache/sessions/<id>.json 的 minSeq 与日志末 seq 的 lag + 未结算字段（openStep / activeStep.active / pendingTurnStart / turnBoundary=start）	滞后且未结算 fail；任一 warn
lossless-json	热态 sessionProjections.checkpoint(session) 逐行判定无损 JSON（undefined / 非有限数 / -0 / 稀疏洞 / 非普通原型 / 函数·Symbol·BigInt / 环）	命中 fail，并给出投影 key → 归属包
cold-read	最后 turn/end 的原因、是否存在未收尾 open step、最后 user 消息之后是否还有 assistant 输出	open step fail；interrupted/无 turn/end warn

处方只给三件可逆的事：① 隔离损坏的投影缓存记录（先备份）② 含未结算 step 时提示等待宿主结算 ③ 输出可执行命令清单。 禁止：改写会话日志、改历史数据、静默丢弃字段。

与 dsh-search-index 的唯一契约

归档文件格式（~/.dsh/storages/workspace.json 的 global.archivedSessionIds）： 本插件写、搜索索引只读。格式说明见 dsh-docs-deliverables/dsh-归档文件格式契约-20260914.md。

开发

pnpm install
pnpm typecheck     # tsc -b --pretty false
pnpm test          # vitest run
pnpm build         # tsc -b && tsdown → lib/index.js + lib/client.js

许可

MIT