q35888/dsh-plugin-browser ↗★ 1
dsh-plugin-browser
原生浏览器自动化,提供十五个浏览器工具,共享已登录的 Chrome。 适合需要网页操作与自动化的任务,需安装依赖并配置 Chrome 与 CDP 端口。
同名包的其他仓库
安装
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:q35888/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 和登录凭据——请只在你信任的会话中使用本插件