用途
当最新样本调试运行显示因子信号很强,但原始 pre-Bayes 标签与多周期证据明显不匹配时,使用本技能。典型模式:最新信号为看涨且 HTF 对齐强烈,但 build_frame_features 的原始标签仍输出 bear/hostile 并强制 observe_only。尤其适用于 ~/projects-ict-engine/ict-engine 中 structure_ict / expansion_manipulation 相关工作。
主要能力
- 证明问题出在上游标签而非因子弱点:先运行 factor-pipeline-debug,检查 latest_signal、raw_pre_bayes_labels、filtered_pre_bayes_labels、gating_status 和 raw_label_trace。若因子信号仍强但原始 regime/liquidity 错误,则将 build_frame_features 作为目标表面,而非盲目修改因子参数。
- 在 frame-feature 层添加窄的市场感知分支:扩展 FrameFeatures 增加 market: Option;保留 build_frame_features(candles) 作为基线通用构建器;新增 infer_market_from_symbol(symbol: &str) -> String 和 build_frame_features_for_market(candles: &[Candle], market: Option<&str>) -> Result。在市场感知包装器中先调用通用构建器,再仅覆盖需要市场特定处理的标签。
- 从务实启发式开始:例如对 NQ,若 sweep_count > fvg_count * 2 则设 regime_label = "range";若基础 liquidity_label == "hostile" 且 sweep_count > 0 且 fvg_count > 0 则设 liquidity_label = "neutral"。保留原始计数/证据以便调试报告仍能显示重标原因。
- 仅先接入需要市场感知标签的路径:重要的生产/调试表面是扩展因子管道构建器 build_expansion_factor_pipeline_report(...) 和 build_expansion_factor_pipeline_report_from_registry(...)。通过 infer_market_from_symbol(symbol) 传入符号派生的市场,而非 factor_name。避免基于 factor_name 的全局替换。
- 将市场家族语义贯穿到 canonical belief:扩展 RegimePosterior 增加 market_family 和 market_behavior_profile;扩展 RegimeGateDecision 增加 market_family;从 belief packet 派生 posterior;当家族已知时将 selected_subgraph 从 <regime>subgraph 改为 <market_family><regime>_subgraph。实际家族行为:metals 增加压力偏置;energy 增加过渡+压力偏置;futures_index 保留基线趋势路径。
- 将市场家族行为带入下游 belief/报告表面:贯穿到 StrategyRecommendation、ParticleBeliefSummary、BeliefReportPacket 和面向人类的 analyze 输出。可用字段:market_family、market_behavior_profile、selected_market_subgraph。策略仓位:energy 减少,metals 轻微减少,futures_index 保持基线。bootstrap_particle_summary(...) 也变为家族感知:energy 更大粒子预算/ESS,metals 中等提升,futures_index 基线。
- 在最终产品表面暴露市场家族结论:添加显式报告字段,如 BeliefReportPacket.market_family、BeliefReportPacket.market_behavior_profile、BeliefReportPacket.selected_market_subgraph、analyze JSON 顶层 market_family_summary、人类报告字符串包含 market_family=... market_profile=... subgraph=...。
- 将最新样本调试产品化为 SOP 输出。
使用方式
- 运行 factor-pipeline-debug 证明问题在上游标签。
- 在 frame-feature 层添加市场感知分支。
- 接入扩展因子管道构建器。
- 扩展 Symbol 表面(如添加 GC/CL 到 Symbol、parse_symbol(...) 和 trade-plan 符号解析),将符号分组为可复用市场家族:NQ/ES/YM -> futures_index,GC -> metals,CL -> energy。
- 将市场家族语义贯穿到 canonical belief、gate、策略、报告。
- 用测试和真实数据验证:添加至少一个针对 build_frame_features_for_market 的聚焦单元测试;运行 cargo fmt、cargo check、cargo test,以及 cargo run -- factor-pipeline-debug --symbol NQ --data ~/Downloads/Tomac/ict-cleaned-mtf/cleaned-15m/nq.continuous-15m.json --factor structure_ict --objective expansion_manipulation。
- 用 analyze-live 验证代码路径:ict-engine analyze-live --symbol GC --futures-symbol GC=F --spot-symbol GLD --options-symbol GLD --spot-kind etf ...;ict-engine analyze-live --symbol CL --futures-symbol CL=F --spot-symbol USO --options-symbol USO --spot-kind etf ...。
- 使 analyze-live 在映射稳定时从 --symbol 自动推断市场默认值:将 AnalyzeLive CLI 字段从必填 String 改为可选 Option<String>(futures_symbol、spot_symbol、options_symbol、spot_kind),在 analyze_live_command(...) 中从 symbol.to_ascii_uppercase() 派生默认值。验证的默认元组:NQ -> NQ=F / QQQ / QQQ / equity;ES -> ES=F / SPY / SPY / equity;YM -> YM=F / DIA / DIA / equity;GC -> GC=F / GLD / GLD / etf;CL -> CL=F / USO / USO / etf。之后命令简化为 ict-engine analyze-live --symbol GC。
适用场景
- ict-engine 中 structure_ict / expansion_manipulation 工作。
- 因子信号强但原始 pre-Bayes 标签错误的情况。
- 需要为特定市场(如 NQ、GC、CL)添加市场特定标签处理。
- 需要将市场家族语义贯穿到 belief、gate、策略和报告。
- 后停滞因子自动研究(post-stagnation factor-autoresearch)中需要真实 spec 表面而非空标签。
限制
- 本技能描述的是 ict-engine 仓库中的具体实现模式,依赖该仓库的代码结构。
- 市场特定启发式(如 NQ 的 sweep_count/fvg_count 规则)是务实起点,非通用规则。
- 数据路径验证与代码路径验证需分开:仓库本地 state/ 初始仅 NQ 存在,data/ 不存在;analyze 通过 --data-root 硬性要求 cleaned-1d、cleaned-1h 和 cleaned-15m,仅 15m 根会失败。
- 商品数据别名:黄金清理文件为 xau.continuous-*,产品符号支持为 GC;可构建临时 clean root 将 xau.continuous-{15m,1h,1d}.json 重命名为 gc.continuous-{15m,1h,1d}.json 进行管道验证,但需明确这验证的是代码路径和状态生成,非最终数据纯度。
- CL 本地历史根缺失时视为数据源阻塞而非代码阻塞,除非可接受实时分析。
- 集群特定参数覆盖(如 displacement_fvg_cluster、mss_bos_cluster、premium_discount_ote_cluster、smt_cluster)仅为 spec 表面改进,非交易价值证明。
- 验证集群轮换应从持久化尝试历史(state_<...>/NQ/factor_autoresearch_attempts.json)读取,而非仅最终摘要 JSON。
- 若实时刷新失败,需区分代码成功与源不稳定(如上游 Yahoo 超时/解析错误)。
- 对 Yahoo/OpenBB 支持的实时获取,可添加最小重试循环(如 3 次尝试加短睡眠),但先保持局部于请求点。
- 无优越突变结果应路由远离盲目全局调优:当 score_delta <= 0.0 且无 pre_bayes_gate_regressed 时,添加专用失败标签如 no_superior_mutation_found,并将状态映射为 factor_mutation_evaluation -> near_local_optimum、factor_mutation_focus -> pivot_to_label_refinement_or_market_specific_fork。
- 后停滞集群应各有真实参数映射,避免虚假集群多样性。
- 在巨大重复输出块中,仅当匹配精确且已验证时同时修补 analyze 和 analyze-live。
- 签名变更后预期附带编译修复,每批后重新运行 cargo check。