前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。隨着生態發展，dsh-plugin topic 下已有 2600+ 個倉庫。面對數量龐大的插件列表，開發者需要一種高效的方式來發現、篩選和獲取插件。awesome-dsh 作爲一個獨立的目錄與檢索工具，解決了插件查找難的問題。它不僅提供靜態目錄，還內置了通過 Workers AI 自動翻譯簡介和按需檢索的 Skill，幫助開發者快速定位目標插件。
核心功能¶
- 全量目錄抓取：自動抓取 GitHub topic
dsh-plugin下的全部插件目錄，支持 2600+ 插件。 - 自動翻譯：利用 Workers AI 將英文插件簡介自動翻譯成中文，並採用永久緩存策略，僅對新增或變更的條目進行翻譯。
- 按需檢索：提供中英混合詞檢索能力，分類僅基於原文，搜索則同時匹配原文和譯文。
- API 支持：提供
/api/search、/api/plugins.json、/api/facets.json、/api/status.json等接口，支持完整快照、分類標籤、抓取進度查詢及手動觸發。
安裝與啓用¶
該插件提供兩種啓用方式，根據使用的環境選擇其一。
裝進 DSH：
運行以下命令將插件註冊到 DSH 中：
dsh plugin --profile <profile> add github:stakeswky/awesome-dsh
裝進 Claude Code：
複製 SKILL.md 到本地技能目錄：
mkdir -p ~/.claude/skills/dsh-plugin-finder && cp SKILL.md ~/.claude/skills/dsh-plugin-finder/
典型用法¶
安裝後，可以通過對話直接觸發檢索，或通過 API 進行程序化調用。
對話檢索：
直接向 Claude Code 或 DSH 提出需求，例如：
“給 DSH 裝個能看圖的插件”
“DSH 有沒有記憶類插件”
系統會檢索本地目錄並返回匹配的插件及安裝命令。
API 檢索：
使用 /api/search 端點，參數包括 q（查詢詞）、kind（種類）、fn（倉庫名，可重複）和 limit（結果數量，默認 8，上限 25）。
curl "https://dsh.jamintextiles.com/api/search?q=vision&limit=5"
注意事項¶
- GitHub 限額：匿名抓取 GitHub 搜索 API 限額爲每分鐘 10 次，若需穩定運行全量抓取，需配置
GITHUB_TOKEN。 - 資源成本：Workers AI 與 KV 存儲均需 Workers 付費計劃，全量抓取過程超出免費版 CPU 與子請求額度。
- 包激活規則：未聲明
dsh.bundle的包只會作爲普通依賴裝上，不會激活插件層。 - 構建限制：git 源插件首次
add會被 pnpm 的allowBuilds攔下，需手動處理。 - 翻譯策略：翻譯採用永久緩存，僅翻譯新增或原文變更的條目。單條失敗會跳過並重試，不影響整體。
- 搜索邏輯：分類標籤僅匹配英文原文，搜索則同時匹配中英內容。
附錄¶
- 在線目錄：https://dsh.jamintextiles.com
- 項目主頁：https://github.com/stakeswky/awesome-dsh
