现金流缺口预测

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

# 现金流缺口预测

现金流预测的价值不在"预计月底有多少钱"，而在**哪一周会断、差多少**。这两件事决定了要不要提前安排融资、要不要压付款节奏。

本包按到期日把应收应付摊进周，加上下周基线收支（历史均值或指定值），算出逐周余额曲线。**累计余额为负的周直接标红并给出缺口金额**，不做任何模糊表述。

## 输出四件套 + 曲线

| 文件 | 内容 |
|---|---|
| `cf_周度.csv` | 每周：流入 / 流出 / 净额 / 期初 / 累计余额 |
| `cf_应收明细.csv` | 摊到各周的应收账期 |
| `cf_应付明细.csv` | 摊到各周的应付账期 |
| `cf_预警.csv` | 负余额周与缺口金额 |
| `cf_校验表.csv` | 基线口径、起始余额、假设清单、人工复核声明 |
| `fin-log.jsonl` | 处理日志（追加） |

## 环境准备

```bash
PY="<python 3.8+ 路径>"   # 纯标准库
"$PY" <skill目录>/scripts/cashflow.py <应收表> <应付表> [参数]
```

## 用法

```bash
cashflow.py 应收账期.xlsx 应付账期.xlsx --weeks 12 --opening 500000
```

真实输出：

```
方案：应收 24 笔 / 应付 18 笔 | 起始余额 500,000.00 | 推演 12 周
--- 周度余额（前 8 周）---
  周起      | 流入        | 流出        | 净额       | 累计余额
  09-28     | 180,000.00  | 96,000.00   | 84,000.00  | 584,000.00
  10-05     | 42,000.00   | 210,000.00  | -168,000.00| 416,000.00
--- 预警 ---
  ⚠ 第 2 周（10-05）起累计余额 416,000.00，第 5 周将出现负余额，最大缺口 -80,000.00
```

## 参数说明

| 参数 | 默认 | 说明 |
|---|---|---|
| `--weeks` | 12 | 推演周数 |
| `--opening` | 0 | 起始现金余额（必填确认，不给则拒算） |
| `--baseline` | 0 | 每周基线净收支（未给时取应收-应付外的日常收支，需 `--base-flow` 指定） |

**不给 `--opening` 就拒绝运行**：起始余额是整条曲线的原点，编一个会让后面所有周都错。

## 假设必须写清

预测是假设的组合。本包把所有假设列进校验表：起始余额、周基线、账期是否按到期日（而非开票日）、是否计入已付款未到期的项。**这些假设需要你确认，而不是工具替你定。**

## 安全与边界（拒绝权）

- **源文件零改动**：输出进 `_out/`
- **不给起始余额不测算**：宁可停，不给"合理的默认余额"
- **不预测不确定性**：不给概率区间、不给情景概率，只给单一路径 + 假设清单
- **不替你决定融资**：缺口金额列出来，怎么解决由你定

## 人工复核（必读）

- 应收按到期日推演，实际回款可能提前或推迟，建议做两遍（乐观/悲观）
- 客户集中度高的，前三大客户延迟一周足以颠覆整条曲线
- 重大付款（货款、税费、工资）不要放进基线，单独列

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 应付到期排期 | `ap-payment-schedule` |
| 票据到期日历 | `bill-due-remind` |
| 应收账龄与坏账 | `ar-aging` |
| 三大表勾稽 | `statement-cross-check` |

## 可直接复制的说法

```text
按应收应付的到期日推演未来十二周的现金流。起始现金余额我从资产负债表给你。
逐周算出流入、流出、累计余额，累计余额为负的周标出来，告诉我哪周断、差多少。
所有假设（起始余额、基线收支、账期口径）都写进校验表，别替我定。
```

## 做完怎么算完成

- [ ] 起始余额与管理层口径一致
- [ ] 预警周已逐周核对，尤其是大额进出
- [ ] 假设清单已确认
- [ ] 缺口金额已报给资金岗

---

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

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

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