trader-entry

trader-entry

Entry Timer 将一个形态转化为一个时刻：确认它的那根 K 线。它会读取 1 分钟或 5 分钟 K 线，并等待每根 K 线收盘。K 线中途价格刺破高点不算入场信号，收盘价高于该点才算。随后它会报出时间和价格，将这些信息记录下来供 Exit Planner 使用，然后停止。它绝不会买入任何东西。日内交易会让大多数人亏钱，而信号干净也不会改变这一点。

下方的 ${CLAUDE_SKILL_DIR} 是此技能所在的文件夹（即 SKILL.md 所在位置）。

python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA                  # 15-minute opening range, 5-minute bars
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA --write          # also save trader/entry.json
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA --setup level --level 371.20
python3 "${CLAUDE_SKILL_DIR}/entry.py" check TSLA --interval 1m --min-volume-x 1.5
python3 "${CLAUDE_SKILL_DIR}/entry.py" watch TSLA --until 15:30    # one line per closed bar, stops on the trigger
python3 "${CLAUDE_SKILL_DIR}/entry.py" watchlist                   # every hit in trader/watchlist.json

其他标志：--or-minutes N（默认值为 15）、--json、--offline FILE（已保存的 Yahoo 图表 JSON，.json 或 .json.gz 文件，或包含 <TICKER>.json 的文件夹）、--now "2026-10-19 10:15"（纽约时间），用于重放某个交易日。 使用 --now 或 --offline 运行 watch 时会使用模拟时钟，逐根 K 线重放当天行情，不会等待。

读取和写入的内容

文件	内容
trader/watchlist.json	扫描器的命中项（hits[].symbol），供 watchlist 使用
trader/config.json	no_entries_before（09:45）和 no_entries_after（15:30），纽约时间。可选
Yahoo chart API	当天的 K 线，range=1d&interval=5m（或 1m）：免费、非官方，可能有延迟
trader/entry.json	使用 check --write 时或 watch 触发时写入：标的、形态、状态、时间、K 线、价格、水平位、开盘区间

规则

• 开盘区间（orb）。 前 15 分钟的最高价和最低价：9:30、9:35 和 9:40 的 5 分钟 K 线，或 15 根 1 分钟 K 线。需要突破的水平位是区间高点。
• 水平位。 由你提供的价格，例如来自 /trader-scanner 的 20 日高点。
• 触发条件是开盘区间之后第一根收盘价高于水平位的已完成 K 线。上影线高于水平位不算触发。收盘价恰好等于水平位也不算突破。
• 时间是该 K 线的收盘时间（10:10 的 K 线于上午 10:15 收盘）。价格是其收盘价，精确到美分。
• 只计算已收盘的 K 线。 当时钟超过 K 线开始时间加 5 分钟（或 1 分钟），且 Yahoo 已更新到该时刻时，该 K 线才算收盘（最多等待 1 分钟）。像 10:49:45 这样的 Yahoo 实时报价永远不算一根 K 线。
• 成交量，可按需启用。 --min-volume-x 1.5 还要求触发 K 线的成交量达到区间内 K 线平均成交量的 1.5 倍。9:30 的 K 线包含开盘集合竞价，因此 1.0 已经是严格要求。
• 时间限制。 9:45 之前或 15:30 之后不允许入场（可配置）。若下午 1:00 提前收盘，截止时间也会随收盘时间提前至 12:30。
• 状态说明。 等待中（并显示最近收盘价与水平位的距离）、已触发、已过期或无数据。9:30 之前：尚未开盘。9:45 之前：开盘区间仍在形成中。周末和 NYSE 假日：市场休市。

步骤

1. 向用户获取标的代码，或在运行 /trader-scanner 后运行 entry.py watchlist。先通过 /trader-news 查询该标的。
2. 运行 entry.py check SYMBOL。用一行话告知用户状态：等待中以及距离水平位多远、触发的时间和价格，或已过期。
3. 若要等待触发，Claude 可以在后台运行 entry.py watch SYMBOL --until 15:30，或每 5 分钟通过 /loop 运行 entry.py check SYMBOL --write。watch 会在每根 K 线收盘后不久唤醒，每根 K 线打印一行；触发时退出码为 0（并写入 trader/entry.json），形态过期时退出码为 1。监控期间请保持电脑唤醒：笔记本进入睡眠会暂停监控，唤醒后会补上行情，但会有延迟。
4. 触发时，告知用户时间和价格，并说明没有下单。如果触发已经过去一根以上的 K 线，也要说明这一点：延迟入场是另一笔交易。
5. 转交给 /trader-exit，在买入任何东西之前设定止损位和目标位。

示例：行情回放

TSLA，2026-10-19，星期一，5 分钟 K 线。开盘区间为 354.47 至 362.18。10:12 时，10:10 的 K 线仍未收盘，因此它会等待：

WAITING  last close $361.68 (10:05 bar), $0.50 under the range high $362.18 (-0.14%).
The 10:10 bar is still forming ($364.18 so far, closes 10:15 AM); it does not count until it closes.

10:15 时，K 线已收盘：

TSLA  Mon 2026-10-19 10:15 ET  opening-range breakout (15-minute range) on 5-minute bars (Yahoo, free, can lag)
Opening range 9:30-9:45: high $362.18, low $354.47 (3 of 3 bars).
TRIGGERED 10:15 AM at $364.18: the 10:10 bar (bar 8) closed above the range high $362.18 (+0.55%).
This is the moment to get in, if you take the trade. Nothing was placed.
Next: set the stop and target BEFORE you buy: /trader-exit (exit.py plan --from trader/entry.json).

使用 --min-volume-x 1 时，10:10 的 K 线成交量过低（为该区间成交量的 0.60 倍）， 触发点移至上午 10:35 的 365.75（对应 10:30 的 K 线，成交量为 7.98 倍）。

规则

• 逐根 K 线判断，使用 Yahoo 免费提供的 1 分钟或 5 分钟 K 线。它们未经官方认证， 也可能有延迟。分钟时间很重要时，请说明这一点。
• 信号是信息，不是订单，也不是承诺。这里的任何内容都不保证交易获利或赚钱。
• 仅做多。v2 只规划做多交易。如果用户想做空，请明确告知。
• 每个设置每天只有一个触发点：首次收盘价高于该水平时。之后的收盘不会重置触发点。
• 绝不要因为某根 K 线看起来将以更高价收盘，就提前称其为入场信号。

它绝不会做的事

它绝不会下单、确定仓位大小、设置止损（那是 /trader-exit 的工作）、事后移动价位， 也绝不会统计尚未收盘的 K 线。它绝不会在后台监控时运行 /trader-broker：因为当时没有人 可以说“是”。

安全

• 仅用于教育和工具辅助，不构成财务建议。PASS 表示通过规则检查，不是投资建议。
• 默认使用模拟交易（"paper": true）。是否实盘由用户自行决定，并在自己的配置中设置。
• 此套件中，除 trader-broker 外，没有任何工具会下单；且只有同时满足以下三个条件时才会下单：trader-risk 当天已通过该笔确切订单的检查；用户在聊天中明确输入“是”以确认该笔订单；用户在 Claude 自己的卡片上点击一次 Allow，因为订单工具已设为“需要批准”（Customize > Connectors > tool permissions）。绝不要将订单工具设为“始终允许”。
• 除非配置允许且用户确认，否则不交易期权、不使用保证金、不做空，也不使用杠杆。
• 券商密钥应存储在环境变量或 Claude Desktop 配置中，绝不要放在聊天中。