项目介绍
dsh-builtin-browser 给 DeepSeek Harness 接上一扇人和 Agent 都能看见、都能操作的浏览器窗口。Web profile 下由插件拉起 Electron，任务各有窗口和标签页；接入 Desktop bridge 后，Agent 可以直接驱动 DSH Desktop 的侧栏页面。它适合需要登录、表单、截图或人工中途接手的流程，同时也把 Cookie、页面脚本和本地文件写入带进了权限边界。
核心功能
可见浏览器与人工接管
自托管模式为每个任务打开真实 Electron 窗口，用户可以直接点页面、地址栏和标签页，操作与 Agent 共用同一会话模型。
34 个浏览器工具
工具覆盖导航、快照、点击、输入、滚动、表单、DOM 和 CDP 执行、截图、下载、认证、历史、标签页以及验证码检测。
任务隔离与共享登录态
每个 DSH 任务有独立标签页与历史，任务结束后窗口关闭；浏览器 profile 和 Cookie 可在任务之间保留。
受限文件写入
截图和下载共用路径准入逻辑，只能写进 downloadDir，拒绝覆盖现有文件，下载按 256MB 上限限流。
安装与使用
先确认 Node.js、DSH profile 和 Electron 条件，再用 DSH 的 profile 级命令安装 npm 包。Web 用户先做一个公开页面的最小任务；Desktop bridge 会修改应用文件，应在单独审查和备份后再装。
让 AI Agent 帮你安装
把这段话发送给 Codex、Claude Code 或其他可以操作本地环境的 AI Agent。
请从 https://github.com/wqty123/dsh-browser 安装 dsh-builtin-browser。先完整阅读 README、docs/user-guide.md、docs/architecture.md 和 package.json，确认我的 DSH 版本、目标 profile、Node.js 与 Electron 条件。使用 dsh plugin --profile web add dsh-builtin-browser 安装，若我的 profile 不是 web，先告诉我需要替换的名称。启动后只用 https://example.com 验证打开页面、读取标题和截图，并确认任务结束后浏览器关闭。首次验证不导入 Cookie，也不登录账号。Desktop bridge 暂不执行，文件写入仍限制在默认目录。遇到现有配置覆盖、额外下载、登录态、内网页面或桌面端修改时先征得我确认，并如实报告没有验证的部分。- Node.js 22.19 以上，并已安装 DeepSeek Harness
- 确认目标 profile 名称，示例统一使用 web
- 准备 Electron 30 以上，仓库建议 40 以上
- 只在隔离的浏览器 profile 中保存测试登录态
dsh plugin --profile web add dsh-builtin-browser- 1确认运行条件
运行 node --version 和 dsh --version，确认 Node.js 至少 22.19，并记下要安装插件的 DSH profile。Electron 版本建议至少 40。
- 2安装到指定 profile
执行 dsh plugin --profile web add dsh-builtin-browser。若使用其他 profile，把 web 换成实际名称，不要同时改动其他 profile。
- 3启动并做最小验证
启动目标 DSH profile，只访问 https://example.com，检查可见浏览器窗口、页面标题读取和截图。首次验证不要登录账号或导入 Cookie。
- 4收紧数据边界
把 downloadDir 指向专用目录，使用独立浏览器 profile，并按需关闭凭据访问。确认 browser_restrict 只是软限制，关键权限仍要靠环境隔离。
启动目标 profile 后，让 Agent 打开 https://example.com，读取页面标题并截图。确认独立浏览器窗口可见、任务结束后关闭，再检查截图只写入配置的 downloadDir。不要用真实账号做首次验证。
- profile 名称 web 只是示例，必须按实际环境替换。
- Electron 44 以上缺少二进制时，仓库提示另跑 npx install-electron。
- Desktop bridge 属于额外步骤，会修改 DSH Desktop 文件，不应和基础安装一起默认执行。
- 仓库当前只确认 Windows 实测。
使用场景
可见的表单流程
Agent 填写普通字段，用户在验证码、敏感确认或最终提交前接手，同一窗口里能看到前后状态。
需要登录态的资料整理
在隔离 profile 和明确授权范围内读取已登录页面，保留 Cookie 供后续任务使用，并限制导出能力。
页面调试与证据留存
结合 DOM 快照、CDP 命令、操作历史和截图检查交互问题，产物写入专用下载目录。
使用评价
公开材料显示，这个插件的优势在于把真实可见浏览器、人工接管和 DSH 工具接口放在同一套流程里，安装命令和 34 个工具都有明确文档。代价也很具体，Agent 能运行页面脚本、接触登录 Cookie，并可能访问本机或内网页面。Windows 之外缺少作者实测，Desktop bridge 还会修改已安装应用。适合先用隔离 profile 和公开页面做小范围验证，再按任务逐步开放权限。
值得一试的地方
- 安装、工具、架构和安全边界文档较完整
- 可见窗口方便人工接管和核对 Agent 操作
- 下载与截图已有目录限制、拒绝覆盖和体积上限
- 2026-10-01 仍有版本发布与修复提交
使用前要知道
- 只在 Windows 完成作者实测
- Cookie 默认明文存储，认证导入导出权限较高
- Desktop bridge 修改应用文件并扩大侧栏页面访问能力
- 本次未执行安装和真实浏览器功能测试
README
dsh-builtin-browser
Overview
为 DeepSeek Harness 提供一个人与 Agent 共用的可见浏览器，包含 34 个 browser_* 工具、独立任务窗口、持久登录态、表单操作、截图、下载和人工接管。 Shared real browser plugin for DeepSeek Harness
Getting started
- 先确认 Node.js、DSH profile 和 Electron 条件，再用 DSH 的 profile 级命令安装 npm 包。Web 用户先做一个公开页面的最小任务；Desktop bridge 会修改应用文件，应在单独审查和备份后再装。
- Web profile 下插件自托管 Electron，每个 DSH 任务拥有独立窗口、标签页和历史，登录状态可跨任务共享。
- 34 个工具覆盖打开页面、快照、点击、输入、表单、脚本、CDP、截图、下载、Cookie、历史和验证码检测。
- 启动目标 profile 后，让 Agent 打开 https://example.com，读取页面标题并截图。确认独立浏览器窗口可见、任务结束后关闭，再检查截图只写入配置的 downloadDir。不要用真实账号做首次验证。
Configuration
dsh plugin --profile web add dsh-builtin-browser