搜索接缝锁定 xyx-cmd-maker/dsh-web-tune

dsh-web-tune

一个 DeepSeek Harness 配置档包，调整两行由其他包负责的配置：把 dsh-free-search 固定到它的 auto 引擎池，同时让 web 接缝继续指向随包提供的服务商，这样安装 dsh-tinyfish 时，就不会悄悄接管所有搜索和所有抓取。

它不附带任何服务、工具或 UI。这个包存在的唯一目的就是携带一个补丁文件，index.js 故意留空。

为什么需要它

DeepSeek Harness 通过叠加补丁层来组合配置档：dsh.profile.bundles 里的每个包按列表顺序依次叠加，最后再叠加配置档自己的 cordis.patch.yml。后叠加的层生效，而且补丁会替换整行的 config 对象，而不是合并键。

dsh-tinyfish 附带一个补丁，把两个 web 服务商都指向自己：

- id: web
config:
searchProvider: tinyfish
fetchProvider: tinyfish

对于一个只负责 TinyFish 的包来说，这很合理，但它一装上就改变了两个全局决策。没有配置 TinyFish 凭据时，web_search 和 web_fetch 会失败；而且 free-search 插件不再用于搜索，因为接缝已经不再指向它。

想要不同安排的主机，必须在更靠后的层里覆盖这些行。这个包做的就是这件事。它 README 里「选择服务商」一节说的也是同一件事，给出的补丁形状也一样。

安装

track the default branch
dsh plugin --profile <profile> add github:xyx-cmd-maker/dsh-web-tune

or pin a release, which is what you want for a working setup
dsh plugin --profile <profile> add github:xyx-cmd-maker/dsh-web-tune#v1.0.0

main 分支还会带上文档和 CI 的改动，所以跟踪它意味着检出会因不影响行为的原因而移动。标签不会。

这个包必须是 dsh.profile.bundles 里的最后一个，因为补丁层按列表顺序生效，而它必须排在它所覆盖的包之后。dsh plugin add 是追加，所以全新安装时它已经在最后。如果在 dsh-free-search 或 dsh-tinyfish 之前安装它，覆盖会悄悄失效。

重启 Harness，或者让插件管理器重新加载该层。

它设置了什么

- insert:
- id: web-tune
name: dsh-web-tune
config: {}

- id: web-search-free
config:
provider: auto
disabledEngines: []
bingMarket: zh-CN
fetchProviderTakeover: false

- id: web
config:
searchProvider: deepseek-official
fetchProvider: http

四个决策，每一个都是有意为之：

provider: auto 会在已启用的引擎之间路由，某个引擎失败时回退。固定引擎是单点故障：比如 DuckDuckGo，从某些网络无法访问，会返回连接错误，这会让 ddg 固定配置下什么都拿不到。

fetchProviderTakeover: false 让搜索插件不再同时改写 fetch。它默认是 true，会把 fetch 请求交给自己的提取器处理。

searchProvider: deepseek-official 是随包发布的默认值，不是某个引擎 id。dsh-free-search 在运行时接管这个字段，但字段值仍读作该默认值，所以搜索依然走免费池。在这里写死一个具体的服务商 id，一旦插件之后被禁用，就会留下悬空引用——这正是它自己的补丁文件里记录过的故障。

fetchProvider: http 让 fetch 留在内置服务商上。除了请求本身，没有任何东西离开这台机器。

把 fetch 切换到 TinyFish

web 接缝在整个进程里只持有一个 fetch 服务商，没有按请求覆盖的机制。要换就是改配置，改一次。

编辑 cordis.patch.yml：

- id: web
config:
searchProvider: deepseek-official
fetchProvider: tinyfish

然后重新安装，让这一层重新落到最后的位置：

dsh plugin --profile <profile> remove dsh-web-tune
dsh plugin --profile <profile> add github:xyx-cmd-maker/dsh-web-tune

TinyFish 得先有凭据才有用。凭据存到 Harness 凭据服务或插件自己的设置卡片里，不要写进这个文件。

如果你更想要单一服务商、完全不做切换，那就等密钥就位后选这套安排：TinyFish 处理需要 JavaScript 的页面，free-search 继续负责搜索。只有当你很在意普通页面 URL 留在本地时，保留 http 才是更好的选择。

卸载

dsh plugin --profile <profile> remove dsh-web-tune

移除后会恢复 bing 作为 free-search 引擎，并让 dsh-tinyfish 接管 web 服务商，也就是这个 bundle 存在之前的状态。如果你想两个都不要、回到随包发布的服务商，先移除 dsh-tinyfish。

兼容性

engines.dsh 为 >=0.2.0 <0.3.0。已针对 DSH 0.2.1-rc.2 测试。

它覆盖的那些行属于其他包。如果 dsh-free-search 重命名了 provider，或者去掉了 fetchProviderTakeover，这里对应的条目就不再起作用；某行配置里出现未知键会被忽略，而不是报错，所以故障表现是设置悄悄失效。大版本升级后，请检查插件自己的配置 schema。

检查

node --check index.js
node scripts/check_manifest.mjs
python3 -c "import yaml; yaml.safe_load(open('cordis.patch.yml'))"

check_manifest.mjs 无需依赖即可运行，检查的不只是语法：manifest 自身一致，它列出的每个文件都存在，补丁里仍然写着 provider: auto、fetchProviderTakeover: false、searchProvider: deepseek-official、fetchProvider: http。这四行就是这个 bundle 的全部意义，删掉任何一行都是回归，哪怕 YAML 依然合法。

每次 push 和 pull request 都会在 CI 里跑这三条命令。

License

MIT。见 LICENSE。

中文说明

这是给 DeepSeek Harness 用的纯配置层，不含任何运行时逻辑。它做两件事：

1. 把 dsh-free-search 的引擎池固定为 auto（失败自动回落，不押注单一引擎）；
2. 把 web seam 的两个 provider 还原成出厂值，避免装了 dsh-tinyfish 之后所有搜索和抓取都被它接管。

为什么需要它：补丁层按 dsh.profile.bundles 的顺序叠加，后装者赢；dsh-tinyfish 的补丁会把 searchProvider 和 fetchProvider 一起指向自己。没有它的（免费）密钥时，搜索和抓取都会失败。这一层就是在它之后把配置改回来。

注意：本包必须排在 bundle 列表末尾，装完再动别的 bundle 时要留意顺序。

切到 TinyFish 抓取：把 fetchProvider: http 改成 tinyfish，重新安装一次即可（重装是为了让它保持在最后一层）。密钥请存进 Harness 的凭据服务或插件设置页，不要写进本文件。