Skip to content

dsh-google-chrome-use

Verified

dsh-google-chrome-use · v0.2.1 · MIT · Web UI

Let DeepSeek Harness use Google Chrome on macOS and Windows: a dedicated profile that stays logged in, or the Chrome you already use. Powered by Chrome DevTools MCP.

Install

dsh plugin add dsh-google-chrome-use

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

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

English

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

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

两种用法

独立 Chrome(默认) 我的 Chrome
是什么 单独的 Chrome 配置,在这里登录过的账号下次还在 你正在用的那个 Chrome,带着全部登录状态和标签页
适合 查资料、测网页、只交给模型特定账号 需要用你已登录的账号时
准备工作 不用准备 Chrome 144 或更新版本,勾选一次,macOS 还要开一次文件夹权限,连接时点允许

需要哪种直接说就行,模型会自己选:

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

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

安装

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

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

    [email protected]
    

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

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

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

命令行和自建 profile
dsh plugin --profile web add [email protected]

不要对 desktop profile 使用这条命令,桌面版请走插件页。DSH 0.1.5 的 headless 模式没有附件存储,模型收不到截图,其他功能正常。

连接你正在用的 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

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

配置项 默认值 作用
defaultTarget dedicated 模型没指定时用哪个 Chrome,可选 dedicated、my_chrome
allowMyChrome true 是否允许连接你的 Chrome
askBeforeNewSite true 在你的 Chrome 里第一次打开某网站时是否询问。headless 模式没人能回答,会拒绝新网站,无人值守时要关掉
headless false 独立 Chrome 不显示窗口
userDataDir DSH 数据目录下的 chrome-use/chrome-profile 独立 Chrome 的配置目录,可能有几百 MB
executablePath 自动查找 Chrome 不在默认位置时指定
toolset standard standard 26 个工具,slim 3 个,full 再加性能、内存和设备模拟
fileRoots [] 除系统临时目录外,还允许上传和保存文件的目录
toolCallTimeoutSeconds 180 单次操作的超时秒数,第一次操作要等你点允许
extraArgs [] 传给 chrome-devtools-mcp 的额外参数,比如 --blockedUrlPattern=*://*.bank.example/*

费用

没调用 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