前言¶
在 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
