# 《人工智能基础》AI 备课工作台 — v0.2 修订执行计划（修订版 v1.1）

| 项目 | 内容 |
|---|---|
| 版本 | v1.1（修订版） |
| 日期 | 2026-08-21 |
| 依据 | 《修改说明文档.md》（59 条修改项，见附录 A 追溯矩阵）；《GrokV0.2执行计划审查意见.txt》（本次修订吸收 K1–K6 / I1–I7 / G1–G8 全部意见） |
| 目标 | 完成设计说明书 v0.2 修订，按"第七章法学课闭环"进入阶段 1 开发 |
| 编码 | UTF-8 |

> **修订说明（v1.0 → v1.1）**：本版针对 Grok 复审意见修订。变更点：
> - K1：纠正计数（修改说明第 3 章实际为 **59 条** M 项，非 52；关键 38 / 重要 16 / 一般 5），A/B 改为"阻断性分级"（非优先级），新增**附录 A M→P 追溯矩阵**；
> - K2：新增 P0.5 工程骨架；P 序列补全 1.1/1.2/1.18 等骨架任务；
> - K3：周数按"有效小时"重估（文档 1.5 周 + 开发约 18 周兼职），删除"压缩至 8 周"；
> - K4：学号字段收口为独立列方案，删除"期中个体对比"（推迟阶段 3）；
> - K5：验收改为"系统闸门 G1–G6 + 教学抽检 S1–S7"两层，试讲与开发联调解耦；
> - K6：最小反馈、M4.3/M4.11/M4.13、材料生成步、M5.2、M6.7、M11.1 安全基线全部写入具体 P；
> - I1–I7、G1–G8：依赖与冻结规则、配置落表、种子范围明示、P0 完成标准、A 表字段、每 P 完成定义、执行风险、编号/抽检/重叠/变更控制等一并修正。

---

## 第 0 章 调整声明（相对《修改说明文档》的显式偏离）

> 变更控制规则（G6）：**凡未写入本章的、对《修改说明文档》的偏离，一律视为缺陷**。
> 每次偏离必须声明：调整内容、覆盖哪条 M / 原裁决、副作用、验收受影响行。

**调整一（灵活性，收窄表述）**：覆盖原"会上确认"三项——学时长度、学校教案格式/栏目、学习通/校级导入规范。修订为：
- **保证不返工的**：学时长度（`LESSON_MINUTES` 配置）、文件命名规则（配置 pattern）；
- **只改导出映射、不改生成引擎的**：教案栏目顺序/标题（导出模板配置）；
- **明确后置的**：学校红头/Logo 母版、学习通官方二进制题库模板 → **阶段 2**；阶段 1 失败路径为"人工套用/照做"，不算返工。

**调整二（保留可选学号，收口）**：覆盖 M2.5 / M4.7 / GROK-PED-G3 的"删除可选学号"裁决，及修改说明 4.4 验收第 8 条"无学号"（**由本计划第 7 章 G5 闸门 + P8 DoD 三项学号完成定义取代之**）。具体方案见第 5 章：独立列、自报未核验、不进分析/生成上下文；"开学 vs 期中个体对比"**推迟阶段 3**，阶段 1 只允许教师查看某生本次作答原文。

**调整三（种子范围，明示裁剪）**：覆盖 M4.14 的"全部章可教最小完整度"（关键项）：
- 阶段 1 种子承诺 = 第七章完整实例（含舆情/流浪狗）+ 第 0/1 课教学包 + 法学 template_rules 实例 + 问卷蓝图 A–F + 若干经典案例位；
- 其余章：允许标题 + 占位 description，**必须走 M6.6 拒生成门槛**（空/过短 description 不得出教案）；
- "全部章可教最小完整度"移到**阶段 2**（知识库录入工作），不阻塞第七章试讲。

---

## 1. 执行计划总览

```
阶段 0：P0 设计书 v0.2 修订（文档层，1.5 周）        ← 本计划第 6 章
   ↓
阶段 1：P0.5–P10 工程（开发层，约 18 周兼职）         ← 本计划第 3 章
   ↓
阶段 2/3：热点/RSS、反馈产品化、扩展（沿用《修改说明文档》4.2/4.3）
```

- **工时口径**：以"有效小时"估算，周数按"单人每周 8–12 小时"反推；日历周 ≠ 人周（K3）。基线只按单人排（G7），第二人只作可选加速，不改变关键路径。
- 本仓库**从零开始**：当前无 src/、无 package.json、无 prisma/，不存在可复用代码基线（K2）。

### 1.1 原则

1. **可教 > 可导出**：阶段 1 验收以"第七章一节真实法学课时能否直接上课"为准绳。
2. **默认值可运行**：一切外部信息依赖项有开箱即用默认值，配置是"调优"不是"前提"（第 4 章）。
3. **人工兜底优先于硬阻断**：机器判断不可靠处用"强警告 + 教师确认"，仅教学合规硬约束（目标编码、思政争议绑定、闭集引用）用系统闸门（第 7 章 G1–G6）。
4. **教学闭环优先，学习通同步靠后**：学习通只做"交换物"，API 同步始终是阶段 2 可行性评估项。
5. **每 P 一个可运行产出**：每个 P 结束有可演示结果（DoD 见第 3 章）。

---

## 2. 阻断性分级（A 开工前必改 / B 阶段 1 内必做）

> **注意**：本表是**阻断性分级**，不等于《修改说明文档》的"关键/重要/一般"（那是教学/合规优先级，38/16/5）。A/B 共 29 个编号格，其中部分格承载多条 M；**全部 59 条 M 的归属以附录 A 追溯矩阵为准**，本表一句话不是范围，范围以 M 原文为准（I5）。

### 2.1 A 级——开工前必改（阻塞数据模型与主流程，P0 必须先落）

| 编号 | 对应 M | 不得省略的字段/枚举（I5） |
|---|---|---|
| A1 | M4.1 | 三级目标：`course_outcomes`（编码/表述/素养维/core）+ 章目标 + 课时目标（id/text/type/bloom/success_criteria/objective_ids 挂接） |
| A2 | M4.2 | `content_depth`（原 base_depth 改名）+ `cognitive_level`（bloom_range）+ `misconceptions[]` + `knowledge_prereq` 表 + `default_depth` 改名 |
| A3 | M4.4 | `sizheng_integration` 改数组；`knowledge_point_sizheng.role`（content/infusion）；元素库按价值主题 + natural/forbidden 示例 |
| A4 | M4.8 | 状态机七态：not_started→plan_draft→plan_confirmed→ppt_draft→ppt_confirmed→materials_draft→completed；draft/confirmed 分存；`teacher_edits_summary`/`why_changed`/`adaptation_log[]`/`generation_meta` |
| A5 | M4.9 | `course_outlines` 语义改为"本班课程设计对象"：version/confirmed_at/assessment_plan 结构化，可课前确认 |
| A6 | M4.12 + M6.3 | **一份产物 Schema 冻结物**（§4.2 与 §6.3 共用，禁止分两次改）：objectives/core_plus_extension/lesson_type/lesson_events 活动单元/relevance_to_major/formative_checks/lesson_phase/citations 闭集；PPT slide_type 枚举 + diagram_spec；materials task_type/rubric/tier/evidence_type；profile_report 分布结构；问卷按蓝图模块 |
| A7 | M5.1 | §5.1 两段式流程（课程设计段 + 课时开发段 + 主案例先选）；无主案例不得生成案例型教案 |
| A8 | M5.3 | 闭集引用：source_type ∈ {knowledge_point, case, hotspot, teacher_url, textbook_section} + source_id；`claim_unverified` 强制处理 |
| A9 | M2.6 | F6.1 生成顺序重写：大纲不得作为首次设计时机（课前确认 + 事后微调） |
| A10 | M2.10 | 导出合规块：AI 标识（模型/时间/确认人）；生成内容与学生作答不得用于训练；热点/教材默认不出全文 |
| A11 | M2.5 + M4.7 | 问卷蓝图：必测模块 **A 迷思/B 工具经验/C 行为化准备度/D 专业先行/E 态度/F 期望** 锁定不可删；`student_no` 独立列（第 5 章）；token 限期/限次；`generation_tasks.type` 补 questionnaire/profile_report/knowledge_extract |
| A12 | M2.2 + M6.6 | 知识点可教字段（description 完整度/content_depth/bloom_range/misconceptions/prerequisites）+ **空/过短 description 拒生成**门槛 + 先修缺口警告 + 出域切片 |
| A13 | M4.3 | template_rules 扩展为可执行 PCK：literacy_focus[]/omit_items[]/permitted_tools[]/expected_student_performance/preferred_lesson_type/media_strategy |

### 2.2 B 级——阶段 1 内必做（不阻塞 P0 签字，按序落地）

| 编号 | 对应 M | 落地 P |
|---|---|---|
| B1 | M6.1 | 素养地图 + 提示词硬约束（先于文采；目标 3–5 条；活动/习题挂目标；闭集引用；六条标准） | P4 |
| B2 | M4.5 | 案例结构字段（case_type/dilemma/stakeholders/teaching_note/time_needed）+ 案例—知识点/模板关系表化 + hotspots.analysis 合规字段 + raw_text 短摘录上限 | P2/P3 |
| B3 | M4.14 | 种子可教性（范围按调整三） | P2 |
| B4 | M4.6 | 画像版本化 + 分布结构 + 学情修订记录（问卷重分析不覆盖教师层） | P3 |
| B5 | M5.4 | 问卷校准步（教师确认后才写回 profile；低完成率不自动改深度） | P8 |
| B6 | M6.2 | 六条"好教案"标准 + adaptation_log（模型与确认清单共用；按失败条目再生成） | P5/P6 |
| B7 | M6.4 | PPT 页级硬约束（要点 ≤5、单条 ≤20 字、讲稿只进备注、一页一信号、图文同页）+ diagram_spec 可渲染 | P7 |
| B8 | M6.5 | 生成后自检（对齐/冲突/未核验列表）+ 易错 ⚠ 标记 + 已知错误清单回写 | P4 |
| B9 | M6.7 | 上下文组装清单：已确认大纲与目标/主案例 teaching_note/未过期补丁/历史改动/最小反馈/错误清单 | P4 |
| B10 | M2.8 + M7.2 | 材料**生成**（task_type 扩展：再认/解释/案例裁决/真实性任务；rubric；tier 必做/选做/拓展；objective_ids）+ 教师版/学生版分套**导出**（生成与导出是两个动作） | P6/P7 |
| B11 | M2.9 + M7.5 | F10 学习通交换物：题库 Excel/活动清单/课件包命名（读 chaoxing 字段）+ 五步清单（P6 壳 / P9 实，G3） | P9 |
| B12 | M4.10 | 知识补丁/修订表最小集（手工 + AI 草稿 + admin 确认；生成拉取未过期补丁） | P2 |
| B13 | M8.1 | 向导界面：课程设计首步 + 主案例步 + 差异提示卡 + 新状态徽章 | P5/P6 |
| B14 | M8.2 + M8.3 | 双模式编辑 + 平行班复制 + 完成页"去学习通五步"（框架 P6 / 内容 P9）+ 预览徽章（AI 草稿/已人工修改/已确认） | P6/P9 |
| B15 | M8.5 | 问卷/画像界面分步：样本量优先展示、题—字段映射、确认写回分离 | P8 |
| B16 | M5.2 | 思政确认项替换"栏目齐全"：至少一处争议绑定本课目标/案例；无空洞口号 | P6 |

> 其余一般项（M2.13 第一课教学包、M6.8 成本叙述、M7.4 学校格式、M8.4 响应式、M11.2 数据可携带、M5.5 热点分支、M9.1 API、M10.1 里程碑、M11.1 安全基线、M12.1/M12.2 风险与开放问题）**不再设 B17 口袋**（I6），全部写入具体 P 的完成定义（见第 3 章与附录 A）。

> **重叠声明（G5）**：闭集引用——数据与校验主责在 **A8**（P1 表结构 / P4 校验），导出渲染在 **A10**（P7），A10 不重复实现校验逻辑；两段式——**A9**（F6.1 需求文字，P0 改）与 **A7**（§5.1 流程图，P0 改、P5 实现一处）：**P0 改两处、P5 实现一处**；素养地图——**A1** 库表在 P1，**B1** 提示词硬约束在 P4。

---

## 3. 阶段 1 执行序列（P0、P0.5、P1–P10）

> 每 P 含：范围（对应原 1.x / 新增 / M 编号）、完成定义 DoD（可勾选）、演示、依赖、建议周数（单人兼职 8–12 h/周，允许 ±30%，K3）。
>
> **并行与冻结物规则（N-G7 / N-I1）**：并行以"冻结物"为准——① **Schema 冻结** = P0 完成标准 2 的样例 JSON 获批（表结构可开工 P1）；② **第七章种子冻结** = P2 DoD 获批（P5–P7 才有合法输入）；③ **产物 JSON 冻结** = P6 首份已确认教案获批（P7 导出层可开工）。任一冻结前，相关并行只做不依赖该物的部分。
>
> **原 1.26–1.39 任务映射（I6）**：1.26→P1；1.27→P5；1.28→P5；1.29→P4/P7；1.30→P7；1.31→P9；1.32→P8；1.33→P6；1.34→P6；1.35→P2；1.36→P5/P6；1.37→P3/P4；1.38→P8/P10；1.39→P2。
>
> **P8/P5 画像写回协议**：P8 问卷分析生成的新画像版本**不自动覆盖** P5 已确认画像，需教师二次确认后才写回（B5）。

### P0 设计书 v0.2 修订 [文档] —— 1.5 周
- **范围**：§1–§12 全覆盖（G2：§3 只改目录与架构说明，不改技术选型）；修改说明附录 5 项全部落实
- **DoD**：
  1. A1–A13 全部落入对应章节（附录 A 可检索）；
  2. §5.1 两段式流程图、§6.3 全部产物 Schema 已重写，与 A6 同一份冻结物；
  3. **附第七章课时手工样例 JSON**：lesson_plan + slides + materials 各一份（可人工编写、不要求已能生成）+ 问卷 A–F 题目样例（I4）；
  4. 第 4 章灵活性配置（LESSON_MINUTES/导出栏目/命名 pattern）写入 §11 配置说明；
  5. §12.2 修订指令：按 M12.2 关闭协作与种子待定；按本计划第 0 章关闭"三项会上确认才能开工"；学号按第 5 章改写 §5.5/F9（**不是去删一条不存在的开放问题**，I4）；
  6. §12.1 教学质量风险表 + 执行风险（I7）
- **依赖**：《修改说明文档》+ 本计划第 0/4/5 章调整
- **演示**：v0.2 文档 + 样例 JSON 供 P1 对拍

### P0.5 工程骨架 —— 1 周
- **范围**：原 1.1/1.2 + 工作台最小壳（K2）；说明：仓库从零开始
- **DoD**：
  1. Next.js 14 + TS + Tailwind + shadcn/ui + Prisma(SQLite) 可运行；
  2. 登录/登出/会话（bcrypt）；admin/teacher 角色；
  3. 空工作台页面（班级卡片占位）+ `.env` 模板（DEEPSEEK_API_KEY/DATABASE_URL/SESSION_SECRET/UPLOAD_DIR/LESSON_MINUTES）
- **依赖**：无（可与 P0 后半并行）
- **演示**：能登录的空白应用

### P1 数据模型落地 —— 1.5 周
- **范围**：A1–A5、A8、A10、A11、A12、A13 表结构；B4、B12；**M4.3 全字段**、**M4.11 反馈最小四字段**、**M4.13 chaoxing 可选字段 + source_case_id**、**student_no 独立列**（K4/K6）；系统配置表（I2）
- **DoD**：
  1. Prisma schema + 迁移，含目标对象/关联表/草稿分存/补丁表/系统配置表；
  2. `questionnaire_responses.student_no` 可空独立列，非 questions[] 题目；
  3. 与 P0 样例 JSON 对拍通过（字段名一致）
- **依赖**：P0 的 Schema 决策冻结（正文可未完成，表结构已定，I1）
- **演示**：`prisma migrate` 可跑 + schema 文档

### P2 种子数据（可教性，按调整三范围）—— 2 周
- **范围**：B3（第七章完整实例：目标/素养/omit/误解/先修/流浪狗 teaching note）、第 0/1 课教学包（M2.13）、法学 template_rules 实例、问卷蓝图 A–F、经典案例位（算法歧视/生成内容责任/人脸识别）、B12 补丁表示例
- **DoD**：
  1. 第七章全部知识点达"可教最小完整度"；流浪狗案例含争议结构 + teaching note；
  2. 问卷蓝图 A–F 模块题目样例（15–20 分钟作答量）；
  3. 其余章占位 description 明确走拒生成（自动测试：空描述不可发布）；
  4. 第 0/1 课教学包就位（问卷 15–20 分钟 + 迷思小案例 + 素养目标解说 + 差异化说明，M2.13 / N-G4）
- **依赖**：P1；用户第 9 章三项输入；**若 AI 辅助补种则 API Key 是 P2 前门闩（非 P4）**（I1）
- **演示**：seed 脚本跑通 + 第七章知识库可浏览

### P3 知识库/模板/班级管理页 —— 2 周
- **范围**：原 1.5/1.6/1.7；知识库含误解/先修/core 目标/**提取审核台 + 空描述不可发布**（1.25，K6）；模板含 **template_rules 全字段**（M4.3）；班级含分布画像编辑/校准状态/修订入口（B4）
- **DoD**：
  1. 三个管理域 CRUD 可用；AI 提取走审核台（禁止提取即入库）；
  2. 画像分布编辑 + "待验证假设"标注 + 第 4–5 周修订入口；
  3. 文件导入（Word/Markdown 大纲解析）最小可用
- **依赖**：P0.5 + P1（功能）；P2（演示数据，可后置，I1）
- **演示**：管理页操作第七章种子

### P4 AI 客户端 + 生成任务 —— 2 周
- **范围**：原 1.8/1.9；B1（提示词硬约束 + 素养地图）、B8（自检 + 错误清单）、B9（**M6.7 上下文组装清单**，K6）；闭集引用校验；出域切片；任务类型补全
- **DoD**：
  1. 统一客户端 JSON 输出 + Schema 校验失败重试 + 失败可视化；
  2. 上下文组装函数包含 B9 全部输入（可单测）；
  3. 自检输出：目标—活动—评价对齐、未核验主张列表、易错 ⚠ 标记；
  4. 教师纠正写入错误清单，后续提示词携带；
  5. 出域切片函数可单测（教材/热点只送切片，N-G5）
- **依赖**：P1（硬）；P2（测"可教"通路径，可后置失败路径，I1）
- **演示**：对第七章一个知识点跑通一次生成（含自检输出）

### P5 课程设计段向导 —— 1.5 周
- **范围**：A7/A9 向导首段：画像确认 → 本班课程目标/考核 → 周进度草稿；主案例 3 选 1（A7）；六条标准骨架（B6）
- **DoD**：
  1. 能生成并确认本班课程目标/考核/周进度草稿；大纲可在课前 confirmed；
  2. AI 推荐 3 案例、教师选主案例；无主案例不能走案例型教案生成；
  3. 画像未确认（或仅有"待验证假设"标注）时生成上下文有明确提示；
  4. 确认页出现六条标准骨架（完整六条在 P6，N-G5）
- **依赖**：P2 + P3 + P4（I1）
- **演示**：对法学班完成课程设计段全流程

### P6 教案生成与确认闭环 —— 2.5 周
- **范围**：原 1.10/1.11；A6 Schema 教案生成；B6 六条清单 + adaptation_log；B16（**M5.2 思政确认项替换"栏目齐全"**，K6）；学时校验；双模式编辑；差异提示卡；平行班复制（B14 框架）；**材料草稿生成（task_type/rubric/tier，B10 生成侧）**；**最小反馈四字段入口（M2.11/M4.11，写入后注入同班下一课上下文，K6）**；工作台质量视图最小集（重生成次数/待审/修改率，K2）
- **DoD**：
  1. 无 objectives[] 无法确认（系统闸门 G1）；
  2. 确认页展示六条清单、adaptation_log、差异提示卡、学时比对（超载标红）、未核验引用列表；
  3. 思政确认项为"至少一处争议绑定目标/案例"，无"栏目齐全"字样；
  4. 材料草稿与教案确认后可并行生成（状态机到 materials_draft）；
  5. 最小反馈四字段可写入且出现在同班下一课生成上下文；
  6. 平行班复制（B14）可用：复制后仅重生案例/习题/相关性（S6 前提）；
  7. 工作台质量视图最小集：重生成次数 / 待审数 / 近两周修改率 / 连续零修改提示（K2）
- **依赖**：P4 + P5（I1）
- **演示**：确认一节第七章教案（含材料草稿）

### P7 PPT 生成与导出 —— 2.5 周
- **范围**：原 1.12/1.15/1.16；B7（slide_type/diagram_spec/页级硬约束）；Word 课前-课中-课后结构 + AI 标识（A10）；教师版/学生版分套**导出**（B10 导出侧）；**读系统配置（LESSON_MINUTES/导出栏目/命名 pattern，I2）**；闭集引用渲染（未核验突出）；无障碍底线（字号/对比度，I6 并入 DoD）
- **DoD**：
  1. 内容页要点 ≤5/单条 ≤20 字/讲稿只进备注为**生成硬约束**（校验失败重试或标红，不得直接待确认）；
  2. diagram_spec 至少一种（流程/对比/利弊）可渲染为形状；
  3. Word 导出含目标—活动—评价对照表 + AI 标识 + 补丁摘要；导出读配置不读常量；
  4. 教师版/学生版分套可用；
  5. 无障碍底线：正文字号 ≥20pt、高对比默认主题、不用唯色彩编码（M7.3 阶段 1 底线，N-G5）
- **依赖**：**A6 产物 Schema** 冻结（Schema 冻结后即使 P6 未全完也可开工，I1）；联调需 P6 至少 1 份已确认教案
- **演示**：第七章一份教案 → PPT + Word 双导出

### P8 问卷闭环 —— 1.5 周
- **范围**：原 1.21–1.24；A11 蓝图生成；B5 校准分步；B15 界面分步；**学号选填**（第 5 章，K4）
- **DoD**：
  1. 必测模块 A–F 无法被 AI 删除（自动化断言）；
  2. **学号三项完成定义**：选填可用（问卷末独立框，非题目）；分析 payload 快照无学号（断言测试）；班级详情学号归集仅 owner 可见；
  3. 作答页隐私首屏（目的/匿名/学号自愿/不用于成绩/不用于训练）；token 限期与限次；
  4. 画像输出含样本量/完成率/分布；教师确认后才写回 profile；低完成率只出"供参考"
- **依赖**：P1 + P2 + P3 + P4（I1；与 P5–P7 可平行，但画像写回影响 P5 需协调）
- **演示**：法学班问卷发布 → 学生作答 → 分布画像 → 确认写回

### P9 学习通交换物 —— 0.5 周
- **范围**：B11 实：题库 Excel 模板、每课时活动清单、课件包命名（**读 classes.chaoxing_* 字段，禁止硬编码**，K6）、"去学习通五步"内容
- **DoD**：
  1. 题库导出 Excel（题干/选项/答案/难度列）+ 一页导入说明；
  2. 活动清单与章节—课时目录对齐；命名 pattern 读配置；
  3. 五步清单可勾选记录
- **依赖**：P7（I1）
- **演示**：导出第七章课件包 + 题库文件

### P10 联调与验收 —— 1 周（开发联调部分；试讲按校历单列）
- **范围**：端到端联调；**上线安全基线（M11.1：HTTPS 或 cookie secure 前提、token 熵/过期/限次、管理操作审计、学生作答不用于训练的配置与声明，K6）**；工作台质量视图补全（K2）；验收按第 7 章
- **DoD**：
  1. 第 7 章系统闸门 G1–G6 全绿；
  2. 教学抽检 S1–S7 执行并出报告（抽样总体/随机种子固定，G4）；
  3. 安全基线清单完成；
  4. M8.4 响应式（工作台 / 待确认 / 问卷回收 / 热点待审关键页）
- **依赖**：P2–P9（I1）
- **演示**：联调报告 + 抽检报告；试讲（按校历）失败只开第七章补丁迭代，不视为计划失败

**合计工时**：文档 1.5 周（约 12–20 h）+ 开发（P0.5–P10）约 **18 周**（144–216 h，中位约 180 h；**250 h 视为 +30% 上限，不是基线**；单人兼职 8–12 h/周）。试讲按教学日历单列，不计入开发周（K3）。

---

## 4. 灵活性原则（调整一的落实，收窄版）

| 外部信息 | 处理 | 是否承诺不返工 |
|---|---|---|
| 学时长度 | `LESSON_MINUTES` 系统配置（.env 或管理页），校验按配置值 | ✅ 是 |
| 文件命名规则 | 命名 pattern 系统配置 | ✅ 是 |
| 教案栏目顺序/标题 | 导出模板配置（内置 1 默认 + 1 空模板，导出前可增删栏目，存个人偏好 `user_export_prefs` 表） | ✅ 只改导出映射，不改生成引擎 |
| 学校红头/Logo 母版 | **阶段 2**；阶段 1 失败路径 = 教师下载后人工套用 Word 样式 | ⚠️ 明确后置，不算返工 |
| 学习通官方题库二进制模板 | **阶段 2**（若存在）；阶段 1 用开放 Excel + 列映射说明 + 30 分钟照做兜底 | ⚠️ 明确后置，不算返工 |

- **配置落表（I2）**：P1 建 `sys_config`（key/value：LESSON_MINUTES、export_columns JSON、file_naming_pattern）与 `user_export_prefs`；P7 读配置，不读常量。
- **配置优先级（N-G2）**：`.env` 提供初值，`sys_config` 表覆盖之；P7 只读 `sys_config`。
- **表述修正**：不再声称"任何一项后来确定都填配置不返工"；明确"学校母版/官方模板 → 阶段 2"（I2）。

---

## 5. 问卷"可选学号"的处理（调整二的落实，收口版）

### 5.1 字段定案（K4）

- `questionnaire_responses.student_no`：可空字符串**独立列**，**不作为 questions[] 的普通题**（避免 AI 改蓝图时动学号题）。
- 学生作答页末尾展示独立选填框，标注"自愿填写，仅教师可见"。
- 分析/画像任务的入模数据构造函数**禁止读取该列**（代码层剥离 + 断言测试）。

### 5.2 用途与限定

- 学号**自报、未核验**，不作为成绩/考勤依据（文案明示）。
- 阶段 1 仅允许教师在班级详情查看某生**本次问卷作答原文**（owner 可见）；"开学 vs 期中个体对比"**推迟阶段 3**（阶段 1 无学生二次问卷，F8 最小集是教师课后四字段）。
- 隐私：保留期、教师删除作答、备份访问控制，并入 M11.1 上线安全基线。

### 5.3 防标签化（不依赖删学号）

- 画像只输出分布（如"约 2/3 未接触过代码"），不生成个体描述；
- 学号列不进 prompt；教师备注限"班级层观察"。

### 5.4 覆盖声明

- 本方案**取代《修改说明文档》4.4 验收第 8 条"无学号"**：由本计划第 7 章 **G5 闸门**（student_no 列不进分析/生成 prompt，断言测试）与 **P8 DoD 三项学号完成定义**为准；验收文档以此为准，不再引用"无学号"。

---

## 6. 设计书 v0.2 修订动作清单（P0 的文档层操作）

| 章节 | 修订动作 |
|---|---|
| §1 概述/术语 | 素养+专业情境定位（M1.1）；术语表增补（M1.2） |
| §2 需求 | F2 三级目标+素养地图（M2.1）；知识点可教字段（M2.2）；F3 模板扩展（M2.3）；F4/F9 画像分布+校准（M2.4/M2.5，含可选学号按第 5 章）；F6 两段式+评估扩展（M2.6/M2.8）；F5 案例结构+知识点优先（M2.7）；**新增 F10**（M2.9）；导出合规（M2.10）；F8 最小反馈（M2.11）；协作机制定稿（M2.12）；第一课教学包（M2.13） |
| §3 架构 | 目录/架构说明更新（新增 curriculum 步骤、patches、交换物导出、问卷校准页），**不改技术选型**（G2） |
| §4 数据模型 | A1–A13 全部表结构；B4/B12；M4.11 反馈字段；M4.13 chaoxing/source_case_id；student_no 列；sys_config/user_export_prefs |
| §5 核心流程 | §5.1 两段式（A7）；§5.2 热点知识点优先+补丁分支（M5.5）；§5.3 思政质量标准（B16/M5.2）；§5.4 闭集引用（A8）；§5.5 问卷校准+第一课（B5/M5.4，含学号第 5 章）；学时校验（M5.6） |
| §6 AI 引擎 | 提示词硬约束（B1）；六条标准（B6）；Schema 全量重写（A6）；PPT 硬约束（B7）；自检/错误清单（B8）；上下文链（B9/M6.7）；出域切片（A12）；成本叙述（M6.8） |
| §7 导出 | Word 课前-课中-课后+AI 标识（A10/M7.1）；分套导出（B10/M7.2）；PPT 版式类型+无障碍（B7/M7.3）；学校格式按第 4 章（M7.4）；学习通活动清单（B11/M7.5） |
| §8 界面 | 向导两段式+主案例（B13）；双模式+平行班复制+五步（B14）；响应式（M8.4）；问卷分步（B15/M8.5） |
| §9 API | 与两段式对齐（M9.1：curriculum/objectives/case_select、草稿/确认分离、复制、交换物导出、闭集校验、patches、最小反馈、问卷分析不自动覆盖 profile） |
| §10 开发计划 | 按本计划 P0–P10 改写（M10.1） |
| §11 部署运维 | 配置项清单（第 4 章）；出域/禁止训练/审计/HTTPS 前提（M11.1）；数据可携带（M11.2） |
| §12 风险/开放问题 | 教学质量+执行风险表（M12.1）；开放问题关闭与新增（M12.2：按本计划第 0 章关闭三项"会上确认"，学号按第 5 章，**不删不存在的开放问题**） |

### 6.1 P0 完成标准

1. A1–A13 全部落入对应章节；§5.1 与 §6.3 Schema 与 P1 表结构一致；
2. **附第七章课时手工样例 JSON（lesson_plan+slides+materials）与问卷 A–F 题目样例**（I4，作 P1 对拍物）；
3. 第 4 章配置项写入 §11；问卷章节含第 5 章学号处理；
4. 新增 F10 章节齐全（边界、三类交换物、不做 API 承诺）；
5. §12.2 按第 0 章关闭三项 + 学号按第 5 章改写 §5.5/F9；
6. 修改说明附录五项全部落实。

---

## 7. 阶段 1 验收（两层：系统闸门 + 教学抽检；K5）

### 7.1 系统闸门（P10 前必须全绿，自动化/代码级）

> **编号说明（N-G3）**：本章闸门编号 G1–G6 与《GrokV0.2执行计划审查意见》中一般问题的编号 G1–G8 **无关**，仅指系统闸门。

| # | 闸门 | 实现 |
|---|---|---|
| G1 | 无 objectives[] 不得 plan_confirmed | 状态机硬约束 |
| G2 | 案例型课无主案例不得生成"案例分析"教案 | 生成前置校验（A7） |
| G3 | 空/过短 description 知识点拒绝调用模型 | 生成前置校验（A12） |
| G4 | 问卷生成不得删除 module_id ∈ {A..F} | 蓝图断言测试（A11） |
| G5 | student_no 列不进入分析/生成 prompt | 构造函数剥离 + 断言测试（第 5 章） |
| G6 | 导出 100% 含 AI 标识与确认人 | 全量扫描（非抽检） |

### 7.2 教学抽检（人工；总体 = 已确认且用于试讲章的全部产物，不足 10 则全检，≥10 随机 10 并固定随机种子记入报告，G4）

| # | 抽检项 | 及格线 |
|---|---|---|
| S1 | 目标—活动—评价 | 抽检样本 0 份缺 objective_ids |
| S2 | 试讲课教学内核 | 核心/支架/拓展均在教案出现；思政至少一处绑定主案例争议（非独立栏目）；主案例有 teaching note；任课教师"不改结构能否上课"≥4/5（**PPT 与教案分项打分**） |
| S3 | PPT 页级约束 | 按页计：要点 >5 或讲稿进正文的页 <5%；diagram_spec 至少 1 页渲染为形状；不达标则产品文案只能称"幻灯片草稿"（回写 4.4.3 降级条款；G8：默认路径机检必须通过，抽检只针对"标红后教师强制确认"的例外路径） |
| S4 | 引用 | 编造 0；claim_unverified 漏标 <2 份；超阈不得宣称"来源引用"能力（文案降级） |
| S5 | 学习通交换物 | 教师按说明 30 分钟内导入或照做 |
| S6 | 平行班复制 | T(copy, n=3) < 2 × T(from_scratch, n=1)；T 从打开向导到可上课导出，**含人工核验时间** |
| S7 | 种子门槛 | 第七章达 M4.14 完整实例标准（按调整三）；其他章只能走拒生成 |

### 7.3 试讲与开发联调解耦（K3/K5）

- P10 交付联调报告 + 抽检报告 = **开发完成标志**；
- 试讲按教学日历单列，**不是开发者可承诺的周数**；试讲失败只开第七章补丁迭代，不视为计划失败。

---

## 8. 风险与应对

### 8.1 项目常见风险（保持）

| 风险 | 应对 |
|---|---|
| 范围膨胀 | A/B 分级 + 附录 A 矩阵 + 每 P DoD；调整三明示种子裁剪 |
| 种子资料不足 | 第 9 章输入截止日（I7）；逾期只做第七章人工最小实例 |
| 单人开发周期长 | 基线单人排期；每 P 可演示增量；关键路径不依赖第二人 |
| 模型 JSON 不稳定 | 先锁最小 Schema（A6 冻结物）；失败可视化；P4 不一次上齐自检+错误清单+出域切片最终形态（I7） |
| 完美主义拖期 | 第 7 章及格线明确，达到即算完成 |

### 8.2 本计划自身引入的执行风险（I7，新增）

| 风险 | 应对 |
|---|---|
| 附录五项未齐备就冻 Schema → P1 返工 | P0 DoD 含手工样例 JSON 作对拍物（I4） |
| 教学日历约束试讲 | 试讲与开发联调解耦（7.3） |
| 可选学号的个保法泄露面 | 第 5 章：独立列、自报未核验、剥离、保留期/删除/备份并入 M11.1 |
| 种子输入延迟 → P5–P7 质量无意义 | P2 设输入截止日，逾期只做第七章最小实例 |
| 调整二与四份专家意见公开文本不一致（"无学号"） | 验收以本计划第 7 章为准，S-条印"覆盖修改说明 4.4.8" |
| 工时假设破产 | 连续两个 P 超 150% 估时则停止加范围，先保第七章一课闭环（K3） |

---

## 9. 需要用户配合的事项

| 事项 | 说明 | 门闩 |
|---|---|---|
| DeepSeek API Key | 可先做成可配置（.env） | **P2 前**（若 AI 辅助补种；否则 P4 前） |
| 第七章 NLP 目录与要点 | 种子可教性主要输入；先给目录框架，AI 补全后你审核 | **P2 输入截止日** |
| 上学期 3 个法学班经验要点 | 写入 template_rules（"何处过深、何例有效"） | P2 前 |
| 流浪狗舆情案例结构 | teaching note 补充（争议结构、立场、法律争议） | P2 前 |
| 学时/格式/学习通信息 | **可选**：有确定信息就填配置，没有用默认值（第 4 章） | 任意时间 |

---

## 附录 A：M→P 追溯矩阵（K1，全部 59 条）

> 列说明：**优先级** = 修改说明中的教学/合规优先级（关键/重要/一般）；**分级** = 本计划阻断性分级（A=开工前必改，B=阶段 1 内必做，仅文档=只改说明书，阶段2/3=后置）；**主责 P** = 落入的 P 序号（"P0"表示只改文档）。
> 未入矩阵者一律视为遗漏。修改说明正文自称"52 条"，以本矩阵 59 条（按第 3 章标题清点）为准。

| M | 标题（简） | 优先级 | 分级 | 主责 P |
|---|---|---|---|---|
| M1.1 | 素养+专业情境定位 | 关键 | 仅文档 | P0 |
| M1.2 | 术语表增补 | 关键 | 仅文档 | P0 |
| M2.1 | 三级目标+素养地图 | 关键 | A1（目标表）+B1（提示词） | P1/P4 |
| M2.2 | 知识点可教字段+拒生成 | 关键 | A12 | P1/P4 |
| M2.3 | 模板扩展 | 关键 | A13 | P1/P3 |
| M2.4 | 画像分布+校准 | 关键 | B4 | P3 |
| M2.5 | 问卷蓝图+必测模块 | 关键 | A11 | P1/P8 |
| M2.6 | 生成顺序（两段式） | 关键 | A9 | P0/P5 |
| M2.7 | 案例结构+知识点优先 | 关键 | B2 | P2/P3 |
| M2.8 | 评估扩展 | 关键 | B10 | P6/P7 |
| M2.9 | F10 学习通交接 | 关键 | B11 | P9 |
| M2.10 | 导出合规 | 关键 | A10 | P0/P7 |
| M2.11 | 反馈最小四字段 | 重要 | B 级内嵌（P6 完成定义） | P6 |
| M2.12 | 协作机制定稿（公共案例可浏览、可引用并记 source_case_id） | 重要 | 仅文档 + 开发 | P0 / P3（案例库页浏览 + 引用记来源） |
| M2.13 | 第一课教学包 | 一般 | 阶段 1 种子 | P2 |
| M4.1 | 三级目标对象 | 关键 | A1 | P1 |
| M4.2 | 双编码+误解/先修 | 关键 | A2 | P1 |
| M4.3 | template_rules PCK | 关键 | A13 | P1/P3 |
| M4.4 | 思政数组/role | 关键 | A3 | P1 |
| M4.5 | 案例结构+关系表化 | 关键 | B2 | P2/P3 |
| M4.6 | 画像版本化+分布 | 关键 | B4 | P3 |
| M4.7 | 问卷字段+合规 | 关键 | A11（含 student_no） | P1/P8 |
| M4.8 | 状态机+草稿分存 | 关键 | A4 | P1 |
| M4.9 | course_outlines 语义 | 关键 | A5 | P1 |
| M4.10 | 知识补丁表 | 重要 | B12 | P2 |
| M4.11 | feedbacks 扩维 | 重要 | B 级内嵌（P6 完成定义） | P6 |
| M4.12 | 教案/材料 Schema | 关键 | A6 | P1/P6 |
| M4.13 | chaoxing/source_case_id | 重要 | B 级内嵌 | P1/P9 |
| M4.14 | 种子可教性 | 关键 | B3（范围按调整三） | P2 |
| M5.1 | 两段式状态机 | 关键 | A7 | P0/P5 |
| M5.2 | 思政质量标准 | 关键 | B16 | P6 |
| M5.3 | 闭集引用 | 关键 | A8 | P1/P4/P7 |
| M5.4 | 问卷校准分步 | 关键 | B5 | P8 |
| M5.5 | 热点知识点优先+补丁分支 | 重要 | 阶段 2（主）+B 级内嵌（P2 补丁表） | P2/阶段2 |
| M5.6 | 学时容量校验 | 重要 | B 级内嵌（P6 DoD） | P6 |
| M6.1 | 提示词硬约束 | 关键 | B1 | P4 |
| M6.2 | 六条标准 | 关键 | B6 | P5/P6 |
| M6.3 | 产物 Schema 全量 | 关键 | A6（与 M4.12 同一冻结物） | P0/P1/P6 |
| M6.4 | PPT 硬约束 | 关键 | B7 | P7 |
| M6.5 | 自检+错误清单 | 重要 | B8 | P4 |
| M6.6 | 拒生成+先修+出域 | 关键 | A12 | P3/P4 |
| M6.7 | 上下文链 | 重要 | B9 | P4 |
| M6.8 | 成本叙述（教师时间） | 一般 | 仅文档+P6 界面提示 | P0/P6 |
| M7.1 | Word 课前-课中-课后 | 关键 | B 级内嵌（P7 DoD，A10 连带） | P7 |
| M7.2 | 教师版/学生版分套 | 重要 | B10 | P7 |
| M7.3 | PPT 版式+无障碍 | 关键 | B7 | P7 |
| M7.4 | 学校格式（阶段 1 标题页） | 一般 | B 级内嵌（P7 DoD，按第 4 章） | P7 |
| M7.5 | 学习通活动清单 | 重要 | B11 | P9 |
| M8.1 | 向导改造 | 关键 | B13 | P5/P6 |
| M8.2 | 双模式+平行班复制 | 重要 | B14 | P6 |
| M8.3 | 完成页五步 | 重要 | B14（P6 壳/P9 实） | P6/P9 |
| M8.4 | 响应式 | 一般 | B 级内嵌（P10 DoD） | P10 |
| M8.5 | 问卷画像界面分步 | 关键 | B15 | P8 |
| M9.1 | API 对齐 | 重要 | B 级内嵌（随各 P） | P5–P9 |
| M10.1 | 里程碑验收改写 | 关键 | 仅文档+第 7 章 | P0/P10 |
| M11.1 | 出域/安全基线 | 重要 | B 级内嵌（P10 DoD） | P10 |
| M11.2 | 数据可携带 | 一般 | 阶段 2 | 阶段2 |
| M12.1 | 教学质量风险表 | 关键 | 仅文档 | P0 |
| M12.2 | 开放问题关闭/新增 | 重要 | 仅文档（按第 0 章） | P0 |

**覆盖检查**：59 条全部入矩阵；A 级 13 格 + B 级 16 格 + "仅文档"（M1.1/M1.2/M2.12/M10.1/M12.1/M12.2 中仅文档部分）+ 阶段 2（M5.5 主、M11.2）+ B 级内嵌（M2.11/M4.11/M4.13/M5.6/M6.8/M7.1/M7.4/M8.4/M9.1/M11.1）均有着落，无静默消失。

---

**文档结束。**
本计划（v1.1）与《修改说明文档》《GrokV0.2执行计划审查意见》配套：前者回答"改什么、为什么"，后者是本次修订依据，本计划回答"按什么顺序改、每步产出什么、如何算完成"。