在使用 DeepSeek Harness (DSH) 或 DSH Desktop 進行智能體開發時，快速篩選合適的公共 API 是常見需求。手動瀏覽列表往往效率低下且缺乏過濾能力。dsh-universe-api 插件提供了一個離線、確定的解決方案。
是什麼¶
這是一個爲 DeepSeek Harness (DSH) 和 DSH Desktop 提供的離線 API 發現插件。由 Ruixinhua 維護。它註冊了一個名爲 universe_api_search 的只讀工具，用於對 public-apis 目錄的標準化快照進行確定性搜索。
核心功能¶
該插件提供以下能力：
- 離線搜索：在 1,693 條標準化公共 API 記錄上進行離線、確定性搜索。
- 多語言支持：支持英文和中文查詢擴展、Unicode 標準化以及 CJK 感知匹配。
- 硬過濾：對類別、認證、HTTPS、CORS、狀態和來源層級進行硬性過濾。
- 穩定排名：提供匹配原因和目錄新鮮度元數據，實現穩定排名。
- 私有目錄：可選的私有 canonical-v1 目錄可完全替換捆綁的快照。
- 統一契約：一個在 CLI、Web 配置文件和 DSH Desktop 中均可重用的 DSH 契約。
安裝與啓用¶
在 DSH Desktop 的終端中運行以下命令進行安裝：
dsh plugin add github:Ruixinhua/dsh-universe-api#v0.1.2
更改文件或路徑後，請重啓 DSH Desktop 以確保新包進入 Loader 組合。
典型用法¶
直接在 DSH 提示中使用工具。
Use universe_api_search to find 3 weather APIs that require no API key and have HTTPS=yes and CORS=yes. Explain why each result matched.
中文示例：
請使用 universe_api_search，找 3 個無需 API key、HTTPS=yes、CORS=yes 的天氣 API，並說明匹配理由。
工具接受以下輸入參數（類型及行爲）：
| 參數 | 類型及行爲 |
|---|---|
query |
可選的自然語言字符串，最長 2,048 字符。省略此參數僅使用過濾器瀏覽。 |
categories |
可選字符串數組，最多 20 個值，每個最長 128 字符。多個值使用 OR 語義。 |
sourceTier |
all（默認）、public 或 apilayer。 |
auth |
none、api_key、oauth2、basic、bearer、signed、user_agent、other 或 unknown。 |
https、cors |
yes、no 或 unknown；值精確匹配。 |
status |
active、coming_soon、stale、candidate 或 unknown。 |
limit |
1 到 20 的整數；默認 5。 |
適用場景與注意¶
- 性質：這是一個發現工具，而非 API 客戶端。它從不調用候選 API，不接受 API 密鑰，也不執行運行時網絡請求。
- 驗證：在做出重要選擇前，請務必在提供商的官方文檔中核實定價、可用性、認證和條款。
- 嚴格過濾：插件在無匹配項時不會靜默放寬過濾條件。特別是
unknown不同於no，且在僅包含公共數據的捆綁目錄中，sourceTier: "apilayer"返回零結果。
結語¶
該插件爲 DSH 提供了一套可靠的離線發現機制。源碼與文檔位於：https://github.com/Ruixinhua/dsh-universe-api
