kirkluokun Stock Research Group
股票研究工具集：业绩预期对比告警、券商研报搜索下载与 AI 解析、券商月度金股统计、机构调研检索、资产负债表查询与分析。
数据源
| 接口 | 说明 | 拉取方式 |
|---|---|---|
forecast_vip |
业绩预告 | period 按报告期全量 |
express_vip |
业绩快报 | period 按报告期全量 |
income_vip |
正式业绩 | period 按报告期全量 |
report_rc |
券商盈利预测 | start_date + end_date 按日期范围（支持分页） |
Period 自适应规则
ingest.py 根据当前日期自动计算 period，无需手动指定：
| 时间窗口 | 自动拉取的 period | 说明 |
|---|---|---|
| 1月1日 - 4月30日 | 上年1231 + 当年0331 |
年报 + Q1 披露季 |
| 5月1日 - 8月31日 | 当年0630 |
中报披露季 |
| 9月1日 - 10月31日 | 当年0930 |
Q3 披露季 |
| 11月1日 - 12月31日 | 当年1231 |
年报预披露期 |
示例：2026年2月3日自动拉取 20251231 + 20260331
模块索引
| 域 | 模块 | 关键词 | 说明 | 参考文档 |
|---|---|---|---|---|
| 财务分析 | 业绩监控 | 业绩预告/快报/超预期/符合预期 | 实际业绩 vs 券商预测，生成告警 | modules/fundamental/earnings.md |
| 财务分析 | 资产负债表 | 资产负债表/资产 | 拉取查询资产负债表数据 | modules/fundamental/balancesheet.md |
| 财务分析 | 财务指标 | 财务指标/ROE/ROA | 拉取查询财务指标数据 | modules/fundamental/fina_indicator.md |
| 财务分析 | 现金流量表 | 现金流量表/现金流 | 拉取查询现金流量表数据 | modules/fundamental/cashflow.md |
| 财务分析 | 主营业务构成 | 主营业务/产品构成/地区构成 | 按产品/地区/行业拆分主营收入 | modules/fundamental/fina_mainbz.md |
| 通用数据 | 券商研报 | 研报/解析/PDF | 搜索下载+Gemini提取观点 | modules/data/research_report.md |
| 通用数据 | 券商金股 | 金股/月度金股 | 拉取统计券商月度金股 | modules/data/broker_recommend.md |
| 通用数据 | 机构调研 | 机构调研/调研 | 按公司/机构/人员检索调研 | modules/data/stk_surv.md |
| 技术分析 | 技术面因子 | 技术面因子/MACD/KDJ/RSI/布林带/均线 | 日频261维因子，含前复权/后复权/不复权 | modules/technical/stk_factor_pro.md |
| 技术分析 | 神奇九转 | 神奇九转/九转序列/抄底/逃顶 | TD序列反转信号，日线+60min | modules/technical/stk_nineturn.md |
| 舆情分析 | — | 新闻/舆情/股吧 | TODO | modules/sentiment/_index.md |
全量数据刷新
full_sync.py 一次性拉取所有数据源并更新数据库。Period 自动计算，日志保存到 logs/full_sync_YYYYMMDD_HHMMSS.log。
cd stock-research-group
# 执行全量刷新（自动计算 period）
python full_sync.py
# 指定基准日期
python full_sync.py --date 20260208
# 预览步骤（不执行）
python full_sync.py --dry-run
步骤由 sync_registry.json 注册表驱动，新增模块只需在注册表追加条目，设 enabled: false 可跳过。
单步失败不阻塞后续执行，末尾输出汇总（成功/失败数、耗时）。VIP 步骤需 5000 积分。
操作约定
用户偏好：
- 当用户要求"读研报/读一下/解析"时，直接执行下载与解析流程，无需再次征求审批。