前言¶

DSH 的理念是「一切皆插件」。当 profile 里存在多个 link: 插件时，需要确认哪些本地目录已经落后于上游。dsh-update-radar 用于完成这项只读检查。

这是什么¶

dsh-update-radar 是一个 DeepSeek Harness 插件，检查已装 link: 插件是否存在上游更新。仓库由 Equinox7379 维护，许可证为 MIT。

核心功能¶

下面介绍它的实际行为。

• 读取 profile dependencies 中的全部 link: 路径。
• 对含 .git 的目录执行 git rev-parse HEAD 与 git ls-remote origin HEAD。
• 对比本地与上游。
• 提供 update_radar 工具，该工具无参数。
• 只读：仅执行 rev-parse / ls-remote，不拉取、不改动任何仓库。
• git 失败（无仓库/网络异常）返回 null 字段，不影响整体报告。
• 零依赖、无自定义会话事件、无 HTTP 路由。

安装与启用¶

将安装命令中的 link: 路径替换为本机目录，然后重启 dsh web。

dsh plugin --profile web add link:/path/to/dsh-update-radar
# 重启 dsh web

典型用法¶

调用 update_radar 工具，不传参数。

update_radar

示例输出包含 checked、behind、upToDate 字段：

{
  "checked": 32,
  "behind": [
    { "plugin": "dsh-notification", "local": "96413d33", "upstream": "3e33100f" }
  ],
  "upToDate": [
    { "plugin": "dsh-genui", "local": "57b43382", "upstream": "57b43382" }
  ]
}

behind 表示本地落后于上游，upToDate 表示本地与上游一致。

适用场景与注意¶

适合通过 link: 路径管理本地插件目录的 DSH 使用场景。它只检查更新状态，不执行拉取，也不改动仓库。

插件以当前 dsh 进程权限运行，安装前建议检查源码和许可证。许可证为 MIT。某些目录缺少 .git 或网络异常时，对应字段会返回 null，不影响整体报告。

结尾¶

dsh-update-radar 将多个 link: 插件的上游更新检查汇总为一份报告。仓库地址：https://github.com/Equinox7379/dsh-update-radar