czsc 缠论量化框架信号解析:pos_stop_V240331 最近 N 根K线追踪止损
czsc 缠论量化框架信号解析:pos_stop_V240331 最近 N 根K线追踪止损
pos_stop_V240331 是 czsc 缠论量化框架中 trader 类别(仓位级)的止损信号,用于在持仓过程中基于"最近 N 根K线极值窗口"动态判断是否触发多头/空头止损。本文以该信号的参数模板、信号逻辑与源码实现为主线,结合 czsc-signals 仓内的注册机制与事件驱动仓位机制,完整讲解其配置方式、底层判定原理、策略落地用法与同族信号差异,帮助读者直接将其接入自己的持仓管理与回测体系。
一、信号概述:trader 类持仓风控信号
在 czsc 的信号体系中,信号按作用对象分为 kline(K线级,描述单根K线/单时间点市场状态)与 trader(仓位级,需要结合仓位开仓记录才能计算)两大类。pos_stop_V240331 属于后者,定义在 crates/czsc-signals/src/pos.rs 模块中,函数名为 pos_stop_v240331,opcode 为 PosStopV240331。
它与普通 K 线信号最大的区别在于:判定结果不仅依赖当前K线数据,还依赖"最后一次开仓操作"的位置与价格。只有存在有效开仓记录(LO 开多或 SO 开空)时,信号才会在 多头止损 / 空头止损 之间输出;无持仓或最近一笔操作是平仓时,输出中性值 其他。因此它天然适合作为 Position 平仓事件(Event)的触发条件,实现"跌破/突破 N 根K线极值即离场"的追踪止损。
二、参数模板与信号字符串拆解
czsc 的每个信号函数都有唯一的参数模板,pos_stop_V240331 的模板为:
"{pos_name}_{freq1}#{n}_止损V240331
按此模板实例化后,生成的完整信号字符串为标准的 7 段格式 k1_k2_k3_v1_v2_v3_score,原文档给出的两个典型实例为:
Signal('SMA5多头_15分钟#10_止损V240331_多头止损_任意_任意_0')
Signal('SMA5空头_15分钟#10_止损V240331_空头止损_任意_任意_0')
各字段含义如下:
| 字段 | 取值来源 | 示例 | 说明 |
|---|---|---|---|
k1 |
pos_name |
SMA5多头 |
仓位名称,用于定位仓位及其最近开仓记录 |
k2 |
freq1#n |
15分钟#10 |
K线周期与追踪窗口,中间以 # 分隔 |
k3 |
固定 | 止损V240331 |
信号函数名标识 |
v1 |
判定结果 | 多头止损 / 空头止损 / 其他 |
核心输出值 |
v2 / v3 |
固定 | 任意 / 任意 |
本信号不细分 |
score |
固定 | 0 |
信号评分,本信号恒为 0 |
从源码看,pos_stop_v240331 中三个 key 段通过 format!("{}#{}", freq1, n) 拼接(pos.rs),信号最终由 make_signal_v1 构造为 k1_k2_k3_v1_任意_任意_0(sig.rs)。Signal::from_str 会严格校验 7 段结构与 score ∈ <a href="https://link.gitcode.com/i/bb400469d0b13ebd5c6fda587d53a61f" target="_blank">0,100],非法字符串会被拒绝([signal.rs)。
三、信号逻辑:多头与空头的镜像规则
原文档对信号逻辑的定义非常简洁,可归纳为两条镜像规则:
- 多头:最新K线低点跌破前
n根K线的最低价,且最新K线的bar_id晚于开仓bar,触发多头止损; - 空头:最新K线高点突破前
n根K线的最高价,且最新K线的bar_id晚于开仓bar,触发空头止损; - 其余任何场景(无有效开仓、数据不足、未破位等)输出
其他。
这里有两个容易忽略但至关重要的约束:
- 窗口取的是"前 n 根"而非"包含最新K线":实际计算时取最近
n+1根K线,用最后一根(最新)与前面n根的极值比较,因此窗口期内的回撤/反弹以最新K线是否穿越为触发点,属于典型的"滚动窗口追踪止损"——止损参考位会随K线推进不断更新,而不是固定在开仓价或某个静态价位。 bar_id晚于开仓 bar 的校验:这是防误触发保护。当最新K线恰好是开仓那根或更早时,即使价格形态满足穿越条件也不会触发止损,确保信号只对"开仓之后的持仓过程"生效,与仓位状态机的时序语义一致。
四、参数说明
| 参数 | 含义 | 默认值 | 使用建议 |
|---|---|---|---|
pos_name |
仓位名称,决定从哪个 Position 取最近开仓记录 |
空字符串 | 应与开仓信号中的仓位名严格一致,例如 SMA5多头 |
freq1 |
K线周期,决定从哪个周期的 CZSC 解析器取K线 |
空字符串 | 常见取值如 15分钟、60分钟、日线;必须与策略涉及周期配置匹配 |
n |
追踪窗口:参与极值比较的前K线根数 | 10 |
窗口越小对价格波动越敏感、止损越紧;窗口越大越宽松。建议结合 freq1 的波动特征调优,典型取值范围 5~20 |
源码通过 get_str_param / get_usize_param 读取上述参数(pos.rs,辅助函数见 sig.rs 与 sig.rs)。需要说明:与 pos_bar_stop_V230524(其 n 显式 clamp(1, 20))不同,本信号源码未对 n 做范围钳制,但代码要求 K 线数量至少达到 n + 1 根才进入判定,否则直接输出 其他,因此过大的 n 会因数据不足而长期无输出,配置时应保证标的在 freq1 周期下有足够的历史K线。
五、源码级实现解析
pos_stop_v240331 的完整实现位于 crates/czsc-signals/src/pos.rs#L905-L970,其执行流程可拆解为以下步骤:
let op = match last_open_operate(cat, pos_name) { // ① 定位最近开仓记录
Some(op) => op,
None => return make_signal_v1(&k1, &k2, k3, v1), // 无开仓 → "其他"
};
let c = match cat.get_czsc(freq1) { // ② 取指定周期 CZSC
Some(c) => c,
None => return make_signal_v1(&k1, &k2, k3, v1),
};
let bars = get_sub_elements(&c.bars_raw, 1, n + 1); // ③ 取最近 n+1 根K线
if bars.len() < n + 1 {
return make_signal_v1(&k1, &k2, k3, v1); // 数据不足 → "其他"
}
let last_bar = bars.last().unwrap(); // ④ 最新K线
if op.op == Operate::LO {
let ll = bars[..bars.len() - 1].iter().fold(f64::INFINITY, |acc, x| acc.min(x.low));
if last_bar.low < ll && last_bar.id > op.bar_id { // ⑤ 破位 + 时序校验
v1 = "多头止损";
}
}
if op.op == Operate::SO {
let hh = bars[..bars.len() - 1].iter().fold(f64::NEG_INFINITY, |acc, x| acc.max(x.high));
if last_bar.high > hh && last_bar.id > op.bar_id {
v1 = "空头止损";
}
}
make_signal_v1(&k1, &k2, k3, v1)
关键依赖与底层原理:
last_open_operate(sig.rs):通过cat.get_position(pos_name)拿到Position,取其operates列表的最后一笔操作;若该操作是平仓(SE/LE)则返回None,否则返回开仓记录。开仓记录中携带的op.dt(时间)、op.price(开仓价)、op.bar_id(开仓K线 id)正是本信号时序校验与后续止损判定的基准。get_sub_elements(sig.rs):di=1, n=n+1时返回序列最后n+1个元素(数量不足时返回可用区间,与 Python 切片语义对齐),这一工具函数在本仓库的多个信号中被复用。TraderStatetrait(state.rs):定义了get_position、get_czsc、latest_price三个方法,是czsc-signals访问仓位与K线数据的统一抽象,解除了czsc-signals与czsc-trader之间的循环依赖;CzscTrader在运行时实现该 trait 并提供数据。bar_id的语义:RawBar.id随K线推进单调递增,因此last_bar.id > op.bar_id等价于"最新K线严格晚于开仓K线",这也是 position.rs 中持仓时长(holding_bar)计算的同一套时序口径。
六、在事件驱动策略中的落地用法
czsc 的策略表达层次为 Signal → Event → Position:Event 用 signals_all(全部满足)、signals_any(任一满足)、signals_not(全部不满足)组合信号;Position 由开仓事件(opens)与平仓事件(exits)驱动,并附带 interval(开仓间隔)、timeout(最大持仓K线数)、stop_loss(BP 止损)、t0 等风控参数(参考 docs/examples/06_event_position.py)。
将 pos_stop_V240331 作为平仓事件的典型配置如下(以多头为例,开仓事件触发后即进入持仓,之后一旦最新K线跌破前 10 根最低价即平多):
from czsc import Event, Position
open_event = Event.load({
"name": "开多_信号触发",
"operate": "开多",
"signals_all": ["15分钟_趋势确认V230101_向上_任意_任意_0"],
"signals_any": [],
"signals_not": [],
})
exit_event = Event.load({
"name": "平多_追踪止损",
"operate": "平多",
"signals_all": ["SMA5多头_15分钟#10_止损V240331_多头止损_任意_任意_0"],
"signals_any": [],
"signals_not": [],
})
position = Position(
symbol="000001",
name="SMA5多头",
opens=[open_event],
exits=[exit_event],
interval=3600 * 4, # 两次开仓最小间隔(秒)
timeout=16 * 30, # 最长持仓K线数
stop_loss=300, # 兜底止损(BP,300 = 3%)
t0=False,
)
配置要点:
exit_event中的signals_all字符串必须与本文第二节的 7 段格式完全一致,pos_name(SMA5多头)必须与Position.name一致,freq1(15分钟)必须在该策略涉及的K线周期列表内;pos_stop_V240331是"辅助离场"信号,可与Position自带的timeout(超时离场)与stop_loss(BP 固定止损)叠加使用,形成"事件平仓优先、止损其次、超时兜底"的多层出场体系(该优先级在 position.rs 的出场判断中体现);- 建仓后若最新K线尚未穿越窗口极值,信号持续输出
其他,事件不触发,持仓继续。
七、与 pos_stop 系列止损信号对比
pos 命名空间下存在多个演进版本的止损信号(均注册于 registry.rs 的 TRADER_SIGNAL_REGISTRY),理解差异有助于按需选型:
| 信号 | 止损参考 | 触发方式 | 参数模板 |
|---|---|---|---|
pos_fx_stop_V230414 |
开仓前最近 n 个分型极值 |
最新价跌破/突破分型极值 | {freq1}_{pos_name}N{n}_止损V230414 |
pos_bar_stop_V230524 |
开仓前最近 n 根K线极值 |
最新价跌破/突破开仓前窗口极值 | {pos_name}_{freq1}N{n}K_止损V230524 |
pos_stop_V240331(本文) |
开仓后滚动窗口:前 n 根K线极值 |
最新K线高低点穿越窗口极值 + bar_id 晚于开仓 | {pos_name}_{freq1}#{n}_止损V240331 |
pos_stop_V240428 |
开仓前离散价位第 t 档 |
收盘价穿越离散价位档 | {pos_name}_{freq1}T{t}N{n}_止损V240428 |
pos_stop_V240608 |
开仓前 w 根极值外第 n 档 |
开仓后极值穿越档位 | {pos_name}_{freq1}W{w}N{n}_止损V240608 |
pos_stop_V240614 |
开仓价 | 开仓后跌破/突破开仓价的K线数量达 n |
{pos_name}_{freq1}N{n}_止损V240614 |
pos_stop_V240717 |
开仓时 ATR 阈值 | 穿越 开仓价 ± ATR×0.67 的K线数量达 n |
{pos_name}_{freq1}N{n}T{timeperiod}_止损V240717 |
其中 pos_stop_V240331 与 pos_bar_stop_V230524 最易混淆:前者以开仓后的滚动窗口极值为参考(最新K线穿越"前 n 根"极值,参考位持续更新,属于真正的追踪止损);后者以开仓前固定窗口极值为参考(一旦跌破该静态价位即止损)。选型时可按需求取舍:希望止损位随行情上移(保护浮盈)用 V240331,希望锚定开仓前的关键支撑/压力位用 V230524。
八、验证与调试
该信号已纳入仓库的注册表自动化测试:test_pos_signal_registry_contains_all_python_pos_functions 明确断言 pos_stop_V240331 存在于 TRADER_SIGNAL_REGISTRY 中(registry.rs),构建或运行 cargo test 时该测试会校验信号函数经 #[signal] 宏注入的元信息(name / template / opcode / param_kind)与注册表一致。
调试建议:
- 先用信号列表示例做字符串级验证:
Signal('SMA5多头_15分钟#10_止损V240331_多头止损_任意_任意_0')必须能被Signal::from_str正确解析(7 段、score=0),解析失败说明模板拼接有误; - 检查数据量:
freq1周期下 K 线总数不足n+1根时信号恒为其他,先用get_signals_freqs反推策略涉及周期(参考 06_event_position.py 中的反推用法); - 核对开仓记录:
last_open_operate依赖Position.operates的最后一笔操作,若为平仓则信号不输出止损值,可用仓位快照/热启动快照机制核对operates时序; - 配合回测:将信号接入
Position平仓事件后,通过交易对(pairs)输出中的事件序列字段确认平仓是由本信号事件触发而非timeout/stop_loss兜底(position.rs)。
综上,pos_stop_V240331 是一个轻量、可参数化、与仓位状态机强耦合的追踪止损信号:理解其"前 n 根极值窗口 + bar_id 时序校验"的双重判定逻辑,即可在 czsc 的事件驱动策略中精准复用,实现随行情滚动更新的动态离场控制。