前言¶

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