dsh-anysearch-fallback
让 web_fetch 在上游 AnySearch 抽取失败（HTTP 422）时自动降级为受约束的浏览器 UA 直抓；零运行时依赖，只读 ctx.web.fetchProviders，不改任何 DSH 私有字段
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ADkun/dsh-anysearch-fallback#4079ad34b4eaa5109c9362528e1f60c5236425cdAnysearch Fallback 以 dsh-anysearch-fallback 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DSH 的 web_fetch 加一条降级兜底：AnySearch 抽不出内容（HTTP 422）时，自动改用浏览器 UA 直抓。
Gives DSH's web_fetch a fallback: when AnySearch cannot extract a page (HTTP 422), fetch it directly with a browser-like user agent instead of failing the whole call.
DSH 的 web_fetch 走 AnySearch 的 /v1/extract。有些页面（openai.com、知乎问题页、不存在的路径……）上游会返回 HTTP 422 extract_failed，于是整次 web_fetch 直接报错。本插件在那个位置接一手：先照旧走 AnySearch，只有 422 时才直抓原文兜底。
ctx.web 注册的 provider 链：
anysearch-fallback (provider id: anysearch-fallback) ← web_fetch 选中它
│
├─ 代理到官方 AnySearch provider 的 extract
│ ├─ 成功 → 原样返回（逐字段不变）
│ ├─ 422 / extract_failed → 进入直抓兜底
│ └─ 401 / 402 / 403 / 429 / 超时 / 网络错误 → 原样抛错，绝不掩盖
│
└─ 直抓兜底：浏览器 UA + 协议/内网校验 + 5 MB 字节上限 + 15s 超时
→ 返回带标记的纯文本（正文顶部写入降级标记，模型一眼可辨）
@anysearch/anysearch-dsh 的任何文件，也不改 DSH 私有字段；它以自己的 id anysearch-fallback 注册 provider，内部再按 id 调官方 anysearch provider。index.mjs 里的 UPSTREAM_PROVIDER_ID）。| 项目 | 取值 |
|---|---|
| provider id | anysearch-fallback（由本插件的 - id: web 覆盖把 fetchProvider 指到它；上游仍是官方 anysearch） |
| 触发降级 | 仅：httpStatus === 422（上游真实字段）／errorCode 字段值 extract_failed／消息含那句 Unable to extract content from the URL.。按字段值判，不按子串判 —— 无关错误里出现 statusCode: 422 或文本里提到 extract_failed 都不会触发 |
| 不降级 | 401 / 402 / 403 / 429 / 超时 / 网络错误 / 非 JSON 响应 |
| 协议白名单 | 仅 http: / https:（file: / data: / ftp: / blob: 等拒绝） |
| 内网拒绝 | localhost / *.localhost / *.local / .internal；IPv4 0.0.0.0、127/8、10/8、172.16/12、192.168/16、169.254/16、100.64/10；IPv6 ::1、fc00::/7、fe80::/10；IPv4-mapped IPv6（::ffff:127.0.0.1） |
| 字节上限 | 5 MB，流式读取（response.body），超限立即 cancel() |
| 字符上限 | 与 DSH 工具侧一致（DEFAULT_FETCH_MAX_OUTPUT_CHARS），超出裁剪并置 truncated: true |
| 超时 | 自带 15s，串联上游 signal，任一触发即中止并说明来源 |
| 请求头 | 固定桌面 Chrome UA + accept + accept-language；不带 Authorization / Cookie / Referer |
| 重定向 | redirect: 'manual'，最多 3 跳，每一跳都重做协议与内网校验 |
| 磁盘缓存 | 无 |
作为本地插件挂进某个 DSH profile：
# 1) 把本目录放到 <DSH_HOME>/plugins/dsh-anysearch-fallback/
# 2) 在 profile 的 package.json 里加依赖（相对路径写法）
# "dsh-anysearch-fallback": "file:C:/Users/you/.dsh/plugins/dsh-anysearch-fallback"
# 3) 把它追加到 profile 的 dsh.profile.bundles 末尾
# （放最后 = 它的 `- id: web` 覆盖在官方 anysearch 之后生效）
# 4) 在 profile 的 node_modules 下建同名入口（本机既有形状：真目录 + 硬链接）
# 5) 重启 DSH —— 新开一个对话不够，profile 的配置树是启动时组合的
本插件的 cordis.patch.yml 会 insert 自己的 bundle（id dsh-anysearch-fallback），并把 web 服务的 fetchProvider 覆盖为 anysearch-fallback（searchProvider 必须一起原样写上——patch 对 config 是整体替换、不深合并）。具体层内覆盖请按你的 profile 现状调整。
npm test # 离线单测：49 通过 / 1 跳过（联网用例默认跳过）
test/integration.test.mjs 是联网实测用例（真实 422 → 真实直抓）：它需要 @anysearch/anysearch-dsh 及其 peer 包可被解析。仓库内默认跳过；在本机已装好的环境里可按该文件头部的注释搭一个临时 staging 目录（node_modules 里为 @deepseek-ai/* 建 junction）后运行。
dsh-web 自带的 dsh-web-fetch-http 用 ipaddr.js + undici pinned agent 做了这套地址钉扎；本插件刻意零依赖，故未复刻。)http://user:pw@example.com/（只给用户名也算）一律以 WEB_BLOCKED_URL 拒掉，错误消息里点名 userinfo；不做静默剥离 —— 用户显式给了带凭证的 URL 就明确报错，比悄悄改写更可预测。168.63/16、198.18/15、192.0.0/24 等非公网段被判为内网并拒绝，宁可误拒。web_fetch 工具预算 30 s 由 DSH 工具层硬编码，本插件不碰；兜底直抓自带 15 s，若上游已耗尽大部分预算，兜底可能来不及完成。MIT
Problem. web_fetch goes through AnySearch /v1/extract; for some pages the upstream answers HTTP 422 extract_failed and the whole fetch call fails. This plugin steps in only there: it registers its own anysearch-fallback fetch provider, points the web service at it, delegates to the official anysearch provider first, and only on 422 degrades to a direct fetch.
Guarantees.
http:/https:; localhost, private, link-local, CGNAT and IPv4-mapped IPv6 targets are refused.user:pw@host) is refused as WEB_BLOCKED_URL and named as such — never silently stripped.response.body), never response.text(); character cap matches DSH's tool layer.accept/accept-language; no Authorization, Cookie, Referer; no TLS bypass; no disk cache.Not done. No DNS-rebinding pinning after resolution, no retry, no timeout-budget change, naive HTML reduction (lower quality than AnySearch extraction).
Test. npm test — 49 passed / 1 skipped offline. The network integration test is skipped unless the installed official bundle and its peer packages are resolvable.
License. MIT