装 DSH 浏览器插件容易走弯路的不是命令本身而是三个岔路口装进哪个 profile、npm 包名到底叫什么、装完之后 34 个browser_*工具按什么顺序用。这篇按顺序过一遍想先看同类插件的中文对照见 完整插件清单与汉化避坑指南。第一步先决定装进哪一端的 profile插件要装进你要用的那一端的 profile两端都装也可以。两条命令只差一个参数--profile web对应纯dsh web--profile desktop对应 DSH Desktop。选错的后果是「装了但那一端看不到工具」不是报错。也能从本地源码目录安装把包名换成本仓库路径。包名不是仓库名仓库叫wqty123/dsh-browser但npm 包名是dsh-builtin-browser——写add dsh-browser会失败。registry 上 npm latest 是0.4.7详情页里的站内快照0.4.5已滞后所以安装命令不要写死小版本许可为 MIT。第二步桌面端特有的第二次安装Web 端装完就结束桌面端还有一步它把插件与官方侧栏之间的 bridge 装进已安装的桌面端装完 agent 才能驱动侧栏那个页面即「人机同页」。脚本幂等也支持--revert回滚。要注意桌面端升级会替换resources/app/、bridge 随之消失插件更新后也要重装bridge 不在时插件自动退回自托管只多一个独立窗口。34 个工具按五组上手先按browser_open→browser_snapshot→browser_execute→browser_fill→browser_screenshot跑一遍能走完就说明链路通了。打开browser_open 与 browser_waitbrowser_open打开 URL 并返回快照browser_wait等页面就绪标签类有browser_list_tabs/browser_switch_tab/browser_close_tab/browser_reset。每个 DSH 任务拥有独立会话独立标签页与历史。导航只有界等待新文档解析完成、不等异步内容所以慢站点要先browser_wait再取快照。了解snapshot、a11y 与 contentbrowser_snapshot给带编号的交互元素清单可引用时附{#id}/{[namex]}选择器并穿透同源 iframe 与 Shadow DOMbrowser_a11y给无障碍树的角色、名称与状态默认 150 个节点maxNodes可调 10–5000browser_content以 html / markdown / txt / json 抓取。只挑一个工具理解页面选browser_a11y。操作点击、输入、按键、滚动与翻页browser_click/browser_type支持语义target{by: css | text | xpath, value, index?}另有browser_key、browser_scroll、browser_back/browser_forward/browser_refresh与browser_execute。定位纪律一句话先语义、后坐标。填表一次填多个字段单控件用browser_set_value/browser_check/browser_select/browser_clear/browser_get_value批量用browser_fill按选择器 / 名称 / 标签匹配单个字段失败不影响其余字段。看到截图、下载与登录态browser_screenshot支持fullPage、savePath、JPEG 与缩放browser_download带会话 cookie 拉文件落盘browser_auth导出 / 恢复 cookie另有browser_history/browser_replay以及检测 Cloudflare / reCAPTCHA / hCaptcha / Turnstile 的browser_challenge——它无法自动解决该让用户人工完成。这一组要克制截图是最贵的工具输出。环境要求与两个如实口径需要 DSH已装对应 profile、Node22.19与 Electron 运行时electron 30.0.0在运行时依赖里Electron 44 不再随安装下载二进制约 100 MB需联网缺了先npx install-electron。桌面端走侧栏、改用本机 Chrome / Edge 都不需要它。两个如实口径安全扫描把本插件标记为「含敏感能力」可执行外部命令 / 读写删除本地文件 / 读取剪贴板或密钥类环境变量 / 发起外部网络请求尚无人工评估信任档位是「已验证」——站内已于 0 天前在dsh 0.2.0-rc.2下真实安装成功。更新方式两端不同插件在两种宿主里各有一份安装更新其中一端不会连带更新另一端。Web 端更新 profile 里的依赖 → 重启dsh web。桌面端更新依赖 →重跑node desktop-bridge/install.mjs→ 重启 DSH Desktop少了中间那步「人机同页」会失效。两边一致的是工具集、设置页里的「浏览器」栏与历史 / cookie 的持久化行为。总结把 profile 选对、把包名记成dsh-builtin-browser、桌面端补上 bridge 那一步剩下就是把 34 个工具按「打开 → 了解 → 操作 → 填表 → 看到」用熟想对照同类插件的中文形态见 完整插件清单与汉化避坑指南。适合与不适合适合真实站点上登录后操作的自动化每一步都要被人看着、随时接管的协作流程已有 Chrome / Edge 想直接复用的机器多任务并行、各任务需要独立标签与历史的批量场景。不适合跑在 Linux / macOS 上且要求稳定承诺的部署——系统浏览器查找虽已适配但端到端链路尚未实测官方口径是暂不承诺不接受浏览器 cookie 在磁盘上明文落盘的部署自托管载体为 Electron 默认行为还需要无痕模式的场景privateMode未实现插件不承诺该能力。标签共享浏览器、DeepSeek Harness、安装教程、34 个工具、Cordis 插件本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。