在 DeepSeek Harness (DSH) 的使用過程中，壓縮操作（無論是自動觸發還是通過 /compact 命令執行）會生成摘要信息。這些信息通常僅顯示在當前終端或界面中，缺乏持久化存儲。若需回溯特定時間點的壓縮結果或排查問題，往往缺乏直接的數據源。dsh-workspace-history 插件通過將每次壓縮摘要記錄到工作區的文件系統，並提供可視化的查閱界面，解決了這一痛點。
核心能力¶
插件會將每次壓縮的摘要持久化到工作區目錄。每個壓縮操作對應一個獨立的 Markdown 文件，文件名基於 Unix 時間戳和短會話 ID。文件頭部包含了完整的會話 ID、工作區路徑以及壓縮統計信息，方便後續排查。
在 Workspace Overview 標籤頁中，插件增加了一個 History 子標籤頁。在安裝了 dsh-workspace-overview 插件的前提下，該子標籤頁會列出按時間倒序排列的日誌條目，點擊即可在右側渲染查看具體的摘要內容。插件默認開啓記錄功能，也可以在 granular settings 中隨時關閉。
安裝與啓用¶
安裝前需要確保已安裝 DeepSeek Harness 並配置了 profile（例如 web）。
- 創建插件目錄並克隆依賴及插件源碼：
mkdir -p ~/dsh-plugins && cd ~/dsh-plugins
git clone https://github.com/joao-paulo-santos/dsh-granular-settings.git
git clone https://github.com/joao-paulo-santos/dsh-workspace-overview.git
git clone https://github.com/joao-paulo-santos/dsh-workspace-history.git
- 通過 pnpm 將插件添加到當前 profile：
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-granular-settings
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-workspace-overview
pnpm dsh plugin --profile web add ~/dsh-plugins/dsh-workspace-history
- 驗證配置是否正確合併：
pnpm dsh --profile web --dump-config
完成上述步驟後，重啓 Harness，History 子標籤頁將出現在 Workspace Overview 中。
典型用法¶
- 在 granular settings 標籤頁中，確保 “Save compaction history” 開關已開啓。
- 進入 Workspace Overview 標籤頁，點擊 History 子標籤頁。
- 在左側列表中選擇一條記錄，右側將展示該次壓縮的 Markdown 格式摘要。
依賴與注意事項¶
插件有明確的依賴關係。
- 硬依賴：必須安裝
dsh-granular-settings插件。該插件提供了 “Save compaction history” 的開關控制，沒有它，插件無法運行。 - 可選依賴：
dsh-workspace-overview提供了 History 子標籤頁的 UI 界面，安裝後可啓用可視化功能；dsh-md-view用於將摘要渲染爲 Markdown 格式，安裝後可改善閱讀體驗。
所有日誌文件統一存儲在工作區目錄下的 <workspace>/.dsh/history/ 文件夾中。此外，插件也會將診斷信息寫入 .dsh/history/.diag.log。
總結¶
dsh-workspace-history 通過文件系統持久化記錄了 DeepSeek Harness 的每一次壓縮操作，爲開發者提供了可追溯的日誌管理能力。如果你需要長期跟蹤工作區的狀態變化，這是一個必要的輔助工具。
GitHub：https://github.com/joao-paulo-santos/dsh-workspace-history
