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

一个 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 的归档管理功能恢复。