dsh-web-fetch-enhanced 0.0.2 → 0.0.3

package/README.en.md

@@ -178,7 +178,7 @@ Most users only need the two allowlists exposed in DSH Web. Manage other values
 | `maxRedirects` | `5` | Maximum same-origin redirect hops; `0` disables following |
 | `userAgent` | `dsh-web-fetch-enhanced/0.1.0` | User-Agent sent with each request |
 
-The default bundle uses the separate `http-enhanced` provider ID and leaves the native `http` provider installed. For manual composition or drop-in replacement, see:
+The default bundle uses the separate `http-enhanced` provider ID and explicitly disables the native `web-fetch-http` provider to avoid `WEB_PROVIDER_AMBIGUOUS` when subsequent Web plugins (such as search plugins) overwrite `id: web` configuration and unpin `fetchProvider`. For manual composition or drop-in replacement, see:
 
 - [coexisting provider example](examples/coexist.cordis.yml)
 - [drop-in replacement example](examples/drop-in.cordis.yml)

package/README.md

@@ -178,7 +178,7 @@ wiki.corp.example
 | `maxRedirects` | `5` | 同源重定向最大跳数；`0` 表示不跟随 |
 | `userAgent` | `dsh-web-fetch-enhanced/0.1.0` | 每个请求使用的 User-Agent |
 
-默认安装采用独立的 `http-enhanced` provider ID，并保留原生 `http` provider。需要手动组合或 drop-in 替换时，参考：
+默认安装（通过 bundle `cordis.patch.yml`）采用独立的 `http-enhanced` provider ID，并显式禁用原生的 `web-fetch-http`，以避免后续其他 Web 插件（如 search 插件）覆盖 `id: web` 的 config 时因 `fetchProvider` 变成未指定而触发 `WEB_PROVIDER_AMBIGUOUS`。需要自定义组合或 drop-in 替换时，参考：
 
 - [独立 provider 示例](examples/coexist.cordis.yml)
 - [drop-in 替换示例](examples/drop-in.cordis.yml)

package/cordis.patch.yml

@@ -1,9 +1,10 @@
 # Optional Profile Bundle: select the enhanced HTTP fetch provider on the Host plane.
-# This layer is applied after @deepseek-ai/dsh-base. A patch replaces a row's
-# entire config, so both WebRuntime selector fields are restated here.
+# Disable the native HTTP fetch provider to avoid WEB_PROVIDER_AMBIGUOUS when fetchProvider is unpinned by later bundles.
+- id: web-fetch-http
+  disabled: true
+
 - id: web
   config:
-    searchProvider: deepseek-official
     fetchProvider: http-enhanced
 
 - insert:

package/docs/design.zh-CN.md

@@ -47,13 +47,13 @@ flowchart LR
 <code>ctx.web</code> 的选择是 ID 驱动而不是注册顺序驱动：
 
 - 配置 <code>fetchProvider: http-enhanced</code> 时只选择本插件默认 ID；
-- 保留原生 <code>http</code> provider 不会产生歧义，因为选择已显式固定；
+- 默认 bundle 会在 Profile 中显式禁用原生的 <code>web-fetch-http</code>，从而在多 Web 插件（如 search 插件）覆盖 <code>id: web</code> config 导致 <code>fetchProvider</code> 未固定时，系统只存在唯一的可用 fetch provider，避免 <code>WEB_PROVIDER_AMBIGUOUS</code>；
 - 未配置 ID 且存在多个可用 provider 时会报 <code>WEB_PROVIDER_AMBIGUOUS</code>；
 - 两个 provider 注册相同 ID 会立即报 <code>WEB_DUPLICATE_PROVIDER</code>。
 
 所以“覆盖原生”有两种明确模式：
 
-1. 推荐模式：本插件使用 <code>http-enhanced</code>，修改现有 web 行的 <code>fetchProvider</code>；
+1. 推荐模式：本插件使用 <code>http-enhanced</code>，修改现有 web 行的 <code>fetchProvider</code> 并禁用原生 <code>web-fetch-http</code>（由随包附带的 <code>cordis.patch.yml</code> 自动处理）；
 2. drop-in 模式：禁用原生 provider，本插件配置 <code>providerId: http</code>。
 
 不存在 last-wins 或自动 fallback。

package/examples/drop-in.cordis.yml

@@ -1,8 +1,6 @@
 # Profile user patch after installing the bundle, retaining fetchProvider: http.
-# A patch replaces a row's whole config, so both WebRuntime fields are restated.
 - id: web
   config:
-    searchProvider: deepseek-official
     fetchProvider: http
 
 # The native provider MUST be disabled to avoid duplicate provider id "http".

package/examples/manual.cordis.patch.yml

@@ -1,8 +1,10 @@
 # Manual Host overlay when the package is resolvable but its dsh.bundle layer
 # is not active. Bundle users should use coexist.cordis.yml instead.
+- id: web-fetch-http
+  disabled: true
+
 - id: web
   config:
-    searchProvider: deepseek-official
     fetchProvider: http-enhanced
 
 - insert:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-web-fetch-enhanced",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "Configurable non-public address allowlists for DeepSeek Harness web_fetch",
   "type": "module",
   "main": "./lib/index.js",