dsh-browser-companion

English | 简体中文

一个面向个人的 DeepSeek Harness (DSH) 浏览器插件。

它给 Agent 一个专属、持久、可见的浏览器：

• 你可以实时看到 Agent 在真实浏览器窗口里做什么。
• 登录由你在弹窗中手动完成；密码和 OAuth 密钥不会经过 Agent。
• Cookies 和登录状态保存在同一个 profile 中，重启后依然保留。

功能特性

• ✅ 持久化浏览器 profile（cookies / localStorage / 登录状态）
• ✅ 可见窗口模式（默认 headless: false）
• ✅ 人机交互登录：browser_login 打开窗口，由你自己输入密码 / 完成 OAuth
• ✅ Agent 工具：open、snapshot、click、type、press、screenshot、see、select、check、upload、hover、scroll、tabs、status
• ✅ 安全护栏：browser_type 禁止填写密码框
• ✅ browser_see 使用本地视觉模型（OpenAI 兼容），让 Agent 理解图片 / 视觉布局
• ✅ 基于 agent-browser，底层浏览器自动化经过实战检验

开箱即用

插件默认零配置即可使用基础浏览功能：

• 默认使用 agent-browser 自带的 Chromium
• 默认使用 ~/.dsh/browser-profile 作为持久化 profile
• 基础工具全部可用：open、snapshot、click、type、tabs 等

可选设置可以在 DSH WebUI 插件设置中修改：

• executablePath：填真实 Chrome/Edge 路径，解决 Google 等登录拦截
• visionBaseUrl / visionModel：启用 browser_see 本地视觉模型
• profilePath：自定义浏览器 profile 位置

如果 browser_see 未配置，会返回友好提示，不会影响其他功能。

安装

1. 安装依赖

npm install -g agent-browser
agent-browser install   # 首次下载 Chromium

2. 安装插件

从 npm 或 GitHub 安装：

dsh plugin --profile web add dsh-browser-companion

pnpm 用户注意： 从 GitHub 安装时，pnpm 可能会阻止 agent-browser 的 build script。 在 profile 的 pnpm-workspace.yaml 中加入并重新运行：

allowBuilds:
  agent-browser: true

本地开发也可以直接加到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
    - id: dsh-browser-companion
      name: 'file:///absolute/path/to/dsh-browser-companion/src/index.js'
      config:
        profilePath: '/home/your-name/.dsh/browser-profile'
        headless: false
        executablePath: '/path/to/your/chrome'
        browserArgs: '--disable-blink-features=AutomationControlled'
        defaultTimeout: 30000