从同一规范内容生成可编辑 DOCX、PDF 与附件
现在
待验收
截至 11 月 4 日 · 项目源码和项目说明

文书和材料制作 · 功能说明

同一份确认内容得到可编辑DOCX、固定版PDF和按序附件,电子版与打印版不各自手改内容。电子版按用途选彩色或黑白,需要快速查找的仍要有清楚的层级和导航;确有打印用途时按打印要求检查,不强制每次交付两版。

当前情况:同源 DOCX/PDF 生成已实现,协议和单方文书按各自用途编排正文,协议每方各有签字和日期位置(11 月 4 日核对源码)。四类材料的虚构样张验收是历史记录;真实个人材料有没有做过没有读取,未核实。

具体测试保留各自日期,页面不实时探测运行状态。

项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。

从同一规范内容生成可编辑 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。

需要准备什么
  • 这次已确认的内容或要改的段落
  • 要附上的材料(如有)
  • 主要用于屏幕阅读还是打印
从开始到拿到结果
1系统核对并处理
从同一规范内容生成两种格式,电子版核对层级与导航,确有打印需求再检查纸面效果。
2交付与接续
交回可编辑 DOCX、固定版 PDF 与附件;导出或字体有问题时保留原内容,重新核对页面。
从哪里开始

要求同一份内容同时得到可编辑 Word 和对应 PDF。

需要准备什么
  • 这次已确认的内容或要改的段落
  • 要附上的材料(如有)
  • 主要用于屏幕阅读还是打印
从开始到拿到结果
1系统核对并处理
从同一规范内容生成两种格式,电子版核对层级与导航,确有打印需求再检查纸面效果。
2交付与接续
交回可编辑 DOCX、固定版 PDF 与附件;导出或字体有问题时保留原内容,重新核对页面。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
11 月 4 日核对源码
版本 2.0.1;源输入结构仍覆盖四类文书,输出仍是 DOCX、PDF、附件包三种。四类材料和隔离安装后的虚构样张完成同源生成与复验,是 9 月初的历史记录;没有运行任何制作、Word 导出或安装验证。
关键规则与设计选择
1
四类材料的输入定义都在;网站总览重点讲合同协议和通知声明两类,不代表另外两类被删掉。
2
内部角色代码、事项编号、目的、渠道和参考号不进入对外正文;文档属性里的主题已清空,类别写人话类型。
3
2.0.1 安装包包含唯一 Word 导出资源;兼容构建与新入口共用同一实现。
4
Word 首选路线和备用 PDF 路线在清单中分开,不能互相冒充。
5
请求默认按电子版处理,明确标为打印才按打印验证;同一内容源,不强制两套版式。
当前怎样实现
  • A4 DOCX:四边 25 mm、页脚 12 mm 带页码,正文宋体 12 pt、1.5 倍行距,标题黑体 18 pt、小标题 13 pt。
  • 协议和单方文书按各自用途组织正文;可选的“依据”和附件随输入出现。
  • 协议每方都有独立的签字(盖章)和日期位置:需要本人签名时只在本人一方嵌入签名和日期,电子版且签名资料里有手印时手印放在签名旁(打印版不预印),其他方留空;不需要签名时各方签署位都留空,状态仍是“已生成”。
技术实现与依据(一)
这里保留实现、关键条件、精确入口、历史记录和验证结果。
11 月 4 日核对源码
版本 2.0.1;源输入结构仍覆盖四类文书,输出仍是 DOCX、PDF、附件包三种。四类材料和隔离安装后的虚构样张完成同源生成与复验,是 9 月初的历史记录;没有运行任何制作、Word 导出或安装验证。
关键规则与设计选择
1
四类材料的输入定义都在;网站总览重点讲合同协议和通知声明两类,不代表另外两类被删掉。
2
内部角色代码、事项编号、目的、渠道和参考号不进入对外正文;文档属性里的主题已清空,类别写人话类型。
3
2.0.1 安装包包含唯一 Word 导出资源;兼容构建与新入口共用同一实现。
4
Word 首选路线和备用 PDF 路线在清单中分开,不能互相冒充。
5
请求默认按电子版处理,明确标为打印才按打印验证;同一内容源,不强制两套版式。
当前怎样实现
  • 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 重新提取正文,逐项核对输出字段;旧版式的已存档成品按旧字段读回,不重写。
技术实现与依据(三)
1
验证计划
2
创建唯一构建临时目录
3
存档输入原字节与附件
4
按文书用途生成 DOCX
5
导出 PDF 或明确使用备用引擎
6
重读字段、各方签署位与签名
7
写构建清单并原子上线
  • 构建和材料包都在临时目录完成后原子替换上线;同名拒绝,失败清理临时目录。附件按输入顺序编号复制,中文名片段最长 80 字,复制后哈希不符即失败。
执行流程
技术实现与依据(三)
1
验证计划
2
创建唯一构建临时目录
3
存档输入原字节与附件
4
按文书用途生成 DOCX
5
导出 PDF 或明确使用备用引擎
6
重读字段、各方签署位与签名
7
写构建清单并原子上线
  • 构建和材料包都在临时目录完成后原子替换上线;同名拒绝,失败清理临时目录。附件按输入顺序编号复制,中文名片段最长 80 字,复制后哈希不符即失败。
执行流程
名词和入口
本模块用到的名词
名词意思
DOCX可继续编辑、修订和批注的 Word 文档;结构正确仍须逐页检查。
PDF固定版面输出;它来自同一内容源,不是另手工维护的一份正文。
Build ID(构建标识)一次不可覆盖制作的稳定名字;同名存在就拒绝覆盖。
Fallback(备用引擎)Word 不可用时使用的本地 PDF 路线,需要可嵌入的中文字体;清单会保留引擎和警告。
签署位协议里每一方的签字(盖章)和日期位置;只在本人一方嵌入本人签名。
专业定义

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

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

计划只定义制作路线;构建才生成 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。