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

快速上手

BrowserSkill

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add @wxg-prc-cpg/browser-skill-dsh-plugin

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 复用真实登录态：Agent 可以操作你已经登录的网站，不需要额外测试账号。
• 不中断你的工作：浏览器任务在独立可见的 Agent Window 中运行，不影响你继续使用自己的浏览器。
• 支持任意 Agent：只要 Agent 能调用 Shell，就可以通过 bsk CLI 使用 BrowserSkill，不绑定特定模型、Agent 框架或 harness。
• 内置 human-in-loop：遇到 captcha、登录、确认弹窗等必须由人处理的步骤时，Agent 可以主动请求你接管，完成后再继续任务。
• crates/bsk-cli — bsk CLI 与本地 daemon

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装上这个插件就能立刻让 AI 操作我的浏览器吗？

不一定。插件本身只是把 bsk 命令行包成 DSH 的模型工具，电脑上还必须先装好 bsk CLI 并让它出现在 PATH，再把 BrowserSkill 浏览器扩展装进 Chrome 或 Edge 并连接好，少任何一步工具调用都会报安装指引。

为什么系统提示里看不到 browser_ 这一组工具？*

默认开了渐进式披露（lazyTools=true）：插件启动时只把 browser-skill 这条 skill 的目录项挂上去，11 个 browser_* 工具的 schema 不进提示。等模型真的调用一次 browser-skill（或用户发了 /browser-skill 指令）后，整套工具才会在当前进程剩余生命周期里全部现身。把 lazyTools 改成 false 可以恢复旧行为——启动就注册全部工具。

AI 能操作我自己打开的那些带登录状态的浏览器标签吗？

可以，但需要显式借用：AI 通过浏览器扩展在你的浏览器里打开一个隔离的 Agent Window 跑任务，你日常用的窗口完全不受影响；要碰你已经登录的某个标签，必须走借出流程并在任务结束后归还。

一个会话里能同时控制多个浏览器吗？

可以。通过 browser_session_start 多次启动就会得到多个会话 id，配置项 maxSessions（默认 5）限制并发上限。除非显式传 session 参数，否则后续工具会作用于"最近一次启动或使用过"的那个会话；工具返回里也会回显实际操作的会话 id。

AI 能看到或操作别的程序创建的浏览器会话吗？

不能。bsk 守护进程可能被多个 Agent 或终端共用，但本插件严格只跟踪自己通过 browser_session_start 启动的会话：传一个外部会话 id 会被直接拒绝，browser_session_list 也只列出自己拥有的会话，插件卸载时只清理自己创建的会话，绝不误伤他人。

我中止了一次 AI 操作会发生什么？

DSH 的取消信号会传到工具，再由 runner 用 SIGTERM 杀掉正在运行的 bsk 子进程（2 秒未退出再发 SIGKILL）。本次调用被标记为 AbortError，AI 这边可能继续后续动作，而那条被中止的浏览器任务就到此为止。

截图是直接给 AI 看一张图，还是只给个路径？

取决于部署：宿主挂载了附件存储、且当前模型路由声明支持图像输入时，浏览器截图会被存进附件存储并以 image 块直接交给 AI；否则工具只返回 PNG 文件路径，需要 AI 自己读文件才能看。

这个插件只在 macOS 能用吗？

插件本身是纯 TypeScript，跨平台都能跑。但它的功能依赖 bsk CLI，目前 bsk CLI 支持 macOS（Apple Silicon / Intel）、Linux（x64 / ARM64）、Windows x64；浏览器端目前支持 Chrome 与 Edge，其他 Chromium 内核浏览器理论上可用，Firefox 还在规划中。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 0.1.0-rc.6+
• Node: 未声明

— 源: plugin_wiki.compatibility_json

踩坑提醒

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

— 来源：通用规则