@deepseek-ai/dsh-web-fetch-local

English | 中文

一个匿名公共 HTTP(S) WebFetchProvider，用于 harness web 能力 seam（ctx.web）。它获取具体 URL，返回状态码与有界解码内容。

这是一个实现包：它向 ctx.web 注册提供方，不拥有该 key，也不注册面向模型的工具。它是函数／namespace 插件（inject: ['web']）。

职责拆分

提供方拥有安全资源获取：URL 验证、HTTP 传输、重定向策略、资源兜底超时、中止传播、字节上限、charset 解码、内容类型分类与二进制拒绝。@deepseek-ai/dsh-tool-web 拥有呈现（HTML→markdown、截断格式）。非 2xx HTTP 响应是结果（状态码 + 解码主体），不是错误；WebError 只用于无法安全获取或表示资源的失败。

提供方的 timeoutMs 是直接 ctx.web.fetch() 调用方与错误配置部署的资源兜底，不是面向模型的工具调用预算。dsh-timeout-policy 拥有 web_fetch 工具调用预算，并通过武装 exec.signal 强制执行该预算。

已交付的 web 工具部署会把提供方兜底设为高于工具预算，因此模型调用通常返回 TOOL_TIMEOUT。如果外层 deadline 先到达提供方，提供方报告 WEB_ABORTED，外层策略再将其替换为 TOOL_TIMEOUT。因此，WEB_FETCH_TIMEOUT 标识提供方预算已经耗尽的直接 seam 调用方。

传输卫生

只接受 http: 和 https: URL；拒绝 URL 中的 credential（WEB_BLOCKED_URL）以及过长／格式错误的 URL（WEB_INVALID_URL）。
强制执行 URL 最大长度、响应字节上限（WEB_FETCH_TOO_LARGE）、解码主体字符上限、超时（WEB_FETCH_TIMEOUT）和重定向跳数上限。
把调用方的中止信号（WEB_ABORTED）传播到网络请求与流式读取。
只跟随同源重定向；跨源重定向以 WEB_REDIRECT_BLOCKED 失败，要求发起新的工具调用（沿用 Claude Code 的 WebFetch 模型）。
发送显式的产品 User-Agent，绝不伪装成浏览器。
不受支持的内容类型（例如二进制）以 WEB_UNSUPPORTED_CONTENT_TYPE 拒绝。

配置

Key	默认值	含义
`maxUrlLength`	`2048`	接受的请求 URL 最大长度。
`maxResponseBytes`	`5_000_000`	响应主体最大字节数。
`maxBodyChars`	`100_000`	解码主体最大字符数。
`timeoutMs`	`30_000`	Node 定时器范围内的抓取超时：直接 `ctx.web.fetch()` 调用方的资源兜底，而非面向模型的工具调用预算（后者属于 `dsh-timeout-policy`）。
`maxRedirects`	`5`	同源重定向最大跳数（`0` 表示完全不跟随）。
`userAgent`	`deepseek-harness/…`	`User-Agent` 标头。

数值限制会在插件构造时验证：除 maxRedirects 外，每个上限都必须是正的有限数；maxRedirects 必须是非负整数。无效值会抛出异常，不会静默构造限制荒谬的提供方。

模型体验

通过 dsh-tool-web 间接影响；该工具把此提供方经 maxBodyChars 限制的解码文本或 markdown 形状 HTML 置于抓取结果包装中，并保留提供方失败；重定向、标头与传输机制保持隐藏。

KV Cache 影响

不会直接失效；请求前缀变更由命名消费方负责。

已知限制与暂缓事项

SSRF／私有网络防护暂缓：不会阻止私有、loopback、link-local、multicast 或其他非公开目标，也不进行 DNS 解析后验证或逐跳重新验证（见 web 能力 seam Agent Note）。在此功能落地前，该提供方是 SSRF 原语；能够访问敏感内部网络目标的部署禁止启用它。
只解码文本内容：包括 html/xhtml 与 text/* 加 JSON/XML 家族；缺少 Content-Type 或任何二进制类型都会抛出 WEB_UNSUPPORTED_CONTENT_TYPE，可提取文本的 PDF 解码属于明确的暂缓工作。
charset 只来自 Content-Type 标头（默认为 UTF-8）：HTML <meta charset> 声明会被忽略；声明但无法识别的 charset label 会抛出异常，而非回退。

4.2 KiB Raw Blame History Unescape Escape