# 交接 · 组卷台 2026-09-02.1 → difrobot.cn 部署

> 2026-09-02 由组卷台开发会话出具，逐条从源码核对。
> 部署目标已迁新服务器（surface:40 负责摸机器），本文只管「上什么、怎么对」。

## ① 前端

- 文件：`/Users/luyan/Desktop/AI workspace/课程设计机器人/组卷系统/组卷台.html`
- 大小：**179,854,745 B（171.5 MB）**，build `2026-09-02.1`
- 内含：57,299 题 + 144MB base64 配图 + MathJax/docx vendor，单文件零外部资源
- 无需重建，直接上这份
- ⚠ 同目录 `*.kp-wip`（知识点功能半成品，明确不上）与 `*.bak-*`（备份）**不要带**

## ② 后端及依赖（相对 07-31 线上版全部动过，整体上）

| 文件 | 说明 |
|---|---|
| `组卷系统/组卷台AI助手.py` | 主服务（8848）。AI 组卷 /api/compose、变式组 by=variants、seed 复现契约都在这版 |
| `组卷系统/verify_gen.py` | AI 出题数值核验（parse_num 加固：百分号/带分数/\frac/$壳/度数） |
| `组卷系统/gen_router.py` | 确定性生成器路由（新增 seed 透传） |
| `组卷系统/topic_source.py` | 源文件预览下载 |
| `组卷系统/export_lib.py` | Word 导出（WPS 实测排版常数，勿动） |
| **`自动出题/core/` + `自动出题/gen/`** | **新增运行时依赖**。gen_router 启动时按 `../自动出题` 相对路径 import；gen/ 共 75 个题型模块（其中 17 个 09-02 新增初中代数）。**目录结构必须保持 `…/组卷系统` 与 `…/自动出题` 平级** |

⚠ 漏掉 `自动出题/` 服务照样能起、不报错——gen_router 有整体降级兜底，
症状是「初中/小学补题静默退化回 DeepSeek 或缺题」，务必带上并在部署后跑下面的验收。

构建期脚本（服务器**不需要**）：`zujuan_v2.py`、`zujuan_exam.py`、
`成果/胡小群题库/gen_组卷台.py`、`原书页/` 生成链。

## ③ API 全量清单（现有 8 项白名单之外的标 ⭐）

```
GET  /api/version          版本握手（前端启动即调，被吞会全页置灰）
GET  /api/topic*           专题目录
GET  /api/page*            原书页图
GET  /api/source*          源文件预览下载
GET  ⭐ /api/paper*         中考原卷原始文件下载（07-31 后新增）
POST /api/similar          出类似题（by=gen/ai/variants/xkw，gen 带 seed）
POST /api/similar_batch    整页出类似题
POST /api/export_docx      Word 导出
POST /api/report           报障
POST ⭐ /api/compose        AI 组卷（一句话→spec 翻译+校验），必须放行
POST ⭐ /api/layout         试卷预览排版计算，必须放行（预览页靠它）
POST    /api/openword      本地桌面功能（唤起本机 Word），服务器上【不要】放行
```

nginx 白名单在现有 `version|topic|page|source|similar|similar_batch|export_docx|report`
基础上**加 `compose|layout|paper`**，openword 不加。

## ④ 依赖与环境

- pip：**零新增**（后端 + 全部生成器纯 stdlib，Python ≥3.9 即可）
- 密钥：`~/.deepseek_pro_key`（DeepSeek key 文件）。**不进 git**，服务器手工放。
  缺失时 /api/version 的 sources.compose/ai 为 false，前端对应按钮自动置灰，其余功能不受影响。
- ⚠ 服务器与本机共用同一个 DeepSeek key/余额（2026-09-02 下午刚充过一次，此前余额烧穿过一回 402）。
- 学科网 key：沿用线上现状，本次无变化。

## ⑤ git 现状

- `课程设计机器人/组卷系统` **不是 git 仓库、无远端**——git 流程要在 difrobot 仓库侧收编。
- 171.5MB 的 组卷台.html 别直接进普通 git 历史：走 **Git LFS**，或 release 附件 / rsync 单发。

## 版本握手与部署后验收（3 分钟）

1. **前后端必须同批上**：`BUILD` 与 `NEED_BUILD` 都是 `2026-09-02.1`，只上一半页面会弹红色版本横幅。
2. `curl https://difrobot.cn/<组卷台路径>/api/version` → 应含
   `"build": "2026-09-02.1"` 且 `"sources": {"gen": true, ...}`（gen=false 就是 ②的自动出题目录没带对）。
3. 补题链路：`POST /api/similar` body
   `{"stem":"x","by":"gen","topic":"勾股定理及其应用","grade":"初二·基础","n":2,"seed":42}`
   → 应返回 2 道带答案的题；同 seed 再调一次题面必须一字不差。
4. 页面上点「✨ AI 组卷」说一句「三年级和差问题 5 道」→ 出预览即通。

## 本版内容摘要（相对 07-31 线上版）

- AI 组卷「说一句话出一份卷」（按钮/预览/换删/进篮/持久化，提示词二轮调优 14 句回归）
- 初中代数生成器 17 个（人工逐行审核），胡小群补题覆盖 48%→61%
- 变式组 by=variants（六策略）、seed 复现契约、判等器加固（2026-08-28 四件套）
- 题库 44,097 → 57,299 题（含一课一练 17 册、中考 19,461 题等）
- 知识点跨教材选题：**不在本版**（半成品停车在 `.kp-wip`）