前言¶
在 DeepSeek Harness（DSH）里长期跑智能体开发，会话数量会随工作区堆积：活跃会话、已归档会话、收藏标记，以及偶尔出现的投影缓存滞后或日志尾帧异常。若只靠侧栏逐条点选，批量归档、取消归档或清理磁盘上的归档文件既慢，也容易误操作。
社区插件 dsh-manage-session（原名 dsh-session-steward，自 2.0.0 起更名，搜索与索引能力已拆至 dsh-search-index）提供统一的管理界面，并在同一插件内附带四门会话体检与可逆处置处方。下面介绍其定位、能力与安装用法。
这是什么¶
dsh-manage-session 是 DSH Web 客户端插件，由维护者 drscrewdriver 发布，当前 npm 包版本为 2.0.3（publishConfig.tag 为 beta）。它解决两类问题：
- 会话管理：在同一主页面按工作区分组列出活跃与归档会话，支持域筛选、标题过滤、收藏，以及勾选后的批量归档、取消归档、清理归档文件（后者为真删磁盘，不可逆）。
- 会话体检：备用页签提供四门体检 → 处方（命令清单）→ 出院（可逆处置，含 before/after）。
管理台语料由 session-catalog 从宿主 sessionQuery 与官方归档集合现场拼装。本包不含搜索/索引，也不依赖 DRS；标题与内容的 FTS5 检索由 dsh-search-index 承担。
目录页：https://www.skillhub.cn/plugins/drscrewdriver/dsh-manage-session
源码与说明：https://github.com/drscrewdriver/dsh-manage-session（MIT 许可）
入口与界面形态¶
插件在装载时探测宿主是否声明侧栏顶部工具行槽位（sidebar.panellist 面板行 + main 整页槽，对应 0.1.7+/0.2.x 的「插件 / 更多」工具行）：
| 宿主能力 | 入口形态 |
|---|---|
| 已声明顶部工具行槽位 | 入口落在「插件」行之后、「更多」之前（order 6）；点击后在主栏整页打开管理台，页内「关闭」回到当前会话 |
| 无该槽位（老线或精简布局） | 回落侧栏底栏 sidebar.footer.action，点击打开浮动对话框 |
若宿主稍后才声明顶栏槽位，底栏入口会撤下并切换到顶栏，不会两份并存。两路入口均受设置开关控制，开关变更即时生效。
核心功能¶
管理（主页面）¶
- 按工作区分组展示活跃 + 归档会话；每行显示标题、工作区与时间。
- 域筛选：全部 / 活跃 / 归档。
- 标题过滤与收藏（持久化见下文存储路径）。
- 勾选后可批量执行三个互不等价操作：
- 归档
- 取消归档（从归档状态移除，可逆，通常需重启宿主）
- 清理归档文件（删除转录目录与相关缓存，不可逆，界面需二次确认）
体检（备用页签）¶
四门体检及判据概要如下（细节以 README 为准）：
| gate | 关注点 | 典型 level |
|---|---|---|
log-integrity |
zstd 多帧、provenance、打包行；seq 连续与尾帧 | 读取问题 fail；仅撕裂尾帧 warn |
projection-cache |
投影缓存 minSeq 与日志末 seq 的 lag、未结算字段 |
滞后且未结算 fail |
lossless-json |
热态投影逐行无损 JSON | 命中 fail |
cold-read |
最后 turn/end、未收尾 open step |
open step fail |
插件原则：只做可逆处置——不改写会话日志、不改历史数据、不静默丢字段。处方仅给出隔离损坏投影缓存（先备份）、等待宿主结算、可执行命令清单等；禁止静默破坏数据。
路由与 API 契约¶
前缀 /manage-session/api，方法名一律 session-*；未识别方法返回显式错误。常用方法包括：
| 方法 | 作用 |
|---|---|
session-catalog |
管理台语料（活跃 + 归档同表） |
session-history-list |
列出归档集合 |
session-history-archive |
批量归档 |
session-history-prune |
批量取消归档状态 |
session-history-purge |
清理归档文件（不可逆） |
session-history-favorites-list / -favorite-set |
收藏读写 |
session-health-status |
开关与方法表 |
session-health-scan / -session / -repair / -source-migrate |
体检与可逆处置、署名迁移 |
安装与启用¶
在 Web 配置档下安装官方包名：
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"
安装后必须重启 DSH 宿主进程；仅刷新浏览器页面无效。
README 列出的支持宿主版本为一系列 0.1.x / 0.2.x rc 构建（peer 白名单逐版实测）；alpha/beta 宿主不在支持范围内。使用前请对照你本地的 DSH 版本。
设置与存储¶
设置命名空间：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 |
归档数组与工作区成员表（宿主文件；插件写入前会自动备份） |
典型用法¶
- 安装并重启宿主后，在侧栏顶栏工具行（或底栏回落入口）打开「会话管理台」。
- 用「全部 / 活跃 / 归档」与标题过滤缩小列表；需要常看的会话加入收藏。
- 勾选多条会话后，按需选择归档、取消归档或清理；清理前确认不可逆提示。
- 切换到「体检」页签，运行扫描，按处方执行可逆命令；涉及取消归档或清理后，按界面与 README 提示决定是否重启宿主。
若需要跨会话全文搜索，应另行安装 dsh-search-index，不要在本插件中期待检索能力。
适用场景与注意¶
适合：需要在 DSH Web 侧集中浏览、筛选、收藏会话，并批量维护归档状态或清理磁盘归档数据的开发者；希望在同一界面做结构化会话健康检查、且只接受可逆修复路径的用户。
注意：
- 插件以当前 DSH 进程权限读写
~/.dsh/storages/等路径；安装前请阅读源码与 MIT 许可证，确认符合你的安全策略。 - 「清理归档文件」会真删磁盘内容，与「取消归档」不同，不可与归档操作混为一谈。
- 社区目录 SkillHub 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」思路，本插件是其中面向会话治理的客户端扩展之一。
结尾¶
dsh-manage-session 把活跃与归档会话的管理、收藏与批量维护收进一个 Web 管理台，并用四门体检给出可逆处方，同时把搜索能力明确留给 dsh-search-index。若你正在维护多工作区、多会话的 DSH 环境，可按上文命令安装、重启宿主后从侧栏入口使用。
