前言¶
在 DSH 裏做智能體時，經常要先確認一個能力是否已經有現成的 dsh 插件。這類信息通常分散在 npm、GitHub 倉庫和 awesome-dsh-plugin 清單裏，需要來回查包名、版本、倉庫和作者。
dsh-plugin-search 把“找插件、查元數據、瀏覽精選清單”放進 DSH agent 內部，減少在智能體工作流外手動查找的成本。
這是什麼¶
dsh-plugin-search 是面向 DeepSeek Harness 的插件發現工具，由 zoahdev 維護，許可證爲 MIT © 2026 zoahdev。
它在 DSH agent 內提供三類能力：
- 搜索
npm與awesome-dsh-plugin精選清單中的 dsh 插件； - 查詢 npm 包元數據，查不到時回退 GitHub 倉庫搜索；
- 瀏覽當前
awesome-dsh-plugin精選清單。
核心功能¶
下面介紹它提供的三個工具。
dsh_search_plugins¶
dsh_search_plugins 用於搜索 dsh 插件。
它會同時搜索 npm 與 awesome-dsh-plugin 精選清單，並以 npm 結果優先、去重，同時帶版本與來源標籤。
適合這類問題：
- 某個能力是否已有 dsh 插件；
- 哪些插件名稱相近，需要區分；
- 某個插件來自 npm，還是來自
awesome-dsh-plugin清單。
dsh_plugin_lookup¶
dsh_plugin_lookup 用於精確查詢插件包。
它會查詢 npm 元數據，包括：
- 最新版本；
- 描述；
- 主頁；
- 倉庫；
- 作者。
如果 npm 中查不到，它會回退到 GitHub 倉庫搜索。
dsh_awesome_top¶
dsh_awesome_top 用於瀏覽當前 awesome-dsh-plugin 精選清單。
它可以在 DSH 內快速查看當前精選清單中的插件，瞭解可選擇的 dsh 插件範圍。
安裝與啓用¶
從 GitHub Release 安裝 v1.1.0 tarball 到 web profile：
dsh plugin --profile web add https://github.com/zoahdev/dsh-plugin-search/releases/download/v1.1.0/dsh-plugin-search-1.1.0.tgz
如果已經本地構建出 tarball，也可以按 README 給出的方式添加：
dsh plugin --profile web add ./dsh-plugin-search-1.1.0.tgz
package.json 聲明的 peerDependencies 如下：
{
"@deepseek-ai/cordis": "^4.0.1",
"@deepseek-ai/dsh-tools": "^0.1.0-rc.6"
}
也就是說，使用時環境需要提供 @deepseek-ai/cordis ^4.0.1 和 @deepseek-ai/dsh-tools ^0.1.0-rc.6。
典型用法¶
安裝後，可以在 DSH 裏直接對 agent 說：
幫我找一個能監控 GitHub release 的 dsh 插件。
也可以使用英文：
Find me a dsh plugin that tracks GitHub releases.
這些示例用於讓 agent 在 DSH 內查找相關 dsh 插件，而不是手動離開 DSH 去 npm 或 GitHub 搜索。
適用場景與注意¶
適合以下場景：
- 在 DSH 內判斷某個能力是否已有現成 dsh 插件；
- 查看某個 dsh 插件的 npm 元數據；
- npm 中查不到時，繼續查看 GitHub 倉庫；
- 瀏覽當前
awesome-dsh-plugin精選清單。
注意：
- 插件以當前 dsh 進程權限運行；
- 安裝前應檢查源碼與許可證；
- 許可證爲
MIT © 2026 zoahdev。
dsh-plugin-search 的價值在於把插件發現過程放進 DSH 工作流內：搜索、查詢和瀏覽清單可以在 agent 內部完成。
GitHub 倉庫：
https://github.com/zoahdev/dsh-plugin-search
