前言¶
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。
