# docfill 手工测试素材

本目录提供四组可直接运行的本地测试素材，用于验证 `docfill` 对筛选、Word、Excel、Excel 数据源和 SQLite 数据源的支持情况。

运行前进入项目根目录：

```bash
cd /Users/zhaoyilun/Documents/xls_doc
```

构建工具：

```bash
bash scripts/build.sh
```

## 案例 1：Excel 数据生成 Word 日报

目录：

```text
manual_tests/01_excel_to_word
```

运行命令：

```bash
dist/docfill-darwin-arm64 run -c manual_tests/01_excel_to_word/task.json --var batch=早班 --verbose
```

输出示例：

```text
generated 2 file(s)
- /Users/zhaoyilun/Documents/xls_doc/manual_tests/01_excel_to_word/out/daily_2026-06-18_张三_测试_1.docx
- /Users/zhaoyilun/Documents/xls_doc/manual_tests/01_excel_to_word/out/daily_2026-06-18_李四_2.docx
```

## 案例 2：SQLite 数据生成 Excel 汇总表

目录：

```text
manual_tests/02_sqlite_to_excel
```

运行命令：

```bash
dist/docfill-darwin-arm64 run -c manual_tests/02_sqlite_to_excel/task.json --var date=2026-06-18 --verbose
```

输出示例：

```text
generated 2 file(s)
- /Users/zhaoyilun/Documents/xls_doc/manual_tests/02_sqlite_to_excel/out/summary_客服部_1.xlsx
- /Users/zhaoyilun/Documents/xls_doc/manual_tests/02_sqlite_to_excel/out/summary_营销部_2.xlsx
```

## 案例 3：Excel 数据生成 Excel 质检表

目录：

```text
manual_tests/03_excel_to_excel
```

运行命令：

```bash
dist/docfill-darwin-arm64 run -c manual_tests/03_excel_to_excel/task.json --var date=2026-06-18 --verbose
```

输出示例：

```text
generated 2 file(s)
- /Users/zhaoyilun/Documents/xls_doc/manual_tests/03_excel_to_excel/out/audit_2026-06-18_王五_1.xlsx
- /Users/zhaoyilun/Documents/xls_doc/manual_tests/03_excel_to_excel/out/audit_2026-06-18_赵六_2.xlsx
```

## 案例 4：按日期和工单编号筛选一条工单并生成 Word

目录：

```text
manual_tests/04_filter_work_order_to_word
```

输入数据内容：

```text
日期          工单编号   客户名称  系统来源   处理结果  下一步
2026-06-18   GD-001    A 公司   PMS3.0   已派单   等待现场反馈
2026-06-18   GD-002    B 公司   D5000    已完成   归档并同步日报
2026-06-19   GD-001    C 公司   风控平台  待复核   补充截图
```

运行命令：

```bash
dist/docfill-darwin-arm64 run -c manual_tests/04_filter_work_order_to_word/task.json --var date=2026-06-18 --var ticket_no=GD-002 --verbose
```

输出示例：

```text
generated 1 file(s)
- /Users/zhaoyilun/Documents/xls_doc/manual_tests/04_filter_work_order_to_word/out/work_order_2026-06-18_GD-002.docx
```

查看结果：

```bash
open manual_tests/04_filter_work_order_to_word/out
```

## 重新生成素材

如需重新生成全部手工测试文件，执行：

```bash
/Users/zhaoyilun/.cache/codex-runtimes/codex-primary-runtime/dependencies/python/bin/python3 scripts/make-manual-test-materials.py
```

输出示例：

```text
/Users/zhaoyilun/Documents/xls_doc/manual_tests
```