dsh-web-scout · DeepSeek Harness 联网检索插件

对话里说的东西，插件替你去搜：46 个平台、8 个免关键词热榜、证据包、研究模式，还能当 MCP 服务用。 Search the web from your chat: 46 platform backends, hot lists, evidence packs, research mode, and an MCP server.

它能做什么

• 挂件：输入框下方多一个「联网检索」，点开面板搜；留空就用当前对话当查询。

• 给 Agent 的 6 个工具：web_scout_search / _open / _read / _evidence / _research / _health。

• HTTP：POST /web-scout/api，本地脚本直接调。

• MCP：node mcp/server.mjs，Claude Desktop / Cursor 可用。

零 API Key、零运行时依赖（纯 Node，Node ≥ 22）。

Related MCP server: codex-search-mcp

功能速览

• 46 个平台：直连接口、site: 兜底、8 个热榜/信息流、自定义站点（填名称/域名/搜索地址即可）。

• 多页抓取：limit ≤30 × pages ≤4 × maxPlatforms ≤14，默认 12×3×10，一次 70–90 条。

• 干净结果：中文 2-gram 相关性过滤、跨源去重（剥 utm_*/spm/from）、落地页过滤、中转壳标「中转」。

• 登录态：插件自带独立 profile 的浏览器，CDP 读 cookie；搜索与读正文都带你自己的登录态。

• 面板：可拖动可缩放、十类卡片、B 站内嵌播放、缓存徽标与「刷新」。

• 缓存：内存 LRU + SQLite（~/.dsh/web-scout-cache.db），cacheTtlMs 可配。

• 证据包 / 研究模式：打分取前 N 条 + 摘录 + 覆盖与缺口；多轮检索带时间预算与质量门槛。

• 可插拔：外部 provider 丢进 <profile>/web-scout-providers/ 即生效，热加载。

更细的改动看 CHANGELOG.md，接口与字段看下面各节。

安装

前置

• DeepSeek Harness（桌面版即可），版本需支持 plugin_manager 的 bundle 安装。

• Node.js ≥ 22（用到全局 fetch、WebSocket、node:sqlite）。

• 操作系统：Windows / macOS / Linux。登录用的浏览器是 Edge 或 Chrome（macOS 的 /Applications、Linux 的 /usr/bin 路径都已内置）。

方式 A：npm 一行装（推荐）

dsh plugin add dsh-web-scout

包名就是 dsh-web-scout（npm）。DSH 会把它当普通 bundle 装进当前 profile：dependencies 里出现 "dsh-web-scout": "^1.22.0"，dsh.profile.bundles 末尾多一项。

想装到指定 profile：dsh plugin --profile <名字> add dsh-web-scout。

方式 B：从本仓库装（开发用）

git clone https://github.com/tang-123-1/dsh-web-scout.git D:/dshcs/web-scout

plugin_manager action=install_bundle target=D:/dshcs/web-scout

装完 profile 的 package.json 里是 "dsh-web-scout": "link:D:/dshcs/web-scout"。本包自带的 cordis.patch.yml（一行 insert，id web-scout）由安装器读取，不要手抄进 profile 的 cordis.patch.yml——同一个包出现在两个 Loader 源里会报 resolves from multiple active Loader sources，客户端半就永远加载不出来。

装完必做两件事

1. 让客户端半进入引导图（触发 Host 重新扫描 dsh.client）：

   plugin_manager action=set_bundle target=dsh-web-scout enabled=false
   plugin_manager action=set_bundle target=dsh-web-scout enabled=true

   跳过这步面板挂件不会出现。

2. 刷新页面（DevTools 里 location.reload()，或重启 DSH）。之后输入框下方应出现「联网检索」挂件。

验证

POST http://127.0.0.1:3209/web-scout/api
{"op":"catalog"}

返回 {"ok":true,...} 且 platforms 长度为 46、chips 为 8 个默认芯片，就说明 Host 和客户端都已就绪。

离线验证（不启动 DSH，直接跑引擎）：

node scripts/smoke.mjs "cordis 插件"

使用

挂件

• 点「联网检索」打开面板；输入关键词回车，或直接点「搜索」（留空 = 用当前对话内容当查询）。

• 芯片行是平台选择：点一下加入、再点一下移除；「站点」分区里是所有平台的网格，还能新增任意站点（名称 / 限定域名 / 搜索地址，用 {q} 占位）；「登录与账号」分区管登录。

• 结果行左边的平台名来自后端标签，右边「打开」交给系统浏览器；服务端不可达的站点会单独列一块，每行一个「在浏览器打开」。

• 结果是卡片：左边缩略图（没有图就显示类型字形）、中间标题 + 平台 类型 URL + 两行摘要、右边竖排按钮（视频类多一个「播放 / 收起」）。

• 结果上方的平台药丸可以点：只看那一个平台（标题变成 9 / 92 这种「当前 / 总数」），再点一次或点「全部平台」恢复。

• 标题栏 ✕ 左边是视图开关：卡片 ↔ 紧凑；紧凑视图一行一条（类型字形 + 标题 + 平台 + ▶ + 打开），选择记在 localStorage 里，刷新后还在。

卡片与内嵌播放（v1.9）

结果列表按站点类型渲染，类型来自三处（优先级从高到低）：

1. 平台定义里的 kind（内置平台用 KIND_BY_ID）；

2. 自定义站点自己填的「类型」（添加站点表单的第三个下拉，选 auto 就交给下一步）；

3. 域名/路径猜类型：bilibili.com|youtube.com|/video/ → 视频，zhihu.com|/question/ → 问答，v2ex|reddit|/t/ → 论坛，github|npm → 代码，taobao|jd → 商品，/hot → 榜单，其余按平台分组兜底。

内嵌播放只对返回 embed 的结果生效，目前是 B 站（https://player.bilibili.com/player.html?bvid=…&autoplay=1，服务端从 x/web-interface/wbi/search/type 的 bvid 拼出来）。抖音拿不到单条视频 URL（site:douyin.com 只回站内入口行，aweme/v1/web/general/search 需要 a_bogus 签名），所以抖音只有「打开」。

维护坑（v1.9 修过一次）：B 站搜索接口是匿名的。带上 store 里那套过期 SESSDATA/buvid3 会被判风控（-412/-352），两次重试都空 → 抛 EngineBlocked → 落到 site: 兜底，结果行就没有 thumb/embed，卡片既没图也不能播。所以 backends.bilibili 请求带了 noCookies: true（net.js 里 init.noCookies === true 时跳过 cookie jar）。

视图与筛选（v1.10）

• 平台筛选：结果上方的每个平台药丸都是按钮，点一下只保留该平台的行，标题变成 「查询」 9 / 92 条结果，并出现 只看 必应 · 全部平台 提示行；再点同一颗药丸或点「全部平台」清除。筛选只影响展示，不重新请求。

• 卡片 / 紧凑：标题栏的视图按钮在两种排版间切换。卡片视图有缩略图与两行摘要；紧凑视图一行一条，适合一次看几十条。当前视图写在 localStorage["web-scout-view"]。

• 无图也有字形：没有缩略图的结果不再显示空框，而是在图位放该类型的淡色字形（网 / 文 / 问 / 论 / 热 / 购 / 码 / 档 / 动 / ▶）。

视频站点的作者与序号（v1.11）

视频类结果（哔哩哔哩、B 站热门）现在会带上「谁发的、这是他第几个视频」：

• 作者一行：卡片视图在 URL 行下面显示 @作者（可点，跳到作者主页），后面接 第 k 个 / 共 M 个、4,221 赞、2025-01-08；紧凑视图把这些压进 平台 · @作者 · 共 M 个视频 那一行。

• 序号怎么来的：x/space/navnum?mid= 拿作品总数 M，再在 x/space/wbi/arc/search?order=pubdate 的倒序分页上二分定位这条视频所在的页，rank = M - 从最新数的位置。一次搜索只给第一条视频算序号（预算 3 秒、最多 6 次翻页），其余行只写「共 M 个视频」——避免一次搜索打穿 B 站风控。

• B 站空间接口是按 IP 限流的：命中 -412 / -352 / -799 时插件会记 10 分钟禁用并自动降级为「共 M 个视频」，过一会儿或换网络会自动恢复出序号。

• 抖音改走分享页：www.douyin.com 的 /discover、/hot、/video/<id> 在服务端一律返回验证码中间页（/discover 还会 302 到 /jingxuan，就是你看到的「抖音精选版」）。所以插件把结果链接换成免验证码的 https://www.iesdouyin.com/share/video/<id>/；这条信息的作者/点赞/封面抖音只肯在前端渲染，服务端拿不到（需要 a_bogus 签名），因此抖音行只保证能在浏览器里正常播放。

把结果带进对话（v1.12）

检索完不用手抄，两步就能让对话基于这些结果写东西：

• 面板标题栏的 加入对话：把当前筛选出的前 8 条（标题 / 平台 / 类型 / 链接 / 摘要）拼成一段 Markdown，直接放进输入框；面板上会闪一行「已加入输入框，回车即可发送」。

• 每条结果右侧的 ＋：只把这一条带进输入框，适合「就这条，帮我总结一下」。

• 放进输入框的内容长这样（第一行是来源与平台，末尾一句是给模型的指令）：

  联网检索「龙珠 孙悟空」（必应 / 360搜索 / CSDN / 掘金 / 今日头条 / V2EX / 知乎 / 哔哩哔哩）的结果：
  
  1. 七龙珠 孙悟空VS贝吉塔
     哔哩哔哩 · 视频 · @消逝的天空L · 共 527 个视频
     https://www.bilibili.com/video/BV...
      ...
  请基于以上结果继续，需要时引用对应链接。

• 实现走的是宿主自己的输入框接口，按三档降级：inputActions.insertQuote(text)（插入成引用块）→ inputActions.insertText(text, inputActions.captureInsertion())（按修订号插入，可撤销）→ inputActions.setDraft(text)（直接覆盖草稿）。任一步成功就不再往下走，全失败会提示「输入框正忙」。

• 内容只放进输入框，不会替你按回车——想发就发，不想发删掉即可。

正文读取与缓存（v1.14）

搜索和读正文都走两级缓存，重复查询几乎零成本：

• 默认 TTL 6 小时，可用配置项 cacheTtlMs 调（60 秒 – 24 小时）。

• 缓存键包含查询词、平台列表、条数、页数、代理设置，所以换代理/换条数不会命中同一份结果。

• 面板上命中缓存时标题会多一个**「缓存 3s」徽标（3s = 这份结果存在了 3 秒）；旁边的刷新**按钮会绕过缓存重新联网。

• 工具调用同理：web_scout_search 传 refresh: true 可强制刷新；web_scout_read 抓过的正文再次读是毫秒级。

• 缓存坏了不会影响搜索：SQLite 打不开时自动退化成纯内存（cache.stats 里 persistent:false 会显示原因）。

• 维护接口：POST /web-scout/api {"op":"cache.stats"} 看命中数/行数/文件路径；{"op":"cache.clear"} 清空。

可插拔 Provider（v1.15）

后端不再写死在 engines.js 里。每个站点就是一个 provider 对象，内置的 46 个和外部的一样走同一个接口：

// <DSH profile>/web-scout-providers/mysite.mjs
export default {
  id: 'mysite',                 // 小写，可含 . _ -
  label: '我的站点',             // 面板里显示的名字
  kind: 'article',              // video/article/qa/forum/hot/shop/code/doc/social/web
  site: 'example.com',          // 可选：没有 search 时用它走 site: 兜底
  browser: (q) => `https://example.com/search?q=${encodeURIComponent(q)}`,
  async search({ query, limit, client, timeoutMs, page }) {
    // 返回 [{ title, url, snippet, extra?, thumb?, embed? }]
    return [{ title: `${query} 的结果`, url: 'https://example.com/a', snippet: '……' }];
  },
};

放进 <DSH profile>/web-scout-providers/（Windows 上是 C:\Users\<你>\.dsh\profiles\desktop\web-scout-providers\），然后：

curl -s -X POST http://127.0.0.1:3209/web-scout/api -H "content-type: application/json" \
  -d '{"op":"provider.reload"}'

它立刻出现在面板「站点」网格与 catalog.platforms（source:"external"）里，也能直接 {"op":"search","platforms":["mysite"]}。

内置 provider 仍然转调原来的后端函数（BACKENDS[id]），所以 v1.14 的行为、翻页、缓存、过滤全部不变；_probe/verify-providers.mjs 里有一条「provider 与直接调后端结果完全一致」的等价性断言。

MCP 服务（v1.16）

除了 DSH 内部使用，web-scout 还能作为标准 MCP 服务被任意宿主调用（Claude Desktop、Cursor、你自己的脚本、CI）。零依赖，只用 Node 内置能力，协议层是手写的 JSON-RPC 2.0 over stdio。

node <仓库路径>/mcp/server.mjs          # 直接跑（stdio 就是协议通道，日志走 stderr）
node <仓库路径>/mcp/server.mjs --help   # 看支持的工具

在宿主的 MCP 配置里加一段即可：

{
  "mcpServers": {
    "web-scout": {
      "command": "node",
      "args": ["D:/dshcs/web-scout/mcp/server.mjs"],
      "env": {}
    }
  }
}

设计要点：

• 共享配置与缓存：MCP 服务读的是同一份 ~/.dsh/web-scout.json，缓存也是同一个 web-scout-cache.db（SQLite WAL，多进程安全）。面板里搜过的词，MCP 侧再搜是毫秒级命中；反之亦然。

• 共享 provider：外部 provider（<profile>/web-scout-providers/*.mjs）会自动加载，MCP 里 platforms:["mysite"] 直接可用。

• 协议兼容：支持 MCP 2025-06-18 / 2025-03-26 / 2024-11-05；客户端报新版本就回新版本，报不认识的版本回落 2024-11-05。传输同时吃换行分隔 JSON（MCP 官方 stdio）和 LSP 式 Content-Length 帧。

• 不会被脏输入打死：坏 JSON 回 -32700 后继续服务；未知方法回 -32601；工具报错用 isError:true 包住，进程不退出；stdin 关闭才 exit 0。

• stdout 只走协议：所有诊断日志写 stderr，避免把宿主解析器搞崩（验收里有一条专门断言）。

验收脚本（都在 _probe/，可直接 node 跑）：

证据包（v1.17）

「搜到 90 条」和「模型能用」是两件事。证据包把结果压成一段可引用的材料：

• 打分：0.42 × 标题命中 + 0.22 × 摘要命中 + 0.16 × 原排名 + 0.12 × 后端质量 + 0.08 × 新鲜度（原排名按名次线性衰减，后端质量按 原生接口 1 / 自定义 0.7 / 站内兜底 0.6 / 榜单 0.55）。

• 配额与预算：每平台最多 perPlatform 条（默认 3），总字符预算 budgetChars（默认 6000，usedChars 会回传），超预算的进 dropped.budget。

• 摘录：从正文/摘要里挑含查询词的那一句（切句后按 token 命中 + 中文 2-gram 覆盖打分），长度 excerptChars（默认 240）。

• 缺口：gaps 说明哪些类型没覆盖到（比如没有视频类结果），platformNotes 记录各平台为什么没贡献。

// 面板：标题栏「证据包」→ 直接放进输入框；接口：
{"op":"evidence","query":"cordis 插件","platforms":["csdn","v2ex"],"budgetChars":1500}

连通性体检（v1.17）

站点会时不时被风控（360 人机验证、百度安全验证、B 站 -412），体检让你先看清哪条通道现在是通的：

• 原生后端（provider / def.backend / 自定义站点）用小样本真打一次（limit:2），判 ok / empty / blocked / login / error，并记耗时。

• 纯 site: 兜底平台默认跳过（skipped: site-fallback），加 deep:true 才真去打搜索引擎；不存在的 id 记 skipped: unknown。

• 并发默认 4，timeoutMs 默认 8000；返回 tally 汇总与 text 人读版本。

{"op":"health.check","platforms":["csdn","v2ex","bing"],"timeoutMs":9000}

面板里：站点分区 → 「体检」→ 每个平台前面出现状态点（绿=可用，黄=空/被拦/需登录，红=出错），悬停看耗时与原因。

查询规划与研究模式（v1.18）

一个问题往往不是一个查询词能解决的。规划器先判断意图、改写查询、挑平台，研究模式再按波次打，够了就停：

• 意图路由：代码/报错 → GitHub、Stack Overflow、CSDN、掘金；文档/API → GitHub、Stack Overflow、CSDN、MDN；论文/研究 → Wikipedia、Stack Exchange、知乎；新闻/热榜 → 头条、微博热搜、百度热搜；教程/怎么做 → 知乎、CSDN、掘金、B 站；对比/选型 → 知乎、V2EX、CSDN；商品/价格 → 淘宝、京东、闲鱼；其余走通用。

• 查询变体：原始查询 → 中文技术词转英文（插件→plugin、报错→error…共 36 条）→ 查询里带域名时补 site: → 代码/文件名 token 加引号。最多 4 个，逐个去重。

• 波次：主平台（前 4 个）→ 换说法再来一轮（前 3 个）→ 剩余平台补漏；每波前先看时间预算，剩余不足 1.5 s 直接记 skipped: budget。

• 质量门槛：每波用证据包评估 items >= minItems && 平台数 >= quorumPlatforms && 类型数 >= quorumKinds，达标立刻停，不浪费请求。

// 面板：标题栏「研究」→ 报告直接进输入框
{"op":"plan","query":"cordis 插件报错 403"}
// → intent: "code"，platforms: ["github","stackoverflow","csdn","juejin"]，variants: 原始 + plugin/error

{"op":"research","query":"cordis 插件","platforms":["csdn","v2ex"],"budgetMs":15000,
 "minItems":6,"quorumPlatforms":3,"quorumKinds":2}
// → rounds[{added,total,platformsHit,kinds,met,took}], quality, pack, text（研究报告）

报告＝证据包正文（评分摘录 + 覆盖面 + 缺口）＋三行机器可读的「规划 / 检索 / 质量」。 只选榜单类平台时可以不填查询词；关键词检索仍然必须给 query。

六个工具（Agent 侧）

HTTP 接口

POST http://127.0.0.1:3209/web-scout/api，请求体 {"op":"...", ...}：

平台与后端

直连后端（不经过搜索引擎，直接拿站内数据）：

站内检索（site: 双引擎兜底，带域名校验、过滤首页）：知乎、博客园、开源中国、Gitee、抖音、小红书、微博、Reddit、PyPI、淘宝、京东、1688、亚马逊、闲鱼、少数派、Medium、YouTube。

加新平台的成本：能直连就在 engines.js 的 BACKENDS 里加一个 async (ctx) => rows，再在 PLATFORM_LIST 里挂 backend；不能直连就在 PLATFORM_LIST 里给个 site + browser(q)，其余全部自动生效（翻页、去重、过滤、状态药丸都不用管）。

空壳结果过滤（v1.13）

搜索结果里有两类「看着有、点开没有」的行，v1.13 起分开处理：

抓到了内容但一条都不相关时（典型场景：搜索引擎把 7-8岁儿童绘本 当成 7，整页返回 7-Zip），状态显示「抓到的 N 条都不含查询词，已过滤」，而不是含糊的"没结果"。

中文相关性判定改用 2-gram 覆盖率（≥0.5 通过）而不是整串包含：必应会把中文标题切出空格（7-8 岁儿童绘本），整串比对会把正常结果全部误杀。

榜单与信息流（v1.7 / v1.8）

八个平台不消费关键词——选中它们、输入框留空直接搜，拿到的就是当前榜单/信息流。面板检测到「选中项全是这类平台」时，输入框提示会变成「榜单/信息流：不用输关键词，直接点搜索」。

• 抖音热榜：iesdouyin 榜单接口，50 条，带排名/热度/标签位。

• 知乎推荐 / 知乎关注：/api/v3/feed/topstory*，6 条/页，pages 控制翻几页。必须先登录知乎，否则状态药丸会显示「需要登录：还没登录知乎…」。

• 这八个平台不在默认 9 源里（混进关键词检索会全是噪音），需要时在「站点」分区里点一下加到芯片条；榜单是实时抓取，刷新面板就是最新榜。

• 只选信息流平台时，插件不会把对话内容硬塞成查询词（feedOnly 分支），API 用 {"op":"search","platforms":["zhihufollow"]} 即可。

热榜趋势与跨榜共振（v1.21）

榜单类平台（抖音热榜 / 微博热搜 / B站热门 / 知乎热榜 / 百度热搜 / 头条热榜 / 知乎推荐 · 关注）每次抓取都会存一份快照（最近 8 个平台、每平台 60 行，写在 ~/.dsh/web-scout.json 的 hotSnapshot），下一次抓取就能算出：

面板上：新上榜是黄色「新」，上升绿色 ↑n，下滑灰色 ↓n，跨榜同题显示「共振×n」；「加入对话」生成的文本也带这些标记，模型能直接看出话题在爬升还是在退烧。

实测（同一批三个榜单连打两次）：微博热搜 fresh=1 moved=3；「2027研究生报考人数」同时出现在微博热搜与抖音热榜，两边都标了共振。关键词检索不受影响（trend 为空对象）。

自测与修复（v1.20.0）

插件自带一套自测，把 28 个接口选项（op）、6 个 Agent 工具、6 个 MCP 工具都真打一遍——断言走真实网络、真实 store、真实缓存，不 mock。

node scripts/selftest.mjs           # 54 项，含搜索/正文/证据包/研究/体检/登录/缓存/脱敏
node scripts/selftest.mjs --heavy   # 58 项，额外拉起系统浏览器和插件浏览器

跑之前确保 Harness 正在运行（默认打 http://127.0.0.1:3209/web-scout/api），退出码 0 表示全绿。

这一轮自测抓出并修掉的 5 个真 bug：

顺手补的：plain() 让工具输出可 JSON 往返（JSON.parse(JSON.stringify(x)) 与 x 深等），browserAuth.js 从 9.4 KB 涨到 11.1 KB 但换来干净的生命周期。

连通性修复（v1.19.1）

2026-11 做了一次全平台连通性扫描（47 个 provider 逐个真打），结论和修法：

扫描后的分布（查询 cordis 插件）：ok 19 / empty 19 / blocked 5 / error 4；其中 error 全是需要代理的站点（谷歌、DuckDuckGo、Brave、维基），blocked 是验证码与未登录（360 已修，百度/搜狗仍按 IP 发验证码，知乎信息流需要登录）。

补一句实话：剩下的 empty 平台（博客园、开源中国、Gitee、少数派、微博、小红书、淘宝、京东、1688、闲鱼、抖音、PyPI、Medium、YouTube、Reddit、Hacker News、Stack Overflow、亚马逊）在当前网络下拿不到服务端结果——要么站点强制 JS 渲染，要么要登录/签名。它们会稳定返回一条「站内搜索入口」，点开就是该站自己的搜索页。

空白站点治理（v1.22.0）

「空白站点」指那些拿不到服务端搜索结果的平台。这轮做的是两件事：能救的救回来，救不了的别再假装在救。

1. 英文站点自动换语言

Stack Overflow、Hacker News、PyPI、Medium、Reddit、YouTube、Amazon 对中文查询基本零命中（实测 Stack Exchange API 用 cordis 插件 返回 0 条，用 cordis plugin 返回正常结果）。现在这类平台带 lang: 'en'，查询含中文时自动换成拉丁变体（中文技术词 → 英文，保留原有的英文/数字 token）：

cordis 插件 报错  →  plugin error cordis   （只在这类平台上生效）

顺带把 Stack Overflow / Hacker News 的 needsTunnel 去掉——它们的 API 本身在本机可达，之前被误标成「需要代理」，导致超时截断到 6 秒还误报。

2. 没有服务端搜索的站点：直接给入口，不再白等

15 个平台标了 entryOnly: true：1688、亚马逊、博客园、Gitee、京东、开源中国、少数派、微博、闲鱼、小红书、抖音、Medium、PyPI、YouTube、Reddit。

以前每次搜索都会为它们跑一遍搜索引擎的 site: 查询（必应中文站忽略 site:，等于白跑约 0.7 秒，还拿到一堆无关结果）。现在直接返回一条「在 XX 里直接搜索「关键词」」的入口行：

3. 慢平台加了超时上限

淘宝 14.2 s、今日头条 10.7 s 会拖住整轮搜索，现在按平台封顶：淘宝/头条 9 s、V2EX/微信 7 s、Stack Overflow 9 s、Hacker News 8 s。超出就按超时降级，不再让一个站点决定整次搜索的耗时。

4. 体检怎么看

面板「站点 → 体检」或 POST /web-scout/api {"op":"health.check","platforms":["jd","douyin"]}，返回里 skipped 会区分 unknown（id 不存在）与 site-fallback（纯站内平台，默认不真打，deep:true 才打）。

想自己确认「这个站点到底能不能服务端搜」，就看 note：出现「没有可抓取的服务端搜索」就是实话说——它在当前网络下确实搜不出来，点开站内搜索页是唯一正确的用法。

登录状态

插件的检索和读页面都用同一个 cookie jar，所以「搜到的内容和你浏览器里看到的一样」取决于有没有登录态。

登录判定不只看「有没有 cookie」：哔哩哔哩要 SESSDATA、知乎要 z_c0、GitHub 要 user_session/logged_in，只有匿名 cookie 会明确告诉你「浏览器里还是未登录状态」。

Cookie 存在 ~/.dsh/web-scout.json 的 cookies 字段里，不要提交到 git（.gitignore 已排除 web-scout.json、session.json）。

配置

配置文件：~/.dsh/web-scout.json（DSH_PROFILE_DIR 存在时在 <profile>/web-scout.json）。也可用面板底部或 op:"config" 改。

代理

默认直连。国内直连能用的有：必应、360、百度、搜狗、CSDN、掘金、哔哩哔哩、今日头条、V2EX、微信、抖音热榜。需要代理的是：谷歌、DuckDuckGo、Brave、YouTube、Reddit、Stack Overflow、维基百科、PyPI、亚马逊、Medium。

打开 TUN/系统代理不会自动生效——本插件走自己的 HTTP 客户端，请在面板底部填代理地址（或 op:"config" 写 proxy）。填了之后所有平台（含站点内检索）都走这个代理。

常见问题

装好了但没看到挂件？ 客户端半要出现在 window.__DSH_BOOT__ 里才会加载。执行一次 plugin_manager set_bundle target=dsh-web-scout enabled=false 然后 enabled=true，再 location.reload()。可以用 POST /web-scout/api {"op":"graph"} 自检：has:true, composed:true 才算进图。

改了 Host 代码不生效？ index.js / api.js / engines.js / store.js 属于 Host 半，改完必须 set_bundle 关开一次；client.js 由 dsh-hmr 自动发版，但页面要刷新才能看到。

某个平台一直 blocked？ 360 / 搜狗 / 百度会按 IP 出验证码，表现为 blocked + 浏览器入口，过几分钟自动恢复。需要稳定结果就给代理，或只留必应这类温和的源。

面板一片空白、结果 0 条？ 先看状态药丸：全是红的说明网络不通（检查代理），只有某个平台红说明是那个平台的问题。用 node scripts/smoke.mjs 你的关键词 可以直接看到每个平台的返回码与耗时。

搜出来的结果很少？ 三个开关：limit（每源条数）、pages（翻页数）、maxPlatforms（参与源数）。默认 12/3/10；拉到 20/4/14 大约能到 100–120 条（更多源不一定更好，噪音也会变多）。

「知乎推荐」显示需要登录？ 知乎信息流走后端接口，必须有 z_c0 登录 cookie。点「登录与账号 → 插件浏览器」登录一次，再点「读取登录」即可。

安全吗？ 插件只做三件事：发 HTTP 请求、起一个独立 profile 的浏览器读 cookie、用系统默认浏览器打开链接。没有遥测，不上传任何数据；cookie 只存在本地配置文件里。

架构

web-scout/
├── index.js          Host 入口：注册 3 个工具 + systemPrompt + /web-scout/api 路由 + 客户端自愈
├── api.js            接口分发（catalog/search/read/open/config/chips/platform.*/login.*/browser.*/graph）
├── engines.js        46 个平台定义 + 各站后端 + 翻页/去重/相关性过滤/站内兜底
├── net.js            零依赖 HTTP 客户端（手动重定向、gzip/br/zstd、GBK、CONNECT 隧道、CookieJar）
├── store.js          配置持久化（原子写、防抖、版本迁移）
├── login.js          登录探针与判定（require 白名单）
├── browserCookies.js 本机浏览器 cookie 导入（Chromium / Firefox）
├── browserAuth.js    插件自管浏览器（CDP 读 cookie）
├── open.js           系统默认浏览器打开
├── client.js         面板挂件（React，内联样式，portal 到 body）
├── locale/           zh.json / en.json
├── scripts/smoke.mjs 离线冒烟测试
└── docs/             截图

数据流：挂件 fetch('/web-scout/api') → api.js 分发 → engines.js 用 net.js 抓 → 汇总去重 → 返回 JSON → 面板渲染；工具调用走同一条链路（index.js 里包了一层 output.render）。

开发

node --check index.js              # 语法检查
node scripts/smoke.mjs 龙珠         # 离线跑引擎
curl -s -X POST http://127.0.0.1:3209/web-scout/api \
  -H 'content-type: application/json; charset=utf-8' \
  -d '{"op":"search","query":"龙珠","platforms":["auto"],"limit":8}'

改 Host 半后：set_bundle 关开一次。改 client.js 后：刷新页面。日志看 DSH 主进程输出，插件侧的问题会带 web-scout: 前缀。

发布到 GitHub

cd D:/dshcs/web-scout
git init
git add .
git commit -m "feat: web-scout 1.8.0 — 46 平台联网检索插件"
git branch -M main
git remote add origin https://github.com/[GITHUB_OWNER]/web-scout.git
git push -u origin main

发布前记得替换占位符：package.json 的 author / repository / homepage / bugs，LICENSE 的版权人，本 README 里的 [GITHUB_OWNER]。

不要提交：~/.dsh/web-scout.json（含登录 cookie）、web-scout-browser/（浏览器 profile）、_probe/（调试脚本）。.gitignore 已处理。

许可

MIT