dsh-web-verify-panel：在侧边栏完成网页验证，阻断系统浏览器弹窗

前言¶

在使用 DeepSeek Harness (DSH) 构建 agent 时，如果 agent 需要验证网页内容或浏览页面，通常会弹出系统浏览器窗口。这会遮挡对话界面，打断 agent 的工作流，且难以进行自动化截图操作。dsh-web-verify-panel 旨在解决这一痛点，将网页请求收敛到 DSH 侧边栏内完成，保持上下文连续性。

这是什么¶

dsh-web-verify-panel 是一个 DSH 插件，它复用侧边栏面板，通过沙箱 iframe 渲染网页。它解决了 agent 需要打开网页进行验证时的窗口切换问题，并允许 computer_screenshot 工具直接截取页面区域，无需处理系统浏览器的遮挡。

核心功能¶

同屏工作流：页面和对话在同一个窗口，agent 不用在浏览器和对话之间来回切换。
直接截图：computer_screenshot 可以直接截取页面区域，不会被系统浏览器窗口挡住。
沙箱隔离：面板为沙箱 iframe 渲染，不共享系统浏览器登录态，每个会话的标签页相互独立。
复用资源：复用侧边栏面板，不额外拉起浏览器进程。
工具支持：提供 web_verify_open(url, title?) 工具，在侧边栏打开网页并返回页面区域 rect，可直接用作 computer_screenshot 的 region。
自动适配：打开页面时自动加宽面板（约 60% 视口，上限 1600px），60 秒后恢复；自动为 Router Standard 预设打补丁，使工具在会话首轮即可用。

安装与启用¶

安装前请确保已安装依赖前置插件 dsh-better-sidebar（侧边卡片浏览器）。

# 复制插件文件到 profiles 目录
Copy-Item -Recurse -Force dsh-web-verify-panel "$env:USERPROFILE\.dsh\profiles\web-desktop\node_modules\"

# 在 cordis.patch.yml 末尾追加以下内容
#   - insert:
#       - id: web-verify-panel
#         name: 'dsh-web-verify-panel'

# 运行补丁脚本
node "$env:USERPROFILE\.dsh\profiles\web-desktop\node_modules\dsh-web-verify-panel\scripts\patch-router-preset.mjs"

# 重启 DSH，并在 Web 页面执行硬刷新（Ctrl+Shift+R）

典型用法¶

打开网页：使用工具 web_verify_open(url, title?) 在侧边栏打开目标网页。工具会返回一个 rect 对象，表示页面在 DSH 窗口中的区域。
截取页面：使用 computer_screenshot(region=rect) 直接截取该页面区域。

适用场景与注意¶

依赖项：插件依赖 computer-user（截图）与 dsh-better-sidebar（面板）。若未安装这些依赖，工具仍会注册，但无法完成打开与截图。
兼容性：
- Windows 桌面端：打开与截图均可用。
- macOS / Linux：打开可用，截图需平台另有 computer-use 实现。
- 网页版：同机可用，远程部署仅支持打开（人工查看）。
限制：
- 被 X-Frame-Options 等响应头拒绝的站点会显示空白。
- rect 相对 DSH 窗口计算。如果 DSH 窗口非全屏，需要先对整屏截图进行定位，再获取页面区域。
安全提示：插件以当前 DSH 进程权限运行。安装前应检查源码与许可证。

短结尾¶

dsh-web-verify-panel 将网页验证流程集成到 DSH 侧边栏，减少了窗口切换，提升了 agent 处理网页内容的自动化程度。更多细节可参考 GitHub 仓库或技能目录。