前言¶
DSH 主机通常运行在无显示器的环境中，这使得智能体在处理需要人工交互的步骤时（如登录、短信验证码、二维码扫码、验证码或硬件密钥）会遇到阻碍。无头浏览器无法直接处理这些交互。dsh-embedded-browser 插件在 DSH 主机内部署了一个浏览器环境，智能体通过工具驱动，而操作者可以在 DSH Web UI 的侧边栏中实时观看或接管同一个标签页，从而解决这一痛点。
是什么¶
该插件由 imroc 维护。它为每个 DSH 会话提供一个独立的浏览器标签页。AI 使用 browser_embedded_* 工具控制该标签页，而操作者通过 DSH Web UI 右侧边栏中的“浏览器”标签页进行实时监控或人工接管。所有会话共享同一个持久化配置文件，登录状态在会话间保持。
核心功能¶
插件提供以下工具集：
browser_embedded_status：报告运行状态、当前 URL/标题，以及是否有人工操作等待。browser_embedded_navigate：打开 URL，首次使用时启动浏览器。browser_embedded_snapshot：读取页面标题、URL、可点击/可输入元素列表及可见文本。browser_embedded_click：通过元素序号或可见文本点击。browser_embedded_type：在字段中输入内容，支持submit按下回车。browser_embedded_press：按下 Enter、Tab、Esc、箭头键等。browser_embedded_scroll：上下左右或全屏滚动。browser_embedded_emulate：模拟设备（如iphone-14）、主题（dark）或视口，或重置为默认（reset: true）。browser_embedded_eval：在页面中执行 JavaScript 并返回受限制的 JSON。browser_embedded_screenshot：返回 PNG 图片。browser_embedded_ask_human：在当前标签页显示指令，等待操作者按下“我已完成”。browser_embedded_close：关闭该会话的标签页，配置文件保持。
安装与启用¶
安装后，工具默认不注册。需要通过以下方式激活：
* 调用名为 browser-use 的 skill。
* 输入手势 /browser-use。
* 在会话日志中找到过去成功的调用记录（这会在插件重载后重新打开工具门禁）。
若希望插件加载时立即注册工具，可在配置中设置 lazyTools: false。
典型用法¶
在启用工具后，可进行以下操作：
- 模拟移动端设备查看页面：
browser_embedded_emulate { "device": "iphone-14" }
browser_embedded_screenshot
- 切换深色模式：
browser_embedded_emulate { "theme": "dark" }
browser_embedded_screenshot
- 重置模拟环境：
browser_embedded_emulate { "reset": true }
注意事项¶
- 插件运行在无 GUI 的环境中，浏览器界面由 DSH Web UI 的侧边栏提供。
browser_embedded_emulate仅在当前会话生效且是临时的，不会修改全局配置。- 需要人工处理登录、2FA、验证码等逻辑，插件仅提供展示和操作入口。
结尾¶
该插件为 DSH 环境下的无头自动化提供了必要的人工交互入口，适合处理复杂的认证流程。
