| 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。根据项目验证输出格式调整结果数据映射部分。