100 added, 54 removed. Audit A to A.
---
name: lls-document-print-restorer
+ description: "把仍可辨认的纸质文件照片保守增强、规范排版成 A4 PDF，并保留输入哈希、处理参数、预览和人工核对记录。用于表格、票据、手写页或旧文档偏灰、轻微模糊、方向错误、边距不适合打印时；只改善可见内容，不猜测或重造缺失文字、数字、签名、公章和法律证据。"
license: CC-BY-NC-SA-4.0
- description: 保守增强拍摄的纸质文件照片，并生成A4打印版PDF。 当用户需要“纸质表格、票据或手写页照片偏灰、对比度低、打印不清。”时使用。
+ metadata:
+ short-description: 保守增强可见内容并生成可复核 A4 打印版
---
<!-- workbuddy-install: published; slug: lls-document-print-restorer -->
## 在 WorkBuddy 中找到并安装
**Skill slug：`lls-document-print-restorer`**
在 WorkBuddy 新会话粘贴：
```text
请按 https://skillhub.cn/install/skillhub.md 检查 SkillHub，搜索 `lls-document-print-restorer`；仅在 slug 完全一致时安装到 `~/.workbuddy/skills/`。安装后读取 `~/.workbuddy/skills/lls-document-print-restorer/SKILL.md`，核对 name、version 和实际路径，然后新开会话触发该 Skill。
```
也可以打开左侧「技能」→「添加技能 / 查找技能」，搜索 `lls-document-print-restorer` 后安装；界面文字可能随 WorkBuddy 版本变化。
# 罗老师纸质文件打印修复助手
- > 类型：LLS Original
- > 当前版本：1.1.0
- ## 一句话用途
+ ## 边界先说清
- 保守增强拍摄的纸质文件照片，并生成A4打印版PDF。
+ 本 Skill 做的是“让原本可见的内容更适合阅读和打印”，不是恢复不存在的信息。
- ## 什么时候使用
+ 允许：方向纠正、保守对比度、轻度锐化、白底 A4 排版、预览和报告。
- 纸质表格、票据或手写页照片偏灰、对比度低、打印不清。
+ 排除：补写缺字、重绘签名、公章、证件纹理，改变数字，拼接法律证据，声称恢复了无法辨认的原文。
- ## 哪些情况换别的方法
+ ## 必要输入
- 需要恢复法律意义上的缺失文字或重制公章、签名。
+ ```text
+ 原始照片：
+ 文件类型和用途：个人阅读 / 普通打印 / 归档参考 / 正式提交
+ 纸张方向：自动 / 竖向 / 横向
+ 是否必须保留颜色：
+ 关键核对字段：金额、日期、编号、签名等
+ 输出 PDF、预览和报告路径：
+ 隐私与本地处理要求：
+ ```
- ## 3 分钟上手
+ 正式提交或证据场景优先咨询相应机构对扫描件、复印件和修复件的接受标准。
- 复制下面这句话给 AI：
+ ## 一、先评估输入
- ```text
- 请用 lls-document-print-restorer，把这张表格照片做成A4打印版。
- ```
+ 分别标记：
- ## 标准工作流程
+ - 清晰：笔画边界稳定，可直接增强；
+ - 偏灰：背景与文字对比不足；
+ - 阴影：局部明暗不均；
+ - 透视：页面四角不平行；
+ - 运动模糊：字符拖影；
+ - 过曝/欠曝：细节已经截断；
+ - 裁切缺失：边缘文字不在照片中；
+ - 遮挡/折痕：原始内容不可见。
- 1. **检查模糊、阴影、折痕和裁切问题**
- 2. **优先使用确定性对比度与锐化**
- 3. **需要AI修复时限制为视觉增强且禁止补字**
- 4. **生成A4 PDF并人工核对关键数字**
+ 后四类无法通过“增强”可靠补回，应重新拍摄或向原文件来源索取副本。
- ## 完整案例
+ ## 二、决定重拍还是处理
- 输入：偏灰但内容基本可见的签收表。
+ 优先重拍的条件：
- 输出：增强JPG、A4 PDF、关键数字复核提醒。
+ - 关键数字无法逐字符识别；
+ - 页面缺角或被手指遮挡；
+ - 反光覆盖正文；
+ - 透视严重到行列变形；
+ - 签名、印章或编号将用于正式用途。
- ## 输出标准
+ 重拍建议：平行页面、均匀散射光、避免数码变焦、四角全部入镜、用最高原始分辨率保存。
- 最终结果至少包含：
+ ## 三、保留原件与输入指纹
- - 用户真正要完成的任务；
- - 可执行步骤，而不是只有观点；
- - 关键事实、假设和未知项；
- - 完成前的检查清单；
- - 下一步最小动作。
+ 不覆盖原图。把原图放在只读 `source/`，处理结果放到 `output/`，报告放到 `qa/`。
- ## 隐私、依赖与权限
+ 脚本会记录输入和输出 SHA256，便于证明处理对象与产物对应，但哈希不证明内容法律效力。
- 票据和签名属于敏感资料；默认本地处理并避免上传公开服务。
+ ## 四、生成 A4 PDF
- 默认只读取用户明确提供的材料。涉及账号登录、文件写入、网络请求或外部发布时，先说明实际动作与影响范围。
+ ```bash
+ python3 scripts/make_a4_pdf.py source/form-photo.jpg output/form-a4.pdf --orientation auto --margin-mm 12 --contrast 1.12 --sharpness 1.08 --preview qa/form-a4-preview.png --report qa/form-a4-report.json
+ ```
- ## 质量检查
+ 脚本会：
- 交付前逐项检查：
+ 1. 按 EXIF 纠正手机方向；
+ 2. 使用有限范围的对比度与锐度；
+ 3. 等比例缩放到 300 DPI A4 页面；
+ 4. 居中并保留指定毫米边距；
+ 5. 生成 PDF、可视预览和 JSON 报告。
- 1. 是否回答了用户的真实任务；
- 2. 是否把事实、推断和建议分开；
- 3. 是否给出至少一个可复制的下一步；
- 4. 是否移除了本机路径、账号、密钥和客户资料；
- 5. 是否说明依赖、权限和失败处理。
+ 目标存在时默认停止；`--force` 会先把旧目标改名备份。
- ## 常见问题
+ ## 五、人工核对关键内容
- ### 结果太泛怎么办？
+ 原图与预览并排，以字符为单位核对：
- 补充目标用户、真实输入、期望输出和一个失败例子，再运行一次。
+ - 姓名、日期、金额、编号；
+ - 小数点、负号、斜杠；
+ - 表格行列对应关系；
+ - 手写改动、签名和印章位置；
+ - 页面是否完整、方向是否正确。
- ### 可以直接公开结果吗？
+ 看不清的字符标记 `[不可辨认]`，不要依上下文自动补全。
- 先检查来源、个人信息、客户内容、截图和下载链接，再决定发布范围。
+ ## 六、打印前检查
- ## 版本与更新记录
+ - PDF 页面尺寸为 A4；
+ - 打印对话框选择“实际大小”或确认缩放策略；
+ - 最小文字在纸上可读；
+ - 边缘没有被打印机不可打印区域裁掉；
+ - 彩色信息没有因黑白打印丢失含义；
+ - 试打一页并与原图核对。
- - 1.0.0：首次公开教学版。
+ ## 输出格式
- ## 三端入口
+ 1. 输入质量分级与重拍判断；
+ 2. 处理参数和执行命令；
+ 3. A4 PDF 与预览路径；
+ 4. 输入/输出 SHA256 报告；
+ 5. 关键字段逐项核对表；
+ 6. 不可辨认、未处理和正式用途风险。
- - GitHub 源码：https://github.com/PhilRobinluo/ai-coevolution-skills/tree/main/skills/lls-document-print-restorer
- - GitHub Release：https://github.com/PhilRobinluo/ai-coevolution-skills/releases/tag/lls-document-print-restorer-v1.0.0
- - 飞书中文教程：https://m2wlgni9k4.feishu.cn/wiki/J6KLwLfvAiemc2kXss0cjOVmnnd
- - SkillHub：搜索唯一 slug `lls-document-print-restorer`
+ ## 失败处理
- ## 支持项目
+ - 输入打不开：保留原文件并报告格式，不自动转存覆盖。
+ - 处理后笔画出现光晕：降低 sharpness 和 contrast，重新从原图生成。
+ - 阴影严重：优先重拍；局部算法处理需另行验证，不假装本脚本已解决。
+ - PDF 太大：先保留无损主版本，再为传输生成副本。
+ - 输出已存在：更换文件名，或显式 `--force` 并保留备份。
+ - 关键字符仍不清楚：标记不可辨认并停止推断。
- 如果这个 Skill 帮你节省了时间，欢迎给总仓库点一个 Star，并使用 Watch Releases 接收新版通知：
+ ## 质量门禁
- https://github.com/PhilRobinluo/ai-coevolution-skills
+ - [ ] 原图未被覆盖，输入哈希已记录；
+ - [ ] 已区分可增强问题与不可恢复信息；
+ - [ ] 对比度、锐度和边距参数在报告中可复核；
+ - [ ] 图像未拉伸，方向和页面尺寸正确；
+ - [ ] 关键数字、日期、编号逐字符与原图核对；
+ - [ ] 无法辨认的内容没有被猜测补写；
+ - [ ] PDF 通过预览和实际打印尺寸检查；
+ - [ ] 正式提交用途保留原始文件并标明处理版本；
+ - [ ] 票据、签名和个人资料默认本地处理；
+ - [ ] 产物、预览、报告和风险说明一并交付。
+
+ 核对表见 [references/restoration-qa.md](references/restoration-qa.md)。
+
+ ## 使用入口
+
+ - [飞书中文教程](https://m2wlgni9k4.feishu.cn/wiki/J6KLwLfvAiemc2kXss0cjOVmnnd)
+ - [SkillHub 安装页](https://skillhub.cn/skills/lls-document-print-restorer)
+ - [GitHub 源码](https://github.com/PhilRobinluo/ai-coevolution-skills/tree/main/skills/lls-document-print-restorer)
+ - [GitHub 1.1.0 安装包](https://github.com/PhilRobinluo/ai-coevolution-skills/releases/download/lls-document-print-restorer-v1.1.0/lls-document-print-restorer-1.1.0.zip)