谷歌AI搜索 sincerity711/dsh-web-search-opencli

dsh-web-search-opencli

通过 OpenCLI 把 Google AI Mode 用作 DeepSeek Harness 的 web_search 服务商。

dsh-web-search-opencli 注册一个 DSH ctx.web 搜索服务商。智能体调用 web_search 时，插件通过 OpenCLI 驱动你现有的 Chrome 或 Edge 浏览器，打开 Google Search AI Mode（udm=50），等待 AI 回答，提取答案和引用的来源 URL，返回 DSH 标准的 WebSearchResult。

功能

- 通过 DSH web_search 暴露 Google AI Mode 的回答。
- 用 OpenCLI 做浏览器自动化，而不是抓取 HTTP 端点。
- 从 AI Mode 的引用和链接中提取来源 URL。
- 把 AI 回答正文转成 Markdown。
- 默认复用已配置的 OpenCLI 浏览器会话标签页。
- 可配置服务商 id、OpenCLI 命令/会话/窗口模式、超时，以及尽力而为的标签页清理。

要求

- Node.js ^22.19.0 || >=24.0.0。
- 已安装 DeepSeek Harness，并提供 @deepseek-ai/dsh-web。
- 已安装 OpenCLI，并连接到它的浏览器扩展。
- Chrome 或 Edge 已登录能使用 AI Mode 的 Google 账号。
- 浏览器账号、地区、语言环境都能使用 Google AI Mode。

服务商使用当前浏览器配置档，不读取也不存储 Google cookies。

先验证 OpenCLI：

opencli doctor

安装

推荐用 npm 安装：

dsh plugin --profile web add dsh-web-search-opencli

从 DeepSeek Harness 源码检出安装时，用检出目录里的 wrapper：

pnpm dsh plugin --profile web add dsh-web-search-opencli

npm 发布之前，从 GitHub 安装：

dsh plugin --profile web add github:sincerity711/dsh-web-search-opencli

本地开发：

git clone https://github.com/sincerity711/dsh-web-search-opencli.git
cd dsh-web-search-opencli
npm install
npm run build

dsh plugin --profile web add /path/to/dsh-web-search-opencli

npm 发行版里包含构建好的 lib/ 产物。从 GitHub 安装会运行包的 prepare 脚本把它们构建出来。

Bundle 补丁

包里包含 cordis.patch.yml，所以常规插件安装就能应用这个默认的 web 配置档补丁：

- id: web
config:
searchProvider: google-ai-mode

- insert:
- id: web-search-opencli
name: dsh-web-search-opencli
config:
providerId: google-ai-mode
opencliSession: dsh-google-ai-mode
opencliWindow: background
timeoutMs: 45000
closeTabAfterSearch: false

如果你手动编辑配置档补丁，保留你还需要用到的现有 web 配置字段。补丁会替换目标行的整个 config。

验证

导出解析后的 web 配置档：

dsh --profile web --dump-config

输出里应该包含：

- id: web
name: '@deepseek-ai/dsh-web'
config:
searchProvider: google-ai-mode

以及：

- id: web-search-opencli
name: dsh-web-search-opencli
config:
providerId: google-ai-mode

改完配置档后重启 DSH Web：

dsh web

架构参考

运行时流程、服务商注册、OpenCLI 命令序列、提取流水线和错误映射，见 docs/architecture.md。

配置

| 字段 | 默认值 | 含义 |
| providerId | google-ai-mode | 注册到 ctx.web 的服务商 id。 |
| opencliCommand | opencli | 可执行文件名或路径。 |
| opencliSession | dsh-google-ai-mode | Google 标签页使用的 OpenCLI 浏览器会话。 |
| opencliWindow | background | 同时作为 OPENCLI_WINDOW 和浏览器命令的 OpenCLI --window 传入。 |
| timeoutMs | 45000 | 每次搜索的超时预算，单位毫秒。 |
| closeTabAfterSearch | false | 每次搜索后尽力关闭标签页，可选。默认关闭，因为 Chrome 可能把 OpenCLI 自动化窗口里的最后一个标签页替换成 about:blank。 |

行为

- content 包含 Google AI Mode 回答，已转成 markdown。
- sources[] 包含 AI Mode 回答引用或链接的 URL。
- 重复的来源 URL 按首次出现顺序去重。
- AI Mode 回答之外的普通 Google 搜索结果不会作为兜底。
- 服务商返回后，DSH ctx.web 会强制执行 maxResults。
- OpenCLI 窗口模式默认用 background，避免抢焦点。
- 服务商默认复用它的 OpenCLI 自动化标签页。只有你更想要尽力清理标签页时，才设置 closeTabAfterSearch: true。

错误

服务商会抛出 DSH WebError 值：

- WEB_SEARCH_OPENCLI_CAPTCHA：Google 显示了 CAPTCHA 或异常流量页面。
- WEB_SEARCH_OPENCLI_AI_MODE_UNAVAILABLE：当前账号、地区或语言无法使用 AI Mode。
- WEB_SEARCH_OPENCLI_TIMEOUT：OpenCLI 操作超过了 timeoutMs。
- WEB_PROVIDER_ERROR：OpenCLI 失败，或提取返回了意外结果。
- WEB_ABORTED：DSH 调用被取消。

故障排查

搜索失败，报 OpenCLI 错误

运行 opencli doctor，然后确认 Chrome 或 Edge 已打开，且 OpenCLI 浏览器扩展已连接。

Google 要求输入 CAPTCHA

在浏览器里手动打开 Google，解决 CAPTCHA，然后重试 DSH 搜索。

AI Mode 不可用

Google AI Mode 的可用性取决于账号、地区和语言环境。用能访问 AI Mode 的账号登录，或换回其他 DSH web 搜索服务商。

并发搜索失败，报浏览器 detached 错误

OpenCLI 浏览器会话是有状态的。避免对同一个 opencliSession 跑并发搜索。需要并行就换用不同的会话名，或把搜索串行化。

社区插件发现

本仓库已适配当前的 DeepSeek Harness 社区插件发现流程。给公开仓库加上这些 GitHub topics： text dsh-plugin deepseek-harness dsh web-search opencli

npm 包带有对应的 keywords，并声明了 DSH bundle 补丁。

开发 sh
npm install
npm run check