一个原生 DeepSeek Harness 插件,把 harness 变成共享真实浏览器的操作者:用 `dsh plugin add` 安装,获得 33 个 `browser_*` 工具,支持人工接管、任务级会话隔离,以及零额外配置的 Electron 自托管。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-09-03
许可证
MIT
01它能帮你完成什么？
让 agent 在 DeepSeek Harness 里驱动一个真实、可见的浏览器
一个人和 agent 共用、随时可人工接管的真实浏览器,通过 33 个 `browser_*` 工具驱动(打开、快照、点击、填表、结构化提取、截图、下载、登录态管理)
运行 DeepSeek Harness(dsh)、需要用户可观察并可介入的真实浏览器的开发者与 agent
自动化需要真实 DOM 与登录态的网页任务
结构化数据提取、批量填表、带登录态下载与持久化的登录状态——按 DSH 任务会话隔离
在 DeepSeek Harness 内对需登录的站点编写浏览器流程的自动化开发者
02如何接入 DeepSeek Harness？
前置条件
- 已安装 DeepSeek Harness(dsh)并具备对应 profile(`web` / `desktop` 等)
- Electron 运行时(必装依赖,随插件自动安装,建议 ≥ 40;44+ 首次使用自动下载二进制,需联网)
- 目前仅在 Windows 环境实测,macOS/Linux 未验证、暂不承诺
安装步骤
- 01
从 npm 安装(已发布):`dsh plugin --profile web add dsh-builtin-browser`
$ dsh plugin --profile web add dsh-builtin-browser
- 02
或从源码目录安装(一插件一仓库):`dsh plugin --profile web add <仓库路径>`
$ dsh plugin --profile web add <仓库路径>
验证接入成功
作者未说明
03DSH 适配与能力边界
Native dsh plugin registered via `dsh plugin add`; exposes 33 `browser_*` tools through the ctx.browser seam, provider and tool layers of DeepSeek Harness
共享真实浏览器(可见、可接管)
agent 的 `browser_*` 工具调用→人类可见、可随时接管的真实 WebContentsView;人与 agent 操作同一页面
自托管模式下插件会拉起自己的 Electron 子进程,并通过本机 TCP JSON-RPC 驱动(随机 token 认证)33 个 `browser_*` 工具(DOM 驱动、框架友好)
页面 URL / 选择器 / 语义 target→打开、快照、无障碍树、点击、输入、填表、结构化提取、截图、下载、登录态管理等
任务级会话隔离
每个 DSH 任务(会话)→每个任务独立的浏览器会话(独立标签与历史);并发任务互不污染
登录态持久化与带登录态下载
`browser_auth` 导出/恢复、`browser_download` 带会话 cookie→重启后登录态不丢;携带会话 cookie 抓取文件
自托管实例的 cookie 以明文落盘(Electron 默认行为);`browser_download` 直接写文件到磁盘(默认 ~/Downloads,可用 downloadDir 覆盖)
04适合谁？何时不该用？
适合
- 运行 DeepSeek Harness(dsh)、需要用户可观察并可介入的真实浏览器的开发者与 agent
- 在 DeepSeek Harness 内对需登录的站点编写浏览器流程的自动化开发者
不适合
- 本插件当前仅在 Windows 环境实测,macOS/Linux 未验证、暂不承诺;需自备 Electron 运行时(随插件自动安装,建议 ≥ 40)。
- `browser_restrict` 白名单只是防误操作的软护栏,模型可自行解除,并非安全边界;敏感操作仍需人工确认。
- 自托管模式下 cookie 以明文落盘(Electron 默认行为),需要加密落盘的部署应在宿主层接入系统钥匙串 / DPAPI。
05兼容性、维护与安全提示
- 本插件当前仅在 Windows 环境实测,macOS/Linux 未验证、暂不承诺;需自备 Electron 运行时(随插件自动安装,建议 ≥ 40)。
- `browser_restrict` 白名单只是防误操作的软护栏,模型可自行解除,并非安全边界;敏感操作仍需人工确认。
- 自托管模式下 cookie 以明文落盘(Electron 默认行为),需要加密落盘的部署应在宿主层接入系统钥匙串 / DPAPI。
MIT · GitHub stars 44 · latest release v0.1.0 (2026-08-14)
06常见问题
怎么把 dsh-browser 装进 DeepSeek Harness?
执行 `dsh plugin --profile web add dsh-builtin-browser` 从 npm 安装(已发布),或 `dsh plugin --profile web add <仓库路径>` 从源码目录安装。它会注册为原生 dsh 插件,安装后 agent 自动获得 33 个 `browser_*` 工具。
需要 DeepSeek Harness 桌面外壳吗?
不需要。有桌面外壳时浏览器视图嵌入外壳;纯 `dsh web` 环境下插件自托管,自己拉起 Electron 窗口,`browser_*` 工具照常可用,零额外配置。
支持哪些平台?
目前仅在 Windows(10.0.26200)环境实测,macOS/Linux 未验证、暂不承诺。需要 Electron 运行时(随插件自动安装,建议 ≥ 40;44+ 首次使用自动下载二进制,需联网)。
agent 用这个浏览器能做什么?
33 个工具:打开/快照页面、读取无障碍树、点击/输入/批量填表(语义 `target` 或坐标)、滚动、前进后退、结构化提取(`browser_scrape`)、截图、带登录态下载、登录态管理(`browser_auth`),以及检测人机验证交由人工处理。
它能自动过人机验证吗?
不能。它会识别 Cloudflare / reCAPTCHA / hCaptcha / Turnstile 并在快照里标注,由你在共享窗口中人工完成,而不是让 agent 盲目重试。`browser_restrict` 只是防误操作的软护栏,模型可自行解除,并非安全边界。
07相关的 DSH 工作流
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tui
作者 ccch1mneyyy
DSH 官方公众号收录的 TUI 补位插件：Claude Code 风，鲸鱼顶栏/实时状态/流式思考/双击 Esc 回滚/上下文进度+TPS。npm 一键装。 DSH official WeChat featured TUI plugin — Claude Code style: whale bar, live status, streaming thoughts, double-Esc rollback, context bar + TPS. npm one-click.
openpets
作者 alvinunreal
本地优先的桌面陪伴平台，提供动效宠物、插件 SDK 与编码智能体集成。
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的交互式终端 UI 插件：自研 ANSI 极简交互渲染、流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断、memory记忆，很丝滑的开发体验。
08数据与来源
dsh plugin --profile web add dsh-builtin-browser
纯 `dsh web` 也能**自托管**——插件自己拉起一个 Electron 窗口,不需要任何额外配置;
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-09-03。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。