DSH(DeepSeek Harness)採用插件化架構,針對測試場景,傳統的腳本編寫或手工測試往往與對話流程割裂。DSH Test Plugin 插件旨在解決這個問題,它允許開發者在 DSH 對話中直接利用自然語言完成測試規劃、執行和結果交付,複用當前的模型、工具和會話記錄。
插件介紹¶
DSH Test Plugin 是 DeepSeek Harness 的原生測試插件,由 Pegasus-Yang 維護。它接收對業務流程的描述,將任務拆解爲業務步驟和檢查點,結合真實的頁面元素或接口響應執行檢查,並在同一對話中展示進度、證據和結果。
插件支持網頁 UI 測試與 GET JSON 接口測試,能夠處理 TXT、Markdown 用例以及 CSV 參數化數據,最終生成包含步驟、斷言和附件的靜態 HTML 報告。
安裝與啓用¶
安裝前請確保已安裝 Node.js 22.19+,以及 DeepSeek Harness 0.2.1-alpha.1、alpha.2 或 alpha.3。插件運行於 DSH native 工具模式。
在 DSH 對話框中使用以下命令進行安裝:
dsh plugin --profile web add github:Pegasus-Yang/DSH-Test-Plugin#v0.13.1
安裝完成後,刷新頁面即可啓用插件。
核心功能¶
該插件提供以下能力:
- 自然語言規劃與審覈:將任務拆解爲步驟,支持直接執行或先審覈修改計劃。
- 網頁與接口測試:通過 Playwright MCP 操作網頁,採集 GET JSON 響應並檢查狀態碼與字段。
- 文件用例與參數化:使用 TXT、Markdown 保存用例,利用 CSV 展開多組數據逐項審覈後串行執行。
- 執行進度與耗時:在輸入框上方顯示當前步驟、結算數量和耗時。
- 實時畫面與錄像:在同一頁面觀看無頭瀏覽器畫面,支持獨立開啓錄像並在報告中回放。
- 證據與測試報告:保存實際觀察與預期值,生成靜態 HTML 報告,支持離線保存。
- 實際步驟與手工用例:記錄真實操作並整理爲可複用的 Markdown 手工用例。
典型用法¶
在 DSH 對話框中,可以使用以下命令:
/test <任務>:展示計劃後直接執行。/test-plan <任務>:先審覈、修改計劃,再執行。/test-run <文件>:從當前工作區讀取 TXT 或 Markdown 用例並執行。/test-data <CSV> --file <用例文件>:按 CSV 展開參數,審覈後執行。
示例:
/test 訪問 http://127.0.0.1:8929/users/sign_in,斷言頁面存在用戶名輸入框、密碼輸入框和 Sign in 登錄按鈕
注意事項¶
- 執行模式:插件運行於 DSH native 工具模式,共享測試環境按串行方式執行;多對話獨立瀏覽器並行運行屬於後續優化。
- 接口測試:接口測試支持 GET JSON 採集。
- 結果判定:測試結果保留失敗、取消和清理狀態。證據缺失、工具錯誤或必要清理失敗不會算作通過。
- 語言:報告界面及部分提示以中文爲主。
參考資料¶
- 插件目錄:DSH Test Plugin
- 源碼倉庫:Pegasus-Yang/DSH-Test-Plugin