纸匠 PaperCraft 是一款开源、本地优先的 Windows 图片与 PDF 排版打印软件，也是一套面向真实办公场景的发票 OCR、AI 报销整理、报销单套打、凭证归档和本地账套工具。
- 把 AI / OCR 配置指南 发给 Codex、Claude Code 或你正在使用的 AI 工具。
- 在 PaperCraft 点击“设置 → AI 配置 → 复制脱敏配置”，把复制结果也发给它。
- AI 会核对官方文档和具体字段；遇到登录、密钥、付费测试或无法代办的界面时，会明确引导你亲自完成。
只需再附上这句话：
请阅读这份 PaperCraft 配置指南，并把它作为配置规范。先根据我提供的脱敏配置核对连接和任务分配；你能安全完成的步骤直接帮助我完成。涉及登录、输入密钥、付费调用、隐私确认或你无法操作的界面时，请停下来明确告诉我在哪里点击、填写什么、怎样判断成功，然后继续帮我检查测试结果。不要索取或回显任何密钥。
如果 AI 工具不能打开链接，可下载并直接上传 docs/AI_CONFIGURATION.md。这套“脱敏配置 + 可执行指南 + 人工接管点”是 PaperCraft 的特色能力：AI 能做的交给 AI，安全与授权始终由用户掌握。
OCR 与 AI 完全由使用者自由选择。 PaperCraft 不内置、代售或强制绑定任何收费接口，也没有会员、订阅、积分、内购、接口转售或抽成。你可以只使用免费的 Windows 本地 OCR，也可以在设置中自行配置腾讯云、MiniMax、通义千问或其他兼容服务；若选用第三方云服务，相关费用仅由对应服务商收取，与 PaperCraft 及其作者无关。不配置 OCR 或 AI，也不影响图片 / PDF 排版和打印功能。
它把图片 / PDF 导入、自由分槽排版、真实纸张预览、单双面打印、票据识别、报销查重与销账管理收敛到一条工作流，适合财务票据、购物小票、证件、二维码、标签及日常办公资料。
PaperCraft is an open-source, local-first Windows desktop app for image/PDF layout printing, invoice and receipt OCR, AI-assisted expense reporting, reimbursement form printing, evidence archiving, and local expense ledger management. Bring your own OCR/AI provider: PaperCraft has no subscription, in-app purchase, API resale, or provider lock-in.
下载最新版 · AI / OCR 配置指南 · 查看功能 · 隐私与安全 · 从源码构建
| 版本 | 适合谁 | 下载 |
|---|---|---|
| v0.2.9 当前版 | 需要账套自动保存、视觉 AI 报销整理、查重、套打、归档与销账的用户 | 下载 v0.2.9 |
| v0.1.2 经典版 | 只需要较轻量的图片 / PDF 分槽排版与打印，或希望保留早期交互的用户 | 下载 v0.1.2 |
两个版本都保留在同一仓库的独立 Release 中，可分别下载和解压运行；它们不是覆盖式安装包。请选择一个版本处理正式数据。若要在同一台电脑对比运行，建议使用 Windows 沙盒或另一个 Windows 用户，因为两版会读取同一用户目录下的 %LocalAppData%\PaperCraft\settings.json，旧版可能无法保留新版增加的设置字段。v0.2.9 的账套数据库可先在“设置 → 账套与备份”创建备份。
| 场景 | 纸匠可以做什么 |
|---|---|
| 发票、票据和购物小票打印 | 多图 / PDF 自动续页，A4 / A5 分槽排版，保持比例并按打印机安全区输出 |
| 财务报销整理 | 视觉 AI 或 OCR 识别付款凭证，生成结构化报销明细并拦截重复报销 |
| 预印报销单套打 | 独立打印机、字段拖动定位、正交格网校准、整单重打和凭证同步输出 |
| 报销台账与销账 | 本地账套保存编号、批次、状态、证据和历史查重索引 |
| 证件、二维码、标签及办公图片 | 自由调整槽位比例、非破坏性裁切、旋转、粘贴、批量打印和双面打印 |
以下是经典版的实际界面；当前版沿用同一排版工作流，并新增账套、报销出具和报销管理。
- 支持 JPG、PNG、WebP、BMP、TIFF、剪贴板图片和按页导入 PDF。
- 支持 A4、A5、自定义毫米纸张、横竖方向、页边距和槽间距。
- 可从纸张上、下、左、右增减槽位，已有素材按原顺序紧凑重排。
- 可拖动编辑区的黑色分隔线，单独调整当前页相邻槽位的比例。
- 可拖动所选槽位的四条裁切虚线，非破坏性去除图片无用边缘；辅助线不会进入打印、PDF 或 OCR。
- 图片默认完整等比显示且不裁切，也支持填满裁切、源 DPI 和左右旋转。
- 支持拖入、粘贴、连续双击重复放置同一素材、拖动换位、页面插入 / 删除 / 移动、撤销与重做。
- 双击槽位分隔线可恢复等分，双击裁切虚线可恢复完整图片。
- 素材卡片可仅从素材列表移除，或通过内联二次确认将原文件移入 Windows 回收站；PDF 会按同一源文件处理全部页面。
- 素材可直接打开源文件对应的 Windows Shell 原生右键菜单。
- 使用独立的本机 SQLite 账套保存唯一工作台、素材副本、OCR 文本和 AI 输出；工作状态会自动保存，重新启动后直接恢复上次关闭现场。
- 动态读取 Windows 打印驱动的纸张与双面能力，记住上次打印机，默认单面。
- “生成报销明细”会将槽位实际可见图片交给主用视觉 AI；JSON 校验失败时按设置自动重试，仍失败再切换备用连接。PaperCraft 不按模型名称猜能力：直接读图的连接必须由用户核对官方文档、显式声明支持图片并通过读图测试。
- 支持 Anthropic Messages、OpenAI Chat Completions、OpenAI Responses 及兼容服务；预设只提供填写起点，模型能力、密钥与地址均由用户自行核对和设置。MiniMax 官方 Anthropic 兼容接口当前不支持图片输入，适合整理 OCR 文字，不应直接读取槽位图片。
- “仅 OCR”可指定视觉 AI，也可继续使用 Windows 本地 OCR、腾讯云票据 OCR与高精度通用 OCR；识别结果仍可人工修正和重新整理。
- AI 使用固定 JSON 协议返回日期、费用内容、金额、来源槽位、附件张数及查重元数据；程序会规范八位日期并拒绝缺日日期、零金额、无效来源或不合格 JSON。
- 可从 OCR/AI 结果生成报销条目，独立编号，套打预印报销单，并将证据图片按编号归档到本地台账；大写金额按拾万至分逐格输出并封闭空位。
- 报销管理采用左侧整单、右侧明细的主从界面（每单 1–5 项）：可按编号、日期、费用内容、整单金额或任一项目金额搜索；双击整单或具体明细字段即可原位编辑。
- 在报销管理详单中悬停任一项目，可按屏幕大小显示约半屏至八成高的归档凭证预览；人工录入、历史导入或文件已移动时会明确说明，不会弹出空白预览。
- 已打印且尚未报销的整单可按项目重新拆成 2–5 张报销单，保留原编号、凭证和查重信息；重打时可使用独立打印机同步输出归档凭证图片。
- 重打、标记“已报销”和“已销账”始终按整单执行；批量重打逐单记录进度，后续任务失败不会抹去已经成功提交的记录。
- AI 生成完成后会自动整理到报销草稿；只有手动修改 OCR/AI 文本后，才需要点击“重新整理”。
- 历史 Excel 可通过迁移工具导入账套中的查重索引；原 Excel 只读不改，迁移前会自动备份当前台账并输出审计报告。
- 报销单套打使用空白单据上的可拖动内容格定位字段，再以 1–6 / A–F 正交格网分别校准横、纵打印偏差；不引入旋转或斜切。
- 出具报销单前会按本地台账查重，拦截确定重复或高度疑似重复的报销条目。
- AI 设置将“服务商连接”和“任务分配”分开：可分别指定图片整理主用 / 备用、OCR 后文字整理和仅 OCR；连接选项会显示模型、读图能力与 JSON 模式，避免把文本模型误用于上传图片。
- 设置页可复制不含密钥、票据正文和账套路径的脱敏配置，让 Codex 或其他 AI 按 AI / OCR 配置与调试指南 接手配置、核对能力并主动引导用户完成登录、密钥和测试等人工步骤；软件不会自动执行付费测试或切换连接。
- 打印任务成功提交后，可选择将符合条件的源文件移入 Windows 回收站。
- 从 Releases 下载
PaperCraft-win-x64-*.zip。 - 解压到任意本地目录。
- 运行
PaperCraft.exe。 - 导入图片或 PDF，调整纸张、方向和槽位。
- 按需识别、整理并选择打印机提交任务。
程序为自包含便携版，目标电脑不需要另行安装 .NET Runtime。
业务数据与软件目录分离：默认账套位于 %LocalAppData%\PaperCraft\Data\papercraft.db，其中包含唯一工作台、账套内素材副本、报销台账和历史查重索引。可在“设置 → 账套与备份”查看位置、立即备份或从备份恢复；恢复前会自动生成一份“恢复前”备份。
如需使用云端 OCR 或 AI，请先阅读 AI / OCR 配置与调试指南。在“设置 → AI 配置”先维护服务商连接，再分别选择“图片整理主用 / 备用、OCR 文字整理、仅 OCR”任务；最后到“连接诊断”运行连接或读图测试。设置页可一键复制不含密钥、票据正文和账套路径的脱敏摘要，直接交给 Codex 或其他 AI 协助核对。发布包不包含作者或用户的任何连接配置。
历史台账迁移完成后，查重索引进入当前账套。旧版 ledger.json / history.json 会在首次读取时无损导入数据库并保留原文件。历史记录只用于识别过去已经报销的交易，不占用纸匠新的 n 编号；低置信度历史条目只会产生提示，不会静默阻止报销。
当前版本尚未进行商业代码签名，Windows 可能显示 SmartScreen 提示。请只从本仓库 Releases 下载，并核对 Release 中的 SHA-256。
- 账套、素材副本和设置默认保存在本机。
- OCR 与 AI 仅在用户主动点击识别或连接测试时调用。
- API Key 和腾讯云凭据使用 Windows DPAPI 按当前用户加密。
- 日志不默认记录票据正文，也不保存明文密钥。
- 源文件回收仅在整个打印任务成功提交 Windows 队列后执行。
- 网络路径、部分打印的 PDF 或不支持回收站的文件不会退化为永久删除。
- 仓库忽略本机账套数据库、数据库备份、
settings.json、.env、日志和发布产物。 - 打包脚本发现设置、账套数据、源码、日志或密钥文件类型时会直接终止。
- Windows 10 22H2 或 Windows 11（x64）
- x64 处理器
- 已正确安装的 Windows 打印机驱动
- 云端 OCR / AI 功能需要网络连接及相应服务商账户
需要 Windows 和 .NET 10 SDK。
dotnet restore PaperCraft.slnx
dotnet build PaperCraft.slnx -c Release --no-restore
dotnet test PaperCraft.slnx -c Release --no-build --no-restore生成 Windows x64 自包含便携包：
.\scripts\package-portable.ps1 -Version 0.2.9解决方案保持三层：
src/PaperCraft.App：WPF 界面与 Windows、OCR、AI、打印适配。src/PaperCraft.Core：毫米布局、分页、工作台快照编码和源文件处理规则。tests/PaperCraft.Tests：布局、渲染、打印票据、OCR、AI 与编辑流程测试。
- 目前仅支持 Windows x64。
- 不支持加密 PDF、云同步或自动提交财务系统。
- 双面方式、纸张能力和最终输出取决于打印机驱动。
- 单色打印机使用半色调网点表现灰阶；出现粗网纹时，可从打印区打开原生驱动设置并尝试系统半色调。
- 云端 OCR / AI 费用由使用者配置的服务商账户承担。
- “已提交 Windows 打印队列”不等于打印机已经物理出纸。
纸匠的产品灵感之一来自 发票闪印 PrintPDF。在开发纸匠之前，作者长期使用 PrintPDF 处理日常发票打印；它对真实办公痛点的专注和便捷体验，为作者的实际工作带来了许多帮助，也启发了纸匠继续探索更通用的图片 / PDF 排版与打印工作流。在此向 PrintPDF 的开发者致以诚挚感谢。
纸匠选择开源发布，并非意在取代已有工具，而是希望从真实工作场景出发，多提供一种解决问题的思路，也期待这些探索能给有相似需求的使用者和开发者带来一点启发。
本项目使用 MIT License。