ohmejj/dsh-chat-archive

DSH Chat Archive - DSH 对话自动归档插件

License: MIT
npm version

一个 DeepSeek Harness 插件，用于自动归档闲置会话。超过设定闲置时间的会话将被自动归档，从侧边栏隐藏但数据完整保留，可随时恢复。

✨ 功能特性

- 🤖 自动归档：根据闲置时间自动归档会话
- ⚙️ 灵活配置：支持分钟/小时/天为单位设置闲置阈值
- 🎯 独立设置界面：在 DSH 设置面板中提供独立的左侧菜单项
- 💾 配置持久化：设置自动保存到 $DSH_HOME/settings.yaml
- 🔄 实时生效：保存配置后立即应用新的扫描间隔
- 👁️ 预览功能：提供预览脚本，可在不修改数据的情况下查看哪些会话将被归档

📦 安装

前置要求

- Node.js >= 22.18.0
- DeepSeek Harness (DSH) 0.1.5-rc.1 或更高（适配最新版 API）已安装并配置

使用 DSH 命令安装（推荐）

安装到默认 profile
dsh plugin --profile default add @ohmejj/dsh-chat-archive

或安装到 web profile
dsh plugin --profile web add @ohmejj/dsh-chat-archive

或安装到 tui profile
dsh plugin --profile tui add @ohmejj/dsh-chat-archive

安装后会自动配置：dsh plugin add 命令会自动将插件添加到 profile 的 bundle 层，插件会在下次启动时自动加载。

重启 DSH 即可使用：

如果是 web profile
kill "$(cat ~/.dsh/dsh-web.pid)"
dsh --profile web

如果是其他 profile，使用对应的启动命令

工作原理：插件包含 dsh.bundle.patch 配置，会自动向 DSH 的 Cordis loader 注册自己。安装命令会将插件添加到 profile 的 dsh.profile.bundles 列表中，DSH 启动时会自动加载。

🎮 使用指南

访问设置界面

1. 启动 DSH Web GUI 后，点击侧边栏底部的 设置 图标
2. 在设置弹窗的左侧菜单中找到 对话自动归档 (Auto-archive conversations)
3. 进入配置界面

配置项说明

| 配置项 | 说明 | 默认值 |
|--------|------|--------|
| 启用自动归档 | 总开关，关闭后不扫描不归档 | 关闭 |
| 闲置阈值 | 会话闲置超过该时间后将被归档支持单位：分钟/小时/天 | 72 小时 |
| 扫描间隔 | Host 端每隔多久扫描一次（分钟） | 30 分钟 |
| 立即归档 | 点击后立即按当前配置扫描一次 | - |

使用说明

- 修改配置：在界面中修改配置后，点击 保存 按钮才会生效（可点击 放弃 取消修改）
- 配置生效：保存成功后会立即应用新的扫描间隔，并显示"已保存，立即生效"提示
- 立即归档：如需立即执行归档，点击 立即归档 按钮
- 持久化：配置自动保存到 $DSH_HOME/settings.yaml 的 chat-archive 章节
- 周期执行：按设定的扫描间隔定期执行

归档规则

- ✅ 会被归档：闲置时间超过阈值的非活跃会话
- ❌ 不会归档：
- 当前正在运行的会话
- 已经在归档集中的会话
- 无法确定活动时间的会话
- 📏 闲置时间判定：基于会话持久化日志文件的最后修改时间（mtime）。通过 sessionPersistence.locate() 定位会话工件（如 session.jsonl / session.jsonl.v3），读取其 mtime 作为最后活动信号；.v3.jsonl 工件缺失时自动回退到旧版 .jsonl
- 🛡️ 防误归档：会话须连续闲置 max(阈值, 一个完整扫描间隔) 才会被归档

🔍 预览功能

在实际启用归档前，可以使用预览脚本查看哪些会话将被归档：

使用默认配置预览（72 小时阈值，30 分钟间隔）
node scripts/preview-archive.mjs

自定义阈值和间隔
node scripts/preview-archive.mjs 10 minutes 5    # 10 分钟阈值，5 分钟间隔
node scripts/preview-archive.mjs 7 days          # 7 天阈值
node scripts/preview-archive.mjs 48 hours        # 48 小时阈值

预览脚本会列出：
- 将被归档的会话及其最后活动时间
- 仍然活跃的会话
- 不会触及的会话（正在运行、已归档等）

🗑️ 卸载

使用 DSH 命令卸载

从指定 profile 卸载
dsh plugin --profile web remove @ohmejj/dsh-chat-archive

卸载后会自动清理：卸载命令会自动从 profile 的 bundle 列表中移除插件。重启 DSH 即可生效。

注意：卸载插件不会影响已归档的会话，这些会话仍然存在于归档集中，可通过 DSH 原生功能恢复。

❓ 常见问题

左侧菜单没有"对话自动归档"选项？

依次检查：
1. 确认插件已安装：ls ~/.dsh/profiles/web/node_modules/@ohmejj/dsh-chat-archive
2. 确认插件已添加到 bundle 列表：检查 ~/.dsh/profiles/web/package.json 中的 dsh.profile.bundles 是否包含插件
3. 重启 DSH（必须重启才能加载新插件）
4. 刷新浏览器页面后重新打开设置

保存配置时提示“保存失败”？

- 检查配置值是否合法（必须是 ≥1 的整数）
- 确认 DSH 设置服务正常运行
- 查看控制台是否有错误信息

如何验证插件是否在工作？

1. 临时设置较小的阈值（如 1 小时）和间隔（如 5 分钟），保存后点击“立即归档”
2. 打开包含老会话的工作区，观察会话是否从列表中消失
3. 检查 $DSH_HOME/settings.yaml 中的 chat-archive 配置是否生效

插件安装后如何确认已正确加载？

插件通过 dsh plugin add 安装后，会自动添加到 profile 的 dsh.profile.bundles 列表中。可以通过以下方式确认：

查看 profile 的 package.json
cat ~/.dsh/profiles/web/package.json | grep -A 5 '"bundles"'

应该能看到类似这样的输出：
"bundles": [
"@deepseek-ai/dsh-base",
"@deepseek-ai/dsh-web-app",
"@ohmejj/dsh-chat-archive"
]

重启 DSH 后，插件会自动加载，无需手动编辑配置文件。

📄 许可证

MIT License - 详见 LICENSE 文件

👤 作者

ohmejj
- Email: ohmezhang@gmail.com
- GitHub: @ohmejj

🔗 相关链接

- GitHub 仓库
- 详细使用指南
- DeepSeek Harness

🤝 贡献

欢迎提交 Issue 和 Pull Request！

注意：本插件使用 DSH 原生的归档机制，归档操作是可逆的，归档的会话可以随时通过 DSH 的归档管理功能恢复。