支持任意 Excel / CSV 表格字段匹配 Word 模板占位符，例如客户报价单、员工证明、订单单据、毕业说明。
01 / MVP Scope
打包原型里的处理能力
隔离验证跑通了模板填充、合并与异常输出。下面是打包代码中的处理范围，不等同于每种文件都已完成广泛兼容测试。
每条记录可生成独立 Word，也会额外分页合并成一个总 Word，方便老师或行政一次性归档。
支持按学号、客户编号、员工编号、订单号等字段合并表格，并输出空值、重复值、缺失记录报告。
支持多个 Word 合并、多个 PPT 合并、PDF 文本摘要和 PDF 合并，第一版保留基础版式和文本结构。
用户可以输入"把表格每一行填入模板""按客户编号合并表格""检查重复编号"等任务指令。
每次执行都会记录 task_id、输入文件、输出文件、执行结果、错误信息、安全模式和是否调用外部模型。
02 / Use Cases
从学生场景扩展到通用办公
学生成绩只是第一个样例，真正的产品抽象是"表格数据 + 模板文件 + 字段映射 + 批量输出"。
成绩表生成毕业说明
按学号和姓名匹配学生信息，把成绩、平均分、结论填入模板，输出单份 Word、合并 Word 和异常报告。
员工证明和合同材料
把员工信息表填入在职证明、合同补充材料、通知书模板，减少重复复制和人工核对。
客户清单生成报价单
按客户编号匹配客户名称、公司、项目、金额和日期，自动生成报价确认单或合同附件。
03 / Privacy First
本地优先是一项实现选择，不是安全认证
打包版本默认关闭外部模型，并把上传、输出与临时文件按任务目录隔离。这能说明设计意图，但尚未经过生产环境安全审计。
打包版本默认本地处理
上传文件保存在 backend/data/uploads/{task_id}/，输出文件保存在 backend/data/outputs/{task_id}/，临时文件保存在 backend/data/temp/{task_id}/。
日志按字段和状态记录
默认 local_only_mode = true，external_llm_enabled = false。日志记录字段名、任务和文件状态，不记录完整敏感内容。
04 / Implementation
技术实现
这个项目的关键不是把所有事情交给大模型，而是让 Agent 负责理解任务，确定性代码负责真实文件处理。
- Python
- FastAPI
- pandas
- openpyxl
- python-docx
- python-pptx
- pypdf
- SQLite
- React
- Vite
- TypeScript
- Tailwind CSS
document-agent://evidenceLIMITS
可核验证据
ZIP / DOCX / XLSX / JSON 任务日志
自动化测试
打包版本包含两个任务解析测试
当前限制
尚无真实用户、生产部署或广泛文件兼容证据