PDF工具 PDF 页面尺寸与出血线检测报告 AI 提示词 (Prompts)

适用场景

这条 Prompt 用来让 AI 直接生成一个“PDF 页面尺寸与出血线检测报告”在线工具:把 PDF 上传后,自动识别每页的页面框(MediaBox/CropBox/BleedBox/TrimBox/ArtBox),并按你设定的印刷规范输出可读的预检报告(通过/警告/错误),支持批量 PDF 与导出 JSON/CSV。

典型场景:印刷出血检查、出版与画册交付前预检、品牌物料的版式规范校验、设计团队的批量 PDF 质量门禁。

交付物清单

AI 需要一次性产出可构建/可部署的完整项目,而不是片段代码。交付物必须包含:项目源码、文件树、安装与运行命令、Docker 部署说明、最少 8 条自动化测试用例(或可执行的测试脚本)以及一份 QA checklist(人工验收步骤)。

功能范围与约束

工具必须专注“检测与报告”,不要引导生成渲染图/海报/插画,也不要涉及任何图像生成模型。允许:预览、抽取信息、规范校验、导出报告、批量处理。

建议支持的检测项:页面尺寸与方向、目标成品尺寸匹配、出血线(BleedBox)存在性与尺寸、TrimBox 与 CropBox 关系、超出版心元素提示(基于边界框的近似判断)、页内安全区建议、单位换算(pt/mm/in)。

Prompt(复制到 AI 直接生成在线工具)

你是一名资深全栈工程师 + 印前预检工具开发者。请直接生成一个可运行、可构建、可部署的“PDF 页面尺寸与出血线检测报告”在线工具项目(Web),要求如下: 【1. 技术栈与项目形态】 - 默认使用:Node.js 20+ + Type 。 - 前端:React + Vite(或 Next.js 也可以,但必须给出完整可跑的配置)。 - 后端:Express/Fastify 任一;提供 REST API。 - PDF 解析:优先使用 pdf-lib 或 pdfjs-dist(如需读取各类 PageBox,允许结合 qpdf/ghost 的解析方式,但必须写清依赖与替代方案)。 - 必须给出:完整文件树、每个关键文件的代码、package.json 脚本、环境变量示例、可一键启动的命令。 【2. 核心功能】 A) 上传与批量 - 支持拖拽上传单个 PDF 或多个 PDF;单文件最大 50MB(可配置)。 - 后端对每个 PDF 逐页解析:MediaBox/CropBox/BleedBox/TrimBox/ArtBox(若缺失则标记为缺失)。 B) 规范配置(用户可编辑) - 允许用户选择或输入:目标成品尺寸(宽x高,单位 mm)、期望出血(例如 3mm/5mm)、允许误差(例如 0.2mm)。 - 支持预设:A4、A5、B5、名片、海报等(用 JSON 维护,可扩展)。 C) 检测规则(必须实现并可测试) - 页面尺寸匹配:TrimBox(优先)或 CropBox(退化)与目标尺寸比对,给出偏差。 - 出血检查:BleedBox 存在性;BleedBox 与 TrimBox 的差值是否满足期望出血(四边分别给出)。 - 框关系合理性:TrimBox 应不大于 BleedBox;CropBox 不应比 MediaBox 更大(若出现给出警告)。 - 方向与旋转:识别页面旋转(/Rotate)并在计算尺寸时考虑;输出最终的可读宽高。 D) 报告与导出 - 页面级结果:每页 PASS/WARN/FAIL,列出命中规则与数值。 - 文件级汇总:失败页数、警告页数、缺失 BleedBox 页数。 - 导出:JSON(完整结构)与 CSV(面向表格审阅)。 - UI 要有“只看失败/警告”的筛选。 【3. 安全与稳定性】 - 上传文件仅在内存或临时目录处理;处理完成后立即清理。 - 限制并发与超时:单个 PDF 处理超时可配置(默认 30s)。 - 错误处理:对损坏 PDF、加密 PDF、空页等给出明确错误提示。 【4. 命令与部署】 - 本地运行:给出从 0 到可访问页面的命令(含安装依赖、启动前后端)。 - Docker:提供 Dockerfile 与 docker-compose.yml,一条命令启动;端口可配置。 - 生产构建:给出 build 与 start 脚本。 【5. 测试(硬要求)】 - 至少 8 条自动化测试:覆盖尺寸匹配、出血计算、缺失框的处理、旋转页、导出 JSON/CSV 格式校验、错误输入、并发/超时策略。 - 允许使用 Vitest/Jest + Supertest。 - 需要提供一份最小化的测试 PDF 生成脚本(用 pdf-lib 生成包含不同 PageBox 的 PDF),避免依赖外部文件。 【6. 输出格式(请严格按此结构输出)】 1) 项目简介(3-6 行) 2) 文件树(tree 格式) 3) 关键实现说明(分点,包含 PageBox 读取与单位换算公式) 4) 完整代码(按文件逐个给出) 5) 运行命令(开发/测试/构建/生产) 6) Docker 部署步骤 7) 测试说明 + QA checklist(人工验收步骤,至少 12 条) 开始生成代码与完整项目。

验收要点(给使用者的检查清单)

你拿到 AI 输出后,应当能做到:1)npm install 后能启动页面;2)上传一份测试 PDF 能得到逐页报告;3)导出的 JSON/CSV 能下载且结构正确;4)跑测试能通过;5)Docker 一键启动可用。

常见问题与扩展方向

扩展建议:支持 ICC/输出意图提示、支持页内安全区可视化(仅叠加线框,不做渲染图生成)、支持把检测规则保存为团队模板、支持 API 批处理流水线(CI 门禁)。

用户评论 (0)

登录后参与讨论

立即登录 注册账号

暂无评论,快来抢沙发吧~

操作成功