vclike/dsh-find-plugin：在會話內發現 DSH 插件

DSH（DeepSeek Harness）生態強調“一切皆插件”。開發者在 Agent 會話中查找插件時，通常需要手動搜索 GitHub topic 或瀏覽外部列表。上游插件在調用 GitHub 搜索 API 時採用匿名調用，受限於每公網 IP 10 次/分鐘的額度，且經常出現 403 錯誤，導致查找不穩定。vclike/dsh-find-plugin 解決了發現渠道單一和調用受限的問題。

這是一個什麼工具¶

這是一個用於在 Agent 會話內發現 DSH 插件的工具。它同時查詢 GitHub 的 dsh-plugin topic 和 curated 列表（約 3400 條），合併去重後返回可直接執行的 dsh plugin add 安裝命令。

這個插件由 vclike 維護，基於上游 awesome-dsh-plugin/dsh-find-plugin 的維護分支開發。上游版本存在匿名 API 調用受限的問題，本分支補上了 token 鑑權、雙源合併、磁盤緩存以及真正的降級鏈。

核心功能¶

雙源搜索：同時搜索 GitHub 的 dsh-plugin topic 和 curated 列表。
結果合併與排序：將搜索結果合併，GitHub 結果按 stars 排序，curated-only 條目補足剩餘名額。
Token 鑑權：支持通過 GITHUB_TOKEN 憑據調用 API，提升額度。
限流韌性：在 Token 鑑權下支持每分鐘 30 次請求；未配置 Token 時每公網 IP 限制 10 次/分鐘。
離線降級：提供完整的離線 fallback 鏈路（內存緩存 -> 磁盤緩存 -> 內置快照）。
零依賴：通過服務層解析憑據，不直接導入 @deepseek-ai/dsh-credentials。

安裝與啓用¶

使用官方插件管理器安裝：

dsh plugin --profile web add github:vclike/dsh-find-plugin

安裝後需要重啓 dsh web，因爲插件在啓動時纔會組合 bundle 層。

配置 GitHub Token（推薦）¶

爲了獲得更高的調用額度並避免共享出口 IP 的干擾，建議配置 GitHub Token。

插件通過 DSH 憑據服務讀取名爲 GITHUB_TOKEN 的憑據（與 dsh-github-companion 使用同一份）。該憑據通常由 DSH 進程的 GITHUB_TOKEN 環境變量提供。

無 Token：調用受限，且當 GitHub 額度耗盡時會降級使用 curated 列表。
有 Token：調用額度提升至 30 次/分鐘，且不受出口 IP 共享限制。

典型用法¶

插件支持三個參數：

query（必填）：搜索關鍵詞，例如 "wechat notifications" 或 "跨會話記憶"。
limit：返回結果數量上限，默認 8，最大 20。
lang：偏好描述語言，en 或 zh，默認 en。

執行搜索時，插件會先返回 GitHub 搜索結果（按 stars 排序），隨後用 curated 列表中僅匹配關鍵詞的條目補足剩餘名額。

輸出示例：

1. dsh-mnemon ★143 — 跨會話記憶 / cross-session memory
   https://github.com/owner/dsh-mnemon
   install: dsh plugin --profile web add github:owner/dsh-mnemon

2. some-curated-only ★7 [curated] — 僅見於 curated 列表的條目
   https://github.com/other/some-curated-only
   install: dsh plugin --profile web add github:other/some-curated-only

來源：GitHub 實時 `dsh-plugin` 搜索（按 stars 排序） + curated 列表（source=live，3408 條，
標 [curated] 的是僅見於 curated 的條目）。All plugins are third-party code — review the
source and pin a commit when installing. Browse https://awesome-dsh-plugin.com

注意事項¶

所有插件均爲第三方代碼：在使用任何通過此插件發現的插件前，請務必審查源碼。
限流細節：
- 無 Token 時：10 次/分鐘（按公網 IP）。
- 有 Token 時：30 次/分鐘，不按 IP 共享。
數據來源：插件返回的插件列表基於社區維護的 curated 列表和 GitHub 實時搜索，不保證 100% 的完整性。

總結¶

vclike/dsh-find-plugin 解決了 DSH 開發者在會話中查找插件的痛點。它通過整合 GitHub 搜索和 curated 列表，提供了一致的發現體驗。配合 Token 鑑權和離線降級機制，保證了在 API 限流或網絡波動情況下的可用性。