Repository navigation
Conversation
- 在项目详情页新增与分数后处理同级的统计与导出板块,并将导出 JSON 入口迁移到该板块中 - 引入 echarts 展示总分分布图,支持在原始分数与后处理分数之间切换统计口径,并同步刷新平均分、极值、方差和标准差等指标 - 新增成绩 Excel 导出,使用 exceljs 生成 xlsx 文件,按每个学生一行导出基本信息、总分、后处理总分以及各小题得分 - 新增小题正确率 Excel 导出,并在统计面板中支持 Markdown/LaTeX 题目标题渲染、滚动列表和题号展示 - 补充 Excel 保存路径、结果导出 IPC 与前后端类型定义,修复图表在切换 tab 后实例丢失的问题
There was a problem hiding this comment.
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), |
There was a problem hiding this comment.
在导出成绩 Excel 的行数据构造里,“最终总分”列现在会在存在后处理分数时写入 postProcessedScore(而且“后处理总分”列也会写同一个值),导致原始最终总分被覆盖且两列重复。建议始终在“最终总分”列写入 computeDisplayedTotal(finalResult),并仅在“后处理总分”列写入 postProcessedScore(没有则留空)。
| postProcessedScore ?? computeDisplayedTotal(finalResult), | |
| computeDisplayedTotal(finalResult), |
| await fs.copy(sourcePath, targetPath, { | ||
| overwrite: false, | ||
| errorOnExist: false, | ||
| }); | ||
| addedPageCount += 1; |
There was a problem hiding this comment.
importOriginalImageGroup() 里对图片文件使用 fs.copy({ overwrite:false, errorOnExist:false }) 时,即使目标文件已存在并被跳过,仍然会 addedPageCount += 1,导致导入提示的页数不准确。建议在复制前判断目标是否存在,或在 copy 后根据实际是否写入来统计新增页数。
| 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; | |
| } |
| for (const columnIndex of remainingColumns) { | ||
| result[columnIndex] = defaultFields[columnIndex]; | ||
| } |
There was a problem hiding this comment.
detectStudentRosterColumnFields() 在为剩余列回填 defaultFields 时,可能把已分配过的字段再次分配(例如有多余列时把第 1 列回填为 studentId),从而生成重复字段映射并触发后续“列属性不能重复”的校验。建议回填时优先使用 'ignore',或只回填尚未被使用的字段。
概要
本次 PR 将
dev_0.3.0合并到main,发布 NeuroMark 0.3.0 的核心功能更新,重点增强试卷导入、扫描处理、核名、统计导出和批阅结果 PDF 输出流程。主要变更
技术变更
echarts、exceljs、pdf-to-img、pinyin-pro。ResultPdfPrintView,用于批阅结果 PDF 的打印渲染。student-roster工具模块,封装花名册解析、字段识别与搜索逻辑。scanMarginRatio参数,并在调试数据中同时记录检测边界与扩展后边界。@napi-rs/canvasunpack,以支持 PDF 渲染相关能力。