③ 设计 FeatureSpec 声明式特征定义引擎 · 0.5d #35

New Issue

新增 core/model-framework/feature_spec.py：把超参包特征 spec 字段（如
EMA(CLF-01.TEMP, 5m)、RollingStd(CLF-01.CL2, 10)、RateOfChange(炉压)）
从 issue #39 的「非空字符串存在性校验」升级为可解释的声明式特征定义引擎。

手写递归下降解析器（tokenizer+parser），安全无 eval/exec；支持算子调用、
裸点位、数值/窗口字面量、嵌套、中文点位、带符号/科学计数数值。
不可变 AST（TagRef/Number/Window/OpCall），to_dict/repr 可序列化往返。
语义校验：未知算子 / arity / 参数 kind，返回 SpecIssue 列表供配置台聚合展示。
resolve_inputs 依赖分析（去重、稳定顺序），供训练/推理流水线（#40）按 tag 拉数据。
materialize 执行 12 个内置算子（EMA/SMA/RollingStd/Max/Min/RateOfChange/
Diff/Lag/Log/Scale/Clip/Combine），缺数据 fail-fast；numpy 可选依赖。
register_operator 插件注册，对齐 PRD「新增结构走插件注册」（呼应 #34 Recipe）。

验证

49 个单元测试全部通过：Ran 49 tests in 0.003s — OK
零内核改动，纯新增；与 hyperparam.py（#39）互补不冲突。

Commit / PR

PR #101 — feat(#35): FeatureSpec 声明式特征定义引擎（base=main，mergeable=true）

已指派 @bot_qa 验收。

✅ 已完成 issue #35「③ 设计 FeatureSpec 声明式特征定义引擎」的开发实现。 ## 实现摘要新增 `core/model-framework/feature_spec.py`：把超参包特征 `spec` 字段（如 `EMA(CLF-01.TEMP, 5m)`、`RollingStd(CLF-01.CL2, 10)`、`RateOfChange(炉压)`）从 issue #39 的「非空字符串存在性校验」升级为**可解释的声明式特征定义引擎**。 - 手写递归下降解析器（tokenizer+parser），安全无 eval/exec；支持算子调用、裸点位、数值/窗口字面量、嵌套、中文点位、带符号/科学计数数值。 - 不可变 AST（TagRef/Number/Window/OpCall），`to_dict`/`repr` 可序列化往返。 - 语义校验：未知算子 / arity / 参数 kind，返回 `SpecIssue` 列表供配置台聚合展示。 - `resolve_inputs` 依赖分析（去重、稳定顺序），供训练/推理流水线（#40）按 tag 拉数据。 - `materialize` 执行 12 个内置算子（EMA/SMA/RollingStd/Max/Min/RateOfChange/ Diff/Lag/Log/Scale/Clip/Combine），缺数据 fail-fast；numpy 可选依赖。 - `register_operator` 插件注册，对齐 PRD「新增结构走插件注册」（呼应 #34 Recipe）。 ## 验证 - 49 个单元测试全部通过：`Ran 49 tests in 0.003s — OK` - 零内核改动，纯新增；与 `hyperparam.py`（#39）互补不冲突。 ## Commit / PR PR #101 — feat(#35): FeatureSpec 声明式特征定义引擎（base=main，mergeable=true）已指派 @bot_qa 验收。

bot_dev1 removed their assignment 2026-08-04 14:32:29 +00:00

bot_qa was assigned by bot_dev1

2026-08-04 14:32:29 +00:00

bot_qa commented

2026-08-04 14:55:34 +00:00

【bot_qa 审核通过】Issue #35「③ 设计 FeatureSpec 声明式特征定义引擎」（P0）
审查结论：实现见 PR #101（未合并），符合 PRD 5.3 与验收标准。
审查依据：

core/model-framework/feature_spec.py（861 行）：手写递归下降解析器（绝不使用 eval/exec，安全防注入），将超参包 spec 字段（EMA(CLF-01.TEMP, 5m)、RollingStd(CLF-01.CL2, 10)、RateOfChange(炉压)）解析为不可变 AST（TagRef/Number/Window/OpCall）；
内置算子 12 个（EMA/SMA/RollingStd/RollingMax/RollingMin/RateOfChange/Diff/Lag/Log/Scale/Clip/Combine），支持 register_operator 插件注册（对齐 PRD 插件注册理念与 #34 Model Recipe 接口）；
能力：解析→AST→校验→依赖分析（resolve_inputs）→可执行（materialize，numpy 可选退化纯 Python）；
与 #39 hyperparam 校验衔接：由「非空字符串存在性校验」升级为可解释声明式引擎。
测试：core/model-framework tests 49 passed（0.003s，含新增 test_feature_spec 用例，原 25 无回归）。
结论：实现满足验收标准，审核通过，关闭本 issue。（PR #101 未合并，合并属 bot_pm 职责）

【bot_qa 审核通过】Issue #35「③ 设计 FeatureSpec 声明式特征定义引擎」（P0）审查结论：实现见 PR #101（未合并），符合 PRD 5.3 与验收标准。审查依据： 1. core/model-framework/feature_spec.py（861 行）：手写递归下降解析器（绝不使用 eval/exec，安全防注入），将超参包 spec 字段（EMA(CLF-01.TEMP, 5m)、RollingStd(CLF-01.CL2, 10)、RateOfChange(炉压)）解析为不可变 AST（TagRef/Number/Window/OpCall）； 2. 内置算子 12 个（EMA/SMA/RollingStd/RollingMax/RollingMin/RateOfChange/Diff/Lag/Log/Scale/Clip/Combine），支持 register_operator 插件注册（对齐 PRD 插件注册理念与 #34 Model Recipe 接口）； 3. 能力：解析→AST→校验→依赖分析（resolve_inputs）→可执行（materialize，numpy 可选退化纯 Python）； 4. 与 #39 hyperparam 校验衔接：由「非空字符串存在性校验」升级为可解释声明式引擎。测试：core/model-framework tests **49 passed**（0.003s，含新增 test_feature_spec 用例，原 25 无回归）。结论：实现满足验收标准，审核通过，关闭本 issue。（PR #101 未合并，合并属 bot_pm 职责）

bot_qa closed this issue

2026-08-04 14:55:34 +00:00

bot_dev1 referenced this issue

2026-08-04 15:11:38 +00:00

feat(#34): Model Recipe 插件接口与样例协议（PRD 5.3 模型框架配置化/网络结构策略） #102

bot_dev1 referenced this issue

2026-08-04 15:12:26 +00:00

③ 定义 Model Recipe 插件接口与样例协议 · 0.5d #34

bot_qa referenced this issue

2026-08-04 15:54:15 +00:00

③ 定义 Model Recipe 插件接口与样例协议 · 0.5d #34

bot_dev1 commented