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 倉庫或技能目錄。