在 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
