# Hulumath v1.2.0 Release Notes

发布日期：待 `release/v1.2.0` 合并并通过生产冒烟后填写。

## 版本主题

v1.2 将比赛、数学画板和数学人生从首发功能升级为可持续使用的完整闭环，同时清理
账号、档案、LaTeX 和本地调试中的 P0 问题。

## 主要变化

### 比赛与记录

- 取消比赛难度入口，实时匹配使用统一玩家池。
- 每局从完整题库生成不可变随机快照；历史 Attempt 不受影响。
- 题库包含入门 400、标准 400、进阶 200 道基础题。
- 实时匹配新增数独 Timerun 与 24 点竞速。
- 三种玩法共享联机码、WebSocket 状态、服务端计时、Rating 和历史记录。
- 结算响应立即刷新右上角 Rating。
- 首页和“我的”展示实时比赛历史、对手、结果、时间和 Rating 变化。

### 数学工具箱

- 数学白板与几何画板合并为“数学画板”单入口。
- 支持 6 位联机码、白板快照和几何状态实时同步。
- 新增数学你画我猜：服务端出题、猜题判定和计分。
- 函数绘图增加语法规则、示例和错误反馈。
- LaTeX 长公式横向滚动，保存按钮保持在独立操作行。

### 数学人生与 MathBTI

- 信仰者人生从弹窗升级为独立全屏体验，提供章节、进度和印记档案。
- `xinzhi`、`shuli`、`xiayi` 旧数值完全退出 v2 剧本。
- 新增 4 领域 × 5 个印记，共 20 个永久收藏印记。
- 新增高斯、祖冲之、欧拉、诺特 4 个组合彩蛋。
- 统一直博结局按单次人生中印记最多的领域分发到数论、代数几何、分析或应用数学。
- 16 位数学家五维评分重新评定，并提供史料和评分口径文档。
- 清理数学人生大厅的“数学人生交叉点”和背景圆球。

### 账号、入口与运维

- 登录或注册成功后，“我的”页面立即刷新。
- 新增仅限 `DEBUG=true` 的本地管理员初始化命令：`make local-admin`。
- 首页新增公众号入口，可复制“葫芦数学”并尝试唤起微信。
- `/health/` 返回 `version: "1.2.0"`。
- 生产静态资源检查、数据库备份、迁移、HTTP/WebSocket 冒烟和失败回退保持启用。

## Issue 对照

| Issue | 状态 | v1.2 验收位置 |
| --- | --- | --- |
| #10 | 完成 | 统一玩家池、前端移除难度 |
| #15 | 完成 | 数学你画我猜 |
| #17 | 完成 | LaTeX 三段式布局与长公式滚动 |
| #18 | 完成 | 大厅残留元素清理 |
| #21 | 完成 | Rating 即时刷新 |
| #22 | 完成 | Attempt 随机题目快照 |
| #24 | 并入 #36 | 独立剧情界面；需仓库所有者手动关闭 #24 |
| #25 | 完成 | 首页与档案比赛记录 |
| #26 | 完成 | 工具按计算、查询、绘图、画板、表达排序 |
| #27 | 完成 | 统一画板与联机码 |
| #28 | 完成 | 1000 道分层题库 |
| #29 | 完成 | 数独与 24 点实时竞速 |
| #30 | 完成 | 主页公众号入口 |
| #31 | 完成 | 本地管理员可登录 |
| #32 | 完成 | 登录后档案刷新 |
| #33 | 完成 | 函数语法说明 |
| #34 | 完成 | 安全的本地管理员初始化方案 |
| #35 | 完成 | 16 位数学家五维重评与依据 |
| #36 | 完成 | 20 印记、4 彩蛋、4 结局、独立界面 |

## 数据库迁移

- Contest Attempt 新增题目快照。
- Realtime Match 新增玩法类型；Math Game Attempt 可关联实时比赛。
- ContestQuestion 题池扩充为当前赛道的全部最新有效题目。
- 新增 Toolbox BoardSession。
- 新增 StoryMark，并发布信仰者人生 StoryVersion v2。
- 旧信仰者 v1 取消发布；旧进行中存档标记为已放弃，历史选择保留。

## 发布检查

```bash
make check
make test
cd backend && ../.venv/bin/python manage.py migrate --plan
cd backend && ../.venv/bin/python manage.py collectstatic --noinput
```

生产部署后检查：

```text
/health/ version == 1.2.0
首页、后台、视频目录正常
联机比赛 WebSocket 正常
统一画板 WebSocket 正常
```