npm package: @gabriel3615/ta_analysis
Description: stock ta analysis
Author: gabriel3615
Latest version: 3.0.1

# TA Analysis 库

本仓库提供一组价格行为与技术分析的模块化工具（TypeScript），支持多时间周期的筹码、形态、支阻、结构、供需、区间/突破、趋势线/通道以及波动率/量能分析，并提供综合整合器与统一格式化输出。

## 安装与构建

- 安装依赖：`npm i`
- 构建：`npm run build`

## 运行示例（Runner）

使用 `scripts/*.mjs`，从 `dist/index.js` 导入导出方法执行：


======== TSLA - 筹码分析 ========

===== TSLA 多时间周期分析（筹码） =====
股票代码: TSLA
当前价格: 329.65

----- 信号强度与一致性 -----
多头信号: █████████░░░░░░░░░░░ (46/100)
空头信号: █░░░░░░░░░░░░░░░░░░░ (5/100)
信号差值: 41
时间周期一致性: 看多 (100%)

----- 各时间周期信号强度 -----
时间周期   | 多头信号 | 空头信号 | 信号差值 | 综合建议
----------|----------|----------|----------|--------
周线     | 45      | 0       | 45      | 偏多
日线     | 40      | 10      | 30      | 偏多
小时线   | 60      | 0       | 60      | 偏多

----- 交易建议 -----

----- 主要建议 -----
综合建议：做多
多个时间周期一致看多，强烈建议买入。 趋势分析显示市场处于上升趋势，一致性强。 短期(1小时)偏多，中期(日线)偏多，长期(周线)偏多。

----- 入场策略 -----
可积极入场，建议在支撑位附近分批买入。

----- 出场策略 -----
可设置在主要阻力位附近，或当短期时间周期出现卖出信号时离场。

----- 风险管理 -----
止损位: 317.08, 253.44
止盈位: 330.93, 350.42

----- 时间周期展望 -----
短期(小时线): 偏多
中期(日线)　: 偏多
长期(周线)　: 偏多

----- 关键价位 -----
支撑位: 241.69, 253.44, 317.08
阻力位: 330.93, 350.42

======== TSLA - 蜡烛形态分析 ========
生成交易计划...
分析 TSLA...

===== TSLA 蜡烛多时间周期分析 =====
股票代码: TSLA
当前价格: 329.65

----- 信号 -----
是否有信号: 否
方向: neutral
信号强度: 0.00

----- 计划 -----
入场价: 无
止损价: 无
目标价: 无

----- 风险/收益 -----
潜在收益: 0
潜在亏损: 0
收益百分比: 0%
亏损百分比: 0%
风险回报比: 0

----- 理由 -----
没有明确的交易信号。周线和日线没有同时出现看涨或看跌信号。建议观望，等待明确的多时间周期确认信号出现。

===== 日线形态 =====

日线看涨
  日期                      形态                      强度        价格
  2025-08-06T13:30:00.000Z看涨吞没                    90        319.91
  2025-08-07T13:30:00.000Z看涨锤子线                   60        322.27

日线看跌
  (none)

===== 周线形态 =====

周线看涨
  (none)

周线看跌
  日期                      形态                      强度        价格
  2025-07-21T04:00:00.000Z看跌吞没                    70        316.06

======== TSLA - 支撑/阻力(BBSR) 分析 ========

===== TSLA 支撑/阻力 + 近期多空信号 (BBSR) =====

----- 周线 -----
无信号

----- 日线 -----
无信号

======== TSLA - 趋势逆转(小时→日线) 分析 ========

===== TSLA 形态分析综合结果 =====
综合形态分析显示看涨信号，信号强度: 100.00/100。 短期形态分析显示看跌，建议关注短线机会。

小时线主导形态: buying_climax
    
 关键时间: Aug 01, 14:30 @ (301.10) | Aug 08, 09:30 @ (333.93), (看跌)，可靠性: 100.00/100。

日线主导形态: double_bottom
    
 关键时间: Jul 07, 09:30 @ (288.77) | Jul 21, 09:30 @ (338.00) | Jul 24, 09:30 @ (300.41), (看涨)，可靠性: 100.00/100。
信号强度: 100.00/100

----- 各时间周期信号分布 -----
时间周期   | 看涨  | 看空  | 中性  | 总计  | 综合信号
----------|-------|-------|-------|-------|--------
周线     | 0     | 0     | 0     | 0     | 中性
日线     | 1     | 0     | 0     | 1     | 看涨
小时线   | 0     | 1     | 0     | 1     | 看空

===== 主导形态分析 =====

----- 周线主导形态 -----
未检测到显著形态

----- 日线主导形态 -----
形态类型: 双底
方向: 看涨  |  状态: 已完成但未突破
可靠性评分: 100.00/100  |  重要性: 5.96/100
目标价位: 381.41  |  止损位: 288.77
可能突破区间: 331.24 - 344.76
形态描述: 双底形态, 正在形成中, 颈线位置在 338.00
交易含义: 看涨信号, 目标价位: 381.41, 止损位: 288.77

日线检测到的其他形态:
  看涨形态:

----- 小时线主导形态 -----
形态类型: buying_climax
方向: 看空  |  状态: 正在形成中
可靠性评分: 100.00/100  |  重要性: 285.94/100
目标价位: 313.64  |  止损位: 343.95
可能突破区间: 286.05 - 316.16
形态描述: 顶部买入高潮, 正在形成中, 高点在 333.93, 支撑位在 301.10
交易含义: 看跌信号, 预计回撤目标: 313.64, 止损位: 343.95

小时线检测到的其他形态:
  看空形态:

===== 关键价位分析 =====

----- 周线关键价位 -----
未检测到明确的阻力位
未检测到明确的支撑位

----- 日线关键价位 -----
阻力位: 338.00, 381.41
支撑位: 288.77

----- 小时线关键价位 -----
阻力位: 343.95
支撑位: 301.10, 313.64

===== 形态分析总结 =====
综合方向: 看涨
时间周期一致性: 时间周期信号混合，无明确方向 (1看涨/1看空/1中性)
形态分析信号强度: 100.00/100

----- 形态分析交易建议 -----
强烈看涨信号，建议考虑做多策略

参考最可靠形态 (日线): double_bottom (可靠性: 100.00)
形态描述: 双底形态, 正在形成中, 颈线位置在 338.00
交易含义: 看涨信号, 目标价位: 381.41, 止损位: 288.77

===== 小时对日线顺势逆转信号分析 =====
波段交易模式: 仅分析小时对日线的顺势逆转(忽略日线对周线)
未检测到小时线对日线的顺势逆转信号

当前趋势状态:
• 小时周期趋势: 上涨
• 日线周期趋势: 上涨

建议等待小时周期调整后再寻找顺势入场机会

======== TSLA - 波动率/量能 分析 ========
=== 波动率分析 ===

历史波动率: 0.13%（年化）
ATR: 3.7849（1.15%）
布林带宽度: 6.83%
波动率状态: 高波动
波动率趋势: 波动率逐渐下降，市场趋于稳定
波动率百分位: 42.11%

平均波动范围:
  日: 0.84%
  周: 2.80%
  月: 6.52%

风险指标:
  最大回撤: 9.76%
  下行偏差: 0.0124
  夏普比率: 0.44

=== 价格位置分析 ===
相对52周高点: 79.29%
相对52周低点: 20.71%

=== 波动率渐变分析 ===
波动率状态: 从中等波动向高波动过渡
渐变强度: 100%

=== 积累分布线分析 ===

积累分布线趋势: 看涨
积累分布线斜率: 1018508.2902
背离类型: 无背离
背离强度: 0.00/100
背离描述: 未检测到明显背离

成交量力量: 4.01 (范围: -100 至 100)
资金流指标(MFI): 57.82
蔡金摆动指标: 0.1067
OBV斜率: 0.0064
价格成交量确认: 是

分析摘要: 积累分布线呈上升趋势，表明买方力量占优，支持价格上涨。 成交量力量基本平衡。 蔡金摆动指标和OBV斜率均为正，确认买盘力量。 价格与成交量变化方向一致，确认当前趋势。


【波动率量能分析结论】

价格位置: 位于过去60天价格区间中段（距底部79.3%，距顶部20.7%）
波动率状态: 高波动（波动率下降中）
波动率渐变: 从中等波动向高波动过渡中
资金流向趋势: 资金流入占优（看涨）




======== TSLA - 综合整合分析 ========
======== 开始执行 TSLA 综合分析 ========
正在获取各时间周期数据...
正在执行筹码分布分析...
正在执行形态分析...
正在整合分析结果...
================================================================================
交易计划 | TSLA | 8/10/2025, 8:51:45 PM ｜ 329.6499938964844

【综合信号】
方向: 📈 做多 | 强度: ⚡ 弱 | 确信度: 80.7/100
TSLA做多信号，信号强度: weak，确信度: 80.72/100。建议入场价格: 313.64
形态分析: 综合形态分析显示看涨信号，信号强度: 100.00/100。 短期形态分析显示看跌，建议关注短线机会。

小时线主导形态: buying_climax
    
 关键时间: Aug 01, 14:30 @ (301.10) | Aug 08, 09:30 @ (333.93), (看跌)，可靠性: 100.00/100。

日线主导形态: double_bottom
    
 关键时间: Jul 07, 09:30 @ (288.77) | Jul 21, 09:30 @ (338.00) | Jul 24, 09:30 @ (300.41), (看涨)，可靠性: 100.00/100。

积累分布线分析: 资金流入占优

波动率分析: 高波动环境，波动率逐渐下降，市场趋于稳定
，目标价格: 330.90，止损价格: 301.44。

--------------------------------------------------------------------------------

【各子分析关键建议】
筹码: 筹码差值 52/100，主要周期 daily，一致性：看多
形态/逆转: 综合形态分析显示看涨信号，信号强度: 100.00/100。 短期形态分析显示看跌，建议关注短线机会。

小时线主导形态: buying_climax
    
 关键时间: Aug 01, 14:30 @ (301.10) | Aug 08, 09:30 @ (333.93), (看跌)，可靠性: 100.00/100。

日线主导形态: double_bottom
    
 关键时间: Jul 07, 09:30 @ (288.77) | Jul 21, 09:30 @ (338.00) | Jul 24, 09:30 @ (300.41), (看涨)，可靠性: 100.00/100。
支阻位: 暂无日线关键位信号
波动率/量能: 波动率逐渐下降，市场趋于稳定；资金流向 bullish
结构: 结构: 震荡，事件: BOS
供需区: 附近无明确供需区
区间/突破: 未检测到稳定区间
趋势线/通道: 通道斜率: 向下 | 宽度: 41.76 | 上触达:1 下触达:7

--------------------------------------------------------------------------------

【入场策略】
价格: 329.65 ➔ 313.64 (回调入场)
区间: 310.50-316.78 | 风险: 🟢 低
条件:
  [必要] 价格回调至313.64附近的支撑位
  [重要] 回调时成交量萎缩，反弹时成交量放大
  [重要] 确认技术形态完成且未出现失败信号

--------------------------------------------------------------------------------

【出场策略】
止盈目标:
  1. 330.90 (+5.5%) | 30%仓位
  2. 338.00 (+7.8%) | 40%仓位
  3. 343.95 (+9.7%) | 30%仓位
止损位置:
  1. 301.44 (-3.9%) | 固定
  2. 298.09 (-5.0%) | 追踪
  3. 288.77 (-7.9%) | 追踪
退出时间: 31个交易日，无论盈亏均考虑清仓

--------------------------------------------------------------------------------

【风险管理】
建议仓位: 10.8% | 风险回报比: 1.97
最大损失: 账户总资金的2.0% | 波动性: 高波动性市场，建议分批建仓并使用较紧的止损

--------------------------------------------------------------------------------

【关键价位】
支撑位:
  301.10 | 形态分析
  288.77 | 形态分析
  253.44 | 筹码分析
阻力位:
  330.90 | 筹码分析
  338.00 | 形态分析
  343.95 | 综合分析

--------------------------------------------------------------------------------

【支撑阻力位的牛熊信号分析】
周线关键位: 321.55
日期: Aug 08, 15:30
名称: 看涨锤子线

--------------------------------------------------------------------------------

【时间周期分析】
主要周期: 日线 | 一致性: 看多
短期: 看多 | 中期: 偏多 | 长期: 偏多

--------------------------------------------------------------------------------

【波动率量能分析】
=== 积累分布线分析 ===

积累分布线趋势: 看涨
积累分布线斜率: 1018508.2902
背离类型: 无背离
背离强度: 0.00/100
背离描述: 未检测到明显背离

成交量力量: 4.01 (范围: -100 至 100)
资金流指标(MFI): 57.82
蔡金摆动指标: 0.0905
OBV斜率: 0.0160
价格成交量确认: 是

分析摘要: 积累分布线呈上升趋势，表明买方力量占优，支持价格上涨。 成交量力量基本平衡。 蔡金摆动指标和OBV斜率均为正，确认买盘力量。 价格与成交量变化方向一致，确认当前趋势。

=== 波动率分析 ===

历史波动率: 0.13%（年化）
ATR: 3.7849（1.15%）
布林带宽度: 6.83%
波动率状态: 高波动
波动率趋势: 波动率逐渐下降，市场趋于稳定
波动率百分位: 19.70%

平均波动范围:
  日: 0.84%
  周: 2.80%
  月: 8.08%

风险指标:
  最大回撤: 17.56%
  下行偏差: 0.0134
  夏普比率: -0.14

=== 价格位置分析 ===
相对52周高点: 59.55%
相对52周低点: 40.45%
相对200日均线: 4.65%

=== 波动率渐变分析 ===
波动率状态: 从中等波动向高波动过渡
渐变强度: 100%


--------------------------------------------------------------------------------

【交易理由】
做多理由: 筹码分析显示中性偏多信号(52/100)，形态分析显示看涨信号(100/100)，日线出现double_bottom形态，市场整体处于上升趋势，趋势一致性强。
辅助理由: 多个时间周期一致看多(100%)，日线技术指标: MACD 金叉并继续向上，RSI 56.34，布林带 运行于上轨道，多个时间周期确认的支撑位: 241.69, 253.44，短期(小时)看多，中期(日线)偏多，长期(周线)偏多。

【波动率量能分析结论】

价格位置: 位于过去60天价格区间中段（距底部59.5%，距顶部40.5%）
波动率状态: 高波动（波动率下降中）
波动率渐变: 从中等波动向高波动过渡中
资金流向趋势: 资金流入占优（看涨）



--------------------------------------------------------------------------------

【机器可解析摘要】
{"symbol":"TSLA","direction":"long","confidence":80.7,"entry":313.6411,"stopLossUsed":301.4382,"weightedTakeProfit":337.6533,"reward":24.0122,"risk":12.2028,"riskReward":1.97,"votes":{"chip":52,"pattern":100,"volume":4,"bbsr":0},"summaries":{"chipSummary":"筹码差值 52/100，主要周期 daily，一致性：看多","patternSummary":"综合形态分析显示看涨信号，信号强度: 100.00/100。 短期形态分析显示看跌，建议关注短线机会。\n\n小时线主导形态: buying_climax\n    \n 关键时间: Aug 01, 14:30 @ (301.10) | Aug 08, 09:30 @ (333.93), (看跌)，可靠性: 100.00/100。\n\n日线主导形态: double_bottom\n    \n 关键时间: Jul 07, 09:30 @ (288.77) | Jul 21, 09:30 @ (338.00) | Jul 24, 09:30 @ (300.41), (看涨)，可靠性: 100.00/100。","bbsrSummary":"暂无日线关键位信号","vvSummary":"波动率逐渐下降，市场趋于稳定；资金流向 bullish","structureSummary":"结构: 震荡，事件: BOS","supplyDemandSummary":"附近无明确供需区","rangeSummary":"未检测到稳定区间","trendlineSummary":"通道斜率: 向下 | 宽度: 41.76 | 上触达:1 下触达:7"}}
--------------------------------------------------------------------------------

【无效信号条件】
  [必要] 价格触及主要止损位301.44
  [重要] 价格跌破强支撑位301.10且无法快速收复
  [重要] double_bottom形态失败，出现与预期相反的突破
  [重要] 日线指标发生明显转向，与交易方向相反

--------------------------------------------------------------------------------

【警告信息】
  ⚠️ 信号强度较弱，建议减小仓位并严格设置止损
  ⚠️ 获利筹码比例过高，可能面临较大抛压

--------------------------------------------------------------------------------

【分析构成】
筹码分析: 20% (得分:52.0/100)
形态分析: 20% (得分:100.0/100)
量价分析: 50% (得分:4.0/100)
支阻位分析: 10% (得分:0.0/100)
（附加）趋势线/通道: (得分:0.0/100)

================================================================================

{"symbol":"TSLA","direction":"long","confidence":80.7,"entry":313.6411,"stopLossUsed":301.4382,"weightedTakeProfit":337.6533,"reward":24.0122,"risk":12.2028,"riskReward":1.97,"votes":{"chip":52,"pattern":100,"volume":4,"bbsr":0},"summaries":{"chipSummary":"筹码差值 52/100，主要周期 daily，一致性：看多","patternSummary":"综合形态分析显示看涨信号，信号强度: 100.00/100。 短期形态分析显示看跌，建议关注短线机会。\n\n小时线主导形态: buying_climax\n    \n 关键时间: Aug 01, 14:30 @ (301.10) | Aug 08, 09:30 @ (333.93), (看跌)，可靠性: 100.00/100。\n\n日线主导形态: double_bottom\n    \n 关键时间: Jul 07, 09:30 @ (288.77) | Jul 21, 09:30 @ (338.00) | Jul 24, 09:30 @ (300.41), (看涨)，可靠性: 100.00/100。","bbsrSummary":"暂无日线关键位信号","vvSummary":"波动率逐渐下降，市场趋于稳定；资金流向 bullish","structureSummary":"结构: 震荡，事件: BOS","supplyDemandSummary":"附近无明确供需区","rangeSummary":"未检测到稳定区间","trendlineSummary":"通道斜率: 向下 | 宽度: 41.76 | 上触达:1 下触达:7"}}

## 分析器文档

- 筹码分布: [docs/analysis/chip.md](docs/analysis/chip.md)
- 蜡烛形态: [docs/analysis/candle.md](docs/analysis/candle.md)
- 图表形态+趋势逆转: [docs/analysis/patterns.md](docs/analysis/patterns.md)
- 支撑/阻力(BBSR): [docs/analysis/bbsr.md](docs/analysis/bbsr.md)
- 波动率与量能: [docs/analysis/volatility.md](docs/analysis/volatility.md)
- 市场结构: [docs/analysis/structure.md](docs/analysis/structure.md)
- 供需区: [docs/analysis/supply-demand.md](docs/analysis/supply-demand.md)
- 区间/突破: [docs/analysis/range.md](docs/analysis/range.md)
- 趋势线/通道: [docs/analysis/trendlines.md](docs/analysis/trendlines.md)

## 统一输出与综合分析

- 统一中文输出由 `src/analysis/FormatTradePlan.ts` 负责，导出 `formatTradePlanOutput` 与 `buildMachineReadableSummary`。
- 综合整合分析入口：`executeIntegratedAnalysis(symbol)`，返回 `IntegratedTradePlan` 可直接格式化打印。

## 配置集中管理

- 筹码: `chipConfig` / `updateChipConfig`
- 蜡烛: `candleConfig` / `updateCandleConfig`
- 形态: `patternConfig` / `updatePatternConfig`
- BBSR: `srConfig` / `updateSrConfig`
- 结构: `structureConfig` / `updateStructureConfig`
- 供需: `sdConfig` / `updateSdConfig`
- 区间: `rangeConfig` / `updateRangeConfig`
- 趋势线: `trendlineConfig` / `updateTrendlineConfig`

## 许可证

MIT