dsh-plugin-browser

문서

전체 README 읽기 ↗

3. 追加到机器级配置(对所有 profile 生效)

cat >> ~/.dsh/cordis.patch.yml /start-agent-chrome.sh| 自定义 Chrome 启动脚本(存在则优先用;适合要挂代理/特殊参数的场景) | |AGENT_BROWSER_CDP_PROFILE|/chrome-cdp-profile| 已登录 Chrome 的用户数据目录——**你的登录态存这里** | |AGENT_BROWSER_ISOLATED_PROFILE|/bw-mcp-profile| isolated 模式的独立目录 | |AGENT_BROWSER_CDP_PORT|9222| CDP 端口 | |AGENT_BROWSER_ISOLATED_CHANNEL| 未设 | 设为chrome让 isolated 模式用系统 Chrome 而非 Playwright 自带 chromium。**macOS 慎用**:无头系统 Chrome 会被 macOS 认定为"正在运行的 Chrome",导致你点 Dock 图标打不开日常 Chrome | |AGENT_BROWSER_NO_SANDBOX| 未设 | 设为1强制 Chrome 加--no-sandbox`(一般只在特殊环境需要) |

默认目录说明:默认值是为了和 agentic-browser-mcp(本插件的原型)的用户无缝共存——两者可以共享同一个已登录 Chrome。如果你没用过它、也不在乎共存,设置 AGENT_BROWSER_DIR 换成自己的目录即可,插件会自动创建。

想带登录态:首次用 real 模式时插件会拉起一个专用 Chrome 窗口(和你的日常浏览器完全独立),在里面手动登录一次你要的站点,登录态持久保存在 AGENT_BROWSER_CDP_PROFILE 目录,以后每次直接可用。

使用要点

ref 是临时的:每次 snapshot 重新编号,页面变化后先重新 snapshot 再操作
验证码/二次验证:模型会调 browser_wait_human,DSH 界面弹出卡片,你去浏览器操作完点确认即可
多标签页:新开的标签页自动跟随;需要固定某个标签页用 browser_tabs 的 switch
隐私提示:browser_eval/browser_storage 能读取浏览器里的 cookies 和登录凭据——请只在你信任的会话中使用本插件