经营分析素材生成

> **本地运行，零网络、免 API Key、数据不出电脑。**
> 四项诚实承诺：① 算不出就说算不出，绝不编造数字；② 高危动作强制人工确认；③ 幂等断点，绝不重复副作用；④ 全程留痕可审计。

# 经营分析素材生成

经营分析会的材料，最尴尬的是**为了凑满四页而编的两页**。
本包按模板出四页要点卡组：本月经营、财务指标、问题与风险、下月计划。

原则很简单：**有数就带数字，没数就写「本次未提供 XX 数据，本页留白待补」。**
留白是合法结果，不是失败——开会上真正要讨论的，往往正是这些没数的地方。

本包只出素材，不出结论。「毛利率 48% 是高是低」它不判断，
「成本缺失导致毛利率不可信」它只提示风险，不下定论。

## 输入 / 输出

### 输入

| 参数 | 必须 | 说明 |
|---|---|---|
| `利润表（本期）` | 必须 | 项目列 + 金额列 |
| `上期利润表` | 可选 | 第二个位置参数，写环比 |
| `--budget 预算表` | 可选 | 项目 \| 预算金额，出预算执行差异 |
| `--orders 客户订单表` | 可选 | 客户 \| 订单金额，出收入集中度 |
| `--risks 风险清单` | 可选 | 问题 \| 责任部门 \| 涉及金额 \| 措施 |
| `--plan 下月计划表` | 可选 | 项目 \| 下月计划，出下月计划页 |
| `--top1 50` | 可选 | 集中度阈值（%），默认 50 |

**第一条位置参数里如果一条利润科目都没有（等于没给利润表），本包直接拒绝执行**——
经营页与指标页没有数据源，硬出就是编。

### 输出（进 `_out/`，源文件一个字节都不动）

| 文件 | 内容 |
|---|---|
| `rd_主表.csv` | 页序 / 页面 / 要点编号 / 要点内容 / 是否带数字 / 数据来源 |
| `rd_异常表.csv` | 集中度超阈值、毛利为负、有收入无成本、超预算等（带风险等级） |
| `rd_校验表.csv` | 各页数据源、阈值、勾稽三态、留白统计 |
| `fin-log.jsonl` | 处理日志（追加） |

主表按页分组，每一页要点编号连续（P1-1、P1-2 …），方便直接粘进 PPT。

## 用法

```bash
PY="<python 3.8+ 路径>"   # 纯标准库，无需 pip install
"$PY" <skill目录>/scripts/review_deck.py 利润表_本期.xlsx 利润表_上期.xlsx \
    --period 2026-09 \
    --budget 预算表.xlsx --orders 客户订单表.xlsx \
    --risks 风险清单.xlsx --plan 下月计划表.xlsx \
    --execute
```

只给利润表（其余四页自动留白待补）：

```bash
"$PY" review_deck.py 利润表_本期.xlsx --period 2026-09 --execute
```

先预览、确认无误再落盘：

```bash
"$PY" review_deck.py 利润表_本期.xlsx
# [预览模式] 未写盘。确认无误后加 --execute 执行。
```

## 真实输出样例

实测（本期 + 上期 + 预算表 + 客户订单表 + 风险清单 + 下月计划表齐全，期间 2026-09）：

```
--- 经营分析素材（共 4 页 / 16 个要点，本期 2026-09）---

【P1 本月经营】
  P1-1   本月营业收入 500,000.00 元（主营业务收入 480,000.00 元，其他业务收入 20,000.00 元）；上月 410,000.00 元，环比 21.95%（增减 90,000.00 元）
  P1-2   本月营业成本 260,000.00 元，毛利 240,000.00 元
  P1-3   本月期间费用合计 123,000.00 元（销售 68,000.00 + 管理 52,000.00 + 财务 3,000.00）
  P1-4   本月营业利润 105,000.00 元；净利润 78,750.00 元

【P2 财务指标】
  P2-1   毛利率 48.00%（毛利 240,000.00 元 / 收入 500,000.00 元）
  P2-2   费用率 24.60%（期间费用 123,000.00 元 / 收入 500,000.00 元）
  P2-3   净利率 15.75%（净利润 78,750.00 元 / 收入 500,000.00 元）
  P2-4   预算收入 520,000.00 元，实际 500,000.00 元，差异 -20,000.00 元，执行率 96.15%

【P3 问题与风险】
  P3-1   客户收入集中度：Top1「甲公司」310,000.00 元，占订单金额合计 532,000.00 元（58.27%）
  P3-2   成本口径已完整（收入 500,000.00 元 / 成本 260,000.00 元），本页无成本类风险要点
  P3-3   【风险】应收账款 60 天以上占比上升；责任部门：销售部；涉及金额 135,000.00 元；措施：下周起对超 60 天客户暂停发货
         【风险】一笔运费发票未取得专票；责任部门：供应链部；本次未提供 涉及金额 数据，本条金额留白待补；措施：要求承运商补开，否则税前扣除剔除

【P4 下月计划】
  P4-1   下月营业收入计划 560,000.00 元（本月实际 500,000.00 元，计划增减 60,000.00 元）
  P4-2   下月营业成本计划 290,000.00 元（本月实际 260,000.00 元，计划增减 30,000.00 元）
  P4-3   下月计划收入 560,000.00 元 vs 本月实际 500,000.00 元，缺口 -60,000.00 元，关键动作按此缺口设定

--- 留白统计 ---
  需人工补数 1 个要点（其余 15 个已带数字），不编造

--- 勾稽 ---
  通过（毛利 − 税金及附加 − 期间费用 = 105,000.00 元，表内营业利润 = 105,000.00 元，差异 0.00 元）
```

失败路径实测（四张坏数据）：

```
# 收入为 0：P2 三个比率全部写「不可计算：分母（营业收入）…为 0，本页留白待补」
  P2-1   毛利率不可计算：分母（营业收入）缺失或为 0，本页留白待补
  P2-2   费用率不可计算：期间费用缺失或分母（营业收入）为 0，本页留白待补
  P2-3   净利率不可计算：净利润缺失或分母（营业收入）为 0，本页留白待补

# 有收入无成本 → 异常表 [高]
  P2-1   本次未提供 营业成本 数据，毛利率留白待补（有收入无成本会让毛利虚高）
  P3-2   营业成本缺失而收入 300,000.00 元，毛利不可信，本页留白待补（高风险）

# 客户订单 Top1 占 95.67% → 异常表 [高]
  P3-1   客户收入集中度：Top1「甲公司」950,000.00 元，占订单金额合计 993,000.00 元（95.67%）
  异常表  P3-1  Top1 客户「甲公司」占比 950,000.00 元，超过阈值 50.0%，毛利 / 收入高度集中  [高]

# 第一条位置参数里没有利润科目
【算不出】「rd_坏_只有风险清单.xlsx」里没有一条利润表科目，无法生成经营页与指标页
建议：把利润表（或损益科目余额表）放第一个位置参数；风险清单请走 --risks
```

## 拒绝权：什么情况下拒绝执行

| 情况 | 本包做法 |
|---|---|
| 文件不存在 / 空表 / 找不到金额列 | 拒绝执行并说明 |
| 第一条位置参数里没有利润科目 | 拒绝（经营页与指标页没有数据源，不硬出） |
| 分母（营业收入）为 0 / 缺失 / 为负 | 比率写「不可计算」+ 原因，不出替代值 |
| 毛利为负 | 要点标「毛利为负（异常）」，异常表 [高] |
| 有收入无成本 | P2 / P3 写留白待补，异常表 [高] |
| Top1 收入占比超 `--top1` | 异常表标风险（≥ 90% 为高） |
| 未给 `--budget / --orders / --risks / --plan` | 对应要点写「本次未提供 XX 数据，本页留白待补」 |
| 风险清单某条缺「涉及金额」 | 该条写「本次未提供 涉及金额 数据，本条金额留白待补」 |
| 勾稽对不上 | 校验表写「不通过（差异 X 元）」，要点照样出 |

## 关键设计

1. **留白是一等公民**：某个可选表没给，对应要点就写明缺什么；
   整页都没有数据时，写「本次未提供 XX 数据，本页留白待补（页面名）」。
2. **「是否带数字」列**：主表逐条标记，方便做 PPT 时一眼看出哪几条需要补数。
3. **集中度看 Top1**：`--orders` 里金额最大的客户占订单金额合计的比例，
   超过 `--top1`（默认 50%）进异常表，≥ 90% 标高风险。
   本包只报集中度，不建议信用政策——那要配合账期和回款看。
4. **风险清单的金额可缺**：没有「涉及金额」列的条目会写明「本条金额留白待补」，
   不按 0 处理，也不因为没金额就丢掉这条风险。
5. **勾稽三态**：毛利 − 税金及附加 − 期间费用 应当等于表内营业利润；
   不等写「不通过（差异 X 元）」，算不出来写「无法校验（原因）」，**不写成通过**。
6. **不做好坏判断**：48% 的毛利率是好是坏，本包不写；「经营良好」这类词本包不产出。

## 人工复核（必读）

- 要点卡组是素材不是结论，进 PPT 前请由财务负责人逐条看过
- 「留白待补」的要点要现场确认是真没数据，还是该表忘了给
- 集中度阈值 50% 只是常用参考，同行业差异大，别当硬指标
- 预算执行差异要确认预算口径（全年分摊？月度？含税？）再解释差异
- 风险清单里的「涉及金额」是财务口径还是业务估计，请标注清楚
- 勾稽对不上最常见的原因是表里有其他收益 / 投资收益科目未纳入

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 一页纸的管理层摘要 | `exec-summary` |
| 按客户 / 产品拆毛利率与亏损客户 | `customer-profit-analysis` |
| 预算执行差异明细（逐科目） | `budget-execution` |
| 18 项财务指标 | `financial-ratio` |
| 应收账款账龄与坏账 | `ar-aging` |

## 可直接复制的说法

```text
按经营分析会的模板，给我四页要点卡组：本月经营、财务指标、问题与风险、下月计划。
每页要点都要带具体数字（多少元、百分之多少）。
这一页如果确实没有数据支撑，就写「本次未提供 XX 数据，本页留白待补」，
不要为了凑页数编一个要点出来，也不要写「情况良好」这种没数字的话。
毛利率、费用率、净利率这些，分母为 0、缺失或者为负的时候标「不可计算」并写原因。
客户订单表如果只有一个客户占比过半，请在风险页标出来，超过 90% 标高风险。
四页之外的东西不用给我，留白的地方我自己补。
```

## 做完怎么算完成

- [ ] 四页要点逐页看过，带数字的要能追溯到原表
- [ ] 每个「留白待补」的要点都已确认真没数据（不是漏传文件）
- [ ] 勾稽结果不是「无法校验」的都追到了原因
- [ ] 有收入无成本、毛利为负、集中度超阈值的条目都已进异常表并逐条追查
- [ ] 风险清单里的「涉及金额」已确认是财务口径还是业务估计
- [ ] 四页要点已交经营分析会参会人讨论，未替代财务负责人的结论

---

本 Skill 采用 BUSL-1.1 许可（源码可见，可自由使用）。

版权所有 © 2026 律令科技（深圳）有限公司（@lexord-technology）。
本技能由律令科技（深圳）有限公司开发，**财友云（caiyouyun.cn）**发布与展示。

允许个人及企业内部免费使用、复制、修改，包括内部生产环境。
未经书面许可，不得将本 Skill 或其修改版作为商业服务对外销售、转售或提供托管服务。
各版本发布之日起 4 年后自动转为 Apache License 2.0。详见随包 `LICENSE.md`。