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
安装步骤
- 01
按服务器部署指南(docs/guides/headless-linux.md)搭建服务,或走本地 Docker 方案(docs/guides/deployment.md)
- 02
在服务地址打开 /admin,用配置好的 admin token 登录
- 03
创建沙箱、打开可视化会话,或按使用指南(docs/guides/usage.md)接入你的 agent
验证接入成功
作者未说明
03DSH 适配与能力边界
仓库自带 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。
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 指向使用指南的兼容性与限制一节,说明隔离与持久化的边界。
07相关的 DSH 工作流
archify
作者 tt-a1i
为编码智能体生成美观可验证的架构图、时序图与数据流图,输出自包含 HTML,支持动效与清晰导出。
openviking
作者 volcengine
为 AI 智能体打造的自进化上下文数据库,统一智能体记忆、知识 RAG 与技能。
aitoearn
作者 yikart
面向抖音、快手、小红书和视频号的 AI 内容发布工作流,提供相关平台与 MCP 工具集成。
learn-harness-engineering
作者 walkinglabs
Harness 工程新手教程,从 0 到 1 系统学习智能体工作流框架。
08数据与来源
| Integrations | [Codex](docs/integrations/codex.md), [Playwright MCP](docs/integrations/playwright-mcp.md), [DeepSeek H…
- **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 个值得优先安装的插件,覆盖各个分类。
