核心功能
A-stock-report 是一套数据驱动型A股自动化报告系统,覆盖交易日全时段:晨报(开盘前)、收盘小结(收盘后15:30)、晚报(晚间)、盘中预警(每5分钟)、IPO周报(周六)、财经周末版(周日)。核心亮点是6维度量化情绪打分系统(满分100),综合涨停家数、涨跌停比、炸板率、主力净流入、换手率、IF基差等指标,输出可视化的市场情绪温度计。
显著优点
架构成熟度高:历经v2.0.0~v3.3.1持续迭代,文档与代码同步维护,配备4端一致性护栏脚本(check_consistency.py),杜绝配置漂移。数据链路完整,覆盖腾讯实时行情、akshare、同花顺问财、Tushare等多源异构数据,带自动降级与缺失占位机制(如A50/HSI偶发403时显示"❌数据缺失"而非编造)。
工程化细节扎实:独立锁文件防并发重复推送,密钥白名单原则(每脚本仅加载必需env变量),.env多路径回退,残留锁自愈机制。LLM驱动型任务(晨报/晚报/周末)采用模板外置+dispatcher注入架构,cron配置镜像化(cron_mirror.json),人机可读分离。
v3.3.0核心升级:针对"财经要闻"段曾混入盘面数据的痛点,引入任务定位协议——强制至少4/7条为事件型新闻(政策/公告/海外央行/行业事件),禁止指数/估值/资金/策略类内容冒充要闻,并约束来源标注与依据长度≤50字符,显著提升了报告可读性与信息纯度。
潜在局限
数据源依赖风险:核心数据来自第三方免费/半开放接口(腾讯、东方财富、同花顺),无SLA保障;A50期货、恒生指数偶发HTTP 403,虽已有fallback仍可能影响实时性。问财API字段名兼容问题(如"炸板家数"vs"涨停开板家数")需持续维护。
LLM生成不可控:晨报/晚报/周末版的"财经要闻""操作建议"等段落依赖LLM生成,虽有prompt层协议约束(v3.3.0),但无硬校验层(v3.1.3风格SystemExit被放弃),存在风格漂移或信息滞后风险。两融数据天然T-1延迟,需用户理解数据时效性。
运维门槛:需要维护7个定时任务、4个API密钥、多路径.env配置,对非技术用户有一定上手成本。历史数据回溯依赖本地MD文件归档,无集中数据库。
适合人群
- 个人投资者/小团队:需要自动化、结构化市场复盘,减少信息搜集成本
- 量化策略辅助:情绪打分可作为策略信号输入,但需自行验证因子的有效性
- 财经自媒体/社群运营:定时推送标准化报告,降低内容生产成本
常规风险
合规风险:自动推送至企业微信需用户明确授权(配置WECOM_WEBHOOK_KEY即视为授权),报告含"仅供参考,不构成投资建议"免责声明,但AI生成的操作建议仍存在合规模糊地带。
数据安全:密钥通过环境变量注入,禁止硬编码,但.env文件权限管理依赖用户自律;问财API直连模式下无额外加密传输说明。
系统稳定性:高频盘中预警(每5分钟)无LLM介入设计正确,但依赖网络与外部接口稳定性,极端行情下数据源延迟可能影响预警时效。