报表批量导出

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

# 报表批量导出

导出报表最怕的不是格式不对，是**漏了一张**。
老板要三大报表，你给了资产负债表和小计表，利润表在另一个文件夹没找着——
等他发现时，月度分析已经写完了。

本包先列清单，缺文件直接拒绝导出。

## 用法

先写清单文件（每行一个路径，`#` 开头是注释）：

```
# 2026-09 月度报表导出清单
资产负债表.xlsx
利润表.xlsx
现金流量表.xlsx
```

然后：

```bash
PY="<python 3.8+ 路径>"   # 纯标准库
"$PY" <skill目录>/scripts/batch_export.py --list 2026-09清单.txt --execute
```

加 `--manifest` 可额外输出一份「导出清单」表：

```bash
"$PY" batch_export.py --list 清单.txt --manifest _out/导出清单_2026-09.csv --execute
```

> 不加 `--execute` 只打印清单预览，不写盘。

## 输出

| 文件 | 内容 |
|---|---|
| `_out/<表名>.csv` | 每张报表一个 CSV，保持原始列 |
| `be_主表.csv` | 导出清单：报表 / 工作表名 / 行数 / 列数 / 状态 / 源文件 |
| `be_异常表.csv` | 列结构不一致等提示 |
| `be_校验表.csv` | 导出时间、表数、总行数、口径声明 |
| `fin-log.jsonl` | 处理日志（追加） |

> **`--manifest` 可指定导出清单单独输出成 .csv 或 .xlsx。**

## 关于「多 sheet 工作簿」

本包**不生成多 sheet 合并的 .xlsx**。财友云共享内核的 `.xlsx` 写入当前只支持单 sheet，
要做多 sheet 就得引入第三方库，跟零依赖约束冲突。

输出是**每张表一个 CSV + 一份导出清单表**。
需要单个 `.xlsx` 文件时，用 `excel-csv-toolkit` 转换。
与其承诺一个做不到的文件，不如说清楚能给什么。

## 拒绝权

清单里有任何一个文件找不到，直接终止导出：

```
【算不出】清单里有 1 个文件不存在，已终止导出：
  _out/根本不存在.xlsx
建议：确认路径与文件名；漏文件导出等于给用户一张残缺的报表
本包不会给一个看似合理的替代数字 —— 财税场景算错比不做更危险。
```

## 关键设计

- **清单先行**：导什么、从哪来，用户说了算，脚本不猜
- **列不对齐**：各表保持各自原始列。强行对齐会引入误判，宁可让用户自己看
- **列名洗安全**：工作表名里的 `\/?*[]:` 会被替换，避免写出非法文件名
- **同名不撞车**：重名表自动加序号，不会互相覆盖

## 安全与边界

- **源文件零改动**：只读取，一个字节都不动
- **默认预览**：不加 `--execute` 不写盘
- **不做格式转换**：CSV ↔ Excel 的复杂转换不在本包范围
- **不判断报表对不对**：导出只负责把文件拿出来，内容准确性由上游负责

## 人工复核（必读）

- 导完先核一遍清单条数，跟发给对方的文件数对得上
- 列结构不一致的表，接收方打开时可能要手工调整
- 导出的 CSV 默认带 BOM，Excel 直接双击打开中文不乱码

## 相邻路线转交

| 用户要做的事 | 转交给 |
|---|---|
| 报表内容有错要查 | `statement-cross-check` |
| 月度经营分析材料 | `monthly-mgmt-report` |
| 多表合并成一个表 | `fin-table-merge` |
| CSV / Excel 格式互转 | `excel-csv-toolkit` |

## 可直接复制的说法

```text
按这份清单把报表导出：资产负债表.xlsx、利润表.xlsx、现金流量表.xlsx。
清单里有任何一个文件找不到就直接告诉我，不要跳过继续导出——
漏一张表比少一个文件严重得多。导出后给我一份清单，
写清楚每个文件导出了多少行多少列。
```

## 做完怎么算完成

- [ ] 导出的文件数与清单条数一致
- [ ] 每个文件的行数与原表对得上
- [ ] 已确认没有列结构异常的表
- [ ] 接收方能按清单找到每一份文件

---

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

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

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