czsc 缠论量化信号 tas_macd_first_bs_V221216 深度解析:MACD 第一买卖点扩展版信号逻辑与 Rust 源码实现

原创2026-10-09 13:36:361,687 阅读
文章标签:量化交易金融科技数据分析技术分析

czsc 缠论量化信号 tas_macd_first_bs_V221216 深度解析:MACD 第一买卖点扩展版信号逻辑与 Rust 源码实现

导读

本文围绕 czsc 缠论量化工具中 tas_macd_first_bs_V221216 信号展开,它是 czsc-signals crate 中 tas(技术分析叠加)类别的 K 线级信号函数,用于在 MACD 指标上识别缠论意义上的"第一买点 / 第一卖点"辅助信号。读者读完本文后,将掌握该信号的参数模板与默认值、完整的判别条件树(含 or 分支组合)、v2 通道的交叉类型输出语义,以及它在 Rust 侧的缓存机制、交叉序列计算和宏注册调用方式,可直接将其投入自己的策略信号配置中。

信号概览与命名模板

tas_macd_first_bs_V221216 归属 kline 类别,是"MACD 第一买卖点(扩展版)"。它与更早的 tas_macd_first_bs_V221201(基础版)相比,引入了 10 根 vs 90 根的高低点对比窗口 以及更复杂的 or 条件组合,并将最后一次交叉类型通过 v2 通道输出。

信号参数模板定义于关联文档 .claude/skills/signal-functions/references/signals/tas_macd_first_bs_V221216.md,并在源码 crates/czsc-signals/src/tas.rs 中通过 #[signal(...)] 宏声明,其模板字符串为:

{freq}_D{di}MACD{fastperiod}#{slowperiod}#{signalperiod}_BS1辅助V221216

拆解模板各段含义:

片段 含义
{freq} K 线周期,如 60分钟、日线,取自 czsc.freq
D{di} 信号计算截止到倒数第 di 根 K 线
MACD{fastperiod}#{slowperiod}#{signalperiod} MACD 快线 / 慢线 / 信号线周期
_BS1辅助V221216 信号类别标签(第一买卖点辅助,版本号 2022-12-16)

信号最终产出的完整 7 段式字符串由 make_kline_signal_v2 拼装,结构为 {k1}_{k2}_{k3}_{v1}_{v2}_{v3}_{score},其中 k3 = "BS1辅助V221216"、v3 固定为 任意、score 固定为 0(见 crates/czsc-signals/src/utils/sig.rs 中 make_kline_signal_v2 的实现)。

参数说明与默认值

信号共四个可配置参数,均通过 ParamView 读取,未配置时落入默认值。关联文档给出核心参数,源码 crates/czsc-signals/src/tas.rs 使用 get_usize_param 逐一解析:

参数 含义 默认值 约束 / 说明
di 倒数第 di 根 K 线作为计算截止点 1 语义上 di >= 1,由 get_sub_elements 断言约束
fastperiod MACD 快线周期(EMA 短周期) 12 与经典 MACD(12, 26, 9) 一致
slowperiod MACD 慢线周期(EMA 长周期) 26 需大于 fastperiod 才能形成有效的快慢差
signalperiod DEA 信号线周期 9 对 DIF 做平滑的窗口

四个参数共同构成 MACD 缓存的唯一键:MACD{fastperiod}#{slowperiod}#{signalperiod}。不同参数组合会各自缓存一份 DIF / DEA / MACD 柱序列,互不干扰,因此同一时刻可以在一个 TaCache 中并存多组 MACD 参数的计算结果。

信号逻辑详解

1. 数据窗口:最近 10 根 vs 前 90 根

信号首先取截止到倒数第 di 根 K 线的最近 300 根 K 线(get_sub_elements(&czsc.bars_raw, di, 300)),并要求长度 不少于 100 根 才会进入判别逻辑(对齐 Python 的 len(bars) >= 100 边界条件)。

在这 300 根窗口内再切分两个对比区间:

  • n_bars:窗口内最近 10 根;
  • m_bars:窗口内从倒数第 100 根到倒数第 11 根,即"前 90 根"。

随后计算四个极值:

  • high_n:最近 10 根的最高价;
  • low_n:最近 10 根的最低价;
  • high_m:前 90 根的最高价;
  • low_m:前 90 根的最低价。

由此得到两个核心事实:low_n < low_m(最近 10 根创出前 90 根的新低)与 high_n > high_m(最近 10 根创出前 90 根的新高),它们分别是一买、一卖的前置形态门槛。

2. 交叉序列统计

信号在 300 根 DIF / DEA 子序列上调用 fast_slow_cross_ext(dif, dea)(扩展版交叉计算,见 crates/czsc-signals/src/utils/sig.rs)。该函数通过相邻两根的 delta = dif - dea 符号翻转识别金叉(kind = 1)与死叉(kind = -1),并记录每个交叉点的:

  • kind:交叉类型(1 金叉 / -1 死叉);
  • slow:交叉时刻的慢线(DEA)值,用于判断零轴位置;
  • distance:距上一个交叉的 K 线距离;
  • to_now:距今的 K 线距离;
  • area:相邻交叉之间的累计面积。

随后按 distance > 5(交叉间距大于 5 根)过滤出有意义的两组:

  • up:金叉列表;
  • dn:死叉列表。

3. 一买条件(四个子条件 AND)

一买要求同时满足 low_n < low_m 与下述三个条件组(b1_con1 内部是 or 组合):

条件 判定 语义
b1_con1a cross.len() > 3 且最后一次交叉为死叉(last.kind < 0)且其 slow < 0.0 零轴下方出现最后一次死叉
b1_con1b cross.len() > 3 且最后一次交叉为金叉,但死叉列表非空且最近一个死叉的 slow < 0.0 金叉收尾但下方仍有死叉铺垫(or 分支)
b1_con2 dn.len() > 3 且倒数第 2、第 3 个死叉的 slow < 0.0 近期连续两次死叉均发生在零轴下方
b1_con3 macd.len() > 10 且 macd[-1] > macd[-2] MACD 柱体最近一根较前一根回升(动能转强)

四者与新高判断 low_n < low_m 全部成立时,v1 = "一买"。这是典型的中枢下移、动能衰竭后的"第一类买点"技术形态:价格创新低 + 零轴下方死叉密集 + MACD 柱开始收缩回升。

4. 一卖条件(对称结构)

一卖与一买严格对称,前置形态改为 high_n > high_m:

条件 判定 语义
s1_con1a cross.len() > 3 且最后一次交叉为金叉(last.kind > 0)且其 slow > 0.0 零轴上方出现最后一次金叉
s1_con1b cross.len() > 3 且最后一次交叉为死叉,但金叉列表非空且最近一个金叉的 slow > 0.0 死叉收尾但上方仍有金叉铺垫(or 分支)
s1_con2 up.len() > 3 且倒数第 2、第 3 个金叉的 slow > 0.0 近期连续两次金叉均发生在零轴上方
s1_con3 macd.len() > 10 且 macd[-1] < macd[-2] MACD 柱体最近一根较前一根回落(动能转弱)

四者与新高判断 high_n > high_m 全部成立时,v1 = "一卖"。

5. v2 通道:最后一次交叉类型

无论是否触发买卖点,只要 300 根窗口长度达标且交叉序列非空,v2 都会被赋值为最后一次交叉的类型:last.kind > 0 时输出 金叉,否则输出 死叉;当交叉序列为空或窗口不足时,v2 保持默认值 任意。v2 由 make_kline_signal_v2 写入信号串第 5 段。

信号列表示例解读

关联文档给出两个典型输出,结合源码可还原出完整语义:

Signal('60分钟_D1MACD12#26#9_BS1辅助V221216_一买_死叉_任意_0')
Signal('60分钟_D1MACD12#26#9_BS1辅助V221216_一卖_金叉_任意_0')

逐段拆解第一个示例:

段 值 含义
k1 60分钟 周期
k2 D1MACD12#26#9 di=1、MACD(12, 26, 9)
k3 BS1辅助V221216 信号类别
v1 一买 触发第一买点
v2 死叉 最后一次交叉为死叉(即 b1_con1a 分支命中)
v3 任意 未使用维度
score 0 固定评分

第二个示例中 v2 = 金叉 对应 s1_con1b 分支:最后一次交叉虽是死叉但上方存在近期金叉铺垫,v2 输出的是最后一次交叉而非促成信号的那个交叉,这一点在使用时容易混淆,需特别注意。

源码级实现剖析

函数入口与宏注册

函数定义位于 crates/czsc-signals/src/tas.rs,签名统一为 (czsc: &CZSC, params: &ParamView, cache: &mut TaCache) -> Vec<Signal>:

#[signal(
    category = "kline",
    name = "tas_macd_first_bs_V221216",
    template = "{freq}_D{di}MACD{fastperiod}#{slowperiod}#{signalperiod}_BS1辅助V221216",
    opcode = "TasMacdFirstBsV221216",
    param_kind = "TasMacdFirstBsV221216"
)]
pub fn tas_macd_first_bs_v221216(
    czsc: &CZSC,
    params: &ParamView,
    cache: &mut TaCache,
) -> Vec<Signal>

#<a href="https://link.gitcode.com/i/6cf63de78158181ba64c8fbf84264e33" target="_blank">signal(...)] 属性宏(来自 czsc-signal-macros)在编译期将函数描述符收集进 inventory 注册表,运行期由 [crates/czsc-signals/src/registry.rs 中的 SIGNAL_REGISTRY 汇总为 name -> SignalMeta { func, param_template, fast_kline } 的映射,从而实现"按字符串配置直接解析并调用信号"。这就是 README(crates/czsc-signals/README.md)中描述的"运行期可按字符串配置解析、调用"机制。

MACD 缓存机制

函数第一件事是调用 update_macd_cache(crates/czsc-signals/src/utils/ta.rs)以 MACD12#26#9 这类字符串为键维护 DIF / DEA / MACD 柱三序列缓存。缓存采用增量更新策略:若缓存缺失、K 线数量过少(now_len < min_count + 15,其中 min_count = signalperiod + slowperiod + 168)或倒数第二根 K 线的 bar.id 不在缓存中,则触发全量重算;否则仅在旧序列上追加增量。这一设计保证同一参数组合在大量 K 线滚动计算时只做一次全量 MACD 计算,显著降低信号评估开销。

信号构造辅助

最终结果通过 make_kline_signal_v2(&k1, &k2, k3, v1, v2) 构造,其内部调用 make_signal7(k1, k2, k3, v1, v2, "任意", 0):即 v3 恒为 任意、score 恒为 0。未满足任何买卖点条件时,函数返回 v1 = "其他"、v2 = "任意" 的信号,保证输出始终是完整、可被下游策略消费的 7 段信号。

与 Python 版本的语义对齐

关联文档与源码注释均声明:分支条件、or 组合与 v2 输出语义对齐 Python 同名函数 tas_macd_first_bs_V221216。具体对齐点包括:

  • 300 根窗口与 len(bars) >= 100 的边界条件;
  • get_sub_elements 的 Python 切片语义(di == 1 取最后 n 根,di > 1 取 <a href="https://link.gitcode.com/i/f23131f548ef3464415b4aa91a298a68" target="_blank">-n-di+1 : -di+1],见 [crates/czsc-signals/src/utils/sig.rs);
  • 交叉间距 distance > 5 的过滤规则;
  • 一买 b1_con1a || b1_con1b 与一卖 s1_con1a || s1_con1b 的 or 分支组合;
  • 柱体方向判定 macd[-1] > macd[-2] / macd[-1] < macd[-2]。

这意味着在 Python 侧验证过的策略逻辑可以直接以 Rust 侧同名信号等价复现,双端行为一致,便于跨语言回测与实盘对照。

使用建议与注意事项

  1. 窗口门槛:信号要求有效 K 线不少于 100 根,且 di 不能超过当前 bars_raw 长度,否则直接返回 其他_任意。在策略冷启动或使用较短历史数据回测时需预留足够热身数据。
  2. v2 语义陷阱:v2 表示最后一次交叉类型,而非触发买卖点的那次交叉。例如 一买_死叉 命中 b1_con1a,而 一买_金叉 则对应 b1_con1b 分支;若要按 v2 细分建仓条件,务必理解这一对应关系。
  3. 参数组合隔离:fastperiod/slowperiod/signalperiod 组合构成独立的缓存键,修改参数不会污染其他组合的缓存,可放心在同一 TaCache 内并行评估多组 MACD 参数。
  4. 定位建议:该信号属于"辅助"性质(模板中的 辅助 字样),在缠论策略中通常与笔、中枢等结构信号(cxt 类别)配合使用,而非单独作为出入场依据。
  5. 版本差异:与同模块的 tas_macd_first_bs_V221201(基础版)相比,本版本多了 10/90 高低点对比这一形态约束,条件更严格,触发频率更低但形态确认更强,选择时需结合自身回测目标权衡。

延伸阅读

登录后查看全文
czsc