
文书和材料制作 · 功能说明
用户能知道当前版本到底是已生成、本人已签还是已经锁定可递送,而不会把一张签名图误写成外部结果。协议里每一方都有自己的签字位置,只在本人那一方放本人的签名。
当前情况:签署人核对、签名资产封存和协议每方独立签署位都已实现(11 月 4 日核对源码);电子版有手印资料时手印放在本人签名旁,打印版不预印。PDF 中的签名和手印是否清晰、位置正确仍需看真实页面,图片数量不够证明。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


文书和材料制作 · 功能说明
用户能知道当前版本到底是已生成、本人已签还是已经锁定可递送,而不会把一张签名图误写成外部结果。协议里每一方都有自己的签字位置,只在本人那一方放本人的签名。
当前情况:签署人核对、签名资产封存和协议每方独立签署位都已实现(11 月 4 日核对源码);电子版有手印资料时手印放在本人签名旁,打印版不预印。PDF 中的签名和手印是否清晰、位置正确仍需看真实页面,图片数量不够证明。
具体测试保留各自日期,页面不实时探测运行状态。
项目源码:私有仓库,源码未公开;用法与技术说明可在下面阅读。


用途与实际影响
签署人、签名资产、日期和最终 PDF 只要错一项,就可能用错版本;反过来,不需要签名的材料也不能伪造“本人已签”状态。协议有好几方,签名放错一方或替对方签都不行。
我可以问:“这份协议需要我签名吗,现在能不能发?”系统会先核对接收要求和实际页面:每一方都有签字和日期位置,只有我这一方放我的签名和日期,对方处留空;无需签名的材料在内容与版面通过后可进入待递送,需要签名的还要确认签名属于本人、位置正确且清楚可见。真要发,还要过收件方审读和发送当下核对。
知道这份本地文件是刚生成、无需签、待本人签、已签、封好待审读还是已可递送;这些状态都不等于实际送出,也不代表对方已签、合同已生效或已履约。

用途与实际影响
签署人、签名资产、日期和最终 PDF 只要错一项,就可能用错版本;反过来,不需要签名的材料也不能伪造“本人已签”状态。协议有好几方,签名放错一方或替对方签都不行。
我可以问:“这份协议需要我签名吗,现在能不能发?”系统会先核对接收要求和实际页面:每一方都有签字和日期位置,只有我这一方放我的签名和日期,对方处留空;无需签名的材料在内容与版面通过后可进入待递送,需要签名的还要确认签名属于本人、位置正确且清楚可见。真要发,还要过收件方审读和发送当下核对。
知道这份本地文件是刚生成、无需签、待本人签、已签、封好待审读还是已可递送;这些状态都不等于实际送出,也不代表对方已签、合同已生效或已履约。

不需签名的版本,或确需签名且已核对本人签名与页面的版本,完成其他检查后成为候选;再过收件方审读和发送当下核对,才标为可递送。
签名人、图片来源或最终可见性对不上时保留待核,不用图片存在代替已签。
必要签名材料或页面检查不可用时暂停签名与可递送步骤,不造占位签名。

不需签名的版本,或确需签名且已核对本人签名与页面的版本,完成其他检查后成为候选;再过收件方审读和发送当下核对,才标为可递送。
签名人、图片来源或最终可见性对不上时保留待核,不用图片存在代替已签。
必要签名材料或页面检查不可用时暂停签名与可递送步骤,不造占位签名。

说明这份文件需不需要本人签名,并问现在能否递送。
- 这份文件需不需要本人签名
- 准备采用的递送方式(若已决定)


说明这份文件需不需要本人签名,并问现在能否递送。
- 这份文件需不需要本人签名
- 准备采用的递送方式(若已决定)



- 签名配置与图片必须是普通可读文件,签名图按配置所在目录解析。
- 构建封存签名配置与签名图,并重算快照大小和 SHA-256;这种内容摘要不是密码学签名。
- 输入结构有手印开关 signature.fingerprint,默认打开:需要签名、用电子版、签名资料里有可读手印且请求没有关掉时,DOCX 和 PDF 把手印放在本人签名旁;打印版不管开关怎么设都不预印;没有手印资料时不凭空生成。手印只是一张图,不代表生物身份认证。


- 签名配置与图片必须是普通可读文件,签名图按配置所在目录解析。
- 构建封存签名配置与签名图,并重算快照大小和 SHA-256;这种内容摘要不是密码学签名。
- 输入结构有手印开关 signature.fingerprint,默认打开:需要签名、用电子版、签名资料里有可读手印且请求没有关掉时,DOCX 和 PDF 把手印放在本人签名旁;打印版不管开关怎么设都不预印;没有手印资料时不凭空生成。手印只是一张图,不代表生物身份认证。

- DOCX 对内嵌媒体做完整 SHA-256 匹配;PDF 只合计每页图像数,要求至少 1,不检查它是否就是签名或手印、是否实际可见。
- 备用 PDF 按签名原图宽高比放置、过宽等比缩小,每方签署块不跨页拆开;这是实现,不是看过所有真实签署页的证据。
- 渲染页的墨迹覆盖和边缘暗度检查不识别签名位置、遮挡或可读性。
- 构建状态为“已生成”或“本人已签”;材料包阶段只形成技术候选(ready_for_delivery=false、recipient_review_required=true、delivery_allowed=false),并固定“未递送”;过了独立审读和发送当下核对,核对结果才允许递交。历史清单里写的状态和技术 passed=true 都不等于现在可发。

- DOCX 对内嵌媒体做完整 SHA-256 匹配;PDF 只合计每页图像数,要求至少 1,不检查它是否就是签名或手印、是否实际可见。
- 备用 PDF 按签名原图宽高比放置、过宽等比缩小,每方签署块不跨页拆开;这是实现,不是看过所有真实签署页的证据。
- 渲染页的墨迹覆盖和边缘暗度检查不识别签名位置、遮挡或可读性。
- 构建状态为“已生成”或“本人已签”;材料包阶段只形成技术候选(ready_for_delivery=false、recipient_review_required=true、delivery_allowed=false),并固定“未递送”;过了独立审读和发送当下核对,核对结果才允许递交。历史清单里写的状态和技术 passed=true 都不等于现在可发。




| 名词 | 意思 |
|---|---|
| produced(已生成) | 文书已生成和核对,但没有声明本人签名已固定。 |
| signed(本人已签) | 本地成品包含核对过的本人签名资产;不表示其他人签名或外部动作。 |
| ready_for_delivery(可递送) | 确切版本、接收对象、渠道、附件和指纹已锁定,并已过收件方审读和发送当下核对,delivered仍为false;刚封好的材料包这里是false。 |
| Fingerprint(电子手印) | 签名资料里可选的手印图;电子版默认带入,打印版不预印;不是生物身份认证。 |
| Signature asset(签名资产) | 受profile管理并以SHA-256绑定的签名图片;不是证书签名或可信时间戳。 |

签名是一个独立制作步骤:需要时核对规范 profile 和图片 hash(内容指纹),不需要时明确保持 produced(已生成);两种情况都要经过完整审计、独立收件方审读和发送当下核对,才能进入 ready_for_delivery(已具备递送条件)。



签名是一个独立制作步骤:需要时核对规范 profile 和图片 hash(内容指纹),不需要时明确保持 produced(已生成);两种情况都要经过完整审计、独立收件方审读和发送当下核对,才能进入 ready_for_delivery(已具备递送条件)。

- 不生成占位签名;协议的空签署位不是占位签名
- PDF 图像对象计数不证明签名身份、位置或最终可见性
- 不把图片哈希称为密码学签名,也不把手印图称为身份认证
- 不把本人签名称为对方签回
- 不把可递送称为已递送
- 制作工具不自动执行外部动作
- 签名配置姓名与请求不一致: 构建前失败,不选择其他签名图片。
- 协议方数不足或本人对上不止一方: 构建前失败。

- 不生成占位签名;协议的空签署位不是占位签名
- PDF 图像对象计数不证明签名身份、位置或最终可见性
- 不把图片哈希称为密码学签名,也不把手印图称为身份认证
- 不把本人签名称为对方签回
- 不把可递送称为已递送
- 制作工具不自动执行外部动作
- 签名配置姓名与请求不一致: 构建前失败,不选择其他签名图片。
- 协议方数不足或本人对上不止一方: 构建前失败。

- 签名图片不可读或越出配置目录: 停止签名步骤,保留请求和旧版本。
- DOCX 没有匹配签名图,或 PDF 图像对象为 0: 当前机械检查失败,不形成材料包;PDF 对象数大于 0 也不能反向证明签名可见。
- PDF 有图片但签名位置或可见性尚未核实: 保留渲染页供核对,明确签名视觉证据仍未闭合;现行命令行没有专门识别这一缺口的自动检查。
- 无需签名: 明确保持“已生成”;单方文书不加签名线,协议保留各方空签署位;通过审计和收件方审读后仍可进入可递送,但不写“已签”。

- 签名图片不可读或越出配置目录: 停止签名步骤,保留请求和旧版本。
- DOCX 没有匹配签名图,或 PDF 图像对象为 0: 当前机械检查失败,不形成材料包;PDF 对象数大于 0 也不能反向证明签名可见。
- PDF 有图片但签名位置或可见性尚未核实: 保留渲染页供核对,明确签名视觉证据仍未闭合;现行命令行没有专门识别这一缺口的自动检查。
- 无需签名: 明确保持“已生成”;单方文书不加签名线,协议保留各方空签署位;通过审计和收件方审读后仍可进入可递送,但不写“已签”。

- PRIVATE source · formal_documents.py 签名配置、签名图封存、协议各方签署位与状态
- PRIVATE source · signature helpers 签名图片嵌入和规范路径
- PRIVATE tests · signature/readback 签署人、图片哈希、协议签署位、已生成/已签/可递送回归
- 签署人不匹配和直接注入图片路径均失败。
- 签名配置和签名图快照被纳入 v3 闭包。
- 手印有 6 个合成组合(合同和单方两类,电子默认带入、显式关闭、打印强制不带),定义在,没有运行,也没看过真实手印。
- 合成签名测试核对 DOCX 签名图已验证与 PDF 图像数至少 1;这只证明当前机械条件,不证明 PDF 签名像素、身份或位置正确。
- 无需签名的单方文书保持“已生成”且不含签名线;无需签名的协议保留各方空签署位。

- PRIVATE source · formal_documents.py 签名配置、签名图封存、协议各方签署位与状态
- PRIVATE source · signature helpers 签名图片嵌入和规范路径
- PRIVATE tests · signature/readback 签署人、图片哈希、协议签署位、已生成/已签/可递送回归
- 签署人不匹配和直接注入图片路径均失败。
- 签名配置和签名图快照被纳入 v3 闭包。
- 手印有 6 个合成组合(合同和单方两类,电子默认带入、显式关闭、打印强制不带),定义在,没有运行,也没看过真实手印。
- 合成签名测试核对 DOCX 签名图已验证与 PDF 图像数至少 1;这只证明当前机械条件,不证明 PDF 签名像素、身份或位置正确。
- 无需签名的单方文书保持“已生成”且不含签名线;无需签名的协议保留各方空签署位。

- 渲染器不可用的回归保持不可递送且不生成材料包。
- 测试文件现有 31 个函数、51 个用例(11 月 4 日静态计数,没有运行);真实签名和外部递送端到端验证没有运行。
本模块只负责本地签名和递送版本;递送之后的现实状态必须进入下一模块回读。

- 渲染器不可用的回归保持不可递送且不生成材料包。
- 测试文件现有 31 个函数、51 个用例(11 月 4 日静态计数,没有运行);真实签名和外部递送端到端验证没有运行。
本模块只负责本地签名和递送版本;递送之后的现实状态必须进入下一模块回读。
数字截至 2026 年 11 月 6 日
复制 AI 续作说明
项目:把本人签名、无需签名和可递送版本准确分开;仓库:页面未提供仓库地址;范围:整个项目;目标:(这里写这次要做的事)。先读项目的 AGENTS.md 和说明,按现行规则做。
把“目标”换成这次要做的事,整段复制给 AI。







