xls_doc/manual_tests/README.md

docfill 手工测试素材

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

运行前进入项目根目录：

cd /Users/zhaoyilun/Documents/xls_doc

构建工具：

bash scripts/build.sh

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

目录：

manual_tests/01_excel_to_word

运行命令：

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

输出示例：

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 汇总表

目录：

manual_tests/02_sqlite_to_excel

运行命令：

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

输出示例：

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 质检表

目录：

manual_tests/03_excel_to_excel

运行命令：

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

输出示例：

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

目录：

manual_tests/04_filter_work_order_to_word

输入数据内容：

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

运行命令：

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

输出示例：

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

查看结果：

open manual_tests/04_filter_work_order_to_word/out

重新生成素材

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

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

输出示例：

/Users/zhaoyilun/Documents/xls_doc/manual_tests