本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-browser (bridge)

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:Lum1104/dsh-browser#path:packages/browser/bridge-browser

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 使用你的真实浏览器，而不是无头副本：模型操作你已经打开的页面，登录态、会话和 Cookie 均会保留。
• 纯文本模型接口：编号控件、跨快照稳定 ID、delta 更新和敏感值掩码，使模型无需视觉也能操作页面。
• 收窄隐私边界：密码和支付卡字段始终显示为 ••••，字段值不会离开页面。
• 受保护的桥连接：远程连接使用认证握手，特权网关方法拒绝非回环调用方，扩展把工具绑定到一个由用户控制的标签页。
• 确认本机 dsh web 正在运行（默认 http://127.0.0.1:3080）。

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

为什么安装后侧边栏一直显示「未连接」？

dsh plugin 命令只把桥 bundle 注册到本机 web profile；安装前已经在跑的 dsh 进程不会自动加载新插件。把当前 dsh 停掉，重新执行 pnpm start 或 npx @deepseek-ai/dsh web，扩展会自动重连，无需重新配置。

需要手动复制粘贴 Token 吗？

本机（127.0.0.1）回环连接不需要 Token，扩展通过 /ext/bridge-config 自动探测本机 dsh 并建立 WebSocket；只有用 --host 0.0.0.0 远程部署时才需要在侧边栏设置里填地址和 Token。没显式配置时 Token 会自动生成并写入 ~/.dsh/ext-bridge-token（权限 0600）。

哪些网页无法被读取和操作？

受保护的浏览器内置页（如 chrome://、chrome-extension://、Chrome Web Store）无法注入内容脚本，因此不支持；只有普通的 http:// 或 https:// 页面可用。已打开的页面不需要刷新，扩展会在第一次操作时自动注入脚本。

密码或银行卡号会不会发给模型？

不会。快照在渲染时把敏感字段（type=password 和支付卡号）一律显示为 ••••，值不离开页面；表单填写也只回送脱敏后的纯文本。

切换标签页会不会被模型跟着切？

不会。助手开始工作时会绑定当前活动标签页；用户手动切页后，后续浏览器操作会暂停，侧边栏会询问是「继续原页面」还是「跟随新页面」，选择原页面允许后台操作，但绝不会改变你正在看的标签页。

这套方案和官方 dsh 浏览器能力是一回事吗？

是的，这是 dsh web profile 内置浏览器能力的桥接实现：插件注册 browser_* 工具集和 WebSocket 通道，模型通过编号寻址操作元素，所有动作在用户自己的 Chrome 里完成，登录态保留。

怎么卸载？

dsh 侧用 dsh plugin --profile web remove @yuxianglin/dsh-bridge-browser 移除桥插件；Chrome 侧到 chrome://extensions 找到「dsh 浏览器助手」点「移除」即可。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: ^22.19 或 >=24

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则