czsc 缠论量化信号 tas_macd_first_bs_V221216 深度解析:MACD 第一买卖点扩展版信号逻辑与 Rust 源码实现
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 侧同名信号等价复现,双端行为一致,便于跨语言回测与实盘对照。
使用建议与注意事项
- 窗口门槛:信号要求有效 K 线不少于 100 根,且
di不能超过当前bars_raw长度,否则直接返回其他_任意。在策略冷启动或使用较短历史数据回测时需预留足够热身数据。 v2语义陷阱:v2表示最后一次交叉类型,而非触发买卖点的那次交叉。例如一买_死叉命中b1_con1a,而一买_金叉则对应b1_con1b分支;若要按v2细分建仓条件,务必理解这一对应关系。- 参数组合隔离:
fastperiod/slowperiod/signalperiod组合构成独立的缓存键,修改参数不会污染其他组合的缓存,可放心在同一TaCache内并行评估多组 MACD 参数。 - 定位建议:该信号属于"辅助"性质(模板中的
辅助字样),在缠论策略中通常与笔、中枢等结构信号(cxt类别)配合使用,而非单独作为出入场依据。 - 版本差异:与同模块的
tas_macd_first_bs_V221201(基础版)相比,本版本多了 10/90 高低点对比这一形态约束,条件更严格,触发频率更低但形态确认更强,选择时需结合自身回测目标权衡。
延伸阅读
- 关联文档:.claude/skills/signal-functions/references/signals/tas_macd_first_bs_V221216.md
- 信号实现:crates/czsc-signals/src/tas.rs
- 交叉与信号构造工具:crates/czsc-signals/src/utils/sig.rs
- MACD 缓存实现:crates/czsc-signals/src/utils/ta.rs
- 信号注册表:crates/czsc-signals/src/registry.rs
- 参数视图:crates/czsc-signals/src/params.rs
- crate 说明:crates/czsc-signals/README.md