dsh-manage-session

dsh plugin --profile web add dsh-manage-session

dsh-manage-session（会话管理台 / Session Manager）

原名：dsh-session-steward（会话管家）。本仓库自 2.0.0 起改名为 dsh-manage-session，

并把搜索/索引能力拆回 dsh-search-index。

DSH Web 插件：活跃与归档会话的统一管理台 + 四门体检。

• 管理（主页面） —— 按工作区分组列出活跃 + 归档会话：域筛选（全部 / 活跃 / 归档）、

标题过滤、收藏，勾选后批量执行三个互不等价的操作 —— 归档、取消归档、

清理归档文件（真删磁盘，不可逆）。每行给出标题、工作区与时间。

• 体检（备用页签） —— 四门体检 → 处方（命令清单）→ 出院（可逆处置 + before/after）。

只做可逆处置：不改写会话日志、不改历史数据、不静默丢字段。

本包不含搜索/索引，也不依赖 DRS：会话检索（标题 / 内容 FTS5、命中定位）由

dsh-search-index 提供，DRS（dsh-reference-session-collector）依赖也在那边。

管理台的语料由 session-catalog 现场从宿主 sessionQuery + 官方归档集合拼装。

入口位次（顶栏工具槽 / 底栏回落）

宿主能力 · 入口形态

侧栏声明了顶部工具行槽位（sidebar.panellist 面板行 + main 整页槽，0.1.7+/0.2.x 的「插件 / 更多」工具行） · 入口作为面板行落在「插件」行之后、「更多」启动器之前（order 6），行内 icon + 文案默认左对齐；点击在主栏整页打开，页内「关闭」回到会话

宿主没有该槽位（老线 / 精简布局） · 回落侧栏底栏 sidebar.footer.action，点击开浮动对话框

判定在装载时做（inject 探测两席位是否已声明）；宿主稍后才声明槽位时，底栏入口会就地撤下

并切换到顶栏，不会两份并存。两路都受设置开关驱动，开关翻转即时生效。

<!-- hosts-sync:begin -->

<!-- 由 scripts/sync-hosts.mjs 生成，勿手改；单源在 scripts/hosts.mjs -->

支持 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、0.2.1-rc.2、0.2.1-rc.3、0.2.1-rc.4、0.2.1-rc.5、0.2.2-rc.1（枚举 peer，逐 rc 实测白名单；alpha/beta 不在支持范围）。

<!-- hosts-sync:end -->

截图

当前形态 —— 入口在侧栏顶部工具行（「插件」之后、「更多」之前），点开是会话管理台：

按工作区分组的三列卡片、工作区与检索域（全部 / 活跃 / 归档）筛选、收藏，

以及勾选后的批量归档 · 取消归档 · 清理（不可逆需二次确认）：

历史形态（仅作沿革对照，非当前界面）：

合并包时代（1.x：含搜索，双页签对话框，已退场） · 更早（≤0.5.7：入口在侧栏底部）

 · 

安装

dsh plugin --profile web add dsh-manage-session
# 或本地 tgz
dsh plugin --profile web add "file:E:/test/rewrite-agently/mine-dsh-plugins/dsh-manage-session/dsh-manage-session-2.0.0.tgz"

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

路由契约

前缀 /manage-session/api，方法名一律 session-*；未识别的方法返回显式错误，绝不静默。

方法 · 作用

session-catalog · 管理台语料（活跃 + 归档同表；sessionQuery + 归档集合现场拼装）

session-history-list · 列出归档集合（存储文件优先；含来源、降级、按行体积与 pendingRestart）

session-history-archive · 批量归档（内存 API 优先，文件降级）

session-history-prune · 取消归档状态：从归档数组批量移除 id（可逆，需重启）

session-history-purge · 清理归档文件：真删转录目录 + 投影缓存 + 两处 id（不可逆）

session-history-favorites-list / -favorite-set · 收藏集合读写（JSON 域）

session-health-status · 开关状态与方法表（面板与删除行探针用，含 directDelete）

session-health-scan / -session / -repair / -source-migrate · 批量体检、单会话报告、可逆处置、署名迁移

设置

命名空间：manage-session。

开关 · 字段 · 关闭效果

启用插件 · enabled（默认 true） · 不注册任何接口，入口整体消失

会话历史文件 · historyFiles（默认 true） · 不注册 session-history-*

健康检查 · healthCheck（默认 true） · 不注册 session-health-*，不渲染「体检」页签

行内删除 · directDelete（默认 false） · 侧栏会话菜单不出现「删除」行（破坏性入口默认关）

存储

路径 · 内容

~/.dsh/storages/manage-session-favorites.json · 收藏集合（按 sessionId）

~/.dsh/storages/workspace.json · 归档数组与工作区成员表（宿主文件，本插件写入前自动备份）

四门体检

gate · 判据 · level

log-integrity · zstd 多帧扫描 → provenance 展开 → 打包行解包；seq 连续、无撕裂尾帧 · 有读取问题 fail；仅撕裂尾帧 warn

projection-cache · ~/.dsh/storages/session_projcache/sessions/<id>.json 的 minSeq 与日志末 seq 的 lag + 未结算字段 · 滞后且未结算 fail；任一 warn

lossless-json · 热态 sessionProjections.checkpoint(session) 逐行判定无损 JSON · 命中 fail，并给出投影 key → 归属包

cold-read · 最后 turn/end 的原因、是否存在未收尾 open step · open step fail；interrupted/无 turn/end warn

处方只给三件可逆的事：① 隔离损坏的投影缓存记录（先备份）② 含未结算 step 时提示等待宿主结算

③ 输出可执行命令清单。禁止：改写会话日志、改历史数据、静默丢弃字段。

开发

pnpm install
pnpm typecheck     # tsc -b --pretty false
pnpm test          # vitest run（宿主半）
pnpm test:client   # 浏览器半身注册 / 字典断言（需先 build）
pnpm build         # tsc -b && tsdown → lib/index.js + lib/client.js

许可

MIT