dsh-session-archive

English | 中文

DSH Web 的会话归档管理插件：集中查看全部会话，批量归档/恢复，并以完整、可审计的管线物理删除会话。可选（默认关闭）的自动策略按未活动时长自动归档、按归档保留期自动清理。

功能

• 完整清单：宿主可见的每一个会话——活跃、已归档、空白、子代理会话、不属于任何工作区的会话，以及元数据缺失的历史会话——均展示标题、会话 ID、工作区、最后活动时间、状态、归档时间（不可靠时明确显示"未知"）、大小与子会话数量。
• 筛选、搜索、排序：按状态（全部 / 未归档 / 已归档）、工作区（含无工作区）、标题或会话 ID 搜索，按最后活动 / 归档时间 / 创建时间 / 标题 / 大小排序，并支持"仅看异常会话"快速过滤；结果数量始终可见。
• 真正的多选：逐条勾选、按工作区全选/取消、跨完整筛选结果集的全选（不只是当前渲染的行）。筛选条件变化后保留选择，并在选中项落在当前结果之外时给出明确提示。
• 批量操作：对选中集合执行批量归档、批量取消归档与批量物理删除，服务端分块执行，实时展示进度与逐会话结果（成功 / 跳过并说明原因 / 失败并说明原因），支持仅重试失败项。当前会话、运行中的会话、有运行中后代的会话始终受保护并被跳过，附原因说明。
• 物理删除的级联语义：删除会话会同时清除其存储（jsonl.zstd 目录或 session-rdb 行）、工作区记录、归档集合条目、投影缓存与本插件归档台账。删除父会话会一并删除全部后代；会话族中任一成员受保护则整族跳过，绝不半删除。删除必须经过明确确认（展示直接选中数、级联数、最终总数、跳过的受保护数与预计释放空间）；大批量删除需要额外的知情勾选。
• 可选自动维护（默认关闭）：按最后活动时间（不是创建时间）自动归档超期未活动会话；按记录的归档时间（不是文件时间）自动删除超过保留期的归档会话。两个开关相互独立，支持启用前预览、立即执行，并持久化上次运行与下次检查状态。本插件出现之前归档的会话没有可靠归档时间，界面显示"未知"，且永远不会被自动删除。
• 默认安全：全部路由仅限回环访问（隧道与局域网客户端得到 403）；删除绝不跟随符号链接越出会话根目录；操作串行化，两个批次永远不会交错执行。

安装

pnpm add @gestaltrun/dsh-session-archive

全家桶（dsh-web-all）已包含本插件。独立挂载到 profile：

dsh plugin --profile web add link:/path/to/dsh-web/packages/dsh-session-archive

重启 dsh web 后，Web 设置中会出现一级入口"会话归档管理"（Workshop 之下）。

配置

设置区提供：

• enabled — 整体关闭管理界面。
• autoArchiveEnabled + autoArchiveDays（1–3650，默认 7）— 按最后活动时间的自动归档阈值。
• autoDeleteEnabled + autoDeleteDays（1–3650，默认 7）— 归档保留期，超期后物理删除。
• checkIntervalMin（15–1440，默认 60）— 自动检查的调度间隔。

无效或越界的值不会被保存，表单会显示校验提示。

语义说明

• 归档不删除数据。 已归档会话只是从分组界面消失；取消归档会原位恢复其工作区位置。
• 物理删除不可恢复。 它会清除会话历史、元数据、工作区关联、归档记录、投影缓存及其他归属于该会话的数据。共享的内容寻址附件保持不动（可能被其他会话引用）；本插件不回收孤儿附件。
• 归档时间由本插件记录。 安装之前归档的会话显示"归档时间未知"，在人工删除、或取消归档后重新归档（重新计算保留期）之前，不会进入自动删除范围。
• 受保护会话无论手动还是自动都不会被删除：运行中的会话、当前正在查看的会话、有运行中子会话的会话，以及正在执行其他归档操作的会话。绝不会通过强制停止会话来完成删除。

安全模型

全部 HTTP 路由（/api/dsh-session-archive/*）要求回环套接字 + 回环 Host 头 + 浏览器同源标记；永不信任 X-Forwarded-For。删除只通过插件自己的会话根目录索引解析存储路径，移除前再次校验 realpath，并拒绝任何位于 $DSH_HOME/sessions 之外的路径。客户端只提交会话 ID，从不提交文件路径。session-rdb（SQLite）在删除前校验存储指纹。

已知限制

• 远程浏览器用户（局域网或 dsh-remote-web-ui 隧道）无法使用本区块；出于"可销毁本地会话数据"的考虑，全部路由仅限回环。
• 既不在宿主会话列表也不在投影缓存中的会话会被标记"元数据不完整"，并排除在自动流程之外。
• $DSH_HOME/attachments 下的附件为共享内容寻址存储；本插件不回收孤儿附件。