【AI+量化实战 #06】金叉死叉只会看不会说？用LLM把技术指标翻译成交易语言

import mairui
import os

api = mairui.Client("<你的证书>")  # 演示证书，请替换成你自己的正式证书

ma = api.stock_ma("600519")
macd = api.stock_macd("600519")

print(ma[-1])   # 最新日均线
print(macd[-1]) # 最新日 MACD

def ma_signal(prev, cur):
    if cur["ma5"] > cur["ma20"] and prev["ma5"] <= prev["ma20"]:
        return "golden_cross", "MA5 上穿 MA20，出现金叉"
    if cur["ma5"] < cur["ma20"] and prev["ma5"] >= prev["ma20"]:
        return "death_cross", "MA5 下穿 MA20，出现死叉"
    if cur["ma5"] > cur["ma20"]:
        return "bull_arrange", "MA5 在 MA20 上方，多头排列"
    return "bear_arrange", "MA5 在 MA20 下方，空头排列"

def macd_signal(prev, cur):
    if cur["macd"] > 0 and prev["macd"] <= 0:
        return "macd_bull_turn", "MACD 由负转正，柱状线翻红"
    if cur["macd"] < 0 and prev["macd"] >= 0:
        return "macd_bear_turn", "MACD 由正转负，柱状线翻绿"
    if cur["macd"] > 0:
        return "macd_bull", "MACD 红柱，多头动能占优"
    return "macd_bear", "MACD 绿柱，空头动能占优"

你是一位量化策略研究员，正在给一位非技术背景的基金经理解释当前技术面状态。

股票：{name}
最新收盘价：{close:.2f} 元
日期：{date}

技术指标：
- MA5 = {ma5}，MA20 = {ma20}；{ma_desc}。
- MACD 柱状线 = {macd}，DIFF = {diff}，DEA = {dea}；{macd_desc}。

请用 3 句话以内、通俗易懂的中文说明：
1. 当前股票处于什么技术状态？
2. 金叉/死叉/红绿柱变化分别代表什么含义？
3. 作为策略信号，需要注意哪些风险？

def explain_signal(prompt: str, ma_state: str, macd_state: str) -> str:
    api_key = os.environ.get("LLM_API_KEY", "")
    base_url = os.environ.get("LLM_BASE_URL", "")
    if not api_key or not base_url:
        # 规则化 fallback
        if "golden_cross" in ma_state and "bull" in macd_state:
            return "MA 与 MACD 同时转多，短期偏多；但需防范假突破与追高风险。"
        if "death_cross" in ma_state and "bear" in macd_state:
            return "MA 与 MACD 同时转空，短期偏空；需关注是否进入调整。"
        if "bull" in macd_state:
            return "动能偏多，但均线形态未确认金叉，属于多头中的震荡。"
        return "动能偏空或处于震荡，未出现共振信号，宜观望。"
    # 否则调用 LLM
    ...