在使用 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
