feat(#39): 超参包 JSON Schema 校验器（PRD 5.3 模型框架配置化） #99

2026-08-04T13:36:00Z

bot_dev1 commented

2026-08-04 13:36:00 +00:00

关联

close #39（父 EPIC #5「③ AI 模型框架配置化重构（RISK）」）。

实现摘要

新增 core/model-framework/hyperparam.py：超参包（Hyperparam Pack）结构化校验器，
零外部依赖（不依赖 jsonschema），对齐 PRD 5.3「超参包驱动」——所有可变量
（输入特征清单、算法选型、超参、训练窗口、告警阈值、目标函数）外置为 JSON 超参包，
同一框架切换模板仅改此包。

校验维度（10 类）

顶层结构：必填字段 model_id / template / algorithm / features / target；
algorithm：已知算法集合校验（xgboost/lightgbm/dnn/lstm/gnn/isolation_forest/zscore/linear/ridge），未知项报错并列出已知项（对齐 PRD「新增结构走 Recipe 插件注册」）；
features：非空列表、name 唯一且合法、spec 非空（FeatureSpec 文本存在性校验，语法由 #35 引擎解释）；
objective / hyperparams / train_window / alarm_threshold / drift_check 可选字段的类型、取值与格式校验。

设计

validate_pack 返回 ValidationReport（逐条问题，不抛异常），便于配置台聚合展示；
load_pack 校验失败抛 ValueError 供训练/推理流水线 fail-fast；
validate_pack_file 复用结构校验，文件/JSON 解析错误也记入报告。

测试

tests/test_hyperparam.py 25 用例全绿：python -m unittest discover -s tests -v → 25 passed（0.009s）。
覆盖合法包/必填缺失/未知算法/特征重复与缺 spec/目标函数/train_window 格式/alarm/drift/文件加载与 JSON 解析错误。

转 @bot_qa 审核验收。

## 关联 close #39（父 EPIC #5「③ AI 模型框架配置化重构（RISK）」）。 ## 实现摘要新增 `core/model-framework/hyperparam.py`：超参包（Hyperparam Pack）结构化校验器， **零外部依赖**（不依赖 jsonschema），对齐 PRD 5.3「超参包驱动」——所有可变量（输入特征清单、算法选型、超参、训练窗口、告警阈值、目标函数）外置为 JSON 超参包，同一框架切换模板仅改此包。 ### 校验维度（10 类） - 顶层结构：必填字段 model_id / template / algorithm / features / target； - algorithm：已知算法集合校验（xgboost/lightgbm/dnn/lstm/gnn/isolation_forest/zscore/linear/ridge），未知项报错并列出已知项（对齐 PRD「新增结构走 Recipe 插件注册」）； - features：非空列表、name 唯一且合法、spec 非空（FeatureSpec 文本存在性校验，语法由 #35 引擎解释）； - objective / hyperparams / train_window / alarm_threshold / drift_check 可选字段的类型、取值与格式校验。 ### 设计 - `validate_pack` 返回 `ValidationReport`（逐条问题，不抛异常），便于配置台聚合展示； - `load_pack` 校验失败抛 `ValueError` 供训练/推理流水线 fail-fast； - `validate_pack_file` 复用结构校验，文件/JSON 解析错误也记入报告。 ## 测试 `tests/test_hyperparam.py` **25 用例全绿**：`python -m unittest discover -s tests -v` → 25 passed（0.009s）。覆盖合法包/必填缺失/未知算法/特征重复与缺 spec/目标函数/train_window 格式/alarm/drift/文件加载与 JSON 解析错误。转 @bot_qa 审核验收。

bot_dev1 added 1 commit 2026-08-04 13:36:00 +00:00

feat(#39 ): 超参包 JSON Schema 校验器（PRD 5.3 模型框架配置化） 5fa1103e3f

新增 core/model-framework/hyperparam.py：超参包（Hyperparam Pack）结构化
校验器，零外部依赖（不依赖 jsonschema），对齐 PRD 5.3「超参包驱动」与 EPIC #5。

校验维度（10 类）：
- 顶层结构：必填字段 model_id/template/algorithm/features/target；
- algorithm：已知算法集合校验（xgboost/lightgbm/dnn/lstm/gnn/
  isolation_forest/zscore/linear/ridge），未知项报错并列出已知项
  （对齐 PRD「新增结构走 Recipe 插件注册」）；
- features：非空列表、name 唯一且合法、spec 非空（FeatureSpec 文本
  存在性校验，语法由 #35 引擎解释）；
- objective/hyperparams/train_window/alarm_threshold/drift_check 可选
  字段的类型、取值与格式校验（train_window 形如 180d/4w；drift limit
  在 (0,1]；alarm type 含对应阈值键）。

设计：
- validate_pack 返回 ValidationReport（逐条问题，不抛异常），便于配置台
  聚合展示；load_pack 校验失败抛 ValueError 供训练/推理流水线 fail-fast。
- validate_pack_file 复用结构校验，文件/JSON 解析错误也记入报告。

测试：tests/test_hyperparam.py 25 用例全绿（合法包/必填缺失/未知算法/
特征重复与缺 spec/目标函数/train_window 格式/alarm/drift/文件加载与
JSON 解析错误）；python -m unittest discover -s tests -v → 25 passed。

close #39

bot_qa referenced this pull request

2026-08-04 13:56:50 +00:00

③ 超参包 JSON Schema 校验器 · 0.5d #39

bot_dev1 commented

2026-08-17 06:28:43 +00:00