amy0720/spts_pdf_label_models

XGBoost 权重

• **xgb_classifier.ubj**：占位二分类模型，与 ../spec/xgb_features.json 列顺序一致。
• 重新生成占位权重：以 Pipe 根目录 README.md →「XGBoost 模型与特征」中的说明为准（若仓库已提供 scripts/gen_xgb_placeholder.py，一般在仓库根执行该脚本）。

附录 A / 默认超参与权重变更流程（运营基线）

以下与 docs/prd/pdf_labeling.md 附录 A 及 Pipe 根目录 README.md 默认超参表对齐；改代码中的默认阈值或模型决策边界前请先读 PRD §15。

1. 特征契约
   更新 xgb_classifier.ubj 时，必须与 resources/spec/xgb_features.json 的列名与顺序一致；改特征定义后同步该 JSON，并跑
   pytest pipe-demos/spts_pdf_labels/tests/test_physical.py -v（至少包含 test_xgb_feature_names_match_model）。

2. 语义是否变化

   • 修复 bug、或仅文档/命名、且不改变对外可见的默认打标语义：在 PR 中说明；通常 不 bump taxonomy_version。
   • 改变默认阈值 / 模型行为导致标签分布或契约含义变化：在 constants.py 中 **bump TAXONOMY_VERSION**，并在 Pipe README.md 的 Changelog（M1/M2）表 增加一行（与 PRD §15 一致）。

3. 与附录 A 表对齐
   代码内常量（如 constants.py 及维度子模块中的默认）应与 README 默认超参数（附录 A 镜像） 表一致；若只改其一，须在 PR 中写明并视为未完成。

4. 合并前验证
   dcd pipe test pipe-demos/spts_pdf_labels 与 pytest tools/spts_eval/tests（见根目录 CONTRIBUTING.md / CI）全绿后再合入。