jujiujiang222-cell/dsh-archive-sessions

dsh-archive-sessions

用于 DeepSeek Harness 的归档会话管理器。

在 DSH 设置界面新增“归档会话”页：列出所有已归档会话，支持恢复与永久删除（删除前二次确认）。

新增一个“归档会话”（Archived Sessions）设置页面，列出已归档的
会话，并允许你恢复或永久删除每一个会话（带有
页面内确认步骤）。

功能特性

- 列出磁盘上仍保留持久日志的已归档会话（磁盘是
唯一事实来源——不会出现来自内存会话存储的幽灵记录）。
- 显示标题、创建时间、工作目录以及该会话当前是否
在内存中打开。
- 恢复：将会话移出归档集合；它会重新出现在
侧边栏中。
- 永久删除：移除会话的持久日志文件，并将其从
工作区记账中分离。需要两步页面内确认。

安装

要求：一个 DeepSeek Harness 桌面 / Web 配置（本机上的“web”配置）
以及插件市场运行时。

from a GitHub checkout (once the repository is listed in the marketplace
registry) or directly from the repository:
dsh plugin --profile web add github:/dsh-archive-sessions

要从源码构建并在本地安装，请将该包放入当前
配置的依赖集合中（pnpm install file:/git 目标），然后确保
配置的 bundle 补丁层中存在下面这一行：

cordis.patch.yml
- insert:
- id: dsh-archive-sessions
name: dsh-archive-sessions

安装/更新后，重启应用（或让市场热重载客户端
bundle），然后打开 设置 → 归档会话。

工作原理

| 层 | 文件 | 作用 |
| --- | --- | --- |
| 宿主 | src/index.js | cordis 插件；注册同源 HTTP 路由 /plugins/dsh-archive-sessions/{list,restore,delete} 并实现所有逻辑 |
| Web 客户端 | lib/client.js | 注册 settings.section 页面“归档会话”并与宿主路由通信 |
| Bundle 行 | cordis.patch.yml | 将插件行插入到配置层栈中 |

设计说明 / 注意事项

- 不存在平台级的“删除会话”服务。 会话日志后端是
仅追加的，并且每个列表都派生自磁盘上的内容。因此永久
删除会移除会话自身的产物
（在 jsonl 持久化后端下为 session.jsonl[.zstd]）以及工作区
记账。该 id 会作为墓碑保留在归档集合中，以便在本次运行期间
仍驻留在内存中的会话继续从侧边栏隐藏；
应用重启后就没有任何东西引用它了。
- 内存中驻留的会话。 在当前应用运行期间打开过的会话
会在内存中保留一个活动 agent。仅当 agent 空闲时
才允许删除这样的会话；正在运行的 agent 会先被要求停止（最多约 4 秒）。
- 完全访问权限的文件移除。 沙箱化的默认 shell 无法删除
应用自身数据目录内的文件，因此删除操作通过 shell 执行，并
一个显式的 danger-full-access 策略。安装前请阅读代码；
使用风险自负。
- 恢复已删除的会话会被拒绝：其日志已不存在。
- 验证状态：作为会话作用域的动态插件开发和实战检验
（参见 docs/dynamic-plugin-source.js）。本仓库中可安装的
静态包遵循已发布的插件布局
（dsh.client 元数据、bundle 补丁、window.__ModuleLoader__ 客户端
bundle、同源主机路由）。在发布更新之前，应在目标配置文件中
验证加载时的依赖装配。

参考：将其作为动态插件运行（无需安装）

如果你希望立即在当前 DSH 会话中获得相同的功能而无需
安装任何东西，请将
docs/dynamic-plugin-source.md 中的代码粘贴到 Cordis
动态插件定义中，或让你的 agent 使用插件 id
前缀 archv 创建它（正如开发期间所做的那样）。

仓库布局

src/index.js                  主机部分（HTTP 路由 + 逻辑）
lib/client.js                 Web 客户端部分（设置页面）
cordis.patch.yml              配置文件 bundle 行
docs/registry-submission.md   如何请求在 awesome-dsh-plugin 上列出
docs/dynamic-plugin-source.md 参考动态插件源码（开发版本）

许可证

MIT — 参见 LICENSE。