核心用法
stock-earnings-review 是面向多市场（沪深京港美）上市公司的自动化业绩点评工具，通过三步流程完成专业财报分析：
1. 实体识别：调用 validate_entity.py 解析用户问句，识别公司/股票实体，返回证券代码、市场标识等关键字段
2. 报告期匹配：通过 normalize_report_period.py 获取该实体已发布的财报报告期列表，由上层模型或默认规则选定目标报告期
3. 业绩点评生成：调用 call_review_api.py 生成结构化点评内容，包含标题、正文分析、分享链接，并将PDF/Word附件本地落盘
用户可通过自然语言触发（如"分析XX公司Q3业绩""解读XX年报"），系统自动完成实体-报告期-点评的完整链路。
显著优点
- 权威数据源：直接对接东方财富妙想数据库，非大模型幻觉生成，数据可信度有保障
- 多市场覆盖：单一接口支持A股、港股、美股、北交所、新三板五大市场
- 专业输出格式：自动生成符合投研规范的业绩点评文档，含财务指标分析、盈利能力解读、风险提示等章节
- 附件自动归档：PDF/Word双格式输出，支持本地保存与分享链接，便于二次编辑或归档
- 分步骤可控：实体识别、报告期选择、点评生成三阶段分离，支持上层模型灵活干预
潜在缺点与局限性
- 数据源依赖：完全依赖东方财富接口，若接口服务中断或数据延迟则无法生成
- 报告期限制：仅支持已发布财报期，无法预测或分析未披露业绩
- 无实时行情：侧重财务数据解读，不包含股价走势、市场情绪等实时维度
- 附件不可解析：明确禁止尝试读取PDF/DOC内容，仅能基于接口返回的
content字段输出 - 单实体优先：多实体场景取第一个，复杂对比分析需多次调用
适合人群
- 证券分析师、基金经理等需要快速获取标准化业绩点评的投研人员
- 财经自媒体、投资顾问等需要专业财报解读内容的生产者
- 个人投资者希望获得结构化的公司财务分析参考
- 金融数据产品经理需要集成业绩点评能力的开发者
常规风险
- API密钥安全：
EM_API_KEY为敏感凭证，存在泄露风险；需严格遵循环境变量配置，禁止硬编码 - 数据时效性：财报发布存在滞后，点评基于历史数据，不构成投资建议
- 接口稳定性：依赖东方财富服务可用性，高峰期可能存在延迟
- 合规边界：自动化生成的点评内容仍需人工复核，不可直接作为投研结论或对外发布依据