本文档面向小白：用通俗语言解释项目里用到的全部技术指标，包括定义、计算方式、如何解读，以及如何写成智能体（LLM）能用的提示词。
数据由系统计算，LLM 只需按规则解读并输出结论。

---

一、小白必读：技术面在报告里干什么？

一句话：技术面不直接下结论，只负责「算指标 + 写一两句参考」，结论由 LLM 综合技术+消息+财报+期权一起出。

• 输入：某只股票的 K 线（开高低收、成交量），来自 yfinance
• 输出：均线、MACD、KDJ、RSI、布林带、OBV、背离、量比、入场/离场参考等
• 用途：拼进 Prompt，让 LLM 据此描述「趋势结构、MACD 状态、KDJ 状态」，并给出加仓/减仓价建议

---

二、指标总览与分类

类别	指标	小白一句话	本项目参数
趋势	MA5/10/20/60、多头排列	看价格在均线上还是下，判断涨跌方向	简单移动平均 SMA
趋势/动量	MACD	看金叉死叉、在零轴上方还是下方	12, 26, 9
动量/超买超卖	KDJ	看是否超买(>80)或超卖(<20)	9, 3, 3
动量/超买超卖	RSI	同上，>70 超买、<30 超卖	14
波动	ATR、ATR%	看波动多大，用于止损和仓位	14
量能	量比	当前量 / 20 日均量，>1 放量	20 日均量
通道	布林带	价格在通道上中下轨的位置	20 日，2 倍标准差
量价	OBV 能量潮	量价是否配合，OBV 在均线上偏多	20 日均线
背离	MACD/RSI 背离	价格创新高但指标没跟上→可能见顶	回溯 30 根 K 线
结构	近期高点（20 日）	突破该价位为强势信号	过去 20 根最高价

---

三、各指标详细说明（小白版）

1. 均线（MA）—— 看趋势方向

是什么：把最近 N 天的收盘价加起来除以 N，得到一条「平均价格线」。

怎么算：

• MA5 = 最近 5 根 K 线收盘价均值
• MA10 / MA20 / MA60 同理

输出字段：price（当前价）, ma5, ma10, ma20, ma60, above_ma5/20/60, daily_long_align

小白解读：

• 多头排列：价格 > MA5 > MA10 > MA20 > MA60 → 短期、中期、长期都在涨，趋势偏多、结构强
• 空头排列：反过来 → 趋势偏空
• 价格在 MA20 之上：短期偏多；在 MA60 之上：中期偏多
• MA20/MA60 常作支撑：跌破 MA20 可视为减仓区，跌破 MA60 可视为离场参考

配置：config/analysis_config.py 中 MA_PERIODS，可通过环境变量 TECH_MA5、TECH_MA10 等覆盖。

---

2. MACD（指数平滑异同移动平均线）—— 看多空与金叉死叉

是什么：用两条「快慢均线」的差值，判断 momentum（动能）是增强还是减弱。

怎么算（本项目）：

• 快线 = EMA(Close, 12)，慢线 = EMA(Close, 26)
• MACD 线 = 快线 - 慢线
• 信号线 = MACD 线的 9 日 EMA
• 柱状图 = MACD 线 - 信号线

输出字段：macd, signal, histogram, above_zero, golden_cross

小白解读：

• above_zero：MACD 线 > 0 → 偏多；< 0 → 偏空
• 金叉：MACD 线由下上穿信号线 → 偏多信号，可考虑入场
• 死叉：MACD 线由上穿下信号线 → 偏空信号，可考虑减仓
• 柱状图由负转正：动能增强；由正转负：动能减弱

配置：TECH_MACD_FAST=12, TECH_MACD_SLOW=26, TECH_MACD_SIGNAL=9

---

3. KDJ（随机指标）—— 看超买超卖

是什么：用最高价、最低价、收盘价算出一个 0～100 的数值，看短期是否「买多了」或「卖多了」。

怎么算（本项目）：

• RSV = (Close - 9 日最低) / (9 日最高 - 9 日最低) × 100
• K = RSV 的 3 日 EMA，D = K 的 3 日 EMA，J = 3K - 2D

输出字段：k, d, j, overbought（K>80）, oversold（K<20）

小白解读：

• 超买：K > 80 → 短期可能回调，不宜追高
• 超卖：K < 20 → 短期可能反弹，可关注低吸
• 钝化：强势行情中 K 可长期 >80；弱势中 K 可长期 <20，需结合趋势与 RSI 综合判断
• J 值最敏感，K、D 金叉/死叉可辅助短多短空

配置：TECH_KDJ_N=9, TECH_KDJ_OVERBOUGHT=80, TECH_KDJ_OVERSOLD=20

---

4. RSI（相对强弱指数）—— 看超买超卖（与 KDJ 互补）

是什么：看最近 N 天「涨的日子」和「跌的日子」谁更强，算出一个 0～100 的数。

怎么算（本项目）：

• 涨跌幅：delta = Close - Close_前一根
• 涨幅均值 avg_gain、跌幅均值 avg_loss（EMA，α=1/14）
• RS = avg_gain / avg_loss，RSI = 100 - 100/(1+RS)

输出字段：rsi, overbought（>70）, oversold（<30）

小白解读：

• 超买：RSI > 70 → 短期可能回调
• 超卖：RSI < 30 → 短期可能反弹
• 中性：30～70，结合趋势与 KDJ 判断多空
• 背离：价格创新高而 RSI 未创新高（顶背离）→ 可能见顶；价格创新低而 RSI 未创新低（底背离）→ 可能见底（本项目有自动检测，见「背离」小节）

配置：TECH_RSI_PERIOD=14, TECH_RSI_OVERBOUGHT=70, TECH_RSI_OVERSOLD=30

---

5. ATR 与 ATR% —— 看波动，用于止损和仓位

是什么：ATR（真实波幅）衡量价格一天内「最多能波动多少」，ATR% 是相对当前价的百分比，便于跨标的比较。

怎么算：

• TR = max(High-Low, |High-前收|, |Low-前收|)（单根 K 线的波动）
• ATR(14) = TR 的 14 日简单移动平均
• ATR% = ATR / 当前收盘价 × 100

输出字段：atr, atr_pct（在 tech_levels 中）

小白解读：

• 波动：ATR 越大波动越大；ATR%=2 表示约 2% 的日波动
• 止损：常用「收盘价 - N×ATR」作止损位，本项目默认 N=1.5（TECH_ATR_STOP_MULT）
• 仓位：波动大时（ATR% 高）可建议轻仓或缩小仓位

配置：TECH_ATR_PERIOD=14, TECH_ATR_STOP_MULT=1.5

---

6. 量比（Volume Ratio）—— 看放量还是缩量

是什么：当前成交量 / 过去 20 根 K 线成交量均值。>1 表示比平时放量，<1 表示缩量。

怎么算：近期一根 K 线的成交量 / 过去 20 根 K 线成交量均值

输出字段：volume_ratio, volume_ma20（在 volume_context 中）

小白解读：

• 量比 > 1：当前量能高于近期均量，放量
• 量比 < 1：缩量
• 放量突破：价格突破近期高点且量比 ≥ 1.5（TECH_VOLUME_BREAKOUT_RATIO）→ 突破更可信，可作入场加强条件
• 放量下跌需警惕；缩量上涨可持续性存疑

配置：TECH_VOLUME_MA_PERIOD=20, TECH_VOLUME_BREAKOUT_RATIO=1.5

---

7. 布林带（Bollinger Bands）—— 看价格在通道中的位置

是什么：以均线为中轨，上下各加 N 倍标准差，形成一个「通道」。价格在上轨附近可能超买，在下轨附近可能超卖。

怎么算（本项目）：

• 中轨 = SMA(Close, 20)
• 上轨 = 中轨 + 2×标准差，下轨 = 中轨 - 2×标准差
• 位置% = (当前价 - 下轨) / (上轨 - 下轨) × 100，0～100，越近上轨越超买

输出字段：upper, middle, lower, above_upper, below_lower, bollinger_pct

小白解读：

• 价格在上轨上方：可能超买
• 价格在下轨下方：可能超卖
• bollinger_pct 越接近 100 越偏超买，越接近 0 越偏超卖

配置：TECH_BB_PERIOD=20, TECH_BB_STD_MULT=2.0

---

8. OBV（能量潮）—— 看量价是否配合

是什么：涨日加量、跌日减量，累加得到一条线。OBV 在均线上表示量价配合偏多。

怎么算：涨日 OBV += 成交量，跌日 OBV -= 成交量，再与 OBV 的 20 日均线比较

输出字段：obv, obv_ma, obv_above_ma

小白解读：

• obv_above_ma = True：量价配合偏多，上涨有量支撑
• obv_above_ma = False：量价背离，上涨可能乏力

---

9. 背离（Divergence）—— 价格与指标不一致的预警

是什么：价格创新高/新低，但指标没有跟上，可能预示反转。

本项目自动检测：

• 顶背离：价格创新高，MACD 或 RSI 未创新高 → 可能见顶
• 底背离：价格创新低，MACD 或 RSI 未创新低 → 可能见底

输出字段：macd_top, macd_bottom, rsi_top, rsi_bottom

小白解读：出现顶背离时不宜追高；出现底背离时可关注低吸机会。

配置：TECH_DIVERGENCE_LOOKBACK=30, TECH_DIVERGENCE_MIN_BARS=20

---

10. 近期高点与入场/离场参考

是什么：系统根据 MA20/MA60、ATR、量比等，自动生成「入场参考」和「离场参考」的简短中文句子。

计算：

• 近期高点 = 过去约 20 根 K 线内的最高价（阻力）
• 支撑 = MA20、MA60
• ATR 止损 = 价格 - N×ATR（N 默认 1.5）

输出字段：support_ma20, support_ma60, resistance_20d, entry_note, exit_note

小白解读：

• 入场：突破/站稳 MA20、或突破近期高点；若同时放量（量比≥1.5）更佳
• 离场：跌破 MA20 考虑减仓，跌破 MA60 考虑离场；或收盘跌破「价格 - 1.5×ATR」止损

---

四、指标对比与组合使用

维度	更适用的指标	小白说明
趋势方向	MA、多头排列、MACD 零轴	判断多空与趋势强度
短期超买超卖	KDJ、RSI	两者可互相印证；同时超买/超卖时信号更强
动能/金叉死叉	MACD	金叉偏多、死叉偏空，结合零轴
波动与风控	ATR、ATR%	止损位、仓位大小
突破有效性	量比 + 近期高点	放量突破更可靠
通道位置	布林带	超买超卖辅助
量价配合	OBV	上涨是否有量支撑
反转预警	背离	顶背离见顶、底背离见底
综合一句	tech_status_one_line	项目已生成一句摘要，智能体可直接引用并展开

组合建议：趋势（MA/MACD）+ 超买超卖（KDJ/RSI）+ 量能（量比）+ 波动（ATR%）+ 布林带 + OBV + 背离 一起看，避免单指标结论；入场/离场参考（entry_note/exit_note）可直接用于「加仓价/减仓价」表述。

---

五、智能体提示词（可直接放入 System 或 User）

以下段落可直接作为「技术面分析」的系统提示或用户说明，粘贴到智能体提示词中使用。

完整版（推荐）

【技术指标定义与解读规则】

你分析技术面时，将使用以下指标（数据由系统提供，你只需按规则解读并输出结论）：

1) 均线（MA）
- MA5/10/20/60：收盘价的 5/10/20/60 周期简单移动平均。
- 多头排列：当前价 > MA5 > MA10 > MA20 > MA60 → 趋势偏多、结构强；反之为空头或非多头。
- 价格在 MA20 之上视为短期偏多，在 MA60 之上视为中期偏多；跌破 MA20 可考虑减仓，跌破 MA60 可考虑离场。

2) MACD（12,26,9）
- MACD 线 = EMA12(Close) - EMA26(Close)；信号线 = MACD 的 9 日 EMA；柱状图 = MACD - 信号线。
- MACD 在零轴上方：偏多；下方：偏空。MACD 线刚上穿信号线：金叉，偏多信号；下穿：死叉，偏空信号。

3) KDJ（9,3,3）
- K>80：超买，短期可能回调；K<20：超卖，短期可能反弹。K 在 20～80 为中性，结合趋势判断。长期停留在超买/超卖区为钝化。

4) RSI（14）
- RSI>70：超买；RSI<30：超卖；30～70：中性。可与 KDJ 互相印证；两者同时超买或超卖时结论更稳。

5) 布林带
- 中轨=SMA20，上下轨=中轨±2倍标准差。价格在上轨上方可能超买，下轨下方可能超卖。bollinger_pct 越近 100 越超买。

6) OBV 能量潮
- OBV 在均线上：量价配合偏多；在均线下：量价背离，上涨可能乏力。

7) 背离
- 顶背离（macd_top 或 rsi_top）：价格创新高但指标未创新高，可能见顶，不宜追高。
- 底背离（macd_bottom 或 rsi_bottom）：价格创新低但指标未创新低，可能见底，可关注低吸。

8) ATR 与 ATR%
- ATR(14)：真实波幅的 14 日均。ATR% = ATR/收盘价×100，表示日波动幅度百分比。
- 用于止损：常见为「收盘跌破 当前价 - N×ATR」离场（N 如 1.5）。ATR% 大时宜轻仓或缩小仓位。

9) 量比
- 量比 = 当前成交量 / 20 日均量。>1 为放量，<1 为缩量。
- 价格突破近期高点且量比≥1.5 时，视为放量突破，突破更可信，可作入场加强条件。放量下跌需警惕。

10) 入场/离场参考（系统已生成）
- 系统会给出 entry_note（入场参考）与 exit_note（离场参考），基于 MA20/MA60、近期高点、ATR 止损与量比。你在输出「加仓价格」「减仓价格」时，应尽量与这两条一致或在其基础上略作说明。

11) 技术面一句摘要（tech_status_one_line）
- 系统会提供一句已汇总的结论（如：日线多头排列；MACD金叉；KDJ中性；RSI中性(45)；布林带60%；量比1.2；ATR%2.5%；顶背离）。你可直接引用并在此基础上用 1～2 句展开「趋势结构」「MACD状态」「KDJ状态」等，保持与数据一致。

输出要求：根据以上指标综合给出「趋势结构」「MACD状态」「KDJ状态」的简短描述，并据此参与评分与交易动作（买入/观察/离场）；加仓价与减仓价尽量对齐系统给出的入场/离场参考。

简短版（占位少的提示词）

技术面解读规则：多头排列(价>MA5>MA10>MA20>MA60)偏多；MACD 零轴上/金叉偏多；KDJ K>80 超买、K<20 超卖；RSI>70 超买、<30 超卖；布林带上轨上方超买、下轨下方超卖；OBV 在均线上量价配合偏多；顶背离不宜追高、底背离可关注低吸；量比>1 放量，放量突破近期高点更佳；ATR% 用于止损与仓位。加仓/减仓价以系统给出的 entry_note/exit_note 为准，可引用 tech_status_one_line 一句摘要后略作展开。

---

六、本项目输出字段与提示词对应关系

系统输出字段	智能体可如何使用
trend_ma（price, ma5~ma60, above_ma*, daily_long_align）	描述趋势、是否多头排列、价格与均线关系
macd_summary（macd, signal, histogram, above_zero, golden_cross）	描述 MACD 状态、是否金叉、零轴上下
kdj_summary（k, d, j, overbought, oversold）	描述 KDJ 超买超卖或中性、是否钝化
rsi_summary（rsi, overbought, oversold）	描述 RSI 超买超卖或中性
bb_summary（upper, middle, lower, above_upper, below_lower, bollinger_pct）	描述布林带位置、是否超买超卖
obv_summary（obv, obv_ma, obv_above_ma）	描述量价配合
divergence_summary（macd_top, macd_bottom, rsi_top, rsi_bottom）	描述顶背离/底背离
volume_context（volume_ratio, volume_ma20）	描述放量/缩量、是否放量突破
tech_levels（atr, atr_pct, entry_note, exit_note, resistance_20d）	描述波动、直接引用入场/离场与加仓/减仓价
tech_status_one_line	直接引用一句摘要，再 1～2 句展开

将上述「智能体提示词」段落放入你的 Agent 系统提示或技术面分析专用提示中即可；若接口传入了上述字段，智能体按本规则解读并输出即可与项目逻辑一致。

---

七、可配置参数一览（config/analysis_config.py）

环境变量	默认值	说明
TECH_MA5 / MA10 / MA20 / MA60	5/10/20/60	均线周期
TECH_MACD_FAST / SLOW / SIGNAL	12/26/9	MACD 参数
TECH_KDJ_N / OVERBOUGHT / OVERSOLD	9/80/20	KDJ 参数
TECH_RSI_PERIOD / OVERBOUGHT / OVERSOLD	14/70/30	RSI 参数
TECH_BB_PERIOD / BB_STD_MULT	20/2.0	布林带参数
TECH_ATR_PERIOD	14	ATR 周期
TECH_ATR_STOP_MULT	1.5	ATR 止损倍数
TECH_VOLUME_MA_PERIOD	20	量比均量周期
TECH_VOLUME_BREAKOUT_RATIO	1.5	放量突破量比阈值
TECH_DIVERGENCE_LOOKBACK	30	背离检测回溯 K 线数
TECH_DIVERGENCE_MIN_BARS	20	背离检测最少 K 线数

---

八、代码位置速查

git项目地址

功能	文件与函数
技术面入口	agents/technical.get_technical_summary()
MACD/KDJ/RSI/ATR 计算	agents/technical._macd, _kdj, _rsi, _atr
布林带、OBV	agents/technical._bollinger, _obv
背离检测	agents/technical._detect_divergence
入场/离场文案	agents/technical._compute_entry_exit_levels
一句摘要	agents/technical._build_tech_status_one_line
配置参数	config/analysis_config.py
拼 Prompt 调用	agents/full_analysis._build_prompt