小白 / Xiaobai
开发者 · 产品构建者
持续构建 AI 工程系统、开发者工具与长期数字资产。
关于作者与 XBSTACK →
财报 PDF 表格解析实战:如何避免 AI 把收入、现金流和风险因素看错?
财报 PDF 表格解析实战:本文拆解 AI 财报助手中的财报 PDF 表格解析流程,包括文本抽取、表格识别、页码定位、单位保留、年份对齐、Chunk 切分、JSON Schema 输出 and 人工复核清单生成,重点解决大模型分析财报时的数字错位和风险遗漏问题。
本文解决的问题
在开发 AI 财报分析助手时,以下几个痛点经常会导致最终提取出的财务指标失真:
- PDF 里的多栏表格被解析成无序的纯文本,导致大模型读取数据时年份和科目张冠李戴。
- 财报中“单位:百万元”或“in thousands”的单位声明被 Chunk 裁剪掉,使得金额计算产生千倍、百万倍的级数误差。
- 脚注中的会计准则调整、非经常性损益说明被模型直接忽略。
- 风险因素段落被当做普通业务描述进行泛泛总结,遗漏了核心的诉讼、客户集中度等致命细节。
- 缺乏原文页码溯源,用户无法在发现异常数字时快速回到 PDF 相应页面进行二次核对。
适合谁读
- 正在开发 AI 投研系统、财报分析工具的全栈工程师或算法工程师。
- 希望将大模型落地于企业审计、风控、投后管理流程的技术决策者。
- 对 AI 财报提取精度有苛刻要求,容忍不了大模型胡说八道的独立开发者与投资人。
1. 财报 PDF 不是长文章,而是半结构化数据
财报 PDF 的底层逻辑不是供人类通读的排版文件,而是需要还原为关系型数据库的半结构化数据集。
我把屁股重重摔在工学椅上,右手摸到杯子里已经不冰了的冰美式,嘴里直犯苦。此时已经是晚上十点多,NAS 在走廊拐角柜子里发出低沉的嗡嗡声,像是催我下班。今天在调试 PDF 提取脚本的时候,终端直接蹦出个大大的报错:
UnicodeDecodeError: 'utf-8' codec can't decode byte 0xe2 in position 10: invalid continuation byte
排查了半天,才发现是一个加密财报 PDF 的字符编码集全乱了。很多做投研工具的兄弟们觉得把财报直接往向量数据库里一丢,或者塞进 Claude/GPT 这样的长文本模型里就大功告成了。结果用户一用就炸锅,AI 不是把前年的收入和今年的利润混在一起,就是把美元看成人民币,甚至把脚注里几千万的诉讼风险直接弄丢。
这是因为财报具有极其复杂的空间布局。一页财报可能上半部分是三栏的正文描述,中间夹着一个跨页的财务表格,底部还带着一堆六号字体的脚注。直接将 PDF 转换为纯文本会彻底破坏表格中横向的同行关联和纵向的同列关联。如果你的 AI系统直接去读取这样错乱的纯文本,它得到的不过是一堆失去上下文的孤立数字。
当前公开版只支持按股票代码查看行情、历史财务趋势和风险摘要;可打开 爱财报 AI 财报分析工具 先体验公开报告。本文中的 PDF 表格解析仍属于后续研发路线。
2. 财报 PDF 最容易出错的 5 个地方
财务表格中的行名列名错位是所有大模型在没有前置处理时必定会犯的低级错误。
根据我做 AI 财报助手的实战经验,大模型在面对原生 PDF 时,主要在以下五个地方遭遇滑铁卢:
一、表格列错位。有些公司财报的资产负债表是右侧是当期,左侧是上期,而有些公司则正好相反。如果文本提取器只是把数字按空格切分出来,大模型极易在计算同比增长率时读反年份。 二、年份和季度混淆。季度报告中的“本报告期”与“上年同期”字样往往出现在表格顶部的表头中。如果切片分块没有包含表头,模型根本无法判断 123,456 代表的是三季报的单季数据还是前三季度的累计数据。 三、单位丢失。这是最致命的幻觉来源。财报正文和表格通常在右上角有个极不起眼的“单位:千元”或“In millions of USD”。在长文本处理中,这种位于边缘的单位标志经常会在分词或 Chunk 阶段被裁剪掉,导致大模型抽取的营业收入直接缩水了三个到六个数量级。 四、脚注被忽略。财报表格下的星号注释或者小字脚注往往包含真实的债务结构、重大诉讼条款和关联交易细节。由于字体较小,传统 PDF 提取库很容易把脚注和下页的页脚混在一起,或者在分块时切断了脚注与主表的关联。 五、风险因素段落被普通正文吞掉。上市公司常常用长篇累牍的套话来隐藏核心风险。如果大模型只是做全局摘要,它会顺着上市公司的公关语气把所有诉讼、监管处罚以及供应链断裂风险一笔带过,总结成“公司面临一定的行业竞争风险”。
在调试 PDF-plumber 处理两栏嵌套表格的时候,因为没有加 explicit_horizontal_lines 限制,脚本直接报错崩溃:
IndexError: list index out of range
这正体现了 PDF 的物理排版与大模型的语义读取之间存在巨大的鸿沟。
3. 第一层处理:先区分文本块和表格块
文本块和表格块在预处理阶段必须通过版面分析实现物理分流。
为了保证数据的绝对准确,我们在读取财报 PDF 的第一步,绝不能使用简单的 pdfminer 全局导出。我们需要通过 PDF 库的空间坐标信息,将页面上的内容分类为正文块与表格块。
这里我推荐使用 layoutparser 或者 pdfplumber 的 Table Finder 功能。对于包含明显表格线框的页面,直接提取表格的行、列、单元格数据,转换成 Markdown 或 HTML 表格语法,再送给大模型。而对于无边框表格,则需要通过文本行之间的水平投影和垂直投影间距来重建表格边界。
以下是我在项目中用于分离并提取 PDF 页面中表格的 Python 核心代码实现:
import pdfplumber
def extract_structured_page(pdf_path, page_num):
with pdfplumber.open(pdf_path) as pdf:
page = pdf.pages[page_num]
# 1. 寻找页面上的所有表格
tables = page.find_tables()
table_objects = []
# 记录表格在页面上的边界坐标
table_bboxes = []
for table in tables:
table_bboxes.append(table.bbox) # (x0, top, x1, bottom)
# 提取单元格数据并转换为 Markdown 表格格式
table_data = table.extract()
markdown_table = format_to_markdown(table_data)
table_objects.append(markdown_table)
# 2. 提取除表格区域外的纯文本块
# 通过在页面中裁剪掉表格坐标框来获取干净的文本
clean_text_parts = []
last_bottom = 0
# 对表格边界按垂直高度排序
sorted_bboxes = sorted(table_bboxes, key=lambda x: x[1])
for bbox in sorted_bboxes:
# 提取表格上方的文本段落
top_box = (0, last_bottom, page.width, bbox[1])
cropped = page.crop(top_box)
text = cropped.extract_text()
if text:
clean_text_parts.append(text)
last_bottom = bbox[3]
# 提取最后一个表格下方的文本
bottom_box = (0, last_bottom, page.width, page.height)
cropped_bottom = page.crop(bottom_box)
text_bottom = cropped_bottom.extract_text()
if text_bottom:
clean_text_parts.append(text_bottom)
return {
"text_blocks": "\n\n".join(clean_text_parts),
"table_blocks": table_objects
}
def format_to_markdown(table_data):
if not table_data or not table_data[0]:
return ""
headers = [str(h).replace("\n", " ").strip() if h else "" for h in table_data[0]]
rows = []
for r in table_data[1:]:
rows.append([str(cell).replace("\n", " ").strip() if cell else "null" for cell in r])
md = "| " + " | ".join(headers) + " |\n"
md += "| " + " | ".join(["---"] * len(headers)) + " |\n"
for r in rows:
md += "| " + " | ".join(r) + " |\n"
return md
通过这套逻辑,表格被完好地保留成了拥有表头、行科目、具体数值的 Markdown 文本,彻底避免了由于左右分栏导致的文本折叠错位。
4. 第二层处理:按章节切分,而不是按固定字数切分
根据章节目录和财报特有的版面标题进行逻辑切分,是保证 Chunk 语义完整性的唯一解。
普通的 RAG 系统习惯用字符长度(比如 1000 字符,重叠 200 字符)来切分 PDF 文件。但在财报里,这样做会带来灾难。一个章节的表格可能刚好在第 990 个字符被切断,表格头被分在 Chunk A,表格体被分在 Chunk B,导致这两个 Chunk 在向量检索时都变成了残废数据。
正确的处理方式是按财报的物理章节目录进行逻辑切分。例如,管理层讨论与分析(MD&A)是一个独立的逻辑 Chunk,风险因素(Risk Factors)是另一个逻辑 Chunk,财务报表附注(Notes)又是一个。每一个逻辑 Chunk 都应当注入必要的元数据上下文。
来看看我设计的财报 Chunk 元数据架构,它确保了模型在读取任何片段时都有完整的上下文参照:
from pydantic import BaseModel, Field
from typing import List, Optional
class FinancialChunk(BaseModel):
chunk_id: str = Field(description="全局唯一标识符")
section_name: str = Field(description="所属章节,例如 Risk Factors 或 MD&A")
page_range: List[int] = Field(description="该 Chunk 对应 PDF 物理页码范围")
reporting_period: str = Field(description="报告期,例如 FY2025 或 Q3 2025")
company_name: str = Field(description="公司名称")
content_type: str = Field(description="内容类别:text 或 table")
raw_content: str = Field(description="干净的文本或 Markdown 表格内容")
units: Optional[str] = Field(default="RMB yuan", description="在提取表格时显式声明的金额单位")
在后续的向量召回或大模型直推中,这些元数据会被强制拼接到 Chunk 的头部,例如:“[Context: Company=Tesla, Period=FY2025, Section=Risk Factors, Page=45, Unit=USD in Millions]”,这样即便模型只读取一小段内容,也不会把单位和年份弄错。
还不了解工具定位,可以先看 我做了一个 AI 财报助手:如何用 AI 快速拆解财报、风险和管理层表述?。
如果你想直接测试 AI 财报助手,可一键跳转试用
支持 PDF 批量上传、管理层 Guidance 情绪审计、核心 KPI 指标抽取,免费免登录。
5. 第三层处理:表格字段标准化
所有原始提取的非标科目指标名称必须通过比对词表或 LLM 映射到标准化的财务字段中。
财报表格里科目的命名千奇百怪。有些公司写“营业总收入”,有些写“营业收入”,在英文中则是“Revenue”、“Total Revenue”、“Net Sales”等。如果不对这些字段进行标准化,大模型在输出财务分析时,无法对多份财报进行横向比对。
我们不应当允许模型在遇到缺失指标时自己瞎编数字。对于无法确定的字段,模型必须输出 null。这也是我做投研工具时的铁律:宁可缺省,也绝不能幻觉。
这里我们使用标准化的映射字典和类型声明来统一核心财务指标:
from typing import Optional
from pydantic import BaseModel, Field
class NormalizedFinancialData(BaseModel):
company_name: str = Field(description="上市公司标准全称或股票代码")
fiscal_year: str = Field(description="会计年度,格式为 FY+四位数字")
fiscal_period: str = Field(description="会计期间:FY, H1, Q1, Q2, Q3")
currency: str = Field(description="货币单位,例如 CNY, USD, EUR")
# 核心利润表指标
revenue: Optional[float] = Field(default=None, description="营业收入,单位归一化为元,缺失输出 null")
gross_profit: Optional[float] = Field(default=None, description="毛利润,单位归一化为元")
operating_income: Optional[float] = Field(default=None, description="营业利润,单位归一化为元")
net_income: Optional[float] = Field(default=None, description="归属于母公司股东的净利润")
# 核心现金流量表指标
operating_cash_flow: Optional[float] = Field(default=None, description="经营活动产生的现金流量净额")
capital_expenditure: Optional[float] = Field(default=None, description="资本开支,即构建固定资产、无形资产和其他长期资产支付的现金")
free_cash_flow: Optional[float] = Field(default=None, description="自由现金流,计算公式为经营现金流减去资本开支")
# 核心资产负债表指标
total_assets: Optional[float] = Field(default=None, description="资产总额")
total_liabilities: Optional[float] = Field(default=None, description="负债总额")
cash_and_equivalents: Optional[float] = Field(default=None, description="期末现金及现金等价物余额")
short_term_debt: Optional[float] = Field(default=None, description="短期借款及一年内到期的非流动负债")
long_term_debt: Optional[float] = Field(default=None, description="长期借款及应付债券")
我们在让模型抽取时,会强制指定这一套 Schema。
6. 第四层处理:用 JSON Schema 限制大模型输出
用 JSON Schema 约束大模型输出,是降低格式漂移、让财报抽取结果可被程序校验的重要手段,但 Schema 合规不等于事实正确。如果需要完整的字段设计,包括 source_page、source_text、confidence、null_reason 和人工复核字段,见 LLM JSON Schema 财报结构化抽取。
很多程序员写 Prompt 时,喜欢用自然语言写一句“请以 JSON 格式输出上述财务数据”。然而在这种宽松的口头要求下,大模型可能会在输出中包含 markdown 代码块、多余解释文字,甚至在字段提取失败时猜测数值。
在生产环境中,优先使用 Provider 支持的 Structured Outputs / JSON Schema 模式,并在应用层再次做 Schema Validation。Schema 可以把 revenue 限制为 number | null,但它不能证明抽取出的数字与原始财报一致,因此还需要证据字段、来源页码和人工复核。
以下是我编写的基于 JSON Schema 的抽取提示词模板和大模型调用参数配置:
import json
from openai import OpenAI
client = OpenAI()
def extract_financials_with_schema(chunk_content: str) -> dict:
prompt = """你是一个高精度的财务数据提取器。
请从以下财报 Chunk 文本中提取各项指标。
必须遵守的铁律:
1. 仔细核对单位(万元、千元、百万元、亿元),必须全部换算为元(RMB)或者美元(USD)的原始基数。
2. 仔细区分年份。如果文本中同时出现 2024 年和 2025 年数据,必须准确对齐到 schema 中对应的年份字段。
3. 如果财报文本中没有提及某个指标,或者你无法以 100% 的信心确认该数字,必须在 schema 中该指标对应的位置填入 null。
4. 绝对不允许基于你自己的常识或计算来虚构任何数字。
5. 每一个数字的提取,都必须在 evidence 字段中给出原文包含该数字的完整句子。
"""
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "system", "content": prompt},
{"role": "user", "content": f"需要提取的财报文本如下:\n\n{chunk_content}"}
],
response_format={
"type": "json_schema",
"json_schema": {
"name": "financial_extraction_schema",
"strict": True,
"schema": {
"type": "object",
"properties": {
"company": {"type": "string"},
"fiscal_year": {"type": "string"},
"revenue": {"type": ["number", "null"]},
"revenue_evidence": {"type": "string"},
"operating_cash_flow": {"type": ["number", "null"]},
"operating_cash_flow_evidence": {"type": "string"},
"free_cash_flow": {"type": ["number", "null"]},
"free_cash_flow_evidence": {"type": "string"},
"total_debt": {"type": ["number", "null"]},
"total_debt_evidence": {"type": "string"}
},
"required": [
"company", "fiscal_year", "revenue", "revenue_evidence",
"operating_cash_flow", "operating_cash_flow_evidence",
"free_cash_flow", "free_cash_flow_evidence",
"total_debt", "total_debt_evidence"
],
"additionalProperties": False
}
}
}
)
return json.loads(response.choices[0].message.content)
这种 Schema 提取方式,不仅锁死了输出格式,还通过 _evidence 字段强迫模型必须输出它做决策的原文依据。如果模型无法提供对应的原文句子,它就不能胡乱填数字。
需要完整使用流程,可以看 用 AI 分析财报的 7 个步骤:从 PDF 到风险检查清单。
7. 第五层处理:风险因素不能只做摘要
对风险因素进行多维度的结构化属性标记,能有效防止核心爆雷风险被模型的公关腔总结稀释。
财报正文里的“风险因素”章节,往往是上市公司公关部门和法务部门博弈的战场。他们会用极其隐晦、平淡的陈述句来描述可能对公司股价造成致命打击的隐患。比如“由于部分客户采购预算调整,公司对第一大客户的销售收入可能存在波动风险”,这其实是在暗示公司的最大客户已经开始砍单。
如果我们只让模型做简单的摘要,它会输出一堆废话:“公司对第一大客户保持密切合作,未来可能会有波动。”
正确的做法是,我们要对风险进行分类打标,并抽取 Severity(严重程度)、Nature(风险本质)以及相比上一年的 Change Status(变化状态:新增、加重、维持)。
下面是我们在后台用于结构化抽取风险清单的 JSON Schema 设计:
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"title": "StructuredRiskFactors",
"type": "object",
"properties": {
"company_name": {
"type": "string"
},
"risk_list": {
"type": "array",
"items": {
"type": "object",
"properties": {
"risk_type": {
"type": "string",
"enum": [
"customer_concentration",
"supply_chain_disruption",
"regulatory_compliance",
"currency_fluctuation",
"litigation_and_arbitration",
"inventory_impairment",
"liquidity_debt_crisis",
"goodwill_impairment",
"margin_erosion",
"demand_slowdown"
]
},
"severity": {
"type": "string",
"enum": ["critical", "medium", "low"]
},
"risk_summary": {
"type": "string",
"description": "去除公关词汇后的硬核事实性总结,要求不超过 100 字"
},
"evidence": {
"type": "string",
"description": "原文中能支撑此判断的句子,直接摘录"
},
"status": {
"type": "string",
"enum": ["newly_added", "aggravated", "stable"]
},
"source_page": {
"type": "integer"
}
},
"required": ["risk_type", "severity", "risk_summary", "evidence", "status", "source_page"],
"additionalProperties": false
}
}
},
"required": ["company_name", "risk_list"],
"additionalProperties": false
}
通过这种定义,我们在 AI 财报助手的分析界面上,就能实现按照“客户集中度”、“商誉减值”、“存货爆仓”等核心风险类别进行可视化筛选,帮助分析师一目了然地看到本期最危险的新增变量。
8. 第六层处理:最后输出复核清单,而不是投资结论
AI 辅助投研工具的技术底线是向用户提供可证伪的数字复核线索,而不是越过合规边界去生成投资建议。
大模型最危险的冲动就是喜欢给人当导师。如果在财报分析 Prompt 结尾不加限制,它经常会自作聪明地输出一段充满空话的结论报告:“由于该公司自由现金流状况良好,我建议投资者积极买入。”
这种言论不仅在法律合规上面临巨大的诉讼风险,更是把大模型脆弱的反思逻辑交给了极其不可靠的概率采样。AI 财报助手真正的价值在于把厚达数百页的 PDF 财报压缩成一张精炼的“人工复核清单”(Checklist)。
这套清单应当根据刚才抽取的标准化指标,自动匹配并暴露异常的逻辑关系。
这里是我们后台触发生成的人工复核清单经典问答集:
一、收入与现金流对齐复核:本期营业收入同比增长了 25%,但经营性现金流量净额却下降了 12%,这是否意味着公司主要通过压货给渠道商来虚增本期的营收?需要人工去核对资产负债表里的应收账款和存货余额。 二、毛利率与行业趋势复核:公司整体毛利率环比提升了 3 个百分点,但这是否与主营原材料价格暴涨的行业背景相悖?需要去附注中核对存货跌价准备和成本构成细节。 三、新出现的合规风险:风险因素章节中,公司首次加入了“新环保法规导致产能受限”的条款,这是否会对下半年的主打工厂带来减产风险? 四、管理层指引变化:相比于上一季度展望,本期 MD&A 中管理层删除了“全年保持两位数增长”的表述,是否意味着公司暗中下调了未来的业绩预期?
将这些异常点以待办事项的形式呈现给分析师,比让 AI 生成一段充满空话的结论报告要有价值得多。
9. 物理切割 vs 逻辑切割对比分析
让我们来看一下这两种不同切分路径在财报解析实战中的对比。以下是具体的对比维度:
| 对比维度 | 物理切割(固定字数) | 逻辑切割(章节语义) |
|---|---|---|
| 表格完整性 | 极差,数据经常在行单元格处被拦腰截断,导致解析失效 | 极佳,整个表格及前后的表头单位均被完整包裹在同一 Chunk 内 |
| 跨页脚注关联 | 彻底丢失,脚注被孤立在下一个 Chunk 中,失去主表参照 | 良好,通过位置算法将物理页面底部的脚注主动拼接到所属表格底部 |
| 向量召回率 | 较低,由于文本中夹杂无意义词汇,经常检索到垃圾片段 | 极高,每个 Chunk 都有明确的 Section 属性,支持精确分类召回 |
| 模型抽取耗时 | 较高,需要模型读取大量冗余的重叠字符,浪费 Token | 较低,每一个分块都是高密度的信息段落,去除了大量空行和噪点 |
| 幻觉发生率 | 频繁,模型容易因为上下文缺失而瞎编表格里错位的数字 | 极低,模型在 Schema 和 Evidence 约束下,对缺失信息只输出 null |
10. FAQ
为什么财报 PDF 不能直接丢给大模型?
因为财报 PDF 包含复杂的表格、脚注、页码、单位、年份和风险因素,直接输入大模型容易出现表格错位、单位丢失、数字混淆和幻觉输出。
AI 如何正确解析财报 PDF?
正确流程是先抽取文本和表格,再按财报章节切分内容,保留页码、单位和年份,最后通过 JSON Schema 约束大模型输出结构化指标和风险检查清单。
AI 财报分析最容易出错的地方是什么?
最容易出错的是财务表格,包括年份列错位、单位丢失、现金流和利润字段混淆,以及脚注中的会计口径被遗漏。
为什么 AI 财报分析需要 JSON Schema?
JSON Schema 可以限制大模型输出字段,减少自由发挥,让收入、利润、现金流、风险因素和复核问题以稳定结构返回。
AI 财报助手能不能直接给投资建议?
不能。AI 财报助手只能做信息压缩、结构化抽取和风险复核清单生成,不能预测股价,也不应该直接给买卖建议。
11. 继续阅读
- 想要直接体验这一套完整方案的效果,可以打开 AI Financial Report Analyzer:AI 财报助手。
- 如果需要完整的 AI Agent 架构知识,可以参考 AI Agent 完整指南:从概念到多 Agent 协同系统架构开发。
- 还不了解我的工具设计初衷,可以先看 我做了一个 AI 财报助手:如何用 AI 快速拆解财报、风险和管理层表述?。
- 想要了解具体怎么上手配置,可以看 用 AI 分析财报的 7 个步骤:从 PDF 到风险检查清单。
- 需要理解整体架构的朋友,可以继续看 AI 财报助手技术实现:如何把财报 PDF 拆成结构化风险检查清单?。
- 后续如果要让 AI Agent 读你本地的财报文件库,可以参考 MCP 如何让 AI Agent 访问本地数据和私有工具。
- 要把财报分析做成自动化任务流,可以参考 AI Workflow 自动化任务处理方法。
准备好分析你的第一份财报了吗?
你可以立刻上传一份 PDF 财报(如 NVIDIA 10-K),体验本工具自动生成的核心 KPI 报表、风险因素和复核清单。
把这篇文章里的财报抽取逻辑,放进爱财报工具里跑一遍
AI 财报文章统一导向工具页:上传财报、查看 JSON Schema、source_page、evidence 字段和人工复核流程。该工具只做信息压缩和结构化分析,不构成投资建议。
继续阅读
返回专题 →AI 工程周报
只发真正改变工程判断的变化、故障、实验和新资产。
参与讨论
问题、验证与勘误
登录后可发表评论。所有新评论先进入审核;审核期间仅评论者本人和管理员可见,通过后才公开。