Chrome Use：给 DeepSeek Harness 一个真实的 Chrome

English

让 DSH 的模型使用你电脑上的 Google Chrome：打开网页、读内容、点击、填表、选下拉、上传文件、处理弹窗、截图。支持 macOS 和 Windows。Windows 目前只跑过 CI 上的自动化测试，还没有在实机的桌面版上试过，遇到问题欢迎反馈。

底层是 Chrome 官方的 chrome-devtools-mcp。这个插件负责把它接进 DSH：按需加载、连接哪个 Chrome、不同系统上的路径、隐私默认值和按网站询问。

两种用法

需要哪种直接说就行，模型会自己选：

用 Chrome 打开 example.com，告诉我页面标题
用我自己的 Chrome 看看 GitHub 上有没有新通知

不需要 Chrome 扩展，也不用安装别的东西。

安装

先准备好 Google Chrome 和 DeepSeek Harness 桌面版（0.2.1 及以上的 0.2.x 版本）。

1. 打开桌面应用的插件页，点击添加插件，在包名或地址中填入：

   dsh-google-chrome-use@0.2.1
   

   安装源选择官方源，点击安装。新版本刚发布的 24 小时内，DSH 的 pnpm 会因为发布冷却期暂缓安装，所以请带上版本号。

2. 完全退出并重新打开 DSH 桌面应用。只刷新页面不会加载 Host 端的新插件。

3. 在对话里说「用 Chrome 打开 example.com，告诉我页面标题」试试。

dsh plugin --profile web add dsh-google-chrome-use@0.2.1

连接你正在用的 Chrome

第一次让模型用你的 Chrome 时，按它的提示做这几步：

1. 只有 macOS 需要： 到「系统设置 → 隐私与安全性 → 文件与文件夹」，在 DeepSeek Harness 下面打开 Google Chrome（用命令行版时是你的终端程序）。不开的话插件读不到 Chrome 的文件夹，macOS 也不会主动弹窗询问。
2. 插件会在 Chrome 里打开 chrome://inspect/#remote-debugging。勾选 Allow remote debugging for this browser instance，然后告诉模型继续。
3. 模型开始操作时，Chrome 会弹窗询问是否允许连接，点 Allow。
4. 模型第一次打开某个网站时，DSH 会询问你。完全访问模式下 DSH 不询问。

连接后，模型每次打开页面都会收到所有标签页的标题和网址，这些内容会发给你配置的模型服务。使用前请读 SECURITY.md。

更新

打开设置 → Chrome Use。这一页每次打开时会去 npm 查一次最新版本，有新版本时点更新插件，然后完全退出并重新打开 DSH。插件不会在后台自己更新。

更新用的是 DSH 自带的 pnpm，遵守它的发布冷却策略：默认会直接装上这个版本，并把它记进 profile 的 minimumReleaseAgeExclude；如果你配了更严格的策略，页面会提示什么时候可以更新。安装源（尤其是国内镜像）还没同步新版本时，页面会提示过几分钟再试。

本地路径（link:）安装不会出现更新按钮。要切回官方源，按这个顺序做：

1. 在插件页卸载。

2. 删掉卸载后留在 profile 里的符号链接，路径末尾不要带 /。Windows 上用 rmdir，不要加 /s。

   rm ~/.dsh/profiles/desktop/node_modules/dsh-google-chrome-use
   

3. 按上面的步骤安装，然后完全退出并重新打开 DSH。

不删这个链接的话，重装时 pnpm 会把本地仓库的 node_modules 整个搬进插件目录，仓库的依赖就没了，插件也启用失败。cordis.patch.yml 里的配置行不受影响。

配置

插件页目前没有配置表单。需要改配置时，在 profile 的 cordis.patch.yml 里加一行（桌面版是 ~/.dsh/profiles/desktop/cordis.patch.yml），改完重启 DSH：

- id: chrome-use
  name: dsh-google-chrome-use
  config:
    userDataDir: /Volumes/外置盘/chrome-profile

这种写法会替换整行配置，没写的项用默认值。

费用

没调用 chrome_use 时，只多一个工具定义。调用之后这个 DSH 进程里的会话都会带上浏览器工具，standard 约 6000 token，每次请求都算（通常有缓存）。大网页的快照可能有一两万 token。用不到时可以让模型调用 chrome_use 的 action=stop 断开。

如果模型不支持图片，截图会看不到，但它仍能靠页面快照工作。

常见问题

提示浏览器已经在运行： 另一个 DSH 窗口正在用独立配置。关掉它，或者让那边断开。

第一次操作超时： Chrome 的 Allow 弹窗没点。点完让模型再试一次。

多个会话同时用： 同一个 DSH 进程里的会话共用一个浏览器连接。切换目标会影响所有会话。

Chrome 和 Edge： 上游只正式支持 Google Chrome。其他 Chromium 浏览器可以用 executablePath 试，但不保证能用。

开发

pnpm install
pnpm run check
node scripts/e2e-dsh.mjs

• pnpm run check：单元测试，加上用真实无头 Chrome 跑的冒烟测试。
• scripts/e2e-dsh.mjs：在真实的 DSH 里跑完整流程，用脚本扮演模型，不需要账号。
• 给 scripts/smoke.mjs 或 scripts/e2e-dsh.mjs 加 --headed，就会用带窗口的 Chrome，也就是插件默认的模式。

致谢

浏览器能力全部来自 Google Chrome DevTools 团队的 chrome-devtools-mcp（Apache-2.0）。本项目与 Google 无关。

许可证

MIT