# 交接 · 组卷台 2026-09-05.2（全国中考真题 + AMC8真题）→ difrobot.cn 部署

> 2026-09-06 由组卷台开发会话出具。05.1 交接件（`交接_网站部署_20260905_05.1.md`）仍有效，本文只写 **05.2 相对 05.1 的增量**，其余条目沿用。
> 定稿确认：`组卷系统/组卷台.html`（372,196,547 B，09-06 00:53）+ `组卷系统/组卷台AI助手.py`（BUILD 05.2）就是要上线的这一对，本地 E2E 已过（见文末）。

## ⚠ 体积（同 05.1 那条，只更新数字）

`组卷台.html` **372,196,547 B（355 MB）**，比 05.1 多 1.8 MB（AMC8 230 张图 + 625 题）。Gitee 单文件上限、带宽、浏览器内存三条风险与 05.1 交接件所述相同，陆老师已知并决定上线。

## ① 前端

- 文件：`/Users/luyan/Desktop/AI workspace/课程设计机器人/组卷系统/组卷台.html`
- 大小 372,196,547 B，sha256 前缀 `2afa2e2eaee65cc0`，`NEED_BUILD='2026-09-05.2'`
- 内容：**113,500 题 / 8 套教材 / 124 节**（05.1 的 112,875 + AMC8 625）。新教材「AMC8真题」：gg=年份逐年（2000年…2025年，**没有 2021年**，那年停办）、cd=「2023年 AMC8」一年一节、d 按题号推 2/3/4、全部选择题、625 题全中文题面（英文原题存 `qe` 字段不显示）。
- 配图仍全部内嵌，**无新静态资源、无外链**。

### 05.2 相对 05.1 的前端增量（加工脚本关心的）

| 项 | 05.1 | 05.2 |
|---|---|---|
| `FIG_PFX` | `['ex/','cn/']` | **`['ex/','cn/','am/']`**（AMC8 资产键前缀 `am/`） |
| `asset://` 解析正则字符集 | `[A-Za-z0-9\-]` | **`[A-Za-z0-9_\-]`**（AMC8 资产 id 形如 `AMC8_2006_10_f3`，带下划线；html 内 3 处正则已全部改，实测 `grep` 计数 3/3） |
| 新字段 | — | 题记录多 `qe`（英文原题，可空）；无消费者，加工脚本不用管 |

### 特殊字符串（本版实测）

| 字符串 | 次数 | 说明 |
|---|---|---|
| `</body>` | 2 | 第 1 处 **line 33890**（doWord 模板串），真结尾 **line 34719**。锚最后一处。 |
| `</html>` | 2 | 同上 |
| `</script>` | 4 | 全是真标签 |
| `__DATA__` / `__FIG__` / `__COURSE__` | 0 | 占位符已替换 |

## ② 后端

**只改了 `组卷系统/组卷台AI助手.py`**（`BUILD = '2026-09-05.2'`），相对 05.1 的增量只有提示词：
- 教材优先级第 2 条新增「提到 AMC/AMC8/美国数学竞赛 → AMC8真题」，其余顺延；
- 新增 AMC8 的轴说明（gg 年份、cd 「2023年 AMC8」、难度可用）。
- `EXAM_TBS` **仍是**（上海中考真题, 全国中考真题），不含 AMC8。
- **`_paper_index` 没有新增扫描目录**：仍只扫 `数学学习系统/data/drafts/batch_exams_final/` + `data/approved/cn_exams_*/`（05.1 已有），AMC8 不在其中。

未动：topic_source / gen_router / verify_gen / export_lib / xkw_similar / `自动出题/`（mtime 都早于 02.1）。

### AMC8 「原卷」按钮怎么处理

AMC8 **不是中考类教材**，前端源文件条走的是普通教材那条路 `GET /api/topic/files?tb=AMC8真题&g=…&cd=…`。本机实测返回 `200 {"ok":true,"files":[]}`，页面显示「这个专题没有带答案的源文件」。**不需要服务器带任何 AMC8 源文件**，行为是干净的空态，不报错。AMC8 记录里的 `pid` 字段没有消费者。

构建期文件 **不上服务器**：`zujuan_amc8.py`、`zujuan_cn.py`、`AMC8考情分析/题库/`、`知识点标注/`、`_wmf_cache/`、`gen_组卷台.py`。

## ③ API

- **路径零新增零删除**，nginx 白名单 `version|topic|page|source|paper|similar|similar_batch|export_docx|report|compose|layout` 原样。
- 请求/响应形状与 05.1 相同（`/api/compose` 请求体带 `kps`，约 60 到 90 KB；spec 可含 `all:true` 展开的 `cds`）。

## ④ 同批

必须同批：`BUILD` 与 `NEED_BUILD` 都是 `2026-09-05.2`。

## ⑤ 依赖 / 环境

pip 零新增，密钥不变（`~/.deepseek_pro_key`），无环境变量变化，无新目录。

## 部署后验收（3 分钟）

1. `curl https://difrobot.cn/api/version` → `"build": "2026-09-05.2"`，`sources.compose: true`。
2. 教材下拉出现「AMC8真题」→ 年级栏是年份（2025年、2024年…）→ 选 2023年 → 25 张卡**首行是中文**、选项公式正常（不出现 `\frac` 之类源码）、带图题图正常显示；2006年 第 10 题五个选项各是一张图。
3. 全国中考真题：选江苏 → 节栏按年份分组、公式图正常（05.1 项）。
4. 「✨ AI 组卷」输入 `AMC8 2023 年选 5 道难题` → 理解句含「2023年 AMC8」、难度「难」，出 5 道；`跨教材来 8 道鸡兔同笼，四年级` → 8 道跨多套教材（02.2 回归）。

## 本机 E2E（2026-09-06 00:53 定稿后跑）

- 无版本横幅；AMC8 25 年份 / 625 题；2025、2024、2023、2006 四年各 25 张卡：首行中文 25/25、露源码选项 0、`⟦`/U+FFFD 残留 0、`<img>` 渲出数与配图字段逐年相等（18/14/15/12）、MathJax 容器有、零 JS 错误。
- 05.1 时跑的知识点 E2E 10/11（唯一不过项是覆盖率分母变大，绝对数不变）、compose 回归 16/16 不受本版影响（本版只加了一套教材和提示词两句）。

## 已知限制（不阻塞）

- 与 05.1 相同：`preNarrow` 在老师提到年份但不带省名时可能把全国批挤出候选；全国批与 AMC8 均**无知识点标注**。