
文书和材料制作 · 功能说明
同一份确认内容得到可编辑DOCX、固定版PDF和按序附件,电子版与打印版不各自手改内容。电子版按用途选彩色或黑白,需要快速查找的仍要有清楚的层级和导航;确有打印用途时按打印要求检查,不强制每次交付两版。
当前情况:同源 DOCX/PDF 生成已实现,协议和单方文书按各自用途编排正文,协议每方各有签字和日期位置(11 月 4 日核对源码)。四类材料的虚构样张验收是历史记录;真实个人材料有没有做过没有读取,未核实。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


文书和材料制作 · 功能说明
同一份确认内容得到可编辑DOCX、固定版PDF和按序附件,电子版与打印版不各自手改内容。电子版按用途选彩色或黑白,需要快速查找的仍要有清楚的层级和导航;确有打印用途时按打印要求检查,不强制每次交付两版。
当前情况:同源 DOCX/PDF 生成已实现,协议和单方文书按各自用途编排正文,协议每方各有签字和日期位置(11 月 4 日核对源码)。四类材料的虚构样张验收是历史记录;真实个人材料有没有做过没有读取,未核实。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


用途与实际影响
分别修改 Word 和 PDF 最容易让日期、请求、附件编号和签名块漂移;覆盖旧输出又会失去可恢复版本。协议和单方声明的结构也不一样,套一个模板会写乱。
我可以说:“把核对后的退款申请做成可编辑版和打印版,两个版本内容必须一致。”系统会从同一份确认内容生成 DOCX 和 PDF;若本机缺少正常导出条件,会说明改用了什么方式以及仍需复核什么。做协议时,每一方都有自己的签字和日期位置,只在我这一方放我的签名。
得到这次确认内容的可编辑 Word、同内容 PDF 和按序附件,知道使用了哪条导出路线。协议按“合同当事人、订立背景、约定条款”组织,单方文书按“致收件方、出具人与相关方、事实、声明事项”组织。新版本不覆盖旧文件;导出失败时保留已经核对的输入和旧版。如果只是在网站表单里填一段字、没有附件,不强制为它生成 PDF。

用途与实际影响
分别修改 Word 和 PDF 最容易让日期、请求、附件编号和签名块漂移;覆盖旧输出又会失去可恢复版本。协议和单方声明的结构也不一样,套一个模板会写乱。
我可以说:“把核对后的退款申请做成可编辑版和打印版,两个版本内容必须一致。”系统会从同一份确认内容生成 DOCX 和 PDF;若本机缺少正常导出条件,会说明改用了什么方式以及仍需复核什么。做协议时,每一方都有自己的签字和日期位置,只在我这一方放我的签名。
得到这次确认内容的可编辑 Word、同内容 PDF 和按序附件,知道使用了哪条导出路线。协议按“合同当事人、订立背景、约定条款”组织,单方文书按“致收件方、出具人与相关方、事实、声明事项”组织。新版本不覆盖旧文件;导出失败时保留已经核对的输入和旧版。如果只是在网站表单里填一段字、没有附件,不强制为它生成 PDF。

要求同一份内容同时得到可编辑 Word 和对应 PDF。
- 这次已确认的内容或要改的段落
- 要附上的材料(如有)
- 主要用于屏幕阅读还是打印


要求同一份内容同时得到可编辑 Word 和对应 PDF。
- 这次已确认的内容或要改的段落
- 要附上的材料(如有)
- 主要用于屏幕阅读还是打印



- A4 DOCX:四边 25 mm、页脚 12 mm 带页码,正文宋体 12 pt、1.5 倍行距,标题黑体 18 pt、小标题 13 pt。
- 协议和单方文书按各自用途组织正文;可选的“依据”和附件随输入出现。
- 协议每方都有独立的签字(盖章)和日期位置:需要本人签名时只在本人一方嵌入签名和日期,电子版且签名资料里有手印时手印放在签名旁(打印版不预印),其他方留空;不需要签名时各方签署位都留空,状态仍是“已生成”。


- A4 DOCX:四边 25 mm、页脚 12 mm 带页码,正文宋体 12 pt、1.5 倍行距,标题黑体 18 pt、小标题 13 pt。
- 协议和单方文书按各自用途组织正文;可选的“依据”和附件随输入出现。
- 协议每方都有独立的签字(盖章)和日期位置:需要本人签名时只在本人一方嵌入签名和日期,电子版且签名资料里有手印时手印放在签名旁(打印版不预印),其他方留空;不需要签名时各方签署位都留空,状态仍是“已生成”。

- Word 导出资源随安装包提供,以无窗口方式运行、180 秒超时。Word 不可用时用本地备用引擎生成 PDF,并在清单写明原因;备用引擎必须有可嵌入的中文 TrueType 字体,缺字体直接失败,不交缺字成品,因此备用 PDF 不保证也是宋体加黑体的组合。
- 备用 PDF 按签名原图宽高比放置,过宽就等比缩小,每方签署块不跨页拆开;这是实现,不说明签名视觉已人工看过。
- DOCX 与 PDF 重新提取正文,逐项核对输出字段;旧版式的已存档成品按旧字段读回,不重写。

- Word 导出资源随安装包提供,以无窗口方式运行、180 秒超时。Word 不可用时用本地备用引擎生成 PDF,并在清单写明原因;备用引擎必须有可嵌入的中文 TrueType 字体,缺字体直接失败,不交缺字成品,因此备用 PDF 不保证也是宋体加黑体的组合。
- 备用 PDF 按签名原图宽高比放置,过宽就等比缩小,每方签署块不跨页拆开;这是实现,不说明签名视觉已人工看过。
- DOCX 与 PDF 重新提取正文,逐项核对输出字段;旧版式的已存档成品按旧字段读回,不重写。

- 构建和材料包都在临时目录完成后原子替换上线;同名拒绝,失败清理临时目录。附件按输入顺序编号复制,中文名片段最长 80 字,复制后哈希不符即失败。


- 构建和材料包都在临时目录完成后原子替换上线;同名拒绝,失败清理临时目录。附件按输入顺序编号复制,中文名片段最长 80 字,复制后哈希不符即失败。



| 名词 | 意思 |
|---|---|
| DOCX | 可继续编辑、修订和批注的 Word 文档;结构正确仍须逐页检查。 |
| 固定版面输出;它来自同一内容源,不是另手工维护的一份正文。 | |
| Build ID(构建标识) | 一次不可覆盖制作的稳定名字;同名存在就拒绝覆盖。 |
| Fallback(备用引擎) | Word 不可用时使用的本地 PDF 路线,需要可嵌入的中文字体;清单会保留引擎和警告。 |
| 签署位 | 协议里每一方的签字(盖章)和日期位置;只在本人一方嵌入本人签名。 |

计划只定义制作路线;构建才生成 A4 DOCX、PDF、附件和清单,正文按文书用途编排。Word 是首选导出器,备用引擎会在清单中明确记录。



计划只定义制作路线;构建才生成 A4 DOCX、PDF、附件和清单,正文按文书用途编排。Word 是首选导出器,备用引擎会在清单中明确记录。

- 只生成明确请求的当前事项
- 不把能打开写成内容正确
- 不覆盖既有构建或材料包
- 备用引擎不冒充 Word 输出
- 不自动执行外部递送
- 同名构建或材料包已存在: 拒绝覆盖;使用新构建标识或继续核对既有版本。

- 只生成明确请求的当前事项
- 不把能打开写成内容正确
- 不覆盖既有构建或材料包
- 备用引擎不冒充 Word 输出
- 不自动执行外部递送
- 同名构建或材料包已存在: 拒绝覆盖;使用新构建标识或继续核对既有版本。

- Word 导出不可用: 明确记录警告并尝试本地备用引擎;没有可嵌入中文字体或备用也失败则停止。
- DOCX/PDF 缺输出字段或签署位: 正文读回失败,不形成候选材料包。
- 附件复制哈希不同: 删除本轮临时目录,原件与旧构建保持不变。

- Word 导出不可用: 明确记录警告并尝试本地备用引擎;没有可嵌入中文字体或备用也失败则停止。
- DOCX/PDF 缺输出字段或签署位: 正文读回失败,不形成候选材料包。
- 附件复制哈希不同: 删除本轮临时目录,原件与旧构建保持不变。

- PRIVATE source · formal_documents.py 按用途编排的 DOCX/PDF、各方签署位、附件、导出与不可覆盖构建
- PRIVATE source · packaged Word exporter 安装包内 Word 固定版导出
- PRIVATE tests · four-type build/verify 四类材料、Word/备用引擎、协议签署位与隔离安装回归(31 个测试函数、51 个用例,11 月 4 日静态计数,没有运行)
- 四类通用材料的合成构建与复验、隔离安装包两个入口用 Microsoft Word + Poppler 的运行,都是 9 月初的历史记录。
- DOCX 不含内部角色代码、事项编号或原始渠道值。
- 11 月 4 日只读核对:没有运行测试,也没有确认当前 Word、字体和 Poppler 安装可用。
- 真实个人正文和真实打印验收没有运行。
本模块形成“已生成”或“本人已签”的构建;逐页审计和自包含材料包由下一模块决定能不能成为候选。

- PRIVATE source · formal_documents.py 按用途编排的 DOCX/PDF、各方签署位、附件、导出与不可覆盖构建
- PRIVATE source · packaged Word exporter 安装包内 Word 固定版导出
- PRIVATE tests · four-type build/verify 四类材料、Word/备用引擎、协议签署位与隔离安装回归(31 个测试函数、51 个用例,11 月 4 日静态计数,没有运行)
- 四类通用材料的合成构建与复验、隔离安装包两个入口用 Microsoft Word + Poppler 的运行,都是 9 月初的历史记录。
- DOCX 不含内部角色代码、事项编号或原始渠道值。
- 11 月 4 日只读核对:没有运行测试,也没有确认当前 Word、字体和 Poppler 安装可用。
- 真实个人正文和真实打印验收没有运行。
本模块形成“已生成”或“本人已签”的构建;逐页审计和自包含材料包由下一模块决定能不能成为候选。
数字截至 2026 年 11 月 6 日
复制 AI 续作说明
项目:从同一规范内容生成可编辑 DOCX、PDF 与附件;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。




