A-stock-report 综合评估
核心用法
A-stock-report 是一套面向A股市场的数据驱动型报告自动生成与推送系统，支持6类定时报告场景：晨报、收盘小结、晚报、盘中预警、IPO周报、财经周末版。系统采用双轨执行架构：收盘小结/盘中预警/IPO周报为纯Python脚本独立运行；晨报/晚报/周末版采用两段式LLM驱动模式——先由dispatcher注入实时数据生成prompt，再由LLM生成内容并推送。
核心能力包括：
- 多维度数据采集：整合腾讯实时API、新浪hq、akshare开源库、同花顺i问财OpenAPI
- 量化情绪打分：6因子等权模型（涨停家数、涨跌停比、炸板率、主力净流入占比、换手率、IF基差），满分100分
- 自动化推送：企业微信Webhook集成，支持盘中5分钟级高频预警
- 历史数据复用：周末版自动合并本周收盘小结+晚报的MD文件生成情绪轨迹
显著优点
1. 工程化程度高：v3.5.2版本历经35+次迭代，建立了14段一致性护栏、3层fallback链、防并发锁机制
2. 数据源多元化：零密钥（腾讯/新浪/akshare）+ 授权API（问财）分层设计，降级策略完善
3. 安全设计严格：密钥白名单原则（每脚本仅加载必需变量）、环境变量注入（禁止硬编码）、进程内直连问财（避免subprocess泄露）
4. 可观测性强：check_consistency.py脚本实现4端真相校验（templates/cron_mirror/jobs.json/SKILL.md）
5. 容错机制成熟：问财API字段名同义词兼容、返回值类型不稳定的三重防御、UA伪装应对反爬
潜在缺点与局限性
1. 数据延迟敏感：两融数据滞后1-2个交易日；VIX/A50偶有HTTP 403需UA回退
2. LLM型任务依赖外部：晨报/晚报/周末版的"财经要闻"和"操作建议"区块若未配置cron则永久为空，非自洽系统
3. A股专属：港股/美股数据仅作外围参考，不生成独立报告
4. 维护复杂度高：6任务×2类执行模式×多数据源，需持续关注knowledge/decisions/中的踩坑记录
适合人群
- 量化投资者：需要结构化情绪指标（涨停家数、炸板率、主力流）辅助择时
- 机构运维团队：有Python环境+企业微信Webhook，能接受cron级调度
- A股日内交易者：依赖盘中5分钟预警和收盘即时的情绪打分
常规风险
- 数据源异常：问财API返回类型不稳定（str/int/float混用）可能导致成交额显示为0
- 并发推送：锁残留需手动清理，超1小时未释放需介入
- LLM幻觉：周末要闻4KB截断+反例前置护栏可降低但无法根除
- 密钥泄露：
.env文件路径需严格按v3.2.7修复的多路径回退机制配置
> 来源可信度：T2（同花顺/腾讯/新浪等商业数据商 + 开源akshare）
> 安全等级：A（密钥白名单+环境变量注入+锁机制+护栏脚本）