Skip to content

发布 NeuroMark 0.3.0 批阅导入与导出能力升级 - #8

Merged
BobH233 merged 18 commits into
mainfrom
dev_0.3.0
Apr 28, 2026
Merged

BobH233 merged 18 commits into
mainfrom
dev_0.3.0

Conversation

@BobH233

@BobH233 BobH233 commented Apr 28, 2026

Copy link
Copy Markdown
Owner

概要

本次 PR 将 dev_0.3.0 合并到 main,发布 NeuroMark 0.3.0 的核心功能更新,重点增强试卷导入、扫描处理、核名、统计导出和批阅结果 PDF 输出流程。

主要变更

  • 支持导入 PDF 格式试卷,可与图片试卷统一进入导入、分组、扫描和批阅流程。
  • 新增项目级扫描裕度比例设置,支持按比例扩展扫描边界,减少裁剪过紧导致的答题内容缺失。
  • 新增班级花名册录入能力,支持字段识别、姓名/学号/班级自动补全,以及中文、拼音、首字母搜索。
  • 优化批阅结果核名体验,支持未核名/已核名优先排序,并新增简单的重复姓名、重复学号检查。
  • 新增“统计与导出”板块,展示总分统计、分数分布、小题正确率,并支持导出成绩 Excel 与正确率 Excel。
  • 支持单份和批量导出批阅结果 PDF,批量导出以后台任务运行,可显示导出进度并支持停止。
  • 新增内置通用理科、通用文科参考答案生成模板;内置模板只读,可复制为自定义模板后调整。
  • 统一批阅、rubric 编译、参考答案生成中的数学 Markdown 渲染规则,避免公式内出现 Markdown 加粗等不兼容写法。
  • 优化统计与导出版块、项目卡片状态、阅卷详情响应式布局等界面细节。
  • 修复保存参考答案后仍提示未保存修改、Windows 打印导出 PDF 默认文件名为空等问题。

技术变更

  • 新增依赖:echarts、exceljs、pdf-to-img、pinyin-pro。
  • 扩展 preload / IPC 合约,新增 Excel 保存、PDF 保存、窗口打印 PDF、批量 PDF 导出等接口。
  • 新增 ResultPdfPrintView,用于批阅结果 PDF 的打印渲染。
  • 新增 student-roster 工具模块,封装花名册解析、字段识别与搜索逻辑。
  • 原生扫描模块新增 scanMarginRatio 参数,并在调试数据中同时记录检测边界与扩展后边界。
  • Electron 打包配置增加 @napi-rs/canvas unpack,以支持 PDF 渲染相关能力。

BobH233 added 18 commits April 14, 2026 22:59
- 在项目详情页新增与分数后处理同级的统计与导出板块,并将导出 JSON 入口迁移到该板块中

- 引入 echarts 展示总分分布图,支持在原始分数与后处理分数之间切换统计口径,并同步刷新平均分、极值、方差和标准差等指标

- 新增成绩 Excel 导出,使用 exceljs 生成 xlsx 文件,按每个学生一行导出基本信息、总分、后处理总分以及各小题得分

- 新增小题正确率 Excel 导出,并在统计面板中支持 Markdown/LaTeX 题目标题渲染、滚动列表和题号展示

- 补充 Excel 保存路径、结果导出 IPC 与前后端类型定义,修复图表在切换 tab 后实例丢失的问题
Copilot AI review requested due to automatic review settings April 28, 2026 08:49
@BobH233
BobH233 merged commit a1cb47b into main Apr 28, 2026
2 of 3 checks passed

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

该 PR 将 dev_0.3.0 合并到 main,发布 NeuroMark 0.3.0:围绕试卷导入(含 PDF)、扫描裁剪裕度、花名册/核名体验、统计与导出(Excel/PDF)以及提示词数学 Markdown 规则统一等关键流程进行升级。

Changes:

  • 增强导入与扫描:支持 PDF 导入、扫描裕度比例、扫描调试数据记录检测/扩展边界。
  • 增强核名与数据管理:新增项目花名册解析与搜索(中文/拼音/首字母),核名排序与重复检查。
  • 增强导出与交付:新增统计页(分数分布/小题正确率)、导出成绩/正确率 Excel、单份与批量批阅结果 PDF(后台任务)。

Reviewed changes

Copilot reviewed 38 out of 39 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
tests/unit/student-roster.test.ts 新增花名册工具解析与搜索能力的单测覆盖。
tests/unit/score-post-process-service.test.ts 补齐 ProjectSettings 新字段的测试上下文(scanMarginRatio/studentRoster)。
tests/unit/score-post-process-ai-prompts.test.ts 更新 AI prompt 单测与 settings 快照字段。
tests/unit/grading-prompts.test.ts 更新数学 Markdown 规则相关断言,适配统一规则文案。
src/renderer/src/views/TasksView.vue 任务页支持 PDF 批量导出任务类型与速率/ETA 文案。
src/renderer/src/views/SettingsView.vue 参考答案生成模板支持“内置/自定义”标签与只读内置模板查看/克隆流程。
src/renderer/src/views/ResultPdfPrintView.vue 新增批阅结果 PDF 专用打印渲染页(用于后台窗口导出)。
src/renderer/src/views/ProjectDetailView.vue 新增统计与导出 Tab、Excel/PDF 导出入口、花名册设置与自动补全、核名排序/重复检查、扫描裕度设置等。
src/renderer/src/utils/student-roster.ts 新增花名册解析、列识别、拼音搜索与建议打分逻辑。
src/renderer/src/styles/global.css 调整布局与响应式样式,新增智能核名与统计导出页面样式。
src/renderer/src/stores/projects.ts 扩展 projects store:更新 settings 字段、增加 Excel/PDF 导出方法封装。
src/renderer/src/router/index.ts 新增 result-pdf-print 路由用于隐藏窗口打印导出。
src/renderer/src/components/StudentInfoAutocompleteInput.vue 新增花名册联想输入组件(键盘导航/选择)。
src/renderer/src/components/ScorePostProcessPresetManager.vue 文案调整:新建/克隆/删除预设按钮命名统一。
src/renderer/src/components/CreateProjectModal.vue 新建项目表单新增 scanMarginRatio 配置与提示文案。
src/renderer/src/App.vue 支持更多“独立路由”(preview/result-pdf-print)绕过 AppShell。
src/preload/scorePostProcessScriptContract.ts score post-process 脚本运行环境文档补充 scanMarginRatio。
src/preload/index.ts preload 新增 Excel/PDF 保存、窗口导出 PDF、打印页 ready/failed 通知、设置主窗口标题等 IPC 封装。
src/preload/contracts.ts 合约扩展:result-pdf-export 任务类型、ProjectSettings 新字段、花名册数据结构、Excel/PDF 导出相关类型与 API。
src/main/services/projectService.ts 主进程:PDF 导入渲染、并发导入、scanMarginRatio 下发扫描;新增导出成绩/正确率 Excel;规范化 studentRoster/settings。
src/main/services/documentScanService.ts 扫描服务:新增 scanMarginRatio 入参并写入调试 JSON;记录 detectedCorners 与扩展后 corners。
src/main/services/appService.ts App 服务:新增导出当前窗口 PDF;新增批量导出结果 PDF(隐藏窗口+ready 协议+后台任务/可取消)。
src/main/services/answerGeneratorService.ts 新增内置参考答案生成模板(只读),并限制内置模板不可修改/删除。
src/main/prompts/shared/mathMarkdownRules.ts 新增共享数学 Markdown 渲染规则片段。
src/main/prompts/grading/user.ts 使用共享数学规则,统一 grading user prompt 的数学/Markdown约束。
src/main/prompts/grading/system.ts 使用共享数学规则,统一 grading system prompt 的数学/Markdown约束。
src/main/prompts/grading/rubric-user.ts 使用共享数学规则,统一 rubric 编译 user prompt 的数学/Markdown约束。
src/main/prompts/grading/rubric-system.ts 使用共享数学规则,统一 rubric 编译 system prompt 的数学/Markdown约束。
src/main/prompts/answer-generator/user.ts 参考答案生成 user prompt 引入共享数学规则。
src/main/prompts/answer-generator/system.ts 参考答案生成 system prompt 引入共享数学规则。
src/main/ipc/projects.ts projects IPC:create/settings schema 增加 scanMarginRatio/studentRoster 校验。
src/main/ipc/grading.ts results IPC:新增导出 Excel / 正确率 Excel / 批量 PDF;cancel 时联动取消 PDF 导出。
src/main/ipc/app.ts app IPC:新增 setMainWindowTitle、选择 Excel/PDF 保存路径、导出窗口 PDF、打印页 ready/failed 通知。
src-native/scancpp/src/scanner.hpp 原生扫描:ScanRequest/Result 增加 scanMarginRatio 与 detectedCorners。
src-native/scancpp/src/scanner.cpp 原生扫描:实现按中心缩放 corners(scanMarginRatio),overlay 同时绘制检测与扩展边界。
src-native/scancpp/src/node_addon.cpp N-API:透传 scanMarginRatio,返回 detectedCorners,增加 float 参数解析校验。
package.json 新增依赖:echarts、exceljs、pdf-to-img、pinyin-pro。
build/electron-builder.yml asarUnpack 增加 @napi-rs/canvas 以支持 PDF 渲染相关依赖。

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

finalResult.studentInfo.className,
finalResult.studentInfo.studentId,
finalResult.studentInfo.name,
postProcessedScore ?? computeDisplayedTotal(finalResult),

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

在导出成绩 Excel 的行数据构造里,“最终总分”列现在会在存在后处理分数时写入 postProcessedScore(而且“后处理总分”列也会写同一个值),导致原始最终总分被覆盖且两列重复。建议始终在“最终总分”列写入 computeDisplayedTotal(finalResult),并仅在“后处理总分”列写入 postProcessedScore(没有则留空)。

Suggested change
postProcessedScore ?? computeDisplayedTotal(finalResult),
computeDisplayedTotal(finalResult),

Copilot uses AI. Check for mistakes.
Comment on lines +777 to +781
await fs.copy(sourcePath, targetPath, {
overwrite: false,
errorOnExist: false,
});
addedPageCount += 1;

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

importOriginalImageGroup() 里对图片文件使用 fs.copy({ overwrite:false, errorOnExist:false }) 时,即使目标文件已存在并被跳过,仍然会 addedPageCount += 1,导致导入提示的页数不准确。建议在复制前判断目标是否存在,或在 copy 后根据实际是否写入来统计新增页数。

Suggested change
await fs.copy(sourcePath, targetPath, {
overwrite: false,
errorOnExist: false,
});
addedPageCount += 1;
const targetExists = await fs.pathExists(targetPath);
await fs.copy(sourcePath, targetPath, {
overwrite: false,
errorOnExist: false,
});
if (!targetExists) {
addedPageCount += 1;
}

Copilot uses AI. Check for mistakes.
Comment on lines +192 to +194
for (const columnIndex of remainingColumns) {
result[columnIndex] = defaultFields[columnIndex];
}

Copilot AI Apr 28, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

detectStudentRosterColumnFields() 在为剩余列回填 defaultFields 时,可能把已分配过的字段再次分配(例如有多余列时把第 1 列回填为 studentId),从而生成重复字段映射并触发后续“列属性不能重复”的校验。建议回填时优先使用 'ignore',或只回填尚未被使用的字段。

Copilot uses AI. Check for mistakes.
@BobH233
BobH233 deleted the dev_0.3.0 branch May 11, 2026 03:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants