能力入口 · 本地维护插件
PDF 安全渲染与目检
把当前 PDF 做成可以逐页核对的图片与总览，发现空白、裁切、错位或重叠；每次成功结果单独保存，失败不会把上一份可用页面图弄乱。
正式源码已更新 / 当前入口运行待验先看怎么用
你不需要记住 Skill 名，直接说需求就行
什么时候用
- 需要逐页检查PDF布局
- 先看全部页面总览，再放大密集或可疑页
- 需要确认页面图来自同一份 PDF，失败时还可继续看上一份报告
- 文件名是中文、只看部分页面，或需要明确区分前后两次页面图片
可以直接这样说
“检查这份二十页报告，先看全部页面，密集表格再放大；如果中途失败，上一份检查结果要还能打开。”系统固定本次输入、生成完整新一代页面，再一次切换报告指向它。
最后会得到什么
得到一份稳定报告，按其中的路径打开本次总览和页面图，再形成视觉结论。默认保留当前与上一代结果；中途失败或源 PDF 变化时保留上一份已接受报告，不混用新旧图片。
不适合这样用
- 只需要核对纯文本而不看布局
- 用来路不明的程序冒充正式页面渲染器
- 删除其他任务、未知文件或历史平铺输出
正常时
本次固定输入的页面与总览完整生成、源文件未变化后，稳定报告才指向新结果；逐页目检另给真实结论。
发现问题时
源 PDF 中途变化、漏页、图片校验不符或同时有人写同一输出时，本次不发布，上一份报告仍可用。
入口不可用或证据不足时
正式渲染器、Python 或输入不可用时停止这次渲染，保留原件与此前结果，不用旧图冒充本轮验收。
从哪里开始
在当前 AI 对话给出 PDF 并说明要看全部页面还是几页；AI 会生成可检查的页面图片与稳定总览，供本次视觉核对。
需要准备什么
- PDF 原件及要检查的页或全部页面
- 需要保存图片时的输出位置与清晰度要求；普通验收不必指定内部版本目录
为什么需要这个能力
PDF 能打开、页数正确，仍可能有内容被裁掉、字体错位或某页空白。只看命令返回值发现不了这些问题。
从需求到结果
提供当前 PDF、输出位置和需要检查的页。先保存不可变的临时输入副本，再按这一份生成图片；源文件在结束前变化就不发布本次结果。
先看全部页面和总览，再单独放大可疑页，检查文字太淡、裁切、重叠、表格、页眉页脚、签名和分页。
每次图片与总览单独保存，全部生成后才更新稳定报告；以后从报告打开这一版页面，不猜同目录里的旧图。
另一项任务正在写同一组图片时，这次明确停下，避免把两轮页面混成一组。失败的新结果不取代已经接受的报告。
默认保留本版和上一版；成功后才把能准确识别的更早版本移入 Windows 回收站。未知文件和其他任务结果不动，需要旧报告长期可用时可明确保留。
清理失败会提示，仍然有效的新报告保留；没有后台清理任务。渲染只证明页面能形成图像，内容与文字约束由制作或阅读环节核对。
通常交付最终 PDF，除非你要求图片；页面图与总览用于真实目检，生成它们不等于目检已经通过。
失败时会怎样恢复
另一个任务正在写同一组输出
系统反应：这次明确失败，不混入另一轮页面。
恢复方式：等原任务结束，或把这次独立检查放到另一组输出位置。
原 PDF 在渲染中变化
系统反应：新结果不发布，上一份报告仍可用。
恢复方式：确认要检查的稳定版本后重新运行。
渲染超时、漏页或校验不符
系统反应：清理未发布结果，保留此前已接受报告。
恢复方式：修复具体输入或渲染缺口后重新生成，不能手拼两代页面。
更旧版本清理失败
系统反应：新报告仍保持有效，并提示保留了哪些旧结果。
恢复方式：只处理这次报告已识别的更早版本，不删除未知或其他任务的文件。
页面图已生成，但肉眼仍发现问题
系统反应：不把渲染成功称作视觉或内容通过。
恢复方式：按实际页码回到制作环节修复，再沿新报告检查本轮完整页面。
技术身份与验证证据
Skill · pdf-render-safe · 成熟度 A（稳定）
这个 Skill 用到的名词
- 不可变输入
- 先复制临时PDF快照，input_sha256与bytes绑定实际渲染副本；发布前重验source hash（源文件指纹）。
- Generation（一次完整页面版本）
- 逐页PNG与contact sheet（页面总览图）进入独立版本目录，完整后才由稳定<prefix>_report.json选中。
- 稳定报告
- 读取report中的pages/contact实际路径；不按prefix猜历史平铺文件。失败未发布代删除但旧报告保留。
- 保留与清理
- 默认当前和最新上一代；成功后仅该prefix已识别更旧代进回收站，未知及legacy平铺不动。--keep-stale保留历史报告路径，无后台清理。
- 并发边界
- 同output-dir与prefix非阻塞文件锁，竞争运行失败；真实Poppler且有timeout（等待超时）。
- 页面质量
- 先150 DPI全量与总览，再不同prefix选页高DPI；report还记录页数、选页、renderer/version、尺寸与逐页hash（内容指纹）。渲染不证明语义。
专业定义
通过PCConfig登记Host Python从不可变PDF快照渲染独立generation（代际），完整后原子发布稳定report；源漂移或失败保留旧报告，同prefix锁防止混写，默认保留当前和上一代。
执行参考
下面保留 AI 和工具实际使用的参数、步骤与依赖。日常使用可以直接提出需求，不需要先手工准备这些协议。
输入
- PDF路径、output-dir与prefix
- dpi、pages和可选contact-sheet；高DPI选页使用不同prefix
- 需要长期保留旧报告路径时显式--keep-stale
输出
- 稳定<prefix>_report.json及其选中的完整generation（代际）
- generation（代际）内逐页PNG与可选contact sheet（页面总览图）的实际路径
- snapshot/source SHA、字节、源页数、选页、renderer/version、DPI、尺寸和逐页hash（内容指纹）
- 成功、失败保旧、同prefix竞争或清理warning的独立结果
执行顺序
- 1
Invoke-MdPdfToolkit.ps1 render使用PCConfig注册Host Python。
- 2
取得同output-dir/prefix的非阻塞文件锁；竞争失败，不混写。
- 3
先复制不可变临时PDF快照，report input_sha256/bytes绑定实际渲染副本。
- 4
用真实Poppler和有界timeout（等待超时）生成唯一generation（代际）及可选contact sheet（页面总览图）。
- 5
核验完整输出，并在发布前重新计算源hash（内容指纹）；源变化保留旧报告。
- 6
完整generation（代际）生成后原子切换稳定report；读者沿report实际路径读取，不猜平铺文件名。
- 7
失败的未发布generation（代际）清理；成功后默认保留当前与最新上一代。
- 8
只把该prefix已识别更旧generation（代际）送Windows回收站；未知/legacy平铺文件不动，清理失败warning不撤销已接受report，--keep-stale保留历史路径。
- 9
先150DPI全量总览，再用不同prefix选页高DPI检查；通常交付PDF而非内部图片。
操作边界
- 渲染快照与源二次hash（内容指纹）分开，源漂移不发布新结果
- 稳定report只指向完整generation（代际），失败不覆盖旧报告
- 同prefix并发采用非阻塞锁；Poppler必须是真实可执行文件
- 默认当前加上一代，不删除未知文件或legacy平铺输出，不建后台清理
- 渲染仅证明栅格化；语义完整性、文字提取和页数合同另验
依赖
- md-pdf-toolkit统一启动器与PCConfig登记Host Python
- 真实Poppler可执行文件
- Pillow与PDF解析依赖
验证状态
源码、安装、供应检查、当前任务、新任务和真实使用分别列出；一层通过不自动提升另一层。
- Source（源码）
- 本轮定向核对 .agents 已发布 main 83db4ff5c274c309207340114af02bdd9ea99758 中的规范 Skill 原文；未采用进行中的未提交修改。
- Install（安装）
- 保留原供应安装观察；本轮未重新运行已发布统一启动入口，不宣称新版已安装并实测。
- Transaction（供应事务）
- 供应事务检查通过；供应采集于2026-09-24 12:56（中国时间），未重跑真实PDF转换或渲染
- Current task（当前任务）
- 本轮核对已发布 Skill 与相关活动合同并修正网页说明；未处理私人业务材料或运行真实能力任务。
- Fresh task（全新任务）
- 新任务回执未知
- End to end（端到端）
- 本轮未执行新版真实转换/渲染与逐页目检；已发布源码不等于当前运行或视觉验收通过。
正式源码cdb09b1包含不可变快照、独立generation（代际）、源漂移保旧、原子report、同prefix锁及保留/回收边界回归。本轮只读已发布原文与实现身份，未重跑源测试、真实页面渲染或目检；旧平铺输出验收不作为新generation（代际）链运行证明。
证据时间与来源
- Observed at（观察时间）
- 2026-09-22：已发布 Skill 正文与活动 E166 合同定向核对；安装、运行与既有业务测试保留各自原观察，不由本轮文字核对刷新。
- Source commit（来源提交）
83db4ff5c274c309207340114af02bdd9ea99758- Supply command（供应验证命令）
E:\.agents\tools\Test-PersonalSkillSupply.ps1 -RequireInstalled -NoExternalEvidence -Json- Evidence basis（证据来源）
- 已发布 main 83db4ff 的 plugins/md-pdf-toolkit/skills/pdf-render-safe/SKILL.md 与活动 E166 相关合同；正文、源码身份与安装/运行/E2E（端到端验证）各自区分，未将文字核对当成业务验收。
Canonical source（唯一维护源）
E:\.agents\plugins\md-pdf-toolkit\skills\pdf-render-safe\SKILL.md该路径是维护源；用户目录中的发现入口不是第二份源码。