前言¶
在 DSH 插件生态中，会话日志是常见的排查与回溯材料。日志文件位于 ~/.dsh/sessions，一旦误删、覆盖或格式迁移出错，恢复起来会比较麻烦。
dsh-log-memory 是面向 DSH 的插件，把“打开 Web 界面”变成一个检查点：立即弹出守护面板，提示是否备份当前会话日志，并允许在弹窗内调整提醒间隔、选择备份文件夹。
这是什么¶
dsh-log-memory 是一个 MIT 许可的 DSH 插件，当前版本为 1.3.0。仓库地址为：
- https://github.com/says693/dsh-log-memory
它的定位很具体：打开 DSH Web 界面时立即弹出守护面板，在弹窗内备份 ~/.dsh/sessions 下的 session.jsonl / session.jsonl.zstd，并可调整提醒间隔和备份文件夹。
核心功能¶
- 打开 DSH Web 界面时立即弹出守护面板，可勾选「今日不再提醒」后当日不再打扰；按北京时间自然日静音，跨天自动恢复提醒。
- 在弹窗内将
~/.dsh/sessions下的session.jsonl/session.jsonl.zstd增量复制到备份文件夹。 - 在弹窗内设置提醒间隔，预设 10 分钟 / 30 分钟 / 1 小时 / 2 小时 / 3 小时，滑杆范围 10 分钟 – 3 小时；运行时间隔需在 10–180 分钟内。
- 备份格式可选鱼话版（原始
.zstd）或人话版（可读.txt），两种格式各自维护独立增量索引。 - 首次安装引导确认或填写备份文件夹，弹窗内支持浏览目录；备份文件夹须为绝对路径且不在会话目录内。
- 运行时设置与备份索引持久化于
<DSH_HOME>/profiles/<profile>/log-memory.json。 - HTTP 路由仅接受同源 POST；备份为纯本机文件复制，不联网、不上报数据。
安装与启用¶
使用 dsh 命令安装¶
执行：
dsh plugin --profile web add github:says693/dsh-log-memory
安装后重启 DSH（Deepseek Harness EAC），首次打开 Web 即弹出引导面板。
可以运行下面命令确认插件已经进入最终配置：
dsh --profile web --dump-config
从源码安装¶
需要修改源码时，克隆仓库后在仓库目录运行：
dsh plugin --profile web add .
手动安装¶
手动安装时，把插件复制到 DSH profile 依赖目录，并在 package.json 的 dependencies 与 dsh.profile.bundles 中加入 dsh-log-memory，然后重启 DSH。首次打开 Web 即弹出引导面板。
典型用法¶
1、安装后重启 DSH，打开 Web 界面处理首次引导面板：确认或填写备份文件夹。
2、在弹窗内设置提醒间隔。可以先用预设档，也可以用滑杆在 10 分钟到 3 小时范围内调整。
3、选择备份格式。鱼话版保留原始 .zstd，人话版生成可读 .txt；两种格式各自维护独立增量索引。
4、需要手动备份时，在弹窗内触发备份，插件会将 ~/.dsh/sessions 下对应的 session.jsonl / session.jsonl.zstd 增量复制到备份文件夹。
5、恢复会话日志时，从最新批次向前找该文件的第一个版本；恢复原始格式时，把文件放回 ~/.dsh/sessions/<对应目录>/。
适用场景与注意¶
- 适合需要为 DSH 会话日志建立本机备份、并希望在打开 Web 时收到备份提醒的开发者。
- 插件以当前 dsh 进程权限运行；安装前建议检查源码与 MIT 许可证。
- 已核实的兼容范围为 Deepseek Harness EAC 3.0.1（封装版）、dsh agent 0.1.0-rc.6（内置），Windows 11 实测通过；依赖 Node 内置模块，无第三方依赖。
- 提醒间隔需在 10–180 分钟内；备份文件夹须为绝对路径且不在会话目录内。
- 备份是纯本机文件复制，不联网、不上报数据；HTTP 路由仅接受同源 POST。
小结¶
dsh-log-memory 解决的问题比较集中：打开 DSH Web 时弹窗提醒，并在弹窗内完成备份、调整提醒间隔、选择备份文件夹。仓库地址：
- https://github.com/says693/dsh-log-memory
