会话归档管理 Jemius/dsh-session-admin

dsh-session-admin

DSH 网页插件：会话管理。为会话增加删除入口，并在设置中提供已归档的聊天管理页，可查看 / 恢复 / 导出 / 永久删除。

当前版本 0.2.0（见 CHANGELOG：修复了 4 个在当前 harness 上会让功能静默失效的兼容性 bug）。

功能

删除会话

会话标题栏会出现一个删除按钮（垃圾桶图标）。点击并确认后，会话被删除（移入归档，记录保留）。

删除走 DSH 运行时原生的归档通道（workspace.archiveSession），与官方「归档会话」菜单共用同一份状态，因此不会和其他插件冲突。

删除会话

已归档的聊天管理

在 设置 → 已归档的聊天 中管理所有已删除（归档）的会话：

已归档的聊天

- 查看：弹窗阅读完整会话记录 —— 用户 / 助手消息、工具调用（含参数）、工具结果（含失败标记）；工具名通过日志中的 tool/call 事件与 tool/result 关联。
- 恢复：把会话移出归档，回到原工作区位置（走 workspace 存储域的原生状态写入，多标签页实时同步）。
- 导出：导出为 Markdown（人类可读转写）或 JSONL（完整原始事件日志，每行一个事件）。标题与「用户 / 助手 / 工具结果」等抬头跟随当前界面语言。
- 永久删除：确认后移除持久化日志（文件级删除，不可撤销），并清理工作区账目、投影缓存与归档集合引用。

运行中判断

只有正在运行（agent 执行中，存在未闭合的 turn）的会话会被拒绝删除；空闲会话——包括本次运行中打开过、仍在内存里的——都可直接删除 / 恢复。「运行中」标记优先读 turnBoundary 投影，缺失时回退到会话日志快照（snapshotEvents()），因此两种 harness 组合下都准确。

文案与语言

所有可见文案（含角色名、条目计数、导出抬头）统一走 DSH 语言服务，跟随「设置 → 语言」切换；插件不再读 navigator.language，同一界面内不会出现中英混排。

安装

dsh plugin --profile web add dsh-session-admin

也可以直接从 GitHub 安装（会执行本包的 prepare 构建；pnpm ≥10 首次需要把 pnpm 提示的包名写进 profile 的 pnpm-workspace.yaml 的 allowBuilds）：

dsh plugin --profile web add github:Jemius/dsh-session-admin#v0.2.0

插件通过 dsh.bundle.patch 追加到 profile 的 bundle 栈；该行是纯新增（不改写任何官方行），所以不会和其他插件或未来的 harness 升级冲突。

兼容性

插件只通过 cordis 服务与 slot 接入，所有跨包访问都经过 src/host/types.ts 里的结构镜像 + 形状适配器，而不是直接按某个版本的属性名取值 —— 因为后者失效时不报错，只是功能静默失灵。

0.2.0 修掉的就是这一类问题（均在 dsh 0.1.5-rc.1 上实测复现）：

| 现象 | 原因 | 现在的处理 |
| 「已归档的聊天」永远是空列表 | sessionPersistence.list() 已从 SessionHeader[] 改为 {header, revision}[] 快照 | headerOfEntry() 同时接受两种形状 |
| 「永久删除」显示成功但磁盘文件还在 | 同一处形状不匹配让 locate() 分支被整段跳过 | 同上，并有单测覆盖真实目录删除 |
| 删除正在运行的会话不被拒绝、「运行中」标记从不出现 | 活跃 Session 没有 events 成员（旧代码读它） | 优先 turnBoundary 投影，回退公开的 snapshotEvents() |
| 永久删除必定报 unsafe-path | 安全校验按 session.jsonl + session- 目录判断，而真实路径是 session.v3.jsonl.zstd + 编码后的 id | assertSafeSessionArtifact() 按当前命名规则校验 |

peer 依赖范围写作 ^0.1.0-rc.6 || >=0.1.5-rc.1 ，把真实 profiles 目录 junction 到 /profiles
$env:DSH_HOME=...; dsh web --port 3099
2. node test-ui.mjs