stock-analysis-lianghua 是一个专为股票技术分析设计的智能分析工具，既支持独立脚本快速分析单只股票的走势与指标，也深度集成于 TradingAgentsV2 交易系统中作为分析师节点运行。该工具通过调用多种数据源获取历史行情信息，并结合一系列标准化技术指标进行综合判断，为用户提供清晰的市场趋势解读和投资参考。其核心优势在于灵活的数据获取机制——当主数据源不可用时自动降级至备用方案，确保分析过程稳定可靠。同时，无论是独立使用还是嵌入 LangGraph 架构，均能输出结构化的分析报告，涵盖近期行情、技术指标、动量波动及短期信号等多个维度。 在功能实现上，该工具内置了丰富的技术指标库，包括移动平均线（如50日SMA、200日SMA）、MACD系列指标、RSI相对强弱指数、布林带以及ATR波动率等共计9类常用参数。用户可通过命令行指定股票代码、分析日期和回看周期，亦可自定义需要展示的技术指标组合。系统默认采用8个核心指标进行综合分析，但允许扩展至多8个以避免冗余。所有成功获取的数据会被自动缓存到本地目录，提升后续访问效率并支持离线模式运行。此外，报告内容不仅包含原始数值序列，还会对趋势方向、超买超卖状态、金叉死叉信号等进行逻辑推理并生成自然语言结论。 从应用场景来看，stock-analysis-lianghua 既适合专业投资者在日常交易中快速评估个股技术面状况，也可作为量化策略开发中的辅助模块用于生成特征输入。对于 TradingAgentsV2 项目而言，它作为市场分析师节点被整合进交易决策流程，与其他基本面、新闻情绪等分析器协同工作，形成多维度投资建议体系。无论是新增自定义指标、调整系统提示词以改变报告风格，还是在 A股/美股之间切换数据源策略，开发者均可根据实际需求灵活配置。整体设计兼顾易用性与可扩展性，满足不同层次用户的分析与系统集成要求。
核心功能特点
- 支持多源数据容灾：优先使用 Stooq 免费接口，失败时自动切换至 Yahoo Chart API、yfinance 或本地缓存，保障数据连续性
- 内置9类技术指标分析：涵盖移动平均线、MACD、RSI、布林带、ATR等关键参数，提供趋势判断、动量分析和波动率评估
- 灵活的命令行交互：可指定股票代码、分析日期、回看天数及自定义指标组合，默认输出结构化中文分析报告
- 深度集成 LangGraph 架构：作为标准分析师节点嵌入 TradingAgentsV2，遵循统一模板返回 market_report 等字段
- 自动缓存机制：成功获取的数据持久化存储于 data_cache 目录，减少重复请求并提升响应速度
- 防无限循环保护：限制工具调用次数不超过3次，超出后强制生成最终报告防止系统卡死
适用场景
该工具特别适合需要高频查看个股技术形态的日内交易者或波段操作者。例如，当用户关注某只热门科技股（如 NVDA 或 META）时，只需在终端执行 `python analyze_stock.py TSLA -i all` 即可在数秒内获得过去90天的完整技术分析摘要，包括价格突破50日均线的可能性、RSI是否进入超买区以及布林带收窄所暗示的方向选择。这种即时反馈能力使其成为盘中监控的有效补充手段。 对于从事算法交易或策略回测的研究人员而言，stock-analysis-lianghua 提供了标准化的数据接口和分析逻辑，便于将技术指标转化为量化因子。结合其缓存功能，可在批量处理大量股票时显著降低外部依赖风险。同时，由于支持 A股（CN）与美股（US）两种市场类型的数据源切换，研究人员可以轻松构建跨市场的对比实验环境。 在企业级应用层面，TradingAgentsV2 系统将其作为核心分析组件之一，串联起市场、基本面、新闻和社交媒体四大分析流。在实际交易场景中，当系统接收到新的目标公司信息后，会依次触发各分析师节点并行处理，最终汇总成一份综合投资建议。此时，market_analyst 节点输出的 market_report 将成为后续决策的关键依据之一，尤其适用于机构客户的多因子风险评估流程。此外，若需定制特定行业的分析逻辑或引入新的技术指标，开发者也可基于现有模板快速扩展，满足个性化需求。