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

快速上手

dsh-browser

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add github:Lum1104/dsh-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 一直在跑、侧边栏却显示「未连接」怎么办？

安装器只在启动时把桥 bundle 注册进 dsh 本机的 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 时 Token 会被自动生成并写入 ~/.dsh/ext-bridge-token（权限 0600）。

哪些网页不能被读取和操作？

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

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

不会。快照在渲染时把敏感字段（type=password 和支付卡号）一律显示为 ••••，字段值不离开页面；可访问名称也不会拿敏感字段的当前值拼装，面板侧收到的就是脱敏后的纯文本。

每次切换标签页都会被模型跟着切吗？

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

怎么卸载？

dsh 侧用 dsh plugin --profile web remove @yuxianglin/dsh-bridge-browser 移除桥插件；Chrome 侧到 chrome://extensions 找到「dsh 浏览器助手」点「移除」即可。删除 ~/.dsh/dsh-browser（托管安装）和 ~/.dsh/browser-extension（扩展目录）会把本地副本清空。

模型看不到截图，会不会更好/更差？

整套管线刻意采用纯文本：页面被转成结构化文本 + 编号交互清单，模型通过编号精确操作。优点是稳定编号跨快照不变、隐私边界更窄；缺点是验证码、纯图片按钮等没有可访问名的元素，工具结果会标注「存在无文本可访问名的元素」，需要手动完成。

DSH 升级会影响这个插件吗？

桥插件通过 peerDependencies 锁定了 @deepseek-ai/dsh-* 系列为 0.1.0-rc.6，且 workspace 的 pnpm-lock.yaml 把运行时与扩展依赖固定在同一条已验证发布线上。DSH 升级时需要同步更新 manifest 与锁文件并重跑测试。

— 源: plugin_wiki.faq_json

兼容性

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

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则