返回目录

verge-browser

精选清单收录维护状态: 活跃

zzzgydi/verge-browser

为 AI 智能体提供自托管浏览器沙箱,支持 Chromium、CDP、Playwright、持久会话和人工接管。

前往 GitHub
$ dsh plugin add verge-browser

28

星标

3

Fork

Python

语言

MIT

许可证

2026-03-11

创建于

2026-11-05

最近推送

MIT 授权、自托管的 AI agent 浏览器沙箱(Python / FastAPI、React、Docker):CDP 自动化、noVNC / Xpra 实时画面、持久化 profile 与人工接管。

DSH 适配

兼容

作者声明

安全审计

未审计

最后核验

2026-11-10

许可证

MIT

01它能帮你完成什么?

  • 给 DeepSeek Harness 的 agent 一个跑在服务器上的真实 Chromium,而不是占用你自己的电脑

    一台 Docker 托管的 GUI Chromium 沙箱,agent 通过 CDP(Playwright / Puppeteer、SDK、CLI 或 REST API)驱动

    需要长期在线、隔离浏览器的 agent 团队

  • 看着 agent 浏览网页,并在它遇到登录页或卡住时接管

    noVNC / Xpra 实时画面,接管前可先暂停自动化

    需要在 agent 运行过程中人工介入的操作者

  • 让浏览器状态在多次运行之间保留,而不是每次都从空白 profile 开始

    每个沙箱独立的浏览器 profile 与共享文件,暂停、恢复后依然保留

    依赖已登录会话或已下载文件的 agent 工作流

02如何接入 DeepSeek Harness?

前置条件

  • 一台 Linux Docker 主机并安装 Docker Compose;主机不需要桌面环境
  • 服务配置好的 admin token,用于登录 /admin

安装步骤

  1. 01

    按服务器部署指南(docs/guides/headless-linux.md)搭建服务,或走本地 Docker 方案(docs/guides/deployment.md)

  2. 02

    在服务地址打开 /admin,用配置好的 admin token 登录

  3. 03

    创建沙箱、打开可视化会话,或按使用指南(docs/guides/usage.md)接入你的 agent

验证接入成功

作者未说明

03DSH 适配与能力边界

DSH 适配兼容

仓库自带 DeepSeek Harness 预览插件(packages/dsh-plugin),让 DSH agent 直接驱动沙箱;此外也可通过 CDP 配合 Playwright / Puppeteer,或 SDK、CLI、REST API 接入。

  • 在管理后台开通沙箱

    admin token 与 /admin 控制台→可打开可视化会话、或交给 agent 使用的沙箱

  • 通过 CDP、SDK、CLI 与 REST 自动化

    沙箱的 CDP 端点(或 SDK / CLI / REST API)→对沙箱内 Chromium 的程序化控制

  • 实时画面与人工接管

    沙箱的可视化会话→noVNC 或 Xpra 的浏览器实时画面

    接管前需要先暂停自动化
  • 持久化工作区

    已有沙箱→该沙箱独立的浏览器 profile 与共享文件,暂停与恢复后保留

04适合谁?何时不该用?

适合

  • 需要长期在线、隔离浏览器的 agent 团队
  • 需要在 agent 运行过程中人工介入的操作者
  • 依赖已登录会话或已下载文件的 agent 工作流

不适合

  • 当前部署模型面向可信环境中的单节点部署;隔离与持久化边界见使用指南的兼容性与限制一节。

05兼容性、维护与安全提示

  • 当前部署模型面向可信环境中的单节点部署;隔离与持久化边界见使用指南的兼容性与限制一节。
  • 需要 Linux Docker 主机与 Docker Compose;主机本身不需要桌面环境。
  • 原始源码是 MIT,但运行时镜像包含单独授权的组件,例如 GPL v2 或更新版本的 Xpra。
2026-03-112026-11-05作者未说明

MIT · 最近推送 2026-11-05;facts pack 未记录任何 GitHub release,因此没有可锁定的版本号

06常见问题

Verge Browser 怎么和 DeepSeek Harness 接起来?

仓库的 Integrations 里列出了 DeepSeek Harness 预览插件(packages/dsh-plugin)。不装插件也可以接入:通过 CDP 配合 Playwright 或 Puppeteer,或使用 SDK、CLI 与 REST API。

服务器需要桌面环境吗?

不需要。README 要求的是带 Docker Compose 的 Linux Docker 主机,并明确说明主机不需要桌面环境。

部署完服务之后第一步做什么?

在服务地址打开 /admin,用配置好的 admin token 登录,然后创建沙箱、打开它的可视化会话,或按使用指南接入你的 agent。

agent 浏览时我能接管吗?

可以。你能通过 noVNC 或 Xpra 查看浏览器画面,并在接管前暂停自动化。

隔离性和限制如何?

当前部署模型面向可信环境中的单节点部署;README 指向使用指南的兼容性与限制一节,说明隔离与持久化的边界。

08数据与来源

  • 作者声明github.com97706906f892…

    | Integrations | [Codex](docs/integrations/codex.md), [Playwright MCP](docs/integrations/playwright-mcp.md), [DeepSeek H…

  • 作者声明github.com97706906f892…

    - **Agent automation**: connect through CDP with Playwright or Puppeteer, or use the SDK, CLI, and REST API.

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-10。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。