前言¶

DSH 的理念是“一切皆插件”。在实际使用 profile 和插件清单时，环境配置可能随时间变化；排查“最近环境改了什么”时，缺少一条清晰时间线会比较麻烦。

dsh-config-watch 是 Equinox7379 维护的 DeepSeek Harness 插件，用于记录环境配置变更历史。它通过每次服务启动时拍快照、与上次快照对比，再把差异写入变更日志，为后续查询提供只读历史。

这是什么¶

一句话定位：DeepSeek Harness 插件：记录环境配置变更历史。

• 插件名：dsh-config-watch
• 维护者：Equinox7379
• 许可证：MIT
• 解决的问题：提供“环境何时被改过”的时间线。
• 快照方式：仅保存哈希与文件名，不复制文件内容。

核心功能¶

下面介绍已核实的能力：

• 记录环境配置变更历史。
• 每次服务启动时，对 profile 关键文件与插件清单拍快照。
• 与上次快照对比，差异写入变更日志。
• 提供工具 config_changes。
• 支持参数 limit，默认 20，最多返回 200 条内的最近 N 条。
• 零依赖、无自定义会话事件、无 HTTP 路由。

安装与启用¶

先准备插件本地路径，再使用下面的命令安装。该命令使用 --profile web 和本地路径 link:/path/to/dsh-config-watch，安装后需要重启 dsh web。

dsh plugin --profile web add link:/path/to/dsh-config-watch
# 重启 dsh web

已核实事实中未提供从 GitHub 仓库直接安装的命令。package.json 声明 dsh.bundle.patch 为 ./cordis.patch.yml，但该文件内容未抓取，无法确认具体 patch 配置。

典型用法¶

启用插件后，使用工具 config_changes 查询历史。参数 limit 默认 20，最多返回 200 条内的最近 N 条。

例如，询问“最近环境改了什么”时，可返回 entries 与 total。README 示例如下：

{ "entries": [ { "at": "2026-08-14T09:47:00Z",
    "changes": [ { "kind": "plugin-added", "target": "dsh-modsearch", "detail": "2026-08-14T09:40:12Z" } ] } ],
  "total": 37 }

这个示例中，entries 是变更记录列表，total 是历史总条数。changes 中可见 kind 为 plugin-added，target 为 dsh-modsearch。

数据存储与可靠性¶

• 数据只写 ~/.dsh/config-watch/。
• 数据包含 history.jsonl 与 last-snapshot.json；history.jsonl 轮换上限 200 条。
• 快照仅保存哈希与文件名，不复制文件内容。
• 快照失败仅记录日志，不影响服务启动。
• 零依赖、无自定义会话事件、无 HTTP 路由。

适用场景与注意¶

适合排查 DSH 环境配置、profile 关键文件与插件清单变化时间的场景。它提供的是启动时快照对比后的变更历史，不保存完整文件内容。

安装前建议检查源码与许可证。插件以当前 dsh 进程权限运行，安装前应确认本地路径、来源与运行环境是否符合要求。

DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

链接¶

• 插件目录页（插件线索）：https://www.skillhub.cn/plugins/Equinox7379/dsh-config-watch
• GitHub 仓库：https://github.com/Equinox7379/dsh-config-watch