pdf-review-dashboard

name	pdf-review-dashboard
tier	meta
description	生成双栏 PDF 审核面板，用于人工核查验证结果。左侧显示原始 PDF 文档，右侧显示验证结果。 点击结果条目可跳转至 PDF 对应页面。当开发者用户需要对照源文件审核验证输出、 或为演进循环收集真实标注数据时使用。输出为单个自包含 HTML 文件。

功能

生成单个自包含 HTML 文件：

• 左侧：浏览器内渲染的原始 PDF
• 右侧：可交互的验证结果列表
• 点击跳转：选中结果后 PDF 滚动到对应页面

开发者用户在浏览器中打开此 HTML 即可人工审核验证质量。

技术栈

• 单 HTML 文件，无需服务器
• PDF 以 base64 内嵌（完全自包含，可分享）
• 通过 CDN 加载 pdf.js 实现浏览器内 PDF 渲染
• 纯 JS + 内联 CSS，无框架依赖
• 深色主题，与 KC 仪表板风格一致

布局

• 可拖拽分隔条调整左右面板比例
• 左侧：PDF 查看器，顶部工具栏含翻页（上一页/下一页/跳转）和缩放（+/-/适应宽度）
• 右侧：结果列表，带筛选按钮，点击展开详情并跳转 PDF 页面
• 跳转时页面高亮动画

数据格式

生成器脚本读取 PDF 文件和结果 JSON，输出 HTML。

输入：

• pdf_path — 源 PDF 文档路径
• results_path — 验证结果 JSON 文件路径

结果 JSON 为对象数组，每个对象至少包含：

• 页面引用（对应 PDF 的哪一页）
• 结果状态（pass/fail/warning 或等效值）

右侧面板的列和详情字段自动适配验证工作流的输出数据。scripts/generate_review.js 是参考实现——根据项目输出格式调整数据映射部分。

使用时机

• 验证工作流完成后，供开发者用户可视化审核结果
• 为演进循环收集真实标注修正
• 向需要查看源文件依据的相关方展示结果

生成器脚本

见 scripts/generate_review.js — Node.js 脚本，输入 PDF 路径，输出审核 HTML。根据项目验证输出格式调整结果数据映射部分。