财报透视(四):20 项指标、三条勾稽,只陈列不评价的异常项
v0.4.0 的指标卡上,有一张写着「加权平均净资产收益率」。
数字是算出来的,公式也是对的:归母净利润除以平均所有者权益。只是这个公式既不是「加权平均」,分母也不对。年报里披露的加权平均 ROE 要按月份加权计算期间的权益变动,这个项目根本没算;分母用的「所有者权益」还包含了少数股东的那一份,分子却只是归属于母公司的利润。
这个名不副实的标签在页面上挂了几天,直到我写这个系列时对照代码才发现,v0.4.1 改成了「净资产收益率(ROE)」,分母换成平均归母权益。
指标这一层,最难的不是算,是说清楚算的是什么。
你在这里
上传年报 → 三表定位 → 表格还原 → 数值归一 → 科目对齐 → 指标计算 → 勾稽与异常 → 呈现
一、20 项指标:一张注册表
20 项指标的定义集中在一个文件里,每项一行:代码、名称、单位、依赖的科目、口径文本。
MetricDef(
"roe",
"净资产收益率(ROE)",
"%",
("net_profit_attributable", "equity_attributable_holders"),
"归母净利润 ÷ 平均归属于母公司所有者权益 × 100",
),src/metrics/registry.py#L40-L46
口径文本不只是注释:点开指标的「溯源」,浮层里显示的「计算口径」就是这一行字。所以页面上说的和代码算的,至少出自同一个地方。
但「同一个地方」不等于「一致」。口径文本是手写的字符串,公式是另一段代码,两者之间没有任何机制保证对得上。ROE 那次出错,就是字符串和代码各说各话。v0.4.1 补了一条单测,断言 ROE 的名称里没有「加权」、依赖科目和口径文本互相对应。这条单测防得住 ROE 这一项,防不住下一项。更彻底的做法是让口径文本从依赖科目生成,这件事还没做。
20 项里大部分是直接取数(营业收入、扣非净利润、经营现金流、应收账款……),算出来的有这些:
| 指标 | 公式 |
|---|---|
| 毛利率 | (营业总收入 − 营业成本)÷ 营业总收入 |
| 净利率 | 净利润 ÷ 营业总收入 |
| ROE | 归母净利润 ÷ 平均归母权益 |
| ROA | 净利润 ÷ 平均总资产 |
| 现金含量 | 经营现金流 ÷ 净利润 |
| 应收 / 存货周转天数 | 365 ÷(营业总收入 或 营业成本 ÷ 平均余额) |
| 资产负债率 | 负债合计 ÷ 资产总计 |
| 三费占收入比 | (销售 + 管理 + 财务费用)÷ 营业总收入 |
| 营收增速、扣非增速 | (本期 − 上期)÷ |上期| |
「平均」用的是同一份年报里的本期和上期比较列。所以单期会话也能算 ROE 和周转天数,不用等第二份年报。
增速的「不适用」
增速公式最容易出荒唐数字的地方是基期:
def _growth(current: Decimal | None, previous: Decimal | None) -> tuple[Decimal | None, str | None]:
if current is None or previous is None:
return None, "基期数据缺失"
if previous == 0 or previous < 0:
return None, "不适用(基期为 0 或负)"
return (current - previous) / abs(previous) * 100, Nonesrc/metrics/compute.py#L176-L181
上期亏 1 亿、本期赚 1 亿,按公式增速是 +200%;上期亏 1 亿、本期亏 3 亿,增速是 -200%。两个数字都「算对了」,都毫无意义。所以基期为 0 或负数,一律显示「不适用」。评测集 10 份年报里,有 2 份的扣非增速就是这么显示的。
二、缺项怎么判:初代版本栽在这里
指标依赖的科目缺了,显示「原文未披露」并列出缺的是哪几个科目,绝不补 0。规则是这样写的:
for metric in METRICS:
missing_codes = [code for code in metric.requires if not present(code)]
missing: str | None = (
None if not missing_codes else "原文未披露:" + "、".join(missing_codes)
)src/metrics/compute.py#L202-L206
依赖的科目有一个缺,整项就不算。这条规则对大多数指标是对的,毛利率缺了营业成本当然不能算。但在评测集上一跑,它让两类指标成片消失:
| 公司 | 2024 年报 | 2025 年报 |
|---|---|---|
| 科大讯飞 | 19 项 | 20 项 |
| 海康威视 | 13 项 | 13 项 |
| 立讯精密 | 20 项 | 20 项 |
| 金山办公 | 17 项 | 17 项 |
| 中芯国际 | 15 项 | 15 项 |
(满分 20 项。)
有息负债:10 份里 7 份算不出来。有息负债 = 短期借款 + 长期借款 + 应付债券,三个科目全列为依赖。一家公司没有发行债券,「应付债券」那一行就是空的,于是整个有息负债显示「原文未披露:bonds_payable」。讽刺的是,往下几十行,计算有息负债的代码本身是能处理缺项的:
elif metric.code == "interest_bearing_debt":
parts = [
pick("balance", "short_term_borrowings"),
pick("balance", "long_term_borrowings"),
pick("balance", "bonds_payable"),
]
value = sum((part for part in parts if part is not None), ZERO)src/metrics/compute.py#L252-L258
它把缺的那项跳过、把有的加起来。可是上面那道「全部依赖都在才算」的闸,让这段代码永远走不到缺项的分支。两段代码各自都对,放在一起就错了。
海康威视:一行没有,丢 6 项。海康威视的利润表第一行是「一、营业收入」,没有「营业总收入」这一行。「营业总收入」是把利息收入、保费收入这类金融业务收入合在一起时才需要的一行;没有这类业务的公司,两者相等,有的年报列两行(科大讯飞两行都是 271.05 亿),有的只列营业收入。而毛利率、净利率、应收周转天数、三费占收入比、营收增速这几项的公式都写的是「营业总收入」,于是全部「原文未披露」,再加上营业总收入自己,一共 6 项。原文里营业收入清清楚楚印着,系统却说没披露。
v0.4.2 更新
已修。指标注册表多了两个声明:fallbacks 写「哪个依赖科目缺了可以用哪个替代」,毛利率等 5 项声明「营业总收入缺了用营业收入」,口径文本里写明;any_of 写「依赖科目至少有一项就能算」,有息负债用它,同比也改成按合计算(原来取的是短期借款自己的同比)。图表层用同一个函数取营业总收入,两边不再各算各的。「营业总收入」这一项本身没有回退:原文没有这一行,就还是「原文未披露」。
修完之后的覆盖率:
| 公司 | 2024 年报 | 2025 年报 |
|---|---|---|
| 科大讯飞 | 20 项 | 20 项 |
| 海康威视 | 19 项 | 19 项 |
| 立讯精密 | 20 项 | 20 项 |
| 金山办公 | 19 项 | 19 项 |
| 中芯国际 | 19 项 | 19 项 |
10 份合计从 167 项到 194 项。剩下 6 项原文里都没有对应的行:海康威视没有营业总收入,金山办公没有任何借款,中芯国际没有商誉。
为什么不干脆把缺的当 0
有息负债这个例子里,把空的「应付债券」当 0,结果是对的。但「对」是因为我知道那一行空着意味着没有债券。规则写成「缺了当 0」,下一个缺的可能是因为表格还原没读到,那时候 0 就是错的。缺项要按科目逐个决定能不能省略,而不是一条全局规则。
三、三条勾稽
三张报表之间有几个恒等式,原文数字必须满足。系统检查三条:
| 勾稽 | 内容 | 评测集结果 |
|---|---|---|
| 资产恒等 | 资产总计 − 负债合计 − 所有者权益合计 | v0.4.1:6 份通过,4 份跳过;v0.4.2:10 份通过 |
| 利润归属 | 净利润 − 归母净利润 − 少数股东损益 | v0.4.1:6 份通过,4 份跳过;v0.4.2:10 份通过 |
| 两表净利润 | 利润表净利润 − 现金流量表补充资料里的净利润 | 10 份全部跳过 |
差额的容差是 0.01,也就是一分钱。超过一分钱就判不通过,页面顶部挂一条黄色提示,列出差额。
跳过的原因要说清楚:v0.4.1 里前两条跳过的 4 份是科创板两家公司,上一篇讲过,「所有者权益(或股东权益)合计」和带编号的「归母净利润」没匹配上,勾稽缺了输入(v0.4.2 已修)。第三条全部跳过,是因为现金流量表的「补充资料」在附注里,不在定位出来的三张表页范围内。
「跳过」不是「通过」。页面上显示的是「勾稽 2 通过 · 1 跳过」,不会把跳过的算成通过。但我得承认,早期任务卡上记的是「10/10 通过」,那是另一件事了,第 6 篇讲。
四、8 条异常规则
异常项的输入是单份年报的本期和上期比较列,只有两个点。这决定了规则只能做「同比」,不能做「连续」。v0.4.0 的需求文档里写着「经营现金流连续下滑」「毛利率连续下滑」,代码里一条是同比、一条干脆没有,v0.4.1 统一改成了同比,并补上了毛利率那条。
| 规则 | 触发条件 |
|---|---|
| 应收增速显著高于营收 | 应收账款增速 − 营收增速 ≥ 10 个百分点 |
| 经营现金流低于净利润 | 现金含量 < 1 |
| 经营现金流同比下降 | 本期 < 上期 |
| 毛利率同比下降 | 下降 ≥ 1 个百分点 |
| 有息负债快速上升 | 同比 ≥ 30% |
| 商誉占净资产偏高 | ≥ 10% |
| 存货增速高于营收 | 存货增速 − 营收增速 ≥ 10 个百分点 |
| 三表勾稽不通过 | 任意一条勾稽差额超过 0.01 |
评测集 10 份年报一共触发 14 条:经营现金流同比下降 5 条,应收增速高于营收 4 条,毛利率同比下降 2 条,有息负债快速上升 2 条,现金含量低于 1 有 1 条。这里不列具体是哪家公司:异常项是数字之间的关系,不是对公司的评价,单独拎出来摆在文章里,就变味了。
只陈述,不评价
每条异常项的文案是模板拼出来的,只有数字和比较关系:
应收账款增速 X%,营收增速 Y%,差额 Z 个百分点。
经营现金流由上期 A 元降至本期 B 元。
毛利率由上期 X% 降至本期 Y%,下降 Z 个百分点。不会出现「回款恶化」「盈利能力下降」这种判断。判断留给读的人。
除了模板,还有一张禁用词表:「买入」「卖出」「看好」「低估」「高估」「目标价」「建议持有」等 10 个词。导出 Markdown 和 Excel 时,生成的文本过一遍这张表,命中就报错、不让导出。
但禁用词表只挡得住「投资建议」,挡不住「评价」。v0.4.0 的概览摘要里有一句「利润基本有现金支撑」,另一句是「关注回款质量」,都不在禁用词表里,也都不是中性陈述。v0.4.1 把它们改成了「经营现金流 / 净利润 = 3.78,不低于 1」这样的句子,并加了一条测试,断言摘要里不出现「关注」「偏低」「支撑」这类评价词。禁用词表管的是红线,中性措辞要靠模板本身。
每条都要有页码
接口契约里写着:异常项的 page_refs 至少一个,否则不返回该项。v0.4.0 的代码里,这个字段永远是空列表,前端照样展示。
v0.4.1 的做法是:取数时记录每个科目来自哪一页,每条规则声明自己依赖哪些科目,命中时把这些科目的页码带上。拿不到页码的异常项,不展示。评测集上 14 条异常项,14 条都带页码,而且页码和单年报表上那几行的溯源页码完全一致。
五、只在图表层算的东西
还有几个数,用户很关心,但不在 20 项指标里:
- 自由现金流 = 经营现金流 − 购建长期资产支付的现金。它只在图表里画,不进指标卡,也不进金标评测。原因写在 ADR-008 里:加进指标卡就要改「20 项指标」这个对外承诺,牵连对比台和 200 个金标用例。代价是同一个口径要在图表和导出里各说明一次。
- 周转率。指标卡显示周转天数,图表显示周转次数(365 ÷ 天数),因为图表上「越高越好」比「越低越好」直观。
- 杜邦拆解。净利率 × 总资产周转率 × 权益乘数,三个因子单位不同(%、次、倍),必须分轴画。乘积和 ROE 偏差超过 0.5 个百分点,图上标「口径差异」。评测集里立讯精密两份年报被标了出来,偏差 2.3~2.5 个百分点:杜邦三因子用的是全部净利润和全部权益,ROE 用的是归母口径,少数股东那部分让两者对不上。这个标注是对的,它说明两个数不是一回事,而不是哪个算错了。
小结
| 环节 | 做法 | 初代版本的状态 |
|---|---|---|
| 指标注册表 | 一行一个指标,口径文本即溯源说明 | 口径文本与公式无机制保证一致(ROE 已修) |
| 增速 | 基期为 0 或负给「不适用」 | 评测集 2 处触发 |
| 缺项 | 依赖全在才算,缺了写「原文未披露」 | v0.4.1 判定太死;v0.4.2 按指标声明替代与「至少一项」,覆盖 194/200 |
| 勾稽 | 三条,容差 0.01 | v0.4.2 前两条 10/10 通过;第三条全部跳过 |
| 异常规则 | 8 条,同比,模板文案 | 14 条全部带页码 |
| 措辞 | 禁用词表 + 中性模板 | 摘要评价词已清理,加了测试 |
数都算好了,下一篇讲怎么把它们摆到人面前:四个页面、11 张图、点一下就能看到原文的溯源浮层,以及一个不需要 npm install 的前端。
版本说明
本文基于 v0.4.1(提交 5150928),代码链接都指向这个版本;文中「v0.4.2 更新」是之后的修复,记录在第 7 篇的账本上。