A-stock-report 是一套面向A股市场的数据驱动型报告自动生成与推送系统，核心功能覆盖晨报、收盘小结、晚报、盘中预警、IPO周报、财经周末版六大场景。系统采用dispatcher + templates + send 库三层架构，实现LLM驱动型任务与独立脚本型任务的分离调度。
核心用法
- 6类报告自动化：晨报/晚报/周末版由LLM生成（templates驱动），收盘小结/盘中预警/IPO周报由纯脚本执行（高频低延迟）
- 6维度情绪打分：涨停家数、涨跌停比、炸板率、主力净流入占比、换手率、IF基差等权映射至0-100分
- 多通道推送：企业微信Webhook为主通道，支持飞书/钉钉/邮件兜底
- 机械一致性护栏：v3.1.5+内置
check_consistency.py，4端校验（templates↔cron_mirror↔jobs.json↔SKILL.md）防配置漂移
显著优点
1. 工程化程度高：39文件/326KB，版本管理精细（v3.2.4累计22个迭代），每个版本≤18行changelog，细节外置knowledge/changelog/
2. 数据链路清晰：腾讯/东方财富/同花顺/Tushare多源聚合，字段名兼容写法处理API变更
3. 并发安全：fcntl文件锁+残留锁自愈机制，6个任务独立锁文件互不干扰
4. 可观测性强：退出码0/1/2语义明确，cron失败可被OpenClaw标记
潜在局限
1. 依赖外部API稳定性：问财/Tushare/akshare任一接口变更需补丁适配（历史多次字段名兼容修复）
2. 环境耦合较重：需预配.env密钥文件+Python依赖+skill级CLI工具（hithink-sector-selector）
3. LLM型任务延迟：晨报/晚报/周末版需两次文件中转（dispatcher写prompt→LLM读→写内容→脚本推送），不适合亚秒级场景
4. 盘中预警无LLM：每5分钟高频任务纯脚本驱动，无法生成自然语言解读
适合人群
- 量化私募/券商研究所：需要标准化日报产出、情绪指标追踪
- 个人高阶投资者：有Linux环境维护能力，需自动化替代手工复盘
- 多账户管理人：企业微信Webhook批量推送，降低重复劳动
常规风险
- 密钥泄露：
.env文件权限需严格管控（最小权限白名单设计） - 数据失真：两融/T-1数据日期标注易混淆，周末版需人工核对合并逻辑
- 推送失败静默：v3.1.1前
wx()无重试，网络抖动可能导致漏推 - 情绪打分黑盒：6因子映射公式未完全文档化，极端行情可能失真
安全等级评估
密钥管理采用环境变量注入+白名单最小权限原则，符合金融数据合规基线；无远程代码执行或反序列化风险。主要风险集中于外部API密钥的本地存储（.env文件），需配合文件系统权限管控。