Financial Edu David

A股上市公司财务分析全流程工具包。覆盖年报采集、三表提取、指标计算、可视化看板、数据核对的全链路。用于对A股上市公司进行近3-5年财务经营状况综合分析，包括年报PDF下载（巨潮资讯网）、合并资产负债表/利润表/现金流量表提取（PDF→xlsx）、财务指标计算（偿债/营运/盈利/发展/现金流/杜邦分析）、ECharts动态可视化看板（HTML）及东方财富F10数据交叉核对。触发场景：(1) "分析XX公司财务状况""XX股票财务分析""XX年报分析"等财务分析需求 (2) "下载XX年报" (3) "生成财务可视化看板" (4) "核对XX财务数据"。

A股上市公司财务分析全流程

适用场景

对指定A股上市公司进行3-5年财务经营状况综合分析，覆盖从数据采集到可视化交付的完整链路。

前置条件

• Python 3.8+，安装依赖：pip install requests pdfplumber openpyxl
• 网络可访问 cninfo.com.cn、eastmoney.com、cdn.jsdelivr.net（或备选CDN）
• 工作目录有写权限

---

五阶段工作流程

严格按以下顺序执行，每阶段完成后确认数据正确性再进入下一阶段。

Phase 1: 年报采集

目标：从巨潮资讯网下载目标股票近N年（默认4年）年报PDF

步骤：

1. 确定股票代码（6位数字）、市场（sh/sz）、年份范围
2. 运行采集脚本：

   bash

   python scripts/fetch_annual_reports.py \
     --code {股票代码} --name "{股票名称}" \
     --years {起始年}-{结束年} --dir "{目标目录}" --market {sh|sz}
   

3. 若脚本因API变化失败，手动执行以下步骤：
   • 先查 orgId：GET https://www.cninfo.com.cn/new/information/topSearch/query?key={code}
   • 再查公告：POST https://www.cninfo.com.cn/new/hisAnnouncement/query（参数详见 cninfo_api.md）
   • 下载PDF：GET https://static.cninfo.com.cn/{adjunctUrl}
4. 验证：PDF文件大小 > 100KB，可正常打开

输出：目录下 N 份年报 PDF + 采集日志.json

Phase 2: 三表提取

目标：从PDF提取合并资产负债表、利润表、现金流量表 → xlsx

步骤：

1. 先用 pdfplumber 探测每份PDF中三张表所在页码（0索引）：

   python

   import pdfplumber
   with pdfplumber.open("年报.pdf") as pdf:
       for i, page in enumerate(pdf.pages):
           text = page.extract_text() or ""
           if "合并资产负债表" in text and "母公司" not in text:
               print(f"资产负债表在第{i}页")
           # 同理探测利润表、现金流量表
   

   重要：每张表可能跨2-3页，需确认起始页和结束页
2. 构建 pdf_config.json（格式见下方示例）
3. 运行提取脚本：

   bash

   python scripts/extract_financial_tables.py --dir "{目标目录}" --config pdf_config.json
   

4. 若出现科目名缺失（因PDF跨行拆分导致），需手动补全核心科目（资产总计、负债合计、营业收入、净利润等）

pdf_config.json 格式：

json

{
  "2022": {
    "file": "2023-04-21_公司名_2022年度报告.PDF",
    "balance_pages": [104, 105, 106],
    "income_pages": [108, 109, 110],
    "cash_pages": [111, 112, 113],
    "ann_id": "1216492757",
    "ann_url": "https://www.cninfo.com.cn/new/disclosure/detail?annoId=1216492757",
    "raw_url": "https://static.cninfo.com.cn/finalpage/2023-04-21/1216492757.PDF"
  }
}

PDF解析核心问题：

• 科目名跨行拆分（如"三、营业利润（亏损以"－"号填列）"可能分3行）：脚本使用 pending_subject 状态机处理
• 附注引用混入科目名（如"七、74"）：正则清理
• 即使处理仍有遗漏，需要以东方财富F10数据为基准补充核心科目

输出：每年一份 xlsx（3个sheet），文件命名：{股票名}_合并三表_{年份}年.xlsx

Phase 3: 财务分析

目标：计算完整的财务指标体系 + 杜邦分析

步骤：

1. 采集核心数据：从xlsx中提取30+个关键科目值，生成 _core_data.json
   • 必含科目：资产总计、负债合计、所有者权益合计、流动资产合计、流动负债合计、存货、货币资金、应收账款、固定资产、短期借款、长期借款、营业收入、营业成本、净利润、归母净利润、归母股东权益、利润总额、销售费用、管理费用、研发费用、财务费用、所得税费用、经营活动/投资活动/筹资活动现金流量净额、销售商品提供劳务收到的现金
   • 注意：单位从"元"转换为"亿元"
2. 逐项计算指标 → 生成 _metrics.json
   • 指标计算公式详见 metrics_guide.md
   • 杜邦分析：ROE = 净利率 × 总资产周转率 × 权益乘数
3. 对每个指标标注判定（好/中/差），判定标准参考 metrics_guide.md

输出：_core_data.json + _metrics.json

Phase 4: 可视化看板

目标：生成HTML格式的动态财务分析数据可视化看板

看板结构（必须包含以下全部模块）：

模块	内容	图表类型
页头	公司名、代码、年份、数据来源	静态HTML
核心结论	5条关键发现（好/中/差三色标注）	静态HTML
数据核对	与东方财富F10对比表	静态表格
指标一览	偿债/营运/盈利/发展 四类指标汇总	彩色标注表格
图表1	资产负债趋势	ECharts分组柱状图
图表2	营收与净利润趋势	ECharts多线图
图表3	经营/投资/筹资现金流	ECharts分组柱状图
图表4	盈利能力指标趋势	ECharts多线图
图表5	偿债能力指标趋势	ECharts多线图
图表6	营运能力指标	ECharts柱+线混合图
图表7	增长率指标	分组柱状图
图表8	费用率结构	堆叠柱状图
杜邦分析	ROE分解树形图（东方财富风格）	纯HTML+CSS
风险预警	高中低三类风险 + 改进建议	彩色卡片

技术规范：

• 使用 ECharts 5.x CDN（5个源自动回退）
• 所有数据内嵌在 <script> 中，无外部JSON依赖
• 使用 IIFE 封装避免全局变量污染
• 参考设计：generate_dashboard.py

杜邦分析实现：

• 纯 HTML+CSS（不用 ECharts graph），更接近东方财富F10风格
• 5层树形结构：ROE → 净利率/周转率/权益乘数 → 净利润÷营收 | 资产÷权益 → ...
• 支持年份切换
• 每个节点显示数值 + 运算符（× ÷ + −）
• 底部多列明细列表

Phase 5: 数据核对

目标：确保分析数据与官方公开数据一致

步骤：

1. 调用东方财富F10接口核对（详见 eastmoney_api.md）
2. 核心核对科目：资产总计、负债合计、所有者权益合计、经营/投资/筹资现金流净额（必须100%一致）
3. 利润表科目允许±5%误差（因PDF解析跨行问题）
4. 将核对结果写入看板的"数据核对"区
5. 若数据不一致，以东方财富F10为准修正 _core_data.json

---

关键注意事项

PDF解析常见陷阱

1. 科目名跨行：A股年报PDF中，部分科目名被排版引擎拆分为2-3行，需使用 pending_subject 状态机处理
2. 附注引用：科目名后常跟"七、74"等附注引用，需正则清理
3. 单位混淆：三张表单位均为"元"，分析时需转为"亿元"
4. 页码探测：三张表页码每年不同，必须逐份PDF人工或程序探测

数据模板

_core_data.json 示例结构：

json

{
  "2022": {
    "资产总计": 10309876543.21,
    "负债合计": 6615432109.87,
    "营业收入": 6165432109.87,
    ...
  }
}

_metrics.json 示例结构：

json

{
  "2022": {
    "流动比率": 0.65,
    "资产负债率%": 64.17,
    "销售毛利率%": 14.83,
    "ROE_归母%": 0.87,
    "杜邦ROE": 0.87,
    "杜邦净利率": 0.35,
    "杜邦总资产周转率": 0.60,
    "杜邦权益乘数": 3.47,
    ...
  }
}

参考文件

• cninfo_api.md — 巨潮资讯网API详细参数
• eastmoney_api.md — 东方财富F10核对接口
• metrics_guide.md — 财务指标计算公式与标准值

脚本文件

• scripts/fetch_annual_reports.py — 年报下载脚本（接受命令行参数）
• scripts/extract_financial_tables.py — PDF三表提取脚本（接受命令行参数）
• 可视化看板由AI直接生成HTML（参考 scripts/generate_dashboard.py 中的模式），不依赖独立脚本