前言¶
在 DeepSeek Harness (DSH) 的開發流程中，前端發佈的質量往往依賴“看起來不錯”的主觀判斷，或者難以復現的靜態快照。dsh-shipcheck 是一個證據優先的前端發佈檢查插件。它利用真實瀏覽器執行確定性檢查，生成截圖、命名基線和可重現的 JSON 報告，從而爲發佈門禁提供事實依據。
核心功能¶
插件通過真實瀏覽器進行多項檢查，涵蓋可用性、結構與內容質量：
* 頁面可用性、標題、可見正文和主要標題檢查。
* 缺失圖片替代文本和未命名控件/鏈接檢查。
* 捕獲視口內的水平溢出檢查。
* 檢查必需/禁止文本和必需 CSS 選擇器。
* 檢查相對於命名基線的結構迴歸。
* 檢查瀏覽器運行時失敗，包括控制台錯誤、未捕獲異常和失敗的 HTTP 4xx-5xx 請求。
安裝與啓用¶
安裝插件使用以下命令：
dsh plugin --profile web add github:guo6x/dsh-shipcheck
安裝後，插件即可在 DSH 環境中調用。
典型用法¶
插件提供以下工具：
shipcheck_run：在真實瀏覽器中檢查 URL，運行檢查，比較基線，並保存截圖和 JSON 報告。shipcheck_matrix：在單一發布門禁中檢查 1-20 個 URL，保留路由級截圖、報告和基線。shipcheck_flow：使用真實瀏覽器操作執行有界用戶旅程，包括步驟截圖、斷言和脫敏證據。shipcheck_baseline：顯式捕獲已審查 URL 作爲命名結構基線。shipcheck_history：列出最近的報告及其通過/失敗摘要。
示例用法：
* 運行 shipcheck_run 檢查 http://127.0.0.1:3000 作爲項目 checkout，要求可見文本 Checkout，禁止 Something went wrong，並告訴是否可以繼續人工審查。不修改文件。
* 使用 shipcheck_baseline 捕獲當前結賬頁面作爲項目 checkout 的基線。然後再次運行 shipcheck_run 並用證據路徑解釋任何結構迴歸。
* 爲 http://127.0.0.1:3000/、http://127.0.0.1:3000/login 和 http://127.0.0.1:3000/checkout 運行 shipcheck_matrix 作爲矩陣 checkout-release。在每個路由上要求 Checkout，禁止 Something went wrong，並報告哪個路由失敗，包括其截圖和 JSON 報告路徑。
* 從 http://127.0.0.1:3000/login 作爲 checkout-login 運行 shipcheck_flow。填寫 Email 和 Password 字段，點擊 #submit，等待 URL 包含 /dashboard，斷言 Logged in 可見，並告訴旅程是否通過。不修改文件。
適用場景與注意¶
- 定位：這是發佈門禁，不是完整的視覺迴歸實驗室。第一個基線比較穩定結構和文本漂移，而不是跨操作系統的像素級截圖。
- dsh-palate 集成：第一個版本不使用
dsh-palate原則對頁面進行評分；它存儲了該集成所需證據的形狀。 - 運行時檢查：運行時遙測使用瀏覽器的 CDP 事件。如果伴隨瀏覽器未暴露該能力，Shipcheck 會報告明確的警告，而不是假裝運行時是乾淨的。
- 人工審查：通過的自動化運行仍需人工審查產品語義、內容質量和有意例外。
總結¶
dsh-shipcheck 爲 DSH 提供了基於證據的前端發佈門禁。它通過真實瀏覽器執行確定性檢查，確保在手動審查前存在可重現的失敗證據。
- 目錄頁: https://www.skillhub.cn/plugins/guo6x/dsh-shipcheck
- GitHub: https://github.com/guo6x/dsh-shipcheck
