Chrome Only Browser for DeepSeek Harness

强制 DSH 里所有浏览器跳转只走 Google Chrome。 无论系统默认浏览器是什么，DSH 自己去开网页时只能是 Chrome；没人提浏览器就默认 Chrome，只有用户明确点名才允许例外。

它解决什么

模型在任务里“顺手打开一个网页”时，默认会落到 Start-Process <url>、open、xdg-open，也就是操作系统的默认浏览器；dsh web 启动时也会把 GUI 地址交给默认浏览器。默认浏览器是 Edge / Firefox / 360 时，DSH 的每一次跳转都跑到了别的浏览器里。

这个 bundle 把这件事钉死：五层机制，从提示词到配置覆盖。

层	机制	效果
提示层	`ctx.systemPrompt.section()`	每轮请求注入硬规则 + Chrome 缺失时的授权流程 + 唯一例外条款
工具层	`chrome_open`	直接启动 `chrome.exe --new-window <url>`，永不回退系统默认浏览器
工具层	`chrome_status`	Chrome 是否安装、实际用哪个可执行文件、宿主补丁真实状态
工具层	`chrome_install`	必须先拿到用户授权（`authorized: true`）才下载安装 Chrome
拦截层	`ctx.tools.guard()`	拒绝 `Start-Process <url>`、`start <url>`、`Invoke-Item`、`explorer <url>`、`rundll32 url.dll`、`xdg-open`、`open`，以及 msedge / firefox / brave / vivaldi / chromium / 360 / QQ / Sogou / maxthon 等非 Chrome 启动
启动层	`web-runtime` 配置覆盖 + Chrome 交接	`dsh web` 不再调用系统默认浏览器：`openBrowser` 固定为 `false`，改由插件在服务器就绪后用 Chrome 打开同一个带 token 的地址；`--no-open` 仍然有效
宿主层	Electron `shell.openExternal` 重定向	Electron 主进程里可用时把外链交给 Chrome；桌面应用的 Host 是 Electron Node 子进程，那里 `require('electron')` 不可用，此层自动降级并如实上报

安装

仓库根目录就是 bundle 包（package.json 里声明了 dsh.bundle.patch）。

git clone https://github.com/SeekAfterSeek/dsh-chrome-only.git

桌面 profile（desktop）：用 Plugin Manager 安装本地 bundle，或调 plugin_manager 的 install_bundle，target 指向仓库绝对路径。

web profile（dsh web 用的那个）：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\Install-WebProfile.ps1

它做与 Plugin Manager 相同的三步：dependencies 加 link: → dsh.profile.bundles 追加 → 用 DSH 自带的 pnpm 安装。重复执行安全。写回 package.json 必须无 BOM，否则 DSH 启动时报 Unexpected token ''。

⚠️ 两个 profile 里记的是 link:<仓库路径>。仓库被移动或删除后，启动时会解析不到 bundle——把仓库放在固定位置。

用法

模型侧：打开网页只用 chrome_open，查状态用 chrome_status，装 Chrome 前必须先 ask_user_question 拿到授权再 chrome_install。

脚本侧：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\Open-DshChrome.ps1 -Url https://example.com -NewWindow

退出码：0 已在 Chrome 中打开；2 网址非法；3 本机没有 Chrome（此时必须先申请安装授权，禁止换浏览器）。

或者直接用 Chrome 本体：

& "$env:ProgramFiles\Google\Chrome\Application\chrome.exe" "https://example.com"

配置

- id: chrome-only
  name: '@local/dsh-chrome-only'
  config:
    chromePath: ''                 # 显式指定 chrome.exe；留空自动探测（注册表 + 常见安装路径）
    newWindow: true                # 每次打开新窗口
    guardShellTools: true          # 拦截 shell 工具里的非 Chrome 浏览器启动
    patchElectronShell: true       # Electron 主进程可用时重定向 shell.openExternal
    openWebUiInChrome: true        # dsh web 就绪后由本插件用 Chrome 打开 GUI
    extraForbiddenBrowsers: []

Chrome 探测顺序：chromePath → CHROME_ONLY_CHROME_PATH → %ProgramFiles% / %ProgramFiles(x86)% / %LOCALAPPDATA% → 注册表 App Paths\chrome.exe。

Chrome 缺失时

chrome_open 返回 code: "CHROME_MISSING"；
模型必须用 ask_user_question 问：「授权下载并安装（推荐）」/「先不安装」；
只有用户明确授权后，才能 chrome_install { authorized: true }；
安装依次尝试 winget install --id Google.Chrome → 官方企业版 MSI 静默安装 → 提权 MSI；全失败则提示手动安装。

未授权调用返回 NOT_AUTHORIZED，不下载不安装。

验证

node test\matcher.test.mjs      # 17 条拦截 + 17 条放行 + URL 规范化
node test\handoff.test.mjs      # dsh web 交接：正常→打开 / --no-open→不打开 / 关配置→不接手
powershell -File .\scripts\Open-DshChrome.ps1 -Url about:blank

实测（Windows 11 + Chrome 155，DSH desktop/web 两个 profile）：

检查	结果
`chrome_open about:blank`	`ok:true`，新窗口开在 Chrome
`chrome_open` 本地 HTML	`ok:true`，`file:///…/sample.html` 在 Chrome 中打开
`pwsh: start https://example.com`	被 guard 拒绝：「检测到「系统默认浏览器」启动」
`pwsh: & "C:\nope\msedge.exe" https://example.com`	被 guard 拒绝：「检测到「msedge」启动」
`pwsh: Test-Path ...firefox.exe` + 显式 chrome.exe 启动	放行（探测类命令不误伤）
`chrome_install authorized:false`	拒绝，`NOT_AUTHORIZED`
`dsh --profile web --port 50778`	打印 URL 后由 Chrome 打开，无 `opening the default browser`

覆盖边界

桌面应用是「Electron 主进程 + Electron Node 子进程（Cordis Host）」两段结构。点外链、下载地址、登录页这几处 shell.openExternal 在主进程里，插件在子进程，够不到；chrome_status 会显示 electronShellPatch.patched: false 及原因。把系统默认浏览器设为 Chrome 即可顺带覆盖这几处。
.html 这类文件扩展名关联是独立于默认浏览器的设置，插件不碰；chrome_open 对本地文件始终用 Chrome。
web_fetch / web_search 是服务端取文本，不启动浏览器，不受规则影响。
guard 只审命令行文本，审不到脚本文件内部（pwsh -File deploy.ps1 里写 Start-Process msedge）。
dsh web --no-open 是用户明确表态“不要打开”，不打开任何浏览器。

诊断工具

不解包整个 app.asar 就能按关键字定位、列目录、导出单个文件：

node tools\asar-scan.mjs "...\resources\app.asar" openExternal
node tools\asar-list.mjs "...\resources\app.asar" "dsh/node_modules/@deepseek-ai/dsh-web-app/lib"
node tools\asar-extract.mjs "...\resources\app.asar" "path/inside/asar.js" .\out.js

（read 能读 asar 内部路径，rg 不能——所以这三个脚本绕过解包。）

卸载

临时关闭：Plugin Manager 里关闭 chrome-only 行。
彻底移除：移除 bundle，并从两个 profile 的 package.json 去掉依赖与 bundles 条目，再跑一次 pnpm install。

License

MIT

Chrome Only Browser for DeepSeek Harness

English | 中文

它解决什么

这个 bundle 把这件事钉死：五层机制，从提示词到配置覆盖。

层	机制	效果
提示层	`ctx.systemPrompt.section()`	每轮请求注入硬规则 + Chrome 缺失时的授权流程 + 唯一例外条款
工具层	`chrome_open`	直接启动 `chrome.exe --new-window <url>`，永不回退系统默认浏览器
工具层	`chrome_status`	Chrome 是否安装、实际用哪个可执行文件、宿主补丁真实状态
工具层	`chrome_install`	必须先拿到用户授权（`authorized: true`）才下载安装 Chrome
拦截层	`ctx.tools.guard()`	拒绝 `Start-Process <url>`、`start <url>`、`Invoke-Item`、`explorer <url>`、`rundll32 url.dll`、`xdg-open`、`open`，以及 msedge / firefox / brave / vivaldi / chromium / 360 / QQ / Sogou / maxthon 等非 Chrome 启动
启动层	`web-runtime` 配置覆盖 + Chrome 交接	`dsh web` 不再调用系统默认浏览器：`openBrowser` 固定为 `false`，改由插件在服务器就绪后用 Chrome 打开同一个带 token 的地址；`--no-open` 仍然有效
宿主层	Electron `shell.openExternal` 重定向	Electron 主进程里可用时把外链交给 Chrome；桌面应用的 Host 是 Electron Node 子进程，那里 `require('electron')` 不可用，此层自动降级并如实上报

安装

仓库根目录就是 bundle 包（package.json 里声明了 dsh.bundle.patch）。

git clone https://github.com/SeekAfterSeek/dsh-chrome-only.git

桌面 profile（desktop）：用 Plugin Manager 安装本地 bundle，或调 plugin_manager 的 install_bundle，target 指向仓库绝对路径。

web profile（dsh web 用的那个）：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\Install-WebProfile.ps1

⚠️ 两个 profile 里记的是 link:<仓库路径>。仓库被移动或删除后，启动时会解析不到 bundle——把仓库放在固定位置。

用法

模型侧：打开网页只用 chrome_open，查状态用 chrome_status，装 Chrome 前必须先 ask_user_question 拿到授权再 chrome_install。

脚本侧：

powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\Open-DshChrome.ps1 -Url https://example.com -NewWindow

退出码：0 已在 Chrome 中打开；2 网址非法；3 本机没有 Chrome（此时必须先申请安装授权，禁止换浏览器）。

或者直接用 Chrome 本体：

& "$env:ProgramFiles\Google\Chrome\Application\chrome.exe" "https://example.com"

配置

- id: chrome-only
  name: '@local/dsh-chrome-only'
  config:
    chromePath: ''                 # 显式指定 chrome.exe；留空自动探测（注册表 + 常见安装路径）
    newWindow: true                # 每次打开新窗口
    guardShellTools: true          # 拦截 shell 工具里的非 Chrome 浏览器启动
    patchElectronShell: true       # Electron 主进程可用时重定向 shell.openExternal
    openWebUiInChrome: true        # dsh web 就绪后由本插件用 Chrome 打开 GUI
    extraForbiddenBrowsers: []

Chrome 探测顺序：chromePath → CHROME_ONLY_CHROME_PATH → %ProgramFiles% / %ProgramFiles(x86)% / %LOCALAPPDATA% → 注册表 App Paths\chrome.exe。

Chrome 缺失时

chrome_open 返回 code: "CHROME_MISSING"；
模型必须用 ask_user_question 问：「授权下载并安装（推荐）」/「先不安装」；
只有用户明确授权后，才能 chrome_install { authorized: true }；
安装依次尝试 winget install --id Google.Chrome → 官方企业版 MSI 静默安装 → 提权 MSI；全失败则提示手动安装。

未授权调用返回 NOT_AUTHORIZED，不下载不安装。

验证

node test\matcher.test.mjs      # 17 条拦截 + 17 条放行 + URL 规范化
node test\handoff.test.mjs      # dsh web 交接：正常→打开 / --no-open→不打开 / 关配置→不接手
powershell -File .\scripts\Open-DshChrome.ps1 -Url about:blank

实测（Windows 11 + Chrome 155，DSH desktop/web 两个 profile）：

检查	结果
`chrome_open about:blank`	`ok:true`，新窗口开在 Chrome
`chrome_open` 本地 HTML	`ok:true`，`file:///…/sample.html` 在 Chrome 中打开
`pwsh: start https://example.com`	被 guard 拒绝：「检测到「系统默认浏览器」启动」
`pwsh: & "C:\nope\msedge.exe" https://example.com`	被 guard 拒绝：「检测到「msedge」启动」
`pwsh: Test-Path ...firefox.exe` + 显式 chrome.exe 启动	放行（探测类命令不误伤）
`chrome_install authorized:false`	拒绝，`NOT_AUTHORIZED`
`dsh --profile web --port 50778`	打印 URL 后由 Chrome 打开，无 `opening the default browser`

覆盖边界

桌面应用是「Electron 主进程 + Electron Node 子进程（Cordis Host）」两段结构。点外链、下载地址、登录页这几处 shell.openExternal 在主进程里，插件在子进程，够不到；chrome_status 会显示 electronShellPatch.patched: false 及原因。把系统默认浏览器设为 Chrome 即可顺带覆盖这几处。
.html 这类文件扩展名关联是独立于默认浏览器的设置，插件不碰；chrome_open 对本地文件始终用 Chrome。
web_fetch / web_search 是服务端取文本，不启动浏览器，不受规则影响。
guard 只审命令行文本，审不到脚本文件内部（pwsh -File deploy.ps1 里写 Start-Process msedge）。
dsh web --no-open 是用户明确表态“不要打开”，不打开任何浏览器。

诊断工具

不解包整个 app.asar 就能按关键字定位、列目录、导出单个文件：

node tools\asar-scan.mjs "...\resources\app.asar" openExternal
node tools\asar-list.mjs "...\resources\app.asar" "dsh/node_modules/@deepseek-ai/dsh-web-app/lib"
node tools\asar-extract.mjs "...\resources\app.asar" "path/inside/asar.js" .\out.js

（read 能读 asar 内部路径，rg 不能——所以这三个脚本绕过解包。）

卸载

临时关闭：Plugin Manager 里关闭 chrome-only 行。
彻底移除：移除 bundle，并从两个 profile 的 package.json 去掉依赖与 bundles 条目，再跑一次 pnpm install。

License

MIT

SeekAfterSeek/dsh-chrome-only

Chrome Only Browser for DeepSeek Harness

它解决什么

安装

用法

配置

Chrome 缺失时

验证

覆盖边界

诊断工具

卸载

License

Community comments

SeekAfterSeek/dsh-chrome-only

Chrome Only Browser for DeepSeek Harness

它解决什么

安装

用法

配置

Chrome 缺失时

验证

覆盖边界

诊断工具

卸载

License

Community comments