dengpeihua/dsh-browser-use

Name: dengpeihua/dsh-browser-use
Author: dengpeihua

Plugin插件 Native原生 ⭐ 3 MIT Search & Web Access搜索与联网 Sessions & Context会话与上下文

Native DeepSeek Harness browser-agent plugin with session-isolated Chromium, CDP, and DOM tools

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This repository is a native plugin built exclusively for DeepSeek Harness (DSH) that adds full Chromium browser automation capability to DSH agents. It launches a local Chrome or Chromium instance on the user's machine, communicates via Puppeteer and the Chrome DevTools Protocol, and exposes 20 total tools: 16 for browser operations and 4 for task evidence management. Before running the install command, you need to generate an npm tarball from local source if installing from a clone, then use the DSH CLI to add the packaged plugin to your web profile.

This plugin enables DSH agents to complete tasks that require interacting with dynamic, JavaScript-enabled websites that cannot be handled by simple static web fetching. Agents can fill out complex forms, navigate across multiple browser tabs, and complete multi-step research workflows without manual intervention from the user. It uses incremental DOM snapshots to reduce redundant context in the agent's conversation window, cutting down on unnecessary token usage and keeping responses fast. Users can customize settings including viewport size, timeouts, and approval modes for different use cases.

The plugin is currently not published to the npm registry, so users need to build it from source before installing it to their local DSH instance. After cloning the repository, users run npm install to pull dependencies, then npm pack to generate the installable tarball. The DSH CLI command npx @deepseek-ai/dsh plugin --profile web add <path-to-tarball> completes the installation, and users can verify the config with the --dump-config flag. The project is released under the permissive MIT open source license, and includes full test suites for package verification and functionality.

dsh-browser-use 是专为 DeepSeek Harness 开发的原生浏览器插件，可为 DSH Agent 添加真实 Chromium 浏览器操作能力。它直接启动用户本机的 Chrome 或 Chromium，通过 Puppeteer、Chrome DevTools Protocol 提供 16 个浏览器操作工具和 4 个任务证据工具，支持增量 DOM 快照减少上下文冗余，原生接入 DSH 的 Agent 会话生命周期，每个 DSH Agent 会话独立拥有浏览器进程、标签页和缓存，保证会话隔离。

该插件支持动态网页访问、复杂表单填写、多标签页多步骤调研，能够增量传递 DOM 差异避免重复读取整页浪费上下文，支持元素截图作为 DSH 附件保存，支持精确检查点恢复和任务证据归档。用户可以自定义配置浏览器运行参数，修改视口大小、超时限制、操作审批模式等，满足不同交互场景和自动化需求。

安装需要 Node.js 22.19 以上版本、本机已安装 Chrome 或 Chromium，使用 pnpm 包管理器完成安装，目前暂未发布到 npm，需要本地打包后安装到 DSH 的 web 配置档。项目采用 MIT 许可证开源，提供完整的单元测试和集成测试，方便开发者贡献代码和验证功能。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：dsh-browser-use（dengpeihua/dsh-browser-use）
仓库：https://github.com/dengpeihua/dsh-browser-use
本站详情页：https://www.yhbd.top/plugins/dengpeihua-dsh-browser-use/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 3 · 最近提交 2026-09-29 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意

Only 3 stars - very few users, little community feedback星标只有 3，几乎没人在用，遇到问题缺少社区反馈

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

npx @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add dsh-browser-plugin

把 dengpeihua/dsh-browser-use 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

41.2 KB · 缓存于 2026-09-29 22:11:50 · 41.2 KB

dsh-browser-use

Native Chromium browser Agent tools for DeepSeek Harness

在 WebVoyager 549 tasks / 13 站点上，按下文完整评分规则复核后取得 88.0%（483/549） 的成功率，平均 16.3 steps、140 s、Agent 标价估算 $0.028 / 任务。归档中的 reference Judge 为 495/549（90.2%）；两种口径及逐题结果见评测报告。

浏览器命令失败的处理、点击检查和脚本异常说明见可靠性文档；原文引用的获取方式见证据文档。

中文 | English

🇨🇳 dsh-browser-use（中文）

给 DeepSeek Harness 装上真实浏览器：让 Agent 能够打开网页、理解页面、填写表单、管理标签页并完成多步骤任务。

我们将 dsh-browser-plugin 作为可独立安装的 DeepSeek Harness（DSH） Web profile 插件。它直接启动本机 Chrome 或 Chromium，通过 Puppeteer、Chrome DevTools Protocol（CDP）和增量 DOM 快照向 Agent 提供 16 个浏览器操作与 1 个归档回读工具。

本仓库只包含浏览器插件自身的源码，不包含 DeepSeek Harness 源码，也不要求用户克隆 Harness 仓库。

本版本通过 DSH 的原生扩展点，把浏览器运行时与上下文策略接入 Agent Harness。这里的 Host 是 DSH 的 Agent/Session 运行时；插件仍可独立打包安装，不需要复制或修改 DSH 源码。

它能做什么

任务	没装插件	装上插件
访问动态网站	只能依赖搜索或静态抓取	启动真实 Chromium 并操作页面
填写复杂表单	无法处理弹窗、下拉框和动态字段	通过 DOM 引用定位、输入和点击
多步资料调研	每一步都要人工复制页面内容	Agent 可在多个标签页之间持续探索
理解页面变化	反复读取整页，浪费上下文	优先返回 DOM 差异，必要时建立完整基线
查看图表和图片	只有文本信息	截取指定视觉元素并保存为 DSH attachment

核心特性

真实 Chromium — 使用本机 Chrome/Chromium，而不是 HTTP 抓取器或模拟页面。
增量 DOM — 首次返回完整快照，后续优先返回 +| / -| 差异，减少重复上下文。
稳定元素引用 — 可点击元素使用 [N]，可输入元素使用 <N>，视觉元素使用 [view:ID]。
Session 隔离 — 每个 DSH Agent 独立拥有浏览器进程、标签页、CDP 会话和 DOM 缓存。
多标签页与滚动探索 — 支持创建、切换、关闭标签页，以及按屏或按页面位置探索长页面。
DSH 原生生命周期 — 使用 Cordis、defineTool、approval、取消信号和 attachment 服务，不依赖兼容服务器。
显式浏览器路由 — 用户明确要求使用浏览器或 Chromium 时，模型从 browser_start 开始并持续使用 browser_*，不会用 web_search 或 web_fetch 替代。
安全默认值 — Chromium sandbox 默认开启；改变页面状态的操作默认需要 DSH approval。
有界输出 — 页面脚本结果过大时只向模型返回预览，并把完整结果写入指定目录或临时目录。
同轮文本留存 — 每个 DOM 快照提醒 Agent 在改变页面前把重要答案、数值和导航线索写进同一次 assistant 输出，无需额外调用旧事实总结接口。
按需回读归档 — 页面观察按访问自动归档；需要核对旧页面时再调用 browser_recall，不强制逐页登记或补齐字段。
操作后置条件 — 点击和输入可检查文本或 URL；实际执行、验证通过和整体任务完成始终是三个独立结论。
精确检查点恢复 — 我们用完整 stateId 恢复支持的表单、展开状态与滚动位置，并将不完整恢复明确标为 partial。
结构化与跨域诊断 — browser_execute_script 支持 JSON-LD、重复列表和有界结果；OOPIF 路由、CDP 录制/回放与统计接口用于可复现的 DOM 诊断。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要，完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

渲染基于仓库 dengpeihua/dsh-browser-use 的 README.md。在 GitHub 查看原文 →