Japanese Candlestick

日本蜡烛图技术 — 形态识别与买卖意见

把史蒂夫·尼森《日本蜡烛图技术》蒸馏成一个可执行 skill：给出 A 股代码或 K 线 → 取前复权日线 / 识别命中的蜡烛形态 → 复现原书对应的买卖操作意见。共 50 个形态（42 固定窗口蜡烛 + 8 长周期图形），全部穿过双层验证才入库。

> 真相源（路径均相对本 skill 根目录） > - patterns// — 每个形态一目录：construction.md（构造+原文引用）/ signal.md（买卖意见+原文引用）/ rule.py（OHLC 判别式 detect(bars, trend)）/ tests/（合成正反例+真实抽样）/ verify-report.md（验证报告）。 > - references/.md — 五个分章详解，列出每族全部形态的几何判别要点 + 买卖意见表，是本文的展开。 > - patterns/candle.py（单根几何）/ patterns/formations.py（峰谷检测）/ patterns/thresholds.py（阈值集中）/ patterns/patterns.index.json（50 形态索引+验证状态）。 > - scripts/fetch_qfq.py — Baostock 前复权日线与证券简称入口；用户说"最近"且未给日期时，默认取最近 20 个交易日。 > - scripts/render_chart.py / scripts/html_to_png.py — 可选可视化链路：生成终端风格 K 线形态 HTML，框选命中窗口并在下方用信号矩阵压缩投资意见，必要时转 PNG。

---

核心原则（全族通则，先于任何识别）

1. 反转形态 ≠ 立即反向。尼森反复强调：反转形态只意味着"之前趋势可能改变"，未必立刻转成相反方向；当成「趋势变化形态」才稳妥。
2. 两个硬前提：① 趋势前提——形态须出现在对应的上升/下降趋势末端（顶部形态要有上涨在前，底部形态要有下跌在前）；② 后续确认——多数形态需等后续 K 线或其他技术信号验证，而非见形即操作。
3. 蜡烛图只给反转/持续信号，不给价格目标。涨跌幅度须另用支撑/阻挡等工具评估。
4. 单一形态不构成交易依据。同向信号叠加才增强；反向叠加须谨慎。
5. 持续形态顺势：窗口/三法/分手线等出现后原趋势恢复，方向跟随先行趋势。
6. 窗口/跳空类必须用前复权数据：未复权价格在除权日会产生虚假跳空，导致窗口误判。

---

输入模式

1. 用户给 A 股代码/名称, 未给 OHLC：先用 scripts/fetch_qfq.py 拉 Baostock 前复权日线 (adjustflag=2)；若用户只说"最近"，默认最近 20 个交易日。示例：python3 scripts/fetch_qfq.py 600519.SH。
2. 用户给明确区间：按用户区间拉前复权日线；若区间不足以判断长周期图形（通常需 ≥40 根），只报告固定窗口形态并说明窗口不足。
3. 用户直接给 OHLC / 截图 / 文字描述：跳过取数，直接进入形态识别；截图无法稳定读数时，要求用户补股票代码或 OHLC。

工作流程

给定一段 OHLC（建议 ≥ 数根；长周期图形需 ≥ 40 根）：

1. 判先行趋势：用形态前的若干根判断 trend ∈ {"up","down"}（可参考 patterns/candle.py 的 trend_before()）。
2. 定位形态族：按用户问法 / K 线外形锁定五大族之一，打开对应 references/.md。
3. 核验构造：逐条比对该族详解里的「几何判别要点」；需要精确判别时，直接调用 patterns//rule.py 的 detect(bars, trend)（它 import ../candle/../formations 与 ../thresholds，阈值已集中管理）。
4. 取买卖意见：命中后，从该族详解的买卖意见表（源自 patterns//signal.md）取「方向/信号类型/确认条件/止损失效位/建议操作」。
5. 按统一格式输出（见下），附免责声明。
6. 跑真实数据（默认可主动执行）：A 股前复权日线与证券简称见 scripts/fetch_qfq.py（Baostock 底座, 默认最近 20 个交易日）+ CASE.md（端到端命中演示）。

可视化输出

• 默认行为：先给文字分析，包括识别结论、买卖操作意见、确认条件、止损失效位与免责声明。
• 若用户明确要求"出图/生成图/HTML/PNG/K线图/可视化"，再运行 scripts/render_chart.py --png 生成 HTML + PNG。
• 若用户未明确要求出图，文字分析结尾必须补一句："我也可以继续生成一张带形态标注的 K 线 HTML/PNG 图，要不要？"
• HTML/PNG 必须对齐 上证形态.html 的信息结构：K 线区域用矩形框选每个命中形态的完整窗口；下方用信号矩阵呈现 patterns//signal.md 的类型、强度、确认状态、止损失效位与动作倾向，避免铺长文；本期研判用方向分布条 + 研判/样本/命中/近期指标块 + 近 10 日形态带表达。
• HTML/PNG 标题层级：大标题优先展示股票中文名称，股票代码只作为小字辅助信息；无法查询名称时才退回代码。
• HTML/PNG 的可见 UI 一律使用中文；英文只允许作为股票代码、数据源专名、文件格式或命令参数等不可避免的技术标识。
• PNG 没有 hover 能力，所有关键信息必须直接可见；HTML 的 title/hover 只能作为补充，不得承载唯一解释。
• HTML/PNG 只作为辅助证据，不替代文字分析；图中形态命中仍来自 patterns//rule.py，不得手工画信号。

---

形态总目录（50 形态 → 详解 + 真相源）

① 反转形态（第四 + 六章，22 个）→ 详解 [references/reversal.md](references/reversal.md)

| 形态 | slug | 方向 | 趋势前提 | |------|------|:---:|------| | 锤子线 Hammer | hammer | 多 | 下降末端 | | 上吊线 Hanging Man | hanging-man | 空 | 上升末端 | | 看涨吞没 Bullish Engulfing | engulfing-bullish | 多 | 下降 | | 看跌吞没 Bearish Engulfing | engulfing-bearish | 空 | 上升 | | 乌云盖顶 Dark Cloud Cover | dark-cloud-cover | 空 | 上升 | | 刺透形态 Piercing | piercing | 多 | 下降 | | 平头顶 Tweezers Top | tweezers-top | 空 | 上升 | | 平头底 Tweezers Bottom | tweezers-bottom | 多 | 下降 | | 看涨捉腰带 Bullish Belt-hold | belt-hold-bullish | 多 | 低价区 | | 看跌捉腰带 Bearish Belt-hold | belt-hold-bearish | 空 | 高价区 | | 三只乌鸦 Three Black Crows | three-black-crows | 空 | 上升（强信号） | | 反击线 Counterattack | counterattack | 双向 | 由趋势定 | | 看涨孕线 Bullish Harami | harami-bullish | 多 | 下降 | | 看跌孕线 Bearish Harami | harami-bearish | 空 | 上升 | | 十字孕线 Harami Cross | harami-cross | 双向 | 由趋势定（比常规孕线强） | | 红三兵 Three White Soldiers | three-white-soldiers | 多 | 低价盘整后 | | 前方受阻 Advance Block | advance-block | 看跌预警 | 上升晚期（红三兵衰退变体） | | 停顿形态 Stalling Pattern | stalling-pattern | 看跌预警 | 上升晚期（红三兵衰退变体） | | 向上跳空两只乌鸦 Upside-Gap Two Crows | upside-gap-two-crows | 空 | 上升（罕见） | | 待入线 On-Neck | on-neck | 失败底反转 | 下降（刺透家族最弱） | | 切入线 In-Neck | in-neck | 弱看涨 | 下降（刺透家族弱化） | | 插入线 Thrusting | thrusting | 弱看涨 | 下降（未过中点） |

② 星线族（第五章，9 个）→ 详解 [references/star.md](references/star.md)

| 形态 | slug | 方向 | 趋势前提 | |------|------|:---:|------| | 启明星 Morning Star | morning-star | 多 | 下降（主要反转） | | 黄昏星 Evening Star | evening-star | 空 | 上升（主要反转） | | 十字星 Doji Star | doji-star | 中性偏反转 | 由趋势定 | | 流星 Shooting Star | shooting-star | 空 | 上升（次级） | | 倒锤子 Inverted Hammer | inverted-hammer | 多 | 下降（须确认） | | 弃婴顶 Abandoned Baby Top | abandoned-baby-top | 空 | 上升（极强极罕见） | | 弃婴底 Abandoned Baby Bottom | abandoned-baby-bottom | 多 | 下降（极强极罕见） | | 十字启明星 Doji Morning Star | doji-morning-star | 多 | 下降（强于常规启明星） | | 十字黄昏星 Doji Evening Star | doji-evening-star | 空 | 上升（主要反转） |

③ 持续形态（第七章，6 个）→ 详解 [references/continuation.md](references/continuation.md)

| 形态 | slug | 方向 | 备注 | |------|------|:---:|------| | 上升窗口 Rising Window | rising-window | 多（顺势） | 影线间真空；窗口=支撑 | | 下降窗口 Falling Window | falling-window | 空（顺势） | 影线间真空；窗口=阻挡 | | 上升三法 Rising Three Methods | rising-three-methods | 多（顺势） | 长白→小实体群→长白 | | 下降三法 Falling Three Methods | falling-three-methods | 空（顺势） | 长黑→小实体群→长黑 | | 分手线 Separating Lines | separating-lines | 顺势 | 相同开市价（罕见） | | 跳空并列阳线 Gapping Side-by-side White | gapping-side-by-side-white | 顺窗口方向 | 窗口定方向（罕见） |

> ⚠️ 本族对复权高度敏感：识别窗口/跳空必须用前复权（或后复权）数据。

④ 十字线族（第八章，5 个）→ 详解 [references/doji.md](references/doji.md)

| 形态 | slug | 方向 | 趋势前提 | |------|------|:---:|------| | 标准十字线 Doji | doji | 中性（顶部偏空） | 可反转趋势末端 | | 长腿十字 Long-legged Doji | long-legged-doji | 中性偏反转 | 双影皆长，失方向感 | | 墓碑十字 Gravestone Doji | gravestone-doji | 空 | 上升/顶部 | | 蜻蜓十字 Dragonfly Doji | dragonfly-doji | 多 | 下降/底部 | | 三星 Tri-star | tri-star | 双向（顶空底多） | 极强但极罕见 |

> 十字线揭示顶部反转强于底部；单根极少直接触发交易，须后续确认。

⑤ 长周期图形（第六章，8 个，峰谷检测）→ 详解 [references/formation.md](references/formation.md)

| 图形 | slug | 方向 | 确认方式 | |------|------|:---:|------| | 三山顶 Three Mountains Top | three-mountains | 空 | 末峰看跌蜡烛确认 | | 三尊顶（头肩顶）Three Buddha Top | three-buddha-top | 空 | 颈线下破 | | 三川底 Three Rivers Bottom | three-rivers-bottom | 多 | 上破颈线/上沿 | | 头肩底（原书名：倒三尊底）Head-and-Shoulders Bottom | inverse-three-buddha | 多 | 上破颈线 | | 圆形顶（饺子顶）Rounding Top | rounding-top | 空 | 向下跳空（A股日线极罕见） | | 平底锅底（圆形底）Pan Bottom | pan-bottom | 多 | 向上跳空（A股日线极罕见） | | 顶部 V 形反转 Spike Top | tower-top | 空 | 右塔大黑实体（不依赖跳空） | | 底部 V 形反转 Spike Bottom | tower-bottom | 多 | 右塔长白实体（不依赖跳空） |

> 长周期图形需 ≥ 40 根 K 线，识别为启发式（峰谷+圆弧曲率），信号偏晚，更适合中长线。

---

输出格式

命中形态时，按以下结构输出：

【识别结论】
命中形态：（）  ［slug: ］
趋势前提：
构造要件核验：
信号强度：

【买卖操作意见】（来源：《日本蜡烛图技术》原书 → patterns//signal.md）
方向：
信号类型：
确认条件：
止损失效位：
建议操作：

【免责声明】
仅为《日本蜡烛图技术》教学含义复现，非投资建议，不保证盈利，据此交易风险自负。

• 同时命中多个形态：逐一输出，并说明叠加效应（同向增强 / 反向需谨慎）。
• 未命中：说明最接近哪个形态、未满足哪条核心判据（实体过大/单向影线/无趋势前提/缺跳空确认/窗口不足等）。
• 未明确要求出图时：在免责声明后追加一句可视化能力提示，询问是否生成 HTML/PNG 图。

---

已知边界

• high-wave（高浪线）：抽取语料无「高浪」原文，列为 wontfix，未纳入 50 形态。
• rounding-top / pan-bottom：原书要求的跳空确认在 A 股前复权日线极罕见，真实命中近 0（如实标注于各自 verify-report.md，非规则缺陷）。
• 长周期图形识别具主观性（原书本身定性描述），置信度按启发式给出。

---

免责声明

本 skill 输出的买卖操作意见仅为《日本蜡烛图技术》（史蒂夫·尼森 著 / 丁圣元 译 / 湖南文艺出版社 2020 / ISBN 9787540493738）教学含义的复现，非投资建议，不保证盈利，据此交易风险自负。 单一形态不构成交易依据，原书反复强调需趋势确认 + 后续 K 线确认。

---

[INPUT]: 依赖 scripts/fetch_qfq.py 的 Baostock 前复权日线与证券简称、scripts/render_chart.py/html_to_png.py 的可选出图链路、references/.md 的分族详解、patterns// 的 construction.md/signal.md/rule.py 验证产物、patterns/{candle,formations,thresholds}.py 几何原语、patterns/patterns.index.json 索引 [OUTPUT]: 对外提供本 skill 的唯一入口与总路由：主动取数/识别结论 + 买卖操作意见 + 免责声明 + 可选 HTML/PNG 可视化 [POS]: skill 根目录的总路由层，是 Baostock 数据入口、可视化工具、references/ 五章详解与 patterns/ 真相源的统一编排入口 [PROTOCOL]: 变更时更新此头部，然后检查 AGENTS.md

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: hssqz
• Source: hssqz/japanese-candlestick-skill
• License: MIT

Install and usage instructions live in the source repository linked above.