dsh-web-search-ddg

LIMITATIONS

已知限制

这些限制说明本提供方何时是差劲选择。 - **异常检测基于签名**——「不携带结果标记的 2xx」视为限流并触发失败预算：包括 HTTP 202 异常页，以及任何以完全没有 `#links` 容器的页面应答的状态（活体验证：所有被正常服务的页面——有机结果、模糊匹配、真正的无结果页——都携带该容器；只有质询页没有）。以 HTTP 200 下发、仍携带 `#links` 却没有行的质询页仍读起来像真正的空查询。 - **提供方内部不重试**——单次瞬态失败会以结构化错误呈现给调用方；只有重复发生（预算）才让提供方让位。是否重试一次失败的查询由调用方决定。 - **抓取标记脆弱**——移除 `#links` 容器的漂移现在抛出瞬态失败而非无声的空结果，但保留容器、只是改了行类名的漂移仍会解析为零条来源，看起来像一次糟糕的查询。 - **标题为空或 URL 不可用的行被丢弃**——没有可映射的可移植值，因此返回的条数可能少于请求数量。 - **`truncated` 永远不是 `true`**——本提供方把可用输出截断到 `request.maxResults`（或配置默认值），所以 seam 永远看不到过量返回，也永远不会翻转该标志。调用方无法得知页面实际存在更多结果；如需知晓，请请求更多条数。 - **无 `publishedAt`，无 `content`**——静态标记两者都不携带，因此无法按发布日期过滤，也没有提供方答案；带密钥的后端是提供这些能力的。 - **查询塑形未暴露**——地区、safesearch、时间与类型过滤、翻页目前还没有提供方中立的 service 字段可挂载；配置面覆盖 `endpoint`、`maxResults` 与失败预算旋钮。 - **中止分类基于错误形状**——只有名为 `AbortError` 的 `DOMException`，或已中止的信号，会映射为 `WEB_ABORTED`；携带自定义 reason 的中止会呈现为 `WEB_PROVIDER_ERROR`。 - **未认证抓取带有服务条款风险**——高并发部署应使用有授权或第一方的后端。