czsc入门8：Signal信号

二狗哈2026-01-15 15:53

czsc\czsc\py\objects.py 中的 Signal 类是一个使用 @dataclass 装饰的数据类，用于在 CZSC（缠中说禅）量化分析系统中标准化定义和匹配交易信号。

1. 核心结构

一个标准的信号由 7 个部分组成，格式为字符串： k1_k2_k3_v1_v2_v3_score 。

2. 关键特性：通配符 "任意"

代码中大量使用了 "任意" 这个默认值（ L458-L465 ）。在信号匹配时，如果某个位置的值是 "任意" ，则表示忽略该位置的精确匹配，相当于通配符 * 。

3. 核心方法：is_match

这是该类最重要的逻辑（ L504-L531 ），用于判断当前市场状态是否满足该信号的条件。

匹配逻辑如下：

键值查找：根据 k1_k2_k3 组成的 key，从传入的信号字典 s 中查找实际发生的信号值。
得分门槛：实际信号的得分必须大于等于当前定义的 score 。
模糊匹配：依次比较 v1, v2, v3 。如果定义的值是 "任意" ，或者是完全相同的字符串，则视为匹配。

4. 代码示例

复制代码

from czsc.objects import Signal

# 场景：定义一个策略信号，要求 "60分钟级别 MACD 发生金叉"，对 v2/v3 不做要求
# 这里的 score=50 表示要求实际信号得分至少为 50
target_signal = Signal(k1="60分钟", k2="MACD", k3="金叉", v1="向上", v2="任意", v3="
任意", score=50)

# 场景：当前市场实际产生的信号池（通常由分析系统生成）
current_market_signals = {
    # 键 (k1_k2_k3) : 值 (v1_v2_v3_score)
    "60分钟_MACD_金叉": "向上_0轴上_有些强_80" 
}

# 判断是否匹配
is_triggered = target_signal.is_match(current_market_signals)
print(f"信号是否触发: {is_triggered}") 
# 输出: True
# 原因: 
# 1. key "60分钟_MACD_金叉" 存在
# 2. 实际得分 80 >= 目标得分 50
# 3. v1 "向上" == "向上"
# 4. v2 "任意" 匹配 "0轴上"
# 5. v3 "任意" 匹配 "有些强"

总结

Signal 类是连接策略定义与市场分析结果的桥梁。它允许策略开发者通过配置化的方式（支持模糊匹配和权重过滤）来灵活地表达交易逻辑，而无需硬编码复杂的 if-else 判断。