用途与实际影响
这项功能怎样使用
为什么需要它
只有 DOCX/PDF 文件不够：输入、附件、逐页证据和签名来源缺一项，换机或复制后就无法解释成品怎样产生。
举个实际例子
我可以说：“逐页检查这份材料，彩色和黑白打印都不能裁字；再复制到一个空目录确认附件没有漏。”我会拿到逐页检查结果、发现的问题，以及复制后仍能独立核对的完整材料包。
最后我会得到什么
得到逐页检查结果和一份可带走的完整材料包：文书、附件、必要签名与核对清单都能再次验真。任何页面或附件不合格时只保留待修改版本。
可以继续制作
正文、页面和附件都核对后，材料包复制到别处仍能重新验证，才称本地可递送。
需要修正
页码、裁切、灰度、签名或文件集合有问题时指出具体页与材料，保留待修改版本。
当前不可用
页面无法渲染时不把结构检查当成肉眼检查通过。
从哪里开始
材料做好后，要求逐页核对并冻结可带走的包。
需要准备什么
- 要核对的这份构建或材料包
- 屏幕阅读或打印的实际用途
从开始到拿到结果
- 1
系统核对并处理
逐页查看内容、页码、可读性、签名和每个文件；机械检查齐全后冻结自包含版本。
- 2
交付与接续
交回已验包和清单；页面或附件不合格就保留旧版与具体失败位置，不冒充可递送。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
当前材料包复制到空目录后仍能完整核对；缺文件、多文件、路径越界或内容变化都会明确失败关键规则与设计选择
每页彩色与灰度图都是 manifest（清单） 可追溯 artifact，不是临时截图。
可见页码逐页匹配；空白和边缘裁切使用 ink/edge 启发式检查。
墨迹和边缘通过不证明签名身份、位置、对比度或未被遮挡；实际渲染页是进一步视觉核对的输入。
自动化仍不能证明整篇语气和事实主线已由AI或人工审阅。
v2 release继续可读，但明确返回legacy_v2_non_self_contained和limitations。
复制到空目录后完整verify不等于已有自动备份或断点续传。
本模块用到的名词
- Closure（闭包）
- 独立解释和验证成品所需的输入、输出、附件、审计、页面和签名快照完整集合。
- Exact set（精确集合）
- release 只允许 manifest（清单） 列出的文件；缺文件和额外文件都会让验证失败。
- Grayscale artifact（灰度页制品）
- 由每张彩色渲染页转换的L模式页面，用于检查打印灰度下的墨迹和边缘。
- legacy_v2_non_self_contained
- 历史v2仍可验证其真实携带内容，但没有v3输入、审计、灰度页和签名closure。
专业定义
ready_for_delivery（已具备递送条件）不由一个布尔值决定：正文、结构、页码、彩色/灰度页面、签名快照、附件与精确文件集合全部可重新核对，才形成 v3 release。
解决什么
解决“能打开就算完成”、递送包缺输入/审计、复制后无法复验和旧格式被新工具无版本破坏。
当前怎样实现
- DOCX/PDF结构审计与全部输出字段读回先运行。
- 现有v3自动管线由Poppler按DPI渲染每页彩色PNG，再生成L模式灰度辅助制品。9月18日媒介设计规则要求非打印成品采用彩色，打印才以灰度可读性作为用途验收；生成了灰度辅助图不表示交付黑白PDF，也不证明新版配色已经实际完成。本轮没有改渲染器或重做样张。
- 逐页记录大小、SHA-256、墨迹覆盖、边缘暗度和可见页码。
- v3 release按build manifest（清单）复制所有closure并拒绝额外文件。
- formal-verify在release根重跑嵌入build验证和当前结构/页面检查。
- v2/v3共享兼容schema（数据结构）；v2只按历史实际携带内容通过并返回限制。
执行流程
- 1
重读DOCX/PDF正文
- 2
检查结构和页码
- 3
渲染全部彩色页
- 4
生成并检查灰度页
- 5
写审计与每页哈希
- 6
复制完整closure到release
- 7
核对精确文件集合
- 8
空目录复制后独立verify
边界
- ink/edge不是整篇语义审阅或签名可见性证明
- 渲染成功不证明签名正确且清楚可见
- 灰度辅助制品不等于黑白交付要求：非打印PDF必须彩色，打印版本另验；同源不等于同版式，不强制两版，原件及已签署历史不改。
- manifest（清单） digest不是数字签名
- 普通复制恢复不等于可续传mirror
- v2限制不会被静默升级
失败与恢复
- 页面渲染器不可用
- page audit标为unavailable，只保留build，不形成release。
- 页码、灰度或页面边缘失败
- 记录精确页码和失败腿，修复后重新完整构建。
- release缺文件或有额外文件
- formal-verify失败，既有源和另一份副本不被删除。
- v2历史材料包
- 核对其DOCX/PDF、附件、状态和摘要，并返回缺少自包含closure的明确limitations。
真实入口
PRIVATE source · formal_documents.py内容读回、逐页审计、closure复制和v2/v3验证
PRIVATE source · audit.py结构、页面、墨迹和边缘检查
PRIVATE tests · self-contained release空目录恢复、缺/多文件和legacy兼容回归
如何验证
- v3 release在原build删除后从空目录副本verify通过。
- 删除输入或新增unexpected文件均失败。
- 无可见页码PDF被拒绝，灰度页必须为L模式并重新审计。
- 旧v2材料包通过有限验证且返回明确limitations。
- 人工整篇语义审阅回执仍为gap。
- 2026-09-18从正式f0a3c28的AGENTS、AGENT_ENTRY与设计合同回读屏幕彩色/打印灰度分工；规则发布只证明制作与验收要求改变，未生成个案材料、读取原件或重跑历史样张。
与其他模块的关系
通过本模块才产生ready_for_delivery候选；是否签名以及本地状态由下一模块说明。