編寫工具可以修改頁面並構建它,但這並不能證明頁面已加載、交互正常、瀏覽器無錯誤,或者結果與預期匹配。dsh-live-loop 爲已安裝的 DeepSeek Harness Agent 提供了一個連貫的運行時循環。
這是什麼¶
這是 DeepSeek Harness 前端運行時驗證插件。它讓 Agent 能夠檢測、運行、預覽、交互、視覺對比並驗證 Web 應用,同時生成持久證據。
- 維護者:POWERRRRRRRR
- 許可證:MIT
- 定位:處理開發服務器生命週期、隔離的瀏覽器狀態、結構化觀察、交互、驗證和持久證據。它不編輯應用程序代碼;DSH 的正常編碼工具仍然負責代碼修改。
安裝與啓用¶
從 GitHub 克隆倉庫並安裝到 web profile。
git clone https://github.com/POWERRRRRRRR/dsh-live-loop.git
cd dsh-live-loop
npm ci --legacy-peer-deps
npm run build
npm pack --ignore-scripts
dsh plugin --profile web add ./dsh-live-loop-1.0.0.tgz
安裝完成後,重啓 web profile 以確保插件生效:
dsh --profile web web
核心功能¶
- 全流程閉環:檢測、運行、預覽、交互、視覺對比、驗證,全程帶有持久證據。
- 結構化檢測:支持 Vite、React、Vue、Next.js、通用腳本及 Monorepo,提供明確的歧義解析,避免靜默選擇錯誤的運行目標。
- 進程所有權:通過公共 DSH 子進程所有權實現 argv-only 執行,包含有界日誌和清理機制。
- 隔離環境:每個 DSH 主題擁有一個獨立的 BrowserContext。
- 有界觀察:支持 HMR、WebSocket、SSE 和輪詢的有界觀察窗口。
- 證據管理:生成 DSH Attachment 截圖,並附帶 Reference(參考)、Current(當前)和 Diff(差異)證據。
- 嚴格判定:使用嚴格的四態判定機制,拒絕將缺失的觀察結果轉化爲通過。
- 原生集成:提供原生的 DSH Web Live Preview、Verification Card 和 Settings 面板。
- 診斷能力:在驗證失敗時提供診斷信息,明確告知 Agent 需要修復的內容。
典型用法¶
Agent 可以通過工具調用完成驗證流程。例如,修復表單並驗證特定行爲:
Fix the form, start or reuse the detected app, fill the Name textbox with Ada,
press Enter, assert that “Hello, Ada!” appears, and do not finish until
live_loop_verify returns VERIFIED with screenshot evidence.
典型的失敗處理循環如下:
first verify: FAILED
→ inspect Console / Network / DOM / assertion / visual diff
→ edit the application
→ reload or let HMR apply
→ verify again: VERIFIED
→ deliver the report and evidence
適用場景與注意¶
- 環境要求:需要 DeepSeek Harness 版本
0.1.0-rc.7,Node.js 版本^22.19.0或>=24。 - 代碼編輯:插件本身不編輯應用代碼,DSH 的編碼工具對此負責。
- 證據權重:視覺相似性是支持性證據,絕不覆蓋頁面加載、診斷、交互或斷言的結果。
總結¶
dsh-live-loop 通過將瀏覽器操作和驗證邏輯封裝爲 DSH 的工具,爲前端智能體提供了可複用的運行時驗證能力。它確保了驗證過程的嚴謹性和結果的確定性,是構建可靠前端自動化流程的必要組件。
- GitHub:https://github.com/POWERRRRRRRR/dsh-live-loop
- 目錄:https://www.skillhub.cn/plugins/POWERRRRRRRR/dsh-live-loop