前言¶
DeepSeek Harness（簡稱 dsh）是 DeepSeek 開源的智能體運行時，核心理念是「一切皆插件」：模型、工具、會話、沙箱、界面都可以換成插件，不必改 Harness 源碼。官方倉庫也約定：社區插件只要在 GitHub 倉庫打上 dsh-plugin topic，就能被生態發現。
實際用起來會碰到一個很具體的問題。插件數量已經不少，社區目錄、精選列表、GitHub topic 頁各有一份索引，但你人還在 Harness 會話裏：想找「任務完成發微信」「終端 TUI」「git diff 審查」這類能力，往往得切出去搜一圈，再把安裝命令拷回來。dsh-find-plugin 做的就是把這一步收進會話——讓智能體自己去搜，把結果和安裝命令帶回來。
本文介紹的是 awesome-dsh-plugin 維護的 dsh-find-plugin（不要和另一款同名相近的 dsh-find-plugins 搞混），資料以插件目錄頁、GitHub README / 源碼、npm 包以及 DeepSeek Harness 官方倉庫交叉覈對。社區插件目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，不要把它當成官方應用商店。
這是什麼¶
dsh-find-plugin 是一款開發與運行時插件，維護者是 GitHub 組織 awesome-dsh-plugin。它給智能體註冊一個工具 find_dsh_plugin：按關鍵詞即時檢索打了官方 dsh-plugin topic 的 GitHub 倉庫，按 star 排序，返回一句話描述、倉庫鏈接和可直接執行的 dsh plugin add 命令。
倉庫 README 把它類比成 skills.sh 上的 /find-skills，只是對象換成了 DSH 插件。許可證是 MIT。主要語言是 TypeScript，npm 包名就是 dsh-find-plugin，本稿覈對到的版本是 0.3.6（2026-08-14 發佈）。GitHub 倉庫在 2026-08-17 讀取到的星標是 40（目錄頁當時仍顯示 20，以 GitHub 一手數據爲準）。插件已收錄在社區目錄「開發與運行時」分類，收錄日期 2026-08-14。
它解決的問題很窄：不必離開當前 Harness 會話，就能按能力描述把候選插件搜出來。它本身不負責替你審查源碼，也不在源碼裏實現「檢查已安裝插件是否可用」這一步；目錄頁簡介裏的「檢查並驗證安裝」，在當前倉庫的 find_dsh_plugin 實現中看不到對應邏輯。搜到之後如果讓智能體幫忙裝，它會去跑返回的安裝命令——裝的仍然是第三方代碼。
核心功能¶
結合 README 和源碼（src/index.ts、src/github.ts、src/registry.ts），當前能力可以概括成下面幾條。
1、按 topic 做即時倉庫搜索。 查詢會拼成 GitHub 搜索 關鍵詞 topic:dsh-plugin，走匿名 API，不需要你配置 Token。同一查詢有 5 分鐘內存緩存，源碼註釋寫明未認證搜索大約每分鐘 10 次請求，緩存是爲了把本地工具調用壓在限額內。工具超時 10 秒，GitHub 請求超時 4 秒。
2、按 star 重新排序。 搜索結果按 stargazers_count 降序。默認最多返回 8 條，limit 上限 20。每條包含名稱、star 數、描述、倉庫 URL，以及一條安裝命令，格式爲：
dsh plugin --profile web add github:owner/repo
3、精選列表只改描述，不改排名。 如果某個倉庫也出現在 awesome-dsh-plugin 的 plugins.json 裏，會用列表中人工撰寫的雙語描述替換 GitHub 倉庫簡介；lang 參數選語言（例如 zh / en），默認 en。精選列表拉不到時會退回倉庫自帶的 snapshot，失敗則只用 GitHub 描述。排序始終按 star，不受精選列表影響。
4、對話裏由智能體自行調用。 安裝並重啓 dsh web 之後，不需要記工具名。你用自然語言說想要什麼能力，智能體在判斷「當前 Harness 缺這個能力」或「用戶在問有哪些插件」時，會自己調用 find_dsh_plugin。
工具參數如下（來自源碼裏的 defineTool 定義，不是猜測）：
query：必填。描述能力的關鍵詞，例如wechat notifications、TUI、跨會話記憶。limit：返回條數，默認 8，最大 20。lang：精選條目描述語言，默認en。中文環境可以讓智能體帶zh。
安裝與啓用¶
社區目錄頁給出的安裝命令是：
dsh plugin add github:awesome-dsh-plugin/dsh-find-plugin
倉庫 README 和 awesome-dsh-plugin 詳情頁推薦走 npm 預構建包，並顯式指定 web profile（這和 DeepSeek Harness 官方文檔裏 dsh plugin --profile <profile> add ... 的寫法一致）：
# npm 包（預構建，README 推薦）
dsh plugin --profile web add dsh-find-plugin
# 或從 GitHub 安裝
dsh plugin --profile web add github:awesome-dsh-plugin/dsh-find-plugin
需要可復現安裝時，按目錄頁說明把 commit 哈希釘死，不要一直追倉庫默認分支：
dsh plugin add github:awesome-dsh-plugin/dsh-find-plugin#<commit>
幾點安裝時要注意：
- 插件以當前 dsh 進程的權限運行，安裝時還可能執行構建腳本。裝之前先看源代碼倉庫和許可證。
- README 寫明：裝完後要重啓
dsh web，工具纔會進當前會話。 - 從 GitHub 裝 TypeScript 源碼時，pnpm 10 及以上可能攔截
prepare/ 構建腳本。awesome-dsh-plugin 詳情頁寫過：第一次add若提示allowBuilds，按提示把包名寫進該 profile 的pnpm-workspace.yaml後再執行一次。npm 預構建包一般不需要這一步，所以 README 把它標成推薦路徑。 - 這個包在
package.json裏聲明瞭dsh.bundle.patch指向./cordis.patch.yml，補丁會把 id 爲find-dsh-plugin的一行插入 profile 的插件棧。peer 依賴是@deepseek-ai/cordis和@deepseek-ai/dsh-tools。
典型用法¶
裝好並重啓之後，直接跟智能體說話即可。README 給的例子如下，可以原樣拿去試：
有什麼終端 TUI 插件？
我想任務完成時收到微信通知，有插件嗎？
找個能在 DSH 裏做 git diff 審查的東西。
智能體調用 find_dsh_plugin 後，會得到類似下面這種文本（格式來自源碼的 renderText，具體條目隨 GitHub 即時結果變化，這裏只說明結構）：
1. 某插件名 ★123 — 一句話描述
https://github.com/owner/repo
install: dsh plugin --profile web add github:owner/repo
每條都帶 star、描述、倉庫鏈接和安裝命令。README 寫明：你可以讓智能體接着執行其中一條 dsh plugin add。搜不到時，工具會提示換更寬的關鍵詞，或去 https://awesome-dsh-plugin.com 瀏覽精選列表。
返回結果裏還會附一句固定說明：這些都是第三方代碼，安裝前請審閱源碼並鎖定 commit。這不是客套，和目錄頁、官方文檔的安全提示是同一件事。
適用場景與注意事項¶
比較適合這幾類人：已經在用 dsh web、經常要給智能體加能力，但不想每次切到瀏覽器翻 GitHub topic 或社區目錄。關鍵詞能對應到倉庫名或簡介時，搜索最有效，例如 TUI、通知、diff、記憶。
使用時有幾條邊界需要心裏有數：
1、它搜的是 GitHub topic，不是「官方認證商店」。 任何打了 dsh-plugin 的公開倉庫都可能出現。沒有 topic 的插件它搜不到。DeepSeek Harness 官方也只是把該 topic 當作發現約定，並不爲社區插件背書。
2、精選描述和搜索範圍不是一回事。 awesome-dsh-plugin 詳情頁有一句「按關鍵詞/分類搜索本精選 registry」；對照源碼，真正發請求的是 GitHub 倉庫搜索，精選 plugins.json 只用來替換描述。分類並不是工具參數。寫文章時以源碼和 README 的「How it works」爲準。
3、同名插件不要裝錯。 社區目錄裏還有 dsh-find-plugins（Nagi-ovo 維護，帶安裝與驗證流程）。本文介紹的是 awesome-dsh-plugin/dsh-find-plugin，安裝命令和倉庫地址都不同。
4、匿名 API 有限額，也依賴網絡。 沒有配置 GitHub Token。緩存按查詢字符串，換關鍵詞就是一次新請求。GitHub 搜索失敗時工具會報 HTTP 錯誤，不會悄悄編造結果。
5、安全模型與官方一致。 目錄頁寫得很清楚：插件以當前 dsh 進程權限運行，安裝時可能執行代碼。DeepSeek Harness 官方文檔同樣提醒：允許構建腳本等於允許安裝期在本機執行第三方代碼，且不在智能體沙箱裏。只裝你信任的源，並儘量釘 commit。dsh-find-plugin 自己搜出來的候選，也適用同一條規則——它給你的是命令，不是擔保。
DeepSeek Harness 目前仍是 developer preview，官方 README 用大寫標明會有破壞性變更。插件的工具 API、profile 安裝方式後續都可能跟着變，安裝前看一下倉庫當前 README。
小結¶
dsh-find-plugin 把「在 GitHub 上找帶 dsh-plugin topic 的倉庫」收進了 Harness 會話：即時搜索、按 star 排序、帶上安裝命令，命中精選列表時換用人工寫的雙語描述。它不替代你對第三方代碼的審查，只是少一次切出去翻目錄的步驟。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-find-plugin/
GitHub：https://github.com/awesome-dsh-plugin/dsh-find-plugin
npm：https://www.npmjs.com/package/dsh-find-plugin
