前言¶
在 DSH 生態中，”代碼已寫完”與”可發佈”是兩個不同的概念。大多數項目在交付時面臨三個核心問題：不知道該測什麼（盲點），沒有驗證記錄（結論易丟失），以及無法結構化地協商修復範圍（修復順序不清）。QualityForge 旨在將 QA 流程轉化爲一個可復現的流水線：從掃描、生成清單、執行檢查，到生成可勾選的報告，最後回到項目內部進行修復和複測。
什麼是 QualityForge¶
QualityForge 是一個企業級的 DeepSeek Harness QA 插件。它通過系統化的端到端測試，提供基於 P0–P3 嚴重等級的可操作報告。該插件維護者 lpeixin 提供了包含 45 個領域、290 種方法、1363 個用例的企業級測試方法庫。
核心能力¶
QualityForge 的核心價值在於將驗證過程標準化、結構化。
- 企業級測試方法庫：涵蓋 45 個領域（如構建依賴、靜態質量、單元測試、集成契約、API 層、UI/無障礙、E2E 驗收、數據、性能、安全合規、可靠性、可觀測性等）。
- 四級測試深度：支持
smoke（冒煙）、standard（標準）、deep（深度）、exhaustive（全面）四種深度，分別對應 331、984、1295、1363 個檢查項。 - 項目類型感知：自動識別項目類型（庫、CLI、服務、Web、桌面、移動、插件、數據、ML、Monorepo），並跳過不適用的檢查項。跳過的項會記錄原因，絕不計入通過。
- 證據優先：偵察結論僅來源於磁盤證據，每個缺陷都需要證據、復現步驟、文件和修復建議。
- 自動化執行與回寫：內置 11 種預設命令（build、typecheck、lint、format、test、coverage、e2e、依賴審計、密鑰掃描、install、outdated）。結果會精確回寫到具體的測試項上。如果缺少工具，會被跳過，不會被視爲失敗。
- 可勾選報告與回讀：生成 Markdown + JSON 報告，報告中的每一項都有複選框。通過
qf_update sync=true將勾選狀態（WONTFIX / DEFER / NA）寫回結構化數據。 - 修復範圍協商：
qf_fixplan能夠構建修復波次（Fix Waves）和交接單，明確本輪修復哪些項。 - 安全邊界：偵察階段只讀不寫；執行階段僅運行白名單預設命令；無運行時依賴。
安裝與啓用¶
在 DSH 中添加該插件：
dsh plugin --profile <profile> add dsh-qualityforge
安裝後重啓 DSH 會話，使模塊生效。如果在會話中直接安裝，需要 danger-full-access 權限。安裝後可通過以下命令驗證配置：
dsh --profile <profile> --dump-config | grep -A3 qualityforge
典型用法¶
QualityForge 提供了一套標準的工作流命令，用於完成從掃描到報告的全過程。
qf_scan：進行偵察。分析棧、項目類型、可運行命令，確認工程化缺口。qf_plan：生成檢查清單。默認根據標準深度生成，並按適用性過濾。qf_exec：執行檢查。運行構建、類型檢查、Lint、測試、覆蓋率、依賴審計、密鑰掃描等命令。qf_report：渲染報告。生成 Markdown 和 JSON 格式的報告，包含判決結果和修復波次。qf_update sync=true：回寫狀態。開發者勾選報告中的項後，同步狀態回結構化數據。qf_fixplan：生成修復方案。基於當前狀態生成修復波次和交接單。
輸出與證據¶
所有中間產物和報告均存儲在審計項目內部的 .qualityforge/ 目錄下，而非插件內部：
<project>/.qualityforge/
├── audit.json 結構化數據（單一事實來源）
├── QUALITYFORGE-REPORT.md 可勾選的報告
└── report.json 機器可讀快照
權限與限制¶
- 語言環境：當前報告和目錄均爲中文。
- 證據來源：證據僅來源於磁盤。
- 工具缺失處理：如果檢測到工具不存在，命令會被跳過，絕不會導致流程失敗。
- 安全性：偵察階段是隻讀的，執行階段僅限於白名單內的預設命令，攻擊面極小。
總結¶
QualityForge 解決了 “寫完代碼” 到 “準備發佈” 之間的證據鴻溝。它通過結構化的檢查清單、可回寫的狀態機制以及基於證據的修復波次，爲團隊提供了一個可協商、可驗證的 QA 流程。
