dsh-builtin-browser站内显示名「共享浏览器」仓库wqty123/dsh-browsernpm 包名与仓库名并不一致装起来只要两条命令但装完不等于能用顺。它把 agent 接进一个真实、可见、可随时人工接管的浏览器代价是运行链条更长桌面端要多一条装在外壳里的 bridge坐标点击受视觉策略约束脚本 / 下载 / 登录态写入由操作者掌握自托管还得找到能用的 Electron 二进制。任何一环没对上报出来的都像故障实际却是配置或环境。本篇只讲四个最容易被当成 bug 的坑。想先看同类插件的安装形态与中文文档再决定装哪一端、装哪个 profile可以先对照 完整插件清单与汉化避坑指南。口径先说清npm latest 是0.4.7取自 registry2026-10-12 发布站内快照0.4.5已滞后安装命令不必写死小版本Node 引擎要求22.19许可 MIT。站内信任档位是「已验证」0 天前在dsh 0.2.0-rc.2下真实安装成功安全扫描那一栏是静态扫描标记为「含敏感能力」、尚无人工评估不是「已确认安全」。这些坑不是站点人工归档的站内当前是「暂无已知风险记录」素材来自 README 的「已知限制 / 环境要求 / 更新方式」三节。四个坑里只有一个属于环境真出问题其余三个都是「设定被改过工具照着设定拒绝你」而带错误码常量输出的多半是后者。坑一 · 桌面端升级之后共享页面失效还凭空多出一个窗口现象。DSH Desktop 升级完成、插件也还在但 agent 打开页面不再出现在侧栏里而是弹出一个独立窗口「人机同页」消失。原因。人机同页不是插件自己实现的而是一条装在外壳主进程里的 loopback token bridge插件跑在 Node 模式宿主里、拿不到 Electron API只能借这条桥把侧栏浏览器 guest 的 CDP 接过来而桌面端升级会整体替换resources/app/bridge 随之消失。解决。重跑一次幂等脚本node 本仓库路径/desktop-bridge/install.mjs首次改动前会备份main.js.before-bridge回滚加--revert。这不是一次性的插件自身更新后同样要重做。bridge 不在时插件会自动退回自托管功能不中断只是让你长期跑在降级形态上。坑二 · 非视觉策略下每一次坐标点击都被拒收现象。browser_click传了视口坐标返回BROWSER_NON_VISUAL_COORDINATES换个坐标再试结果一样。原因。设置里的vision.strategy处在nonVisual那一档该档明确禁止依赖截图的坐标点击——这是设计出来的拒绝不是崩溃也不是页面元素没找到。它只作用在坐标这一件事上两种策略下 DOM 查询、无障碍树、文本提取与结构化抓取完全一致没有图像输入能力也能完整操作页面。解决。换成语义定位例如target { by: text, value: Sign in }或按css/xpath定位错误信息里本来就附了改法。别把同一次坐标点击发第三遍——要么改语义定位要么先去设置里把视觉策略调回auto。坑三 · 一串 XXX_DISABLED 错误码重试多少次都不会变现象。执行页面脚本报BROWSER_EXECUTE_DISABLED下载报BROWSER_DOWNLOAD_DISABLED恢复登录态报BROWSER_AUTH_WRITE_DISABLED导出 cookie 报BROWSER_AUTH_DISABLED。原因。设置页有一组「Agent 能做什么」的动作开关执行页面脚本、下载文件到磁盘、写入登录状态外加控制读取凭据的「凭据访问」它们写在设置文档里、由操作者持有34 个browser_*工具没有一个能改它。重试、换参数、找替代路径都没有出口。解决。请操作者在设置页打开对应开关。另三个码容易混BROWSER_DOWNLOAD_BLOCKED与BROWSER_SCREENSHOT_BLOCKED是保存路径被沙箱拒了该换路径而不是找开关BROWSER_DOWNLOAD_UNSUPPORTED是该载体没这个能力browser_restrict是模型可自解的软护栏不能用来绕过上面几个闸。坑四 · 自托管浏览器进程秒退报错却指向 Electron 路径现象。纯dsh web环境或桌面端退回自托管之后第一次调用页面工具子进程刚起来就退出报一个「exited immediately」味道的错误像 Electron 装坏了。原因。自托管要 spawn 一个 Electron定位顺序里有一条兜底是复用宿主自己的 Electron 二进制而打包应用如DSH Desktop.exe无法按脚本参数拉起误用就会秒退——这就是 issue #6 记录的现象。解决。插件侧已经修过这条判定标准是二进制旁边有没有app.asar有就一律不复用打包应用被整体排除在定位顺序之外开发模式那种裸 Electron 宿主仍可复用。所以该做的不是重装 Electron而是确认被选中的二进制到底是什么——ELECTRON_PATH可显式指定并且优先级最高。总结结论很朴素这个插件的坑基本不在代码里而在「哪一端的 profile、哪一层的外壳、哪一个开关」这三处装完只算走完一半把 bridge 与设置页对齐才算能用顺完整的错误码对照与配置项清单见 完整插件清单与汉化避坑指南照着查能少走几轮弯路。适合与不适合适合需要「人看着 agent 操作同一个页面」的演示与教学场景遇到 Cloudflare / reCAPTCHA 这类必须人工接管的页面、愿意随手接手点两下的协同流程表单批量填充、带登录态下载、结构化抓取这类目标明确的重复劳动已经在桌面端跑 DSH、接受每次升级后重跑一次 bridge 的人。不适合只在 Linux 或 macOS 上部署、且要求稳定性承诺的人——系统浏览器查找虽已适配这两个平台但端到端链路尚未实测暂不承诺把browser_restrict当安全边界用的人它只是防误操作的软护栏模型可自行解除不接受「侧栏页面内容与该 partition 的 Cookie 可被 agent 读取」这条边界变化的人就该把插件从 desktop profile 里移除。标签共享浏览器、DeepSeek Harness、避坑指南、浏览器自动化本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。