爱建证券财务报表解读助手

概述

📑 AI 财务数据解读工具

由「爱建证券财务报表解读助手」改造的仅对客版本：默认产出面向互联网/客户的数据解读工具页——不包含"证券研究报告"字样、证券公司品牌、署名、发布前审核、利益冲突披露等研报要素，只呈现财务数据事实与指标偏离提示。

若内部投研或正式研报发布需要研报形态内容，请走公司研报流程，不在本技能范围内。

环境准备

# 零第三方依赖，仅需 Python 3 标准库
python scripts/fetch_statements.py 600048 --industry 房地产 --latest   # 取数 -> JSON
python scripts/interpret.py statements_600048_SH.json                  # 解读 -> HTML
python tests/selftest.py                                               # 自检（48 项）

何时使用

• 拿到一家公司的三表数据，需要快速读懂"赚不赚钱、家底厚不厚、钱真不真"。
• 校验财务数据质量，定位潜在失真或雷区（应收、存货、商誉、现金流）。
• 做横向/纵向财务对比前的比率标准化。
• 配合 aijian-stock-analysis（个股基本面）与 aijian-morning-brief（早报）使用。

核心理念：三表交叉验证，比率说话，指标提示；先选对行业口径，再看偏离，只陈述数据不下导购结论。

🚨 硬性约束（必须遵守，违反即视为无效输出）

数据真实性

1. 禁止编造任何财务数据。 取数失败必须显式报错并终止流程，不得用示例数据、占位值或"合理估计"填充。
2. 缺失科目一律显示 —，禁止填 0 或插值。 引擎已保证此行为，不得人工改写。
3. 禁止跨口径混用：periods 中不得同时出现年报与中报/季报（如 ["2024A","2025H1"]）。

纵向对比必须同口径；如需看最新进展，单独取该期做补充说明，不并入趋势表。

1. 数据以巨潮资讯网披露的定期报告原文为准；使用第三方接口（东财/新浪等）须在 sources 中标注来源与取数日期。

行业口径

1. 必须指定 company.industry。 地产/金融/周期股未指定时引擎会报 WARN，此时不得输出结论——

通用阈值会对这些行业产生大量噪音红旗（详见 references/industry_adaptation.md 第一节实战教训）。

1. 金融业（银行/券商/保险）必须显式声明：本引擎不覆盖不良率、拨备覆盖率、资本充足率、净息差、

偿付能力充足率等监管口径指标，结论不完整；不得用通用财务比率代替。

输出纪律

1. 不得把指标偏离翻译成买卖结论。 每条提示必须给出"可能原因 + 补充数据说明"（引擎已内置 verify 字段）。
2. 禁止在报告与对话中使用评级词汇：买入/卖出/增持/减持/目标价/推荐/建仓等一律不得出现。
3. 校验不通过必须披露：validate() 返回的 ERROR（长度错位、会计恒等式不平、报告期重复）

会在报告页脚红字显示，不得删除或隐藏。

1. 报告必须包含风险免责声明与数据来源溯源；示例数据须标注"演示用"。
2. 比率与增速由脚本计算，禁止心算。 所有除法、YoY、CAGR 一律交给 interpret.py。
3. 输出形态（仅对客）：交付物为对客数据解读工具页——不得出现"证券研究报告/研究报告/仅供研究参考"等研报措辞，不出证券公司品牌落款，不设署名、发布前审核、利益冲突披露等研报要素；指标偏离提示不得改写为买卖、评级、操作建议。
4. 结论与提示必须一致：「数据要点速览」的偏离计数必须统计全部「关键指标提示」（高/中/低），不得只按严重度过滤——否则会出现"未发现明显偏离"与多条中/低级提示并存的矛盾（实战已踩坑，引擎已修复，人工不得改回"只报高危"）。
5. 技能包卫生：公司私有取数 JSON、带研报措辞的示例页等一律不得写入技能包目录；取数产出放在工作区。曾发现技能目录内残留 statements_xxxxxxxx_xxx.json（旧研报式免责）与旧示例页"仅供研究参考"，均已清理。
6. 构建环境注意：不要在 bash 里用 sed 修改含 HTML 实体（&#...;）的 Python 串——& 会被 sed 当特殊字符破坏内容；改脚本用编辑器直改/整体覆写，改完必须重跑 tests/selftest.py。

一、工作流（Workflow）

1. 定行业：先确认公司所属行业，映射到 通用 / 房地产 / 金融 / 周期 / 高研发

（别名见 references/industry_adaptation.md）。这一步不能跳。

1. 取数（按可用性排序）：
   • 首选：scripts/fetch_statements.py（东方财富 F10 公开接口，零依赖，已实战验证）→

直接产出引擎输入 JSON，自动转换单位为百万元、自动报告缺失科目。

• 爱建证券研究终端 / Wind / iFinD：导出标准三表后手工填 JSON。
• 巨潮资讯 / 公司年报 PDF：手工摘录（优先年报，含分部与附注）。
• ⚠️ westock-mcp、akshare 等通道在部分环境下不可用；若 MCP 未连接，直接用取数脚本，不要干等。
• 数据基准期 = 最近一期已披露年报；纵向对比用同口径。

1. 填 JSON：按 examples/sample.json 结构组织，三表各科目数组与 periods 严格对齐；单位统一（百万元）。
2. 跑引擎：python scripts/interpret.py <statements.json> [--output out.html]。
   • 引擎自动校验（对齐/恒等式/行业），自动计算比率、趋势、杜邦、指标偏离，注入模板生成 HTML。
   • 控制台会打印 ERROR / WARNING，须逐条处理后再交付。
3. 校验与解读：数据页中指标提示按偏离程度排序，每条带"补充数据说明"。
4. 交付：对客数据解读工具页 HTML + 对话内数据要点；含对客免责、数据来源与数据口径声明，不含研报要素。

# 完整示例（房地产）
python scripts/fetch_statements.py 600048 --industry 房地产 --years 4 --latest
python scripts/interpret.py statements_600048_SH.json --output 保利发展.html

二、输入数据结构

顶层：company（含 industry）+ periods（报告期列表）+ 三表对象 + 可选 notes/sources/risk_disclaimer。

{
  "company": {"name": "保利发展", "ticker": "600048.SH", "industry": "房地产"},
  "periods": ["2022A", "2023A", "2024A", "2025A"],
  "income_statement": {
    "营业收入": [281016.7, 346828.13, 311666.32, 308144.19],
    "营业成本": [219228.01, 291308.02, 268259.82, 268856.98],
    "营业利润": [34600, 24300, 15300, 9600],
    "归母净利润": [18320.16, 12067.16, 5001.18, 1034.7],
    "利息费用": [5200, 5100, 4900, 4700]
  },
  "balance_sheet": {
    "总资产": [1471352.97, 1436911.79, 1335108.02, 1188916.72],
    "负债合计": [1149203.86, 1099885.15, 992578.19, 858784.77],
    "归母权益": [196227.61, 198543.1, 197596.49, 192946.8],
    "存货": [877893.19, 869508.46, 798559.42, 668174.93],
    "合同负债": [412019.29, 377215.01, 334482.05, 246331.62],
    "商誉": [66.82, 65.92, 65.92, 66.89]
  },
  "cash_flow": {
    "经营活动现金流净额": [7422.38, 13930.01, 6257.31, 15189.15],
    "购建固定资产无形资产和其他长期资产支付的现金": [186.19, 179.32, 179.47, 487.46]
  }
}

字段名支持常见别名（如 营业收入/营收、合同负债/预收款项、购建固定资产无形资产和其他长期资产支付的现金/资本开支）。

地产分析务必带上 合同负债 —— 它是销售蓄水池，缺了就检测不到"未来收入承压"这条关键领先信号。

三、解读维度（引擎自动计算）

四、关键指标提示（对客措辞）

引擎内部沿用红旗检测逻辑，对客渲染统一命名为"关键指标提示（偏离参考阈值部分）"，严重度显示 高/中/低，附"补充数据说明"。

通用阈值（阈值按行业调整）

• 高：应收增速持续快于营收；净利润现金含量不足（净现比<0.6）；利润与现金流背离；

商誉/净资产>30%；利息保障<阈值；经营现金流持续为负；净负债率>100%；现金短债比<1×。

• 中：存货/营收超行业阈值；其他应收款/总资产异常；资产负债率超行业阈值；流动比率偏低；

长期盈利含金量低；净负债率 70~100%；现金短债比 1.0~1.5×；合同负债连续 3 期下滑>15%；扣非/归母<70%。

行业专属

每条提示含可能原因 + 补充数据说明。完整阈值表见 references/industry_adaptation.md，提示清单见 references/red_flags.md。

五、目录结构

aijian-financial-statements/
├── SKILL.md                         # 技能主体
├── _meta.json                       # 元数据
├── README.md                        # 部署与说明
├── requirements.txt                 # 依赖（零依赖，仅标准库）
├── references/
│   ├── statement_framework.md       # 三表解读框架
│   ├── ratios_reference.md          # 比率公式与阈值
│   ├── red_flags.md                 # 异常红旗清单
│   └── industry_adaptation.md       # 行业阈值表与专属指标 ★v1.1
├── scripts/
│   ├── interpret.py                 # 零依赖解读引擎（行业适配 + 校验 + 渲染）★v1.1
│   └── fetch_statements.py          # 东财 F10 取数 -> 引擎输入 JSON ★v1.1
├── assets/
│   └── report_template.html         # 爱建蓝 HTML 模板
├── examples/
│   └── sample.json                  # 样例数据（演示用）
└── tests/
    └── selftest.py                  # 引擎自检（48 项）

六、与兄弟技能联动

• aijian-stock-analysis：个股基本面/复盘/组合批量复盘（本技能可作为其财务模块）。
• aijian-etf-rotation：ETF 轮动选基。
• aijian-morning-brief：投资早报（可引用本技能结论做个股财务速览）。

七、版本记录

v1.2.0（对客化改造）

• 默认输出改为「AI 财务数据解读工具」对客形态：移除"爱建证券"品牌与研报标题/落款，删除证券研究报告字样、署名、发布前审核、利益冲突披露等研报要素；
• 渲染措辞对客化：跳"红旗预警"→"关键指标提示（偏离参考阈值部分）"、HIGH/MID/LOW→高/中/低、"需进一步核实"→"补充数据说明"、"解读结论与关注点"→"数据要点速览"（结论改写为客观数据陈述，无评价/导向措辞）、页脚免责改对客工具话术、落款与 CLI 描述中性化；
• selftest 新增「HTML 无研报要素」断言；示例数据 disclaimer 对客化；
• 结论一致性修复：「数据要点速览」改统计全部偏离指标（原只统计 high，会出现"未发现明显偏离"与中/低级提示并存的自相矛盾）；
• 包级一致性收尾：frontmatter 与 _meta.json/_skillhub_meta.json 版本统一为 1.2.0；requirements.txt/README 重写为对客版；references 术语说明与笔误修订；删除技能目录残留的公司私有取数 JSON；示例页替换为对客版（移除旧研报措辞）；自检 47→48 项；
• 一份数据只产出对客版；内部投研/正式研报发布另行走公司研报流程（研报形态的修复/后处理脚本已从技能移除）。

v1.1.0（实战复盘后）

• 新增行业适配层：5 档阈值（通用/房地产/金融/周期/高研发），消除地产/金融噪音红旗
• 新增专属指标与红旗：净负债率、现金短债比、合同负债蓄水池、扣非依赖度
• 新增取数脚本 fetch_statements.py（东财 F10，零依赖，已验证）
• 每条红旗新增"需进一步核实项"
• 修复：首期 YoY 因 [i-1] 负索引绕到末期，产出 1670% 假同比
• 修复：CAGR 在多期表格中重复填充同一数值
• 修复：报告生成时间硬编码为 —
• 修复：缺失「营业成本」时 rev - None 崩溃（金融业必现，已加 safe_sub）
• 修复：金融档负债率阈值 92% 会把银行常态 90~93% 误报，放宽至 95%
• 取数脚本新增报表套系自动探测（G 通用 / B 银行 / S 证券 / I 保险），

三表全部取到才算匹配——只验利润表会把银行股误判为通用套系

• 强化 validate()：长度对齐、会计恒等式、报告期重复、缺失行业
• 新增硬性约束章节（数据真实性 / 行业口径 / 输出纪律）
• 自检从 15 项扩充至 47 项（含上述全部 bug 的回归用例）