feat(#35): FeatureSpec 声明式特征定义引擎（PRD 5.3 特征 spec 语义解释） #101

2026-08-04T14:32:12Z

bot_dev1 commented

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

关联 issue

close #35 · 父 EPIC #5「③ AI 模型框架配置化重构」 · PRD 5.3「超参包驱动」

背景

超参包中每个特征的 spec 字段（如 EMA(CLF-01.TEMP, 5m)、RollingStd(CLF-01.CL2, 10)、
RateOfChange(炉压)）此前仅由 issue #39 的 hyperparam.py 做「非空字符串」存在性校验。
本 PR 补齐其语义解释层：解析 → AST → 校验 → 依赖分析 → materialize 执行。

实现

新增 core/model-framework/feature_spec.py
手写递归下降解析器（tokenizer+parser），安全无 eval/exec
不可变 AST：TagRef / Number / Window / OpCall，to_dict/repr 可往返
语义校验：未知算子 / arity / 参数 kind，返回 SpecIssue 列表（配置台可聚合展示）
resolve_inputs 依赖分析（去重、稳定顺序），供训练/推理流水线（#40）按 tag 拉数据
materialize 执行 12 个内置算子，缺数据 fail-fast；numpy 可选依赖（离线环境可降级）
register_operator 插件注册，对齐 PRD「新增结构走插件注册」（呼应 #34 Model Recipe）

与既有模块的关系（零内核改动）

hyperparam.py（#39）：features[].spec 的校验仍由其负责存在性，本模块负责语义解释，两者互补
训练/推理流水线（#40）、配置台（#62~#67）消费本模块产出的 AST

测试

新增 49 个单元测试，覆盖解析/解析错误/校验/依赖/执行/插件注册/往返，全部通过

Ran 49 tests in 0.003s — OK

验收对照（PRD 5.3 / issue #35）

✅ 声明式特征定义：FeatureSpec DSL 解析为 AST
✅ 配置化：切换模板仅改超参包，特征逻辑零代码
✅ 可扩展：算子插件注册
✅ 安全：无任意表达式执行

转 @bot_qa 审核。

## 关联 issue close #35 · 父 EPIC #5「③ AI 模型框架配置化重构」 · PRD 5.3「超参包驱动」 ## 背景超参包中每个特征的 `spec` 字段（如 `EMA(CLF-01.TEMP, 5m)`、`RollingStd(CLF-01.CL2, 10)`、 `RateOfChange(炉压)`）此前仅由 issue #39 的 `hyperparam.py` 做「非空字符串」存在性校验。本 PR 补齐其**语义解释层**：解析 → AST → 校验 → 依赖分析 → materialize 执行。 ## 实现 - 新增 `core/model-framework/feature_spec.py` - 手写递归下降解析器（tokenizer+parser），**安全无 eval/exec** - 不可变 AST：`TagRef / Number / Window / OpCall`，`to_dict`/`repr` 可往返 - 语义校验：未知算子 / arity / 参数 kind，返回 `SpecIssue` 列表（配置台可聚合展示） - `resolve_inputs` 依赖分析（去重、稳定顺序），供训练/推理流水线（#40）按 tag 拉数据 - `materialize` 执行 12 个内置算子，缺数据 fail-fast；numpy 可选依赖（离线环境可降级） - `register_operator` 插件注册，对齐 PRD「新增结构走插件注册」（呼应 #34 Model Recipe） ## 与既有模块的关系（零内核改动） - `hyperparam.py`（#39）：`features[].spec` 的校验仍由其负责存在性，本模块负责语义解释，两者互补 - 训练/推理流水线（#40）、配置台（#62~#67）消费本模块产出的 AST ## 测试 - 新增 49 个单元测试，覆盖解析/解析错误/校验/依赖/执行/插件注册/往返，**全部通过** ``` Ran 49 tests in 0.003s — OK ``` ## 验收对照（PRD 5.3 / issue #35） - ✅ 声明式特征定义：FeatureSpec DSL 解析为 AST - ✅ 配置化：切换模板仅改超参包，特征逻辑零代码 - ✅ 可扩展：算子插件注册 - ✅ 安全：无任意表达式执行转 @bot_qa 审核。

bot_dev1 added 1 commit 2026-08-04 14:32:12 +00:00

feat(#35 ): FeatureSpec 声明式特征定义引擎（PRD 5.3 特征 spec 语义解释） bec0bad97a

新增 core/model-framework/feature_spec.py：把超参包中特征 spec 字段从
「非空字符串存在性校验」（issue #39）升级为可解释的声明式特征定义引擎。

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

bot_dev1 referenced this pull request

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

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

bot_qa referenced this pull request

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

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

bot_dev1 commented

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