前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構，允許用戶通過插件擴展其功能。對於粒子物理中的分波分析（PWA），手動處理物理門禁（如運動學閾值、衰變頂點 J^P、C 守恆）以及迭代擬合流程非常繁瑣。auto-pwa 插件旨在通過 AI 驅動的自動化，解決這一痛點，提供從配置編輯、擬合執行到迭代收斂的全流程支持。
核心功能¶
該插件提供以下核心能力：
* PDG-2026 共振態表查詢：支持查詢共振態名稱、J^P、J^PC、質量區間及衰變末態。
* 物理門禁 config 編輯：嚴格校驗配置，運動學閾值、衰變頂點 J^P、C 守恆等物理門禁絕不豁免。
* ctpwa 擬合執行：集成 ctpwa 擬合引擎，支持後臺任務提交。
* 數值化擬合評估：提供 chi2/ndf、pull 區域、分波份額等數值診斷。
* goal 驅動的迭代收斂：支持基於目標的迭代邏輯，自動評估與收斂判定。
* SLURM 集羣作業提交：支持在無本地 GPU 的環境下，通過 SLURM 集羣提交作業。
* 分波分析工具集：提供 auto_pwa_* 系列工具，覆蓋查找、診斷、編輯、執行等環節。
安裝與啓用¶
通過 npm 全局安裝即可啓用。
npm install -g @deepseek-ai/dsh auto-pwa
安裝後，插件會自動註冊 auto-pwa-analysis skill，無需手動複製到 ~/.dsh/skills 目錄。
典型用法¶
- 啓動交互式界面（默認啓動 Web GUI）：
auto-pwa
- 升級插件：
auto-pwa --upgrade
- 無頭模式執行分析：
auto-pwa -p headless "完成此文件夾分波"
- 本地 patch 掛載（開發或未發佈時使用）：
pnpm dsh web --patch /absolute/path/to/auto-pwa/patch/auto-pwa.cordis.yml
注意事項¶
- 權限與風險：插件以當前 DSH 進程的權限運行。在安裝前，請務必檢查源碼與許可證。
- 物理門禁：物理門禁絕不豁免，包括運動學閾值、衰變頂點 J^P、C 守恆。
- 依賴環境：依賴 yaml 運行時。
- 默認擬合程序：默認使用插件自帶的
scripts/aifit.py進行擬合。
結尾¶
該插件由 BHXiang 維護，分類爲模型推理，開源協議爲 MIT。
