十六进制平台习题批量录入助手

要解决的问题

把散落的习题录入题库，难不在打字，而在三件事同时做对：公式必须是文本、图片必须真上传、HTML 片段必须符合平台编辑器规范。老师手里常是一批混着 MathType OLE 公式的 Word、带几何图的 PDF、或刚从对话里生成好的题目。手工录入时，公式容易被当成图片传上去，图片又常丢在富文本外面，选择括号还会在编辑时被误删。

技能如何工作

这个 Skill 是 hex-batch-exercises 的独立版，不依赖任何 MCP 连接器。它用内置的 scripts/hex_tool.py 直接通过 HTTP JSON-RPC 调用远程 mcp-server，把"解析 → 校验 → 构建 → 批量保存"串成一条端到端流程。

第一步，内容来源处理。 文件来源（Word/PDF/PPT/网页/图片）先转 markdown 中间格式；对话来源中用户已确认的结构化习题则直接复用，禁止先转文件再识别。公式一律从 MathType OLE、OMML 或图片公式中提取，还原为 $...$ 或 $$...$$ 的 LaTeX 文本，绝不上传。图片走 --uploadimg 模式本地直传 OSS，再原位替换为 <img> 标签，并记录每张图所属的精确字段（题干、哪个选项、哪个子题）。

第二步，结构规范化。 识别题型（单选/多选/判断/填空/简答/综合/选择填空/完型填空），填空空位统一转为 __N__ 占位符，选择题题干末尾的作答括号用 contenteditable="false" 的 span 包裹，换行按行包进 <p>，图片标签严格放在 <p> 内，最后按平台规范拼出 exerciseList 参数。

第三步，校验与保存。 先取课程编号和课程信息，校验习题学科与平台课程学科一致，不匹配则终止；保存前展示参数供用户确认，ExerciseID=0 为新增，非 0 为修改。

适用边界

• 仅适配 hexfuture.net 平台的题模型规范，非通用题库导入工具。
• 学科年级必须与课程匹配，不一致时直接报错退出，不会强行写入。
• MathType OLE 公式提取率约 95% 以上，个别公式可能缺前缀或后缀，需在确认阶段手动修正，但不影响整体流程。
• 对话来源的习题必须是用户已确认的结构化内容，否则仍需走文件解析路径。
• 所有中间文件放在 $TMPDIR/hex_work/，每次调用开始删除旧状态，保证会话隔离。