{"projectId":"mtiku","id":"import-questions","title":"用 Excel 校验并导入试题","summary":"用 Excel 校验并导入试题：普通练习按后台章节编排。Chapter 可填“章节 / 小节”，最多三级、完整路径不超过100字符；新增题目导入后自动补齐章节关联。SortOrder 为章节内题序，默认0，同序按题目ID排列。未填章节的英语题按题型和套题编号分类。已存在题号仍跳过，人工调整的章节关系不会被导入覆盖。","content":"# 用 Excel 校验并导入试题\n\n适用项目：好大夫练题后台（mtiku）\n适用版本：本仓库 Admin.NET 集成版，2026-11-17 工作区\n审核状态：已核对前后端源码；待业务负责人复核，未验收生产环境\n最后核对日期：2026-11-17\n\n## 前置条件\n\n必须是系统超级管理员，且目标题库已经存在。使用后台管理员账号，学生账号不能登录后台。MCP 只提供说明，不代替用户操作，不查询学生个人资料。\n\n## 页面入口\n\n练题项目 → 题库与试题（`#/practice/questions`）。菜单或按钮不可见时，先核对后台账号权限。\n\n## 操作步骤\n\n1. 点击“下载试题模板”；已有题目可先“导出试题 Excel”作为填写结构参考。\n2. 填写试题，BankCode 必须对应已有题库编码。\n3. 先在“校验试题 Excel”选择文件。该入口只校验，不写入；按行号修正错误。\n4. 在“导入试题 Excel”选择修正后的文件。选择文件即开始导入。\n5. 核对导入数量，在下方按题库及题号查询，抽查题干、选项、答案和标签。\n\n## 字段与规则\n\n普通练习按后台章节编排。Chapter 可填“章节 / 小节”，最多三级、完整路径不超过100字符；新增题目导入后自动补齐章节关联。SortOrder 为章节内题序，默认0，同序按题目ID排列。未填章节的英语题按题型和套题编号分类。已存在题号仍跳过，人工调整的章节关系不会被导入覆盖。\n\nBankCode 与 SourceId 联合标识题目；已有题目会跳过，不会覆盖修改。\n表头：BankCode、SourceId、Type、Chapter、SetNumber、GroupId、TagsJson、QuestionJson、AnswerJson、AutoGradable、Enabled。SourceId 最多 64 字符，Type 最多 40 字符。\nQuestionJson 和 AnswerJson 必须是 JSON 对象；TagsJson 使用数组。题目对象不能含 answer、ans、ex、ex_k、ex_c、ex_j、ref、ref2、model、keypoints 这些答案/解析字段。\nAutoGradable=true 时，AnswerJson.answer 必须是 A/B/C/D 中的单个字母，例如 {\"answer\":\"A\"}；无标准答案题目设为 false，不自动判对错。合法 JSON 不代表完整业务结构正确，题干和选项沿用已导出的同题型数据，勿猜测字段。\n单次最多 20,000 道题，.xlsx 文件不超过 30,000,000 字节。\n\n## 常见问题\n\n导入 0 条可能是题号已存在，不代表失败；页面成功提示只展示新增数，接口另返回 SkippedExisting。修改已有试题使用“编辑”。\n校验最多显示约 100 条错误，修正后应重新校验，不能当作全部错误总数。导入先校验全文件，再事务写入新增题目。\n\n## 依据\n\n- `Web/src/views/business/practice/questions.vue`\n- `Admin.NET/HdfTools.Application/Practice/PracticeQuestionAdminService.cs`\n- `Admin.NET/HdfTools.Application/Practice/PracticeMenuSeedData.cs`\n\n文档描述核对日期的实际实现；若线上页面版本不同，以当前页面和服务端校验为准，需重新核对本文。\n","moduleId":"questions"}