day-trader-skill入场计时器trader-entry:如何逐K线锁定开盘区间突破的精准入场时刻
day-trader-skill入场计时器trader-entry:如何逐K线锁定开盘区间突破的精准入场时刻
day-trader-skill 是一套面向日内交易的 Claude skills 工具箱,其中的 trader-entry(Entry Timer,入场计时器) 专门解决一个问题:把"看着像要突破"的模糊感觉,变成唯一且精确的入场时刻。它逐根监控免费的 Yahoo 1 分钟/5 分钟 K 线,以开盘前 15 分钟的开盘区间(Opening Range)为基准,在 K 线收盘确认突破的那一刻,报出精确的时间和价格——而且它只报信号,从不替你下单。
⏱️ 什么是 trader-entry 入场计时器
入场计时器的核心逻辑可以概括为一句话:把 setup(形态)变成一个 moment(时刻)。
它逐根读取 K 线,并耐心等待每一根 K 线走完。价格在一根 K 线中途刺穿上轨,不算入场;一根完整收盘在区间上方的 K 线,才算。确认后它报出时间和价格、为退出计划(Exit Planner)写好档案,然后停下。完整规则说明见 trader-entry/SKILL.md,判定逻辑实现在 trader-entry/entry.py。
📐 锁定突破时刻的三条铁律
开盘区间:默认只看前 15 分钟
- 开盘区间(ORB)由开盘后前 15 分钟决定:5 分钟线就是 9:30、9:35、9:40 三根 K 线,1 分钟线则是 15 根;
- 需要突破的价位就是区间高点(range high),可用
--or-minutes参数调整区间长度(如 30 分钟); - 也可以改用
--setup level --level 价格,把基准换成你指定的价位,例如从 trader-scanner 得来的 20 日高点。
只有"已收盘"的 K 线才算数
这是整个工具最关键的设计,也写在 entry.py 的头部注释 里:
- 一根 K 线必须时钟已过其起点 + 5(或 1)分钟,且 Yahoo 数据已追上该时刻(最多等 1 分钟),才算"已收盘";
- Yahoo 的实时报价(如 10:49:45)永远不构成一根 K 线,会被直接丢弃;
- 收盘价恰好等于基准价,不算突破,必须严格高于它。
第一根收盘突破的 K 线 = 当天唯一触发
同一 setup 每天只触发一次:以"第一根收盘高于基准价"的 K 线为准,后面再高的收盘价不会重置信号。触发时刻报的是该 K 线的收盘时间(10:10 开始的 K 线,报 10:15 AM),价格是它的收盘价,精确到美分。
🚀 快速上手:四条命令覆盖所有场景
python3 entry.py check TSLA # 现在状态:waiting / triggered / expired
python3 entry.py check TSLA --write # 同时把结果存进 trader/entry.json
python3 entry.py check TSLA --setup level --level 371.20 # 突破指定价位
python3 entry.py watch TSLA --until 15:30 # 逐K线盯盘,每根已收盘K线打印一行,触发即停
python3 entry.py watchlist # 检查 trader/watchlist.json 里的全部标的
两个新手特别实用的参数:
| 参数 | 作用 |
|---|---|
--now "2026-10-19 10:15" |
假装现在是纽约时间某时刻,回放任意一天的判定 |
--offline FILE |
用保存的 Yahoo chart JSON 离线复算,不联网也能练习 |
--min-volume-x 1.5 |
附加成交量确认:触发 K 线量需达区间均量的 1.5 倍 |
--interval 1m |
改用 1 分钟线(更精确,但 Yahoo 只保留约一周) |
watch 配合 --now 或 --offline 时会运行在模拟时钟上,无需等待就能逐 K 线回放一整天。
📈 真实案例:TSLA 2026-10-19 的开盘区间突破
项目用真实数据录制了一个完整"剧场版"(reel),测试夹具就保存在 tests/fixtures/trader-entry/TSLA-2026-10-19-5m.json:
- 开盘区间:9:30–9:45 三根 5 分钟 K 线,高点 $362.18,低点 $354.47;
- 10:12,状态 WAITING:最近收盘 $361.68(10:05 K 线),距区间高点还差 $0.50;此时 10:10 的 K 线正在形成中(已到 $364.18),未收盘就不算;
- 10:15,状态 TRIGGERED:10:10 这根 K 线(bar 8)收在 $364.18,高出区间高点 +0.55%——这就是入场时刻;
- 若加上
--min-volume-x 1,10:10 K 线量能只有区间均量的 0.60 倍,被剔除,触发点后移到 10:35 AM 的 $365.75(量能 7.98 倍)。
对应的测试用例见 tests/test_entry.py,每一行输出都可以离线复现。
🔗 信号如何衔接后续交易
入场计时器只负责"报时刻",整套流水线是:
scanner(找 setup) → news(查消息) → entry(定时刻) → exit(定止损/目标)
触发后它会把契约形状的结果写入 trader/entry.json,包含 symbol、setup、触发时间、K 线序号、价格、基准价和开盘区间,供 /trader-exit 读取——止损和目标必须在买入之前设好(exit.py plan --from trader/entry.json)。
入场时间窗由 trader/config.json 控制:
no_entries_before(默认 09:45):区间还没定型前不许入场;no_entries_after(默认 15:30):错过即 expired,当天该 setup 作废;- 半天市(如下周四 1 点提前收市)时,截止时间会自动随收盘提前到 12:30。
⚠️ 新手最易踩的四个坑
- 把"刺穿"当突破:K 线中途冲高不算,收盘才算。工具宁可报 WAITING 也不抢跑,因为"看着像要收在上方"就提前进场,是新手最常见的亏损来源;
- 迟到的触发:如果触发已经发生了一根 K 线之前,它会明确提醒你——价格是 5 分钟前那根收盘的,"迟到入场是另一笔交易",止损距离和赔率都已变化;
- 休市日:周末和 NYSE 假日(内置 2026/2027 假期表)直接返回 no-data 并告诉你下次开盘时间;
- 数据会延迟:Yahoo 免费接口非官方、可能滞后,工具会主动提示"Yahoo 最后一笔成交在 10:49:45,早于该 K 线收盘"。分钟级决策时,务必以自己券商的行情核对。
🛡️ 它永远不做的事
入场计时器有清晰的边界,这也是它值得信任的原因:
- 永不下单、永不算仓位——下单只有 trader-broker 能做,且需要你逐单确认;
- 只做多(longs only),v2 版本不支持做空入场;
- 触发后不移动基准价,不事后改规则;
- 默认模拟盘(
"paper": true),是否实盘由你自己的配置决定; - 信号只是信息,不是承诺——日内交易对大多数人亏钱,干净信号改变不了这一点。
所有判定规则都有离线测试覆盖(tests/test_entry.py),你可以放心用 --offline 夹具反复练习,直到开盘区间突破的每一秒都在你的理解之中。