蜡烛图形态分析系统

概述

蜡烛图形态分析（全品种通用方法论 skill）

本 Skill 基于 Steve Nison 经典著作《日本蜡烛图技术》（丁圣元译本）的方法论，把"某段 K 线出现了什么蜡烛形态、意味着什么"这件事结构化、可复用化。品种无关：任何期货/证券的 OHLC 序列都能分析，形态检测算法不写死任何品种——输入的只是一串开高低收。

触发场景

• "看看黄金的日线蜡烛图 / 有什么形态"
• "螺纹钢周线现在是什么形态、偏多偏空"
• "帮我分析下生猪 1 小时的蜡烛信号"
• "启明星、吞没、十字星怎么解读"

最典型的调用就是一句话："分析下{品种}的{周期}蜡烛图" → 自动取数并给结论。

方法论（Nison 五大原则）

1. 趋势是前提：反转形态必须出现在既有趋势末端（顶部/底部），而非无趋势区。
2. 确认至上：多数蜡烛信号需下一根 K 线或成交量确认，孤立信号不可作交易依据。
3. 位置重于形状：同一形状在支撑/阻力位附近与在趋势中段含义不同。
4. 相互验证：与西方技术分析（趋势线、均线、量能）相互验证更可靠。
5. 风险管理：蜡烛图给出概率倾向，非保证，必须配套止损与仓位管理。

本 Skill 在输出中强制体现「趋势前提符合度」与「确认状态」两项，避免把孤立形态误读为确定信号。

覆盖形态（库在 references/pattern_table.json，可扩展）

• 单根（11）：十字线 / 蜻蜓十字 / 墓碑十字 / 长腿十字 / 锤子线 / 上吊线 / 倒锤子线 / 流星线 / 光头光脚阳(阴)线 / 纺锤线
• 双根（8）：看涨吞没 / 看跌吞没 / 刺透形态 / 乌云盖顶 / 看涨孕线 / 看跌孕线 / 平头顶 / 平头底
• 三根（10）：启明星 / 黄昏星 / 十字启明星 / 十字黄昏星 / 三白兵 / 三乌鸦 / 上升三法(内包) / 下降三法(内包) / 上升三法(外包) / 下降三法(外包)

每形态含字段：name/en/category/type/bias/reliability/context/confirmation/description，新增形态 = 在 JSON 里加节点，引擎零改动。

依赖

• 行情源 = slzq-ai-trading-assistant（默认、核心）：本 Skill 直接调 slzq 取 K 线——catalog/goods 按品种解析主力合约（mainContractCode），再调 market/kline 取该合约的日/周/分钟 K 线（chats 含 o/h/l/c）。用户只需说品种 + 周期，无需知道合约代码。需配置 SLZQ_OPENCLAW_DOMAIN/API_KEY/ENV（与其余 4 个 skill 同构）。
• 本地数据（离线兜底）：--data kline.json 支持 slzq kline 结构 {chats:[...]} 或通用 [{open,high,low,close}]，脚本绝不编数据。
• 引擎纯标准库，仅依赖 references/pattern_table.json + references/symbol_names.json（品种中文名字典）。

执行逻辑（全品种通用）

用户: 品种(名/代码) + 周期
   → ① 品种解析(symbol_names.json: 中文名/别名→品种代码)
   → ② 主力解析(slzq catalog/goods: 品种→主力合约 mainContractCode)
   → ③ 取K线  (slzq market/kline: 合约+周期→OHLC)
   → ④ 归一化 + 逐根特征(实体/影线/阴阳/十字)
   → ⑤ 趋势前置(窗口对比判定 uptrend/downtrend/flat)
   → ⑥ 单/双/三根形态检测(按 Nison 定义)
   → ⑦ 输出(形态+倾向+可靠度+趋势前提+确认+综合信号)

• 引擎只有"解析→取数→检测→输出"几段，不出现任何具体品种名。
• 品种名称 100% 在 symbol_names.json（新增品种=加一行）；形态 100% 在 pattern_table.json；主力合约与行情全部动态取自 slzq，不硬编码。
• 综合信号 = Σ(偏向 × 可靠度权重 × 趋势前提系数)，仅反映蜡烛倾向，非交易指令。

用法（极简：只说品种 + 时间）

# 最简用法——只需品种与周期，自动解析主力合约并出结论
python3 candle.py --symbol 黄金 --period 日线
python3 candle.py --symbol 螺纹钢 --period 周线
python3 candle.py --symbol 生猪 --period 1小时

# 也支持品种代码
python3 candle.py --symbol au            # 默认日线
python3 candle.py --contract IF2509      # 直接指定合约

# 离线：本地 JSON，只看最近 60 根
python3 candle.py --data kline.json --last 60

--period 取值：日线(默认) / 周线 / 1小时 / 30分 / 15分 / 5分 / 1分（也接受数字 type）。

交付物

• 引擎：scripts/candle.py（纯标准库）。
• 形态库：references/pattern_table.json（Nison 原则 + 29 种形态元数据）。
• 品种字典：references/symbol_names.json（中文名/别名→品种代码，仅名称解析用）。

边界

• 形态检测为几何近似判定，容差内的近似（如平头）按阈值处理；极端行情/一字板可能产生噪声，需人工复核。
• 反转形态必须结合趋势前提与下一根确认，本 Skill 已标注，但仍不构成投资建议。
• 不判断基本面、不预测点位；仅对已有 K 线做形态归类与概率倾向提示。
• 非投资建议，输出须附免责。