核心用法
A-stock-report是一套面向A股市场的数据驱动型报告自动生成与推送系统，采用"数据采集→量化分析→AI生成→自动推送"的闭环架构，覆盖投资者全天候信息需求：
六大报告类型：
- 晨报（工作日08:00）：隔夜美股、VIX恐慌指数、富时A50期货、港股、大宗商品等外围市场复盘，附财经要闻与操作建议
- 收盘小结（工作日15:30）：6大指数表现、板块行情、主力资金流、6维度量化情绪打分（满分100）、后市展望
- 晚报（工作日20:00）：A股收盘数据、亚太股市、两融余额与风险溢价、沪深300 PE估值、财经要闻
- 盘中预警（交易日09:00-14:55每5分钟）：实时异动监测与风险提示
- IPO周报（周六10:00）：排队情况、上会动态、获批/撤回信息、新股上市表现
- 财经周末版（周日20:00）：一周情绪轨迹回溯（5交易日数据合并）、杠杆/估值/预期三维研判
技术实现：
- 数据源：腾讯实时API、新浪行情、akshare开源库、同花顺i问财OpenAPI（进程内直连，无subprocess）
- 量化模型：情绪打分基于涨停家数、涨跌停比、炸板率、主力净流入占比、换手率、IF基差6因子等权平均
- 架构设计：LLM驱动型（晨报/晚报/周末版）采用"dispatcher生成prompt→LLM执行→脚本推送"两段式；独立脚本型（收盘小结/盘中预警/IPO）直接cron触发
显著优点
1. 全自动化闭环：从数据采集到企业微信推送无需人工干预，支持历史日期补跑（--date参数）
2. 多维度情绪量化：首创6因子情绪打分体系，将主观市场情绪转化为可追踪的0-100分数，支持5日趋势线对比
3. 数据源冗余设计：关键指标（如A50期货）设置3层fallback链，单一数据源故障不中断服务
4. 工程化成熟度：14段一致性护栏脚本（check_consistency.py）保障4端真相（templates/cron_mirror/jobs.json/SKILL.md）同步；6类任务独立锁文件防并发冲突
5. 安全最小权限：仅2个必需密钥（WECOM_WEBHOOK_KEY仅发送权限、IWENCAI_API_KEY只读查询），密钥白名单按脚本精准注入
6. 防幻觉机制：财经要闻段采用"任务定位"协议，明确区分"盘面数据"与"要闻"，模板内置反例前置
潜在缺点与局限性
1. 数据时效性约束：两融数据T+1滞后（收盘后1-2小时更新），周末版依赖历史MD文件无实时采集
2. LLM生成不可控：晨报/晚报/周末版的"财经要闻"和"操作建议"完全依赖LLM质量，存在幻觉风险（虽已加固）
3. 行情源稳定性：腾讯/新浪API偶发403或字段变更，需持续维护fallback链
4. A股市场局限：港股仅覆盖恒生指数，美股仅3大指数，缺乏个股级预警能力
5. 运维复杂度：14段护栏、4端一致性校验、版本累积规则（未发版≥5条必须发版）对使用者技术能力有要求
适合人群
- 量化交易者：需要系统化情绪指标与资金流向追踪
- 私募/券商运营：标准化投研报告输出，替代人工日报
- 个人投资者：定时获取结构化复盘，减少信息过载
- 技术开发团队：学习工程化Skill设计（护栏机制、版本管理、密钥隔离）
常规风险
- 市场风险：情绪打分基于历史数据，无法预测黑天鹅事件；AI后市展望仅供参考
- 数据风险：第三方API（问财/腾讯/新浪）服务变更可能导致数据缺失或延迟
- 推送风险：企业微信Webhook频率限制（未明确披露），高频盘中预警存在被限流可能
- 合规风险：自动生成的投资建议需标注"仅供参考，不构成投资建议"，使用者需确保符合当地监管要求