核心用法
A-stock-report 是一套面向中国A股市场的数据驱动型自动化报告生成与推送系统，覆盖投资者全天候信息需求：
| 报告类型 | 触发时间 | 数据来源 | 生成方式 |
|---------|---------|---------|---------|
| 晨报 | 工作日08:00 | 隔夜美股/VIX/A50期货/大宗商品 | LLM驱动模板生成 |
| 收盘小结 | 工作日15:30 | 实时行情/涨跌停统计/主力资金/IF基差 | 纯Python脚本 |
| 晚报 | 工作日20:00 | 亚太股市/两融余额/沪深300 PE | LLM驱动模板生成 |
| 盘中预警 | 交易日每5分钟 | 实时行情异动监控 | 纯Python脚本 |
| IPO周报 | 周六10:00 | 注册制审核/上会/获批/上市数据 | 纯Python脚本 |
| 财经周末版 | 周日20:00 | 历史报告MD合并(情绪轨迹) | LLM驱动模板生成 |
核心功能亮点：
- 6维度情绪量化打分（涨停家数、涨跌停比、炸板率、主力净流入、换手率、IF基差），满分100分自动计算
- 14段一致性护栏（check_consistency.py）确保4端真相不漂移：templates/ ↔ cron_mirror.json ↔ jobs.json ↔ SKILL.md
- 3层fallback数据链：主题聚合页>单篇头条，batch_web_search失败自动降级
- 防并发锁机制：各任务独立锁文件，finally块兜底释放
显著优点
工程成熟度极高：历经35+版本迭代（v2.0.0~v3.5.2），文档结构遵循" MEMORY约束"（单文件>30KB强制瘦身），changelog外置知识库按需加载。
数据源多元可靠：零密钥（腾讯/新浪/akshare）+ 问财API直连（进程内调用，无subprocess泄露风险），字段名同义词兼容、返回值类型不稳定三重防御已固化。
运营风险可控：密钥白名单原则（仅WECOM+IWENCAI两枚）、.env路径多回退、send_evening_report.py新增5项内容质量硬校验（v3.5.1）。
潜在缺点与局限性
强依赖外部数据稳定性：VIX/富时A50依赖新浪hq.sinajs.cn，2026-06已遇403反爬升级（需完整浏览器UA）；问财API字段类型不稳定（float/str/int混返）需消费侧兼容。
LLM型报告存在"内容空窗"风险：晨报/晚报的"财经要闻"和"操作建议"区块依赖cron中LLM步骤生成，若未配置对应task则永久为空——这是架构设计而非bug，但新手易误判为故障。
周末要闻数据时效性弱：完全依赖历史MD文件合并，无法反映实时突发事件。
情绪打分模型未公开回测：6因子等权平均（各0~100映射后取均）的预测有效性未经大规模历史验证，仅供参考。
适合人群
- 个人量化投资者：需自动化盘面跟踪+情绪指标辅助决策
- 券商/投顾团队：标准化早报/晚报生产，降低人力成本
- 财经自媒体：合规免责声明已内置，可直接二次分发
常规风险
| 风险类型 | 具体场景 | 缓释措施 |
|---------|---------|---------|
| 数据漂移 | 问财字段名/类型变更 | 兼容分支+check_consistency护栏 |
| 推送重复 | cron重叠触发 | 文件锁+JSON状态锁双保险 |
| 密钥泄露 | .env误提交 | .clawhubignore排除+仅加载必需变量 |
| 合规风险 | 投资建议被误解 | 强制"仅供参考"尾注+≤50字点评限制 |
| 服务中断 | 新浪/问财API故障 | 3层fallback链+兜底值占位(❌数据缺失) |
版本建议：生产环境建议锁定v3.5.0+，未发版小改（≥5条）强制触发版本bump规则已生效。