DSH plugin 浏览器控制怎么配?DeepSeek Harness 的 dsh-browser 能力与安全边界
dsh-browser 是让 DeepSeek Harness 驱动真实浏览器执行动作的浏览器控制 DSH plugin:开页面、抓取内容、模拟点击输入、截图(来源)。 它和「联网搜索」不是一回事——搜索只取内容,浏览器控制能真的操作网页。这篇讲清它能干什么、怎么装怎么配、以及权限和安全边界。
浏览器控制插件能干什么:DeepSeek Harness 的开页、抓取、交互、截图
浏览器控制插件让 DeepSeek Harness 拥有「真的动手打开网页并操作」的能力,而不只是把网页内容取回来。 官方工具子系统里,工具由插件注册进注册表、由工具流水线在循环里分派调用(来源),浏览器控制类插件就是把浏览器动作注册成工具。它的核心能力有四类:
- 开页面 — 打开指定 URL,等待加载完成。预期:拿到可交互的页面上下文。
- 抓取内容 — 提取正文、链接或结构化数据。预期:把网页变成可用资料。
- 模拟交互 — 点击、输入、选择、翻页、提交表单。预期:走完需要多步操作才能完成的任务。
- 截图 — 保存页面或特定区域的可视快照。预期:留证或做视觉核对。
和联网搜索最直观的区别:搜索插件回答「这个页面写了什么」,浏览器控制回答「帮我把它点出来」。
DSH plugin 怎么安装与配置浏览器控制:依赖与 profile
浏览器控制插件用标准的 dsh plugin --profile web add 安装,但它比多数插件多一步:准备浏览器运行时依赖。 依赖没装好,最常见的结果就是「插件在、页面打不开」。按下面步骤走:
- 安装插件 — 命令行执行:
预期:终端回显插件已加入bash
dsh plugin --profile web add @caob23/dsh-browser-controlwebprofile。 - 准备浏览器依赖 — 按插件说明安装或指向它需要的浏览器内核。预期:插件能找到可用的浏览器实例。
- 重启并验证 — 重启 DeepSeek Harness,让它开一个简单页面。预期:能拿到页面内容,说明链路打通。
- 换成真实任务 — 让它完成一次多步操作(如填一个测试表单)。预期:点击与输入按顺序发生。
- 收权限 — 任务结束切回受限 profile。预期:动手能力收回,降低风险。
找同类实现时,到 DSH Plugin Hub 按 browser 关键词搜索,像 dsh-browser-control、dsh-browser-playwright 这类条目会一起列出,按兼容状态挑。

浏览器控制的 DSH plugin 权限与安全边界
浏览器控制的风险在于它能带着你的登录态访问站点,所以凭证剥离与站点白名单是必须的前置动作。 DeepSeek Harness 的沙箱约束子进程的文件效果(来源),但浏览器里的会话状态、Cookie 与本地存储属于另一层,需要你主动管理。三条边界:
- 能访问哪些站点 — 用白名单把范围收窄到任务真正需要的站点。预期:无关站点的登录态不暴露。
- 凭证要不要给 — 敏感站点用无痕会话或剥离凭证再操作。预期:账号凭证不进模型上下文。
- 出问题先关能力 — 行为异常时立刻关掉浏览器控制,先止血再排查。预期:避免异常动作持续发生。
DSH plugin 使用注意事项
- 依赖先于插件:装了插件却开不了页面,先查浏览器依赖是否齐全。
- profile 要对:装进正在用的 profile,否则装了不生效。
- 页面结构会变:选择器失效是常见故障,页面改版后要重新验证流程。
- 别和 computer use 叠权限:只做网页自动化就别开桌面级能力。
- 登录态是最大风险点:能不带凭证就不带,能限制站点就限制。
- 搜索类不等于操作类:要取资料用联网搜索插件,别为取一段文字启动整套浏览器。
来源:dsh-browser-control(DSH Plugin Hub)、工具子系统(DeepSeek Harness 官方文档)、进程沙箱(DeepSeek Harness 官方文档)
常见问题
dsh-browser 是让 DeepSeek Harness 驱动真实浏览器执行动作的 DSH plugin:开页面、抓取内容、模拟点击输入、截图。 它和联网搜索插件的区别在「动作」二字:搜索插件只负责把网页内容取回来当资料,浏览器控制能真的点按钮、填表单、走多步流程。要「查资料」用搜索类插件,要「完成操作」才需要浏览器控制。
浏览器控制插件用 dsh plugin --profile web add 安装,通常还要单独准备浏览器运行时依赖。 命令行安装示例:dsh plugin --profile web add @caob23/dsh-browser-control;装完按插件说明安装或指向它要用的浏览器内核。这一步常被跳过,结果就是插件装上了却开不了页面,排查时先确认依赖是否齐全。
浏览器控制插件原则上能访问你本机能打开的站点,所以凭证剥离与站点白名单才是安全关键。 登录态、Cookie 与本地存储都可能随浏览器上下文暴露给 Agent,敏感站点不应在开启状态下访问。稳妥做法是把操作限制在必要站点、用无痕会话、任务结束即关闭能力。
行为异常时第一步先关掉浏览器控制能力,把 Agent 的动手权限收回来,再去排查。 常见原因是页面结构变化导致选择器失效、依赖版本不匹配、或插件对某站点做了意料之外的动作。先止血(关能力 / 收权限),再对照日志定位是哪一步偏离预期,比让它继续跑更安全。
按「取资料 / 动网页 / 动桌面」三档选:只取资料用联网搜索,要操作网页用浏览器控制,要操作整个桌面才用 computer use。 三者权限面依次放大,最小权限原则永远优先。只做网页自动化的场景不要为了「更强」直接上 computer use,权限越大,误操作与提示词注入的代价越高。
相关术语
- dsh-browser
- dsh-browser 指 DeepSeek Harness 生态里的浏览器控制类 DSH plugin,能驱动真实浏览器开页面、抓取内容、模拟交互与截图。它面向页面操作,区别于只取内容的联网搜索插件。— DSH Plugin Hub - dsh-browser-control
- 浏览器依赖(browser runtime)
- 浏览器依赖是浏览器控制插件运行所需的浏览器内核或运行时,需要单独安装或指定路径。缺失依赖会表现为插件已装但无法打开页面。— DSH Plugin Hub - dsh-browser-control
- 凭证剥离(credential stripping)
- 凭证剥离指在把浏览器上下文交给 Agent 前,移除登录态、Cookie、密钥等敏感信息,避免其进入模型输入。它是浏览器自动化最重要的安全前置。— DeepSeek Harness 官方文档 - 进程沙箱
- profile
- profile 是 DeepSeek Harness 里的一整套配置组合,决定加载哪些插件、暴露哪些工具与权限策略。DSH plugin 装到哪个 profile,就只在那个 profile 里生效。— DeepSeek Harness 官方文档 - 工具子系统
来源
- dsh-browser-control(DSH Plugin Hub 插件条目)· dsh-plugin.org
- DeepSeek Harness 官方文档 - 工具子系统· deepseek-harness
- DeepSeek Harness 官方文档 - 进程沙箱· deepseek-harness