前言¶
随着 DeepSeek Harness 使用时间的增加，侧边栏中积累了大量对话会话。手动归档既耗时又容易遗漏。@ohmejj/dsh-chat-archive 插件通过配置闲置阈值，自动将不再活跃的会话归档至归档区，从侧边栏隐藏但保留数据，帮助保持工作区整洁。
功能¶
该插件主要提供以下能力：
1. 自动归档闲置会话
2. 灵活配置闲置阈值（支持分钟/小时/天）
3. 独立设置界面
4. 配置持久化到 $DSH_HOME/settings.yaml
5. 实时生效
6. 预览功能
安装与启用¶
前置要求：
- Node.js >= 22.18.0
- DeepSeek Harness >= 0.1.5-rc.1
使用 DSH 命令安装到不同 profile：
dsh plugin --profile default add @ohmejj/dsh-chat-archive
dsh plugin --profile web add @ohmejj/dsh-chat-archive
dsh plugin --profile tui add @ohmejj/dsh-chat-archive
安装后重启 DSH 即可生效。
使用方法¶
- 启动 DSH Web GUI，点击侧边栏底部的设置图标。
- 在设置弹窗的左侧菜单找到“对话自动归档”。
- 配置闲置阈值（默认 72 小时）和扫描间隔（默认 30 分钟）。
- 点击保存，配置会持久化到 $DSH_HOME/settings.yaml。
归档规则基于会话持久化日志文件（session.jsonl 或 session.jsonl.v3）的最后修改时间（mtime）。为防误归档，会话须连续闲置超过设定阈值。
预览功能¶
在启用归档前，可使用预览脚本查看效果：
# 使用默认配置预览
node scripts/preview-archive.mjs
# 自定义阈值和间隔
node scripts/preview-archive.mjs 10 minutes 5
node scripts/preview-archive.mjs 7 days
卸载¶
dsh plugin --profile web remove @ohmejj/dsh-chat-archive
注意事项¶
- 归档操作不删除数据，仅从侧边栏隐藏。
- 插件以当前 DSH 进程权限运行，请确认源码与许可证。
- 归档的会话可通过 DSH 原生功能恢复。
结尾¶
该插件通过自动化归档策略，帮助开发者管理长期对话历史。更多详情见 GitHub 仓库。
