# SPEC-001: 期末复习包（生物与化学·成都市调研统考对标版）规格说明书

**规格编号**：`SPEC-001`  
**关联决策**：[`docs/adr/0001-期末复习包架构与增量组织原则.md`](../adr/0001-期末复习包架构与增量组织原则.md)  
**调研依据**：[`docs/research/RESEARCH-001-成都四七九高二上期末考情与真题范围调研.md`](../research/RESEARCH-001-成都四七九高二上期末考情与真题范围调研.md)  
**统一语言依据**：[`CONTEXT.md`](../../CONTEXT.md)  
**标签**：`ready-for-agent`

---

## 1. 问题阐述 (Problem Statement)

高二理科学生在备考四川省成都市高二上学期期末调研统考（成都市教科院统一命题、成都石室/七中/树德等重点中学统一评卷）时，面临三大痛点：
1. **知识容量急剧膨胀**：考试范围锁定为《选择性必修1》全册（生物全册 5 章、化学全册 4 章），学生难以兼顾前期旧概念与后期高密度新硬骨头。
2. **高分阻断题型集中在期末增量模块**：期末卷 70% 的大题分值集中在期末后半程核心模型（生物：体液-免疫调节网络、植物激素两重性与环境信号；化学：弱电解质三大守恒与滴定分布图、沉淀溶解平衡 $K_{sp}$ 转化、多室膜电解池电极反应），学生在多变量分析与规范表达上失分严重。
3. **缺乏体系化、免受乱码干扰的高交互复习产物**：现存资料多为格式混乱的散装试卷，缺少支持“自测隐藏答案”、“错题避坑打卡”以及“印刷级原生符号”的沉浸式复习工具。

---

## 2. 解决方案 (Solution)

构建《期末复习包》（包含生物与化学两门科目），采用“全书骨架串联（30%）＋期末新增硬骨头深度突破（70%）”架构，以独立的单页交互式 Web 网页形式交付：
- 生物文件：`docs/期末/生物.html`
- 化学文件：`docs/期末/化学.html`

两份文件均内嵌原生交互控制栏（支持一键自测隐藏答案、三色护眼主题切换、易错清单打卡持久化、A4 打印优化），全量采用标准 HTML+Unicode 符号排版（0 外链依赖、0 乱码风险），并配备成都市期末统考真题级别的全真例题与扣分严防细则。

---

## 3. 用户故事 (User Stories)

1. 作为备考高二学生，我希望在生物复习包中看到全书 5 章的宏观思维脉络图，以便我快速理清内环境、神经、体液、免疫与植物调节之间的逻辑演进。
2. 作为备考高二学生，我希望获得特异性体液免疫与细胞免疫协同的“双流机理矢量图”，以便我彻底搞懂 B 细胞活化双信号、辅助性 T 细胞的枢纽作用及细胞毒性 T 细胞的识别杀伤机制。
3. 作为备考高二学生，我希望掌握生长素极性运输及“低促高抑”敏感性曲线模型，以便我在做植物激素综合大题时能准确分析云母片阻断和对照实验。
4. 作为备考高二学生，我希望在化学复习包中系统掌握弱电解质电离平衡、水解平衡与“三大守恒”（电荷守恒、物料守恒、质子守恒）的推导范式，以便我在滴定曲线和微粒浓度排序大题中拿满分。
5. 作为备考高二学生，我希望获得沉淀溶解平衡 $K_{sp}$ 计算与沉淀转化曲线的题型方法论，以便我能搞定工业湿法冶金除杂等情境化计算题。
6. 作为备考高二学生，我希望学习多室离子交换膜电解池与新型二次电池的电极反应式书写四步法，以便我攻克期末化学压轴大题。
7. 作为备考高二学生，我希望通过交互式复选框逐一打卡 8 大高频易错雷达点，并在刷新页面后依然保留我的自测进度。
8. 作为备考高二学生，我希望在自测时一键收起所有解析，在自己思考完成后再展开比对官方评分细则。
9. 作为备考高二学生，我希望页面在无网环境和手机、平板上打开时所有公式和符号均清晰美观、无任何 LaTeX 源码残留。

---

## 4. 实施决策 (Implementation Decisions)

### 4.1 文件结构与交付边界
- 目录结构：`docs/期末/`
  - `docs/期末/生物.html`
  - `docs/期末/化学.html`
- 项目规划同步：更新 `docs/复习规划.md` 中的期末包状态。

### 4.2 视觉规范与设计系统
- **配色系统**：
  - 生物采用翡翠绿主题：`--primary: #047857`、`--primary-light: #ecfdf5`
  - 化学采用暖陶橙主题：`--primary: #c2410c`、`--primary-light: #fff7ed`
- **主题切换系统**：
  - 浅色模式（默认清晰）
  - 羊皮纸护眼模式（Paper，温暖柔和）
  - 极简深色模式（Dark，夜间防疲劳）
- **符号排版法则（严禁 LaTeX 标记残留）**：
  - 必须使用标准 HTML 标签（`<sub>`、`<sup>`、`<strong>`）与 Unicode 字符（`ΔH`、`⇌`、`＝`、`＋`、`－`、`·`、`∑`、`M̄`）。
  - 化学方程式与核心公式使用 `.chem-eq` 和 `.formula-block` 容器样式。
  - 严禁出现未转义的 `$` 符号或未经渲染的 Markdown `**` 标记。

### 4.3 内容架构规范（每科三大标准模块）
1. **一、知识点总结（四七九核心模型与机理图解）**：
   - 生物（全册 5 章）：
     - 1. 内环境稳态与跨膜转化回路（精炼导图）
     - 2. 神经调节电生理模型（精炼复习）
     - 3. 体液调节三大轴心（甲状腺轴、血糖拮抗、水盐渗透压调节）
     - 4. 免疫调节双流协同图解（体液免疫、细胞免疫、二次应答、免疫失调）
     - 5. 植物生命活动调节（生长素运输、敏感性差异、五大激素协同、光敏色素）
   - 化学（全册 4 章）：
     - 1. 化学反应热效应与盖斯定律消元（精炼复习）
     - 2. 化学反应速率与化学平衡判据（精炼复习）
     - 3. 水溶液四大平衡与三大守恒体系（电离、水解、pH变温、四大守恒、Ksp沉淀转化）
     - 4. 化学反应与电能模型（原电池放电机制、多室膜电解池流向、电极反应式配平四步法）
2. **二、易错清单（考前避坑雷达）**：
   - 每科严格筛选 8 项期末统考杀手级易错陷阱，带复选框交互与 `localStorage` 状态持久化。
3. **三、经典例题（成都市期末调研全真大题）**：
   - 每科提供 4 道完整的大题（各分值 12~15 分），涵盖情境题干、递进设问、标准采分点、易错警示。

---

## 5. 验收与测试决策 (Testing Decisions)

1. **结构完整性验证**：两份 HTML 均须包含完整的 Hero、Toolbar、Quick-nav、三大主模块、Footer。
2. **交互功能自动化测试**：
   - 自测模式按钮点击时，所有 `<details>` 展开/折叠状态同步变更；
   - 切换主题按钮点击时，`data-theme` 属性在 `default`、`paper`、`dark` 间循环并持久化；
   - 易错清单勾选时，进度条实时计算（如 1/8、2/8）并写入本地缓存。
3. **符号与代码整洁度验收**：
   - 文本扫描：验证两个 HTML 文件中字面 `$` 符号数量为 0。
   - 文本扫描：验证两个 HTML 文件中字面 `**` 标记数量为 0。
4. **Git 版本归档**：以原子性提交将 Spec 及后续交付物纳入 Git 分支跟踪。