# 通千算智AI教案 · 节省时间量化体系口径说明

> 版本：v1.0 ｜ 日期：2026-11-12  
> 适用范围：校长驾驶舱「估算节省机械工作时间」、教师「我的 AI 教学报告」、试点评估包  
> 代码单一来源：`server/server.js` 的 `DASH_SAVED_RULES` / `SAVED_NOTE`（前端只展示，不自行加权）

---

## 一、为什么需要一份口径说明

调研（`调研-海外产品管理端视角` §TL;DR 2、§12.1）显示，"证明减负"是机构版的第一卖点，但**证据链分三级**，越往下越能打动校长/局长：

| 级别 | 形态 | 海外标杆 | 我方现状 |
|------|------|----------|----------|
| **L1 估算** | 生成次数 × 固定权重 | MagicSchool "每周 7h+"（自述） | ✅ 已实现（本文件规范的对象） |
| **L2 调研** | 教师问卷自报 + 样本量与方法论注脚 | Diffit：2,517 名教师、96% 称省时、第三方机构执行 | 🟡 试点评估包已提供问卷模板，待真实数据积累 |
| **L3 成果** | 学业成绩对照 / 独立 RCT | Curipod 州考 69%→89%；Khanmigo RCT | ⚪ 需种子校案例，运营驱动 |

**合规红线**：L1 是**机械工作量估算**，不是"提分"承诺，也不是教师实际少加班的精确时长。所有展示位置必须标注估算口径，不得当精确数据对外宣传。

---

## 二、L1 权重表（当前实现）

### 2.1 逐类权重

| 工具 kind | 中文名 | 每次估算节省 | 依据 |
|-----------|--------|:---:|------|
| `lesson_gen` | AI 教案课件 | 30 分钟 | 一次完整教案 + 课件初稿的机械工作时间 |
| `aippt` | AI 生成课件 | 30 分钟 | 同上 |
| `quiz_gen` | AI 出题 | 15 分钟 | 一份课堂练习的选题、排版、附答案 |
| `juanzi` | 自动组卷 | 15 分钟 | 一份单元测试卷 |
| `homework_gen` | AI 练习卷 | 15 分钟 | 一份作业 |
| `homework_levels` | 分层作业 | 15 分钟 | 一次生成基础/提高/挑战三档（人工需分三遍做，此处保守只按 1 份计） |
| `interactive_quiz_gen` | 课堂互动题 | 15 分钟 | 一组互动题 |
| `classweekly_gen` | 班级周报 | 15 分钟 | 班主任整理一周零散记录成稿 |
| `unit_paper` | 单元测评卷 | 20 分钟 | 含覆盖面设计的完整卷 |
| `grade_upload` | 拍照批改 | 2 分钟 | 一次拍照批改（按张计费，单张节省有限，故权重低） |
| `ai_copilot` | AI 助教 | 3 分钟 | 一次问答式建议 |
| **其余全部** | — | **5 分钟** | 兜底保守值：评语、话术、反思、变式题等轻量产出 |

### 2.2 计算规则

```
savedMinutes = Σ 当月每条 usage 记录的 dashSavedMin(kind)
```

- **只统计当月** `usage-YYYY-MM.jsonl` 中本组织成员（驾驶舱）/ 当前用户（个人报告）的记录
- **前端零加权**：服务端下发 `savedMinutes` + `savedNote`，`schoolDash.ts` 只做 `savedHoursText()` 的人话换算
- **展示口径脚注**：`SchoolDashPanel.vue` 的 `.sd-note` 强制展示 `data.savedNote`；月报文本末尾同样带说明

### 2.3 内部调用排除规则（2026-11-12 新增）

`DASH_INTERNAL_KINDS` 白名单内的 kind **不计入**使用次数、按 kind 分布、8 周趋势、减负估算：

| kind | 排除原因 |
|------|----------|
| `quality_check` | AI 输出质量保障层的自动质检调用，教师无感知、不是一次独立教学工作；计入会虚增实证数据 |

> 新增任何"系统自动触发、教师不主动发起"的 AI 调用，必须同步加入此白名单。

---

## 三、口径展示的强制约束

1. **任何展示减负时长的位置必须带口径说明**：
   - 校长驾驶舱：卡片标题「估算节省机械工作时间 *」+ 底部 `* {{ savedNote }}`
   - 教师个人报告：KPI 卡「估算节省机械工作时间」+ 表格下 `savedNote` 小字
   - 月报文本：`说明：节省时长为估算（…）；所有 AI 产物均由教师审核后使用。`
2. **话术禁用词**：不得写"提分""提高成绩""保证节省 X 小时"；统一用"估算节省机械工作时间""仅供汇报参考"
3. **AI 产物口径**：所有对外文本必须保留"AI 生成、教师审核"表述，不暗示 AI 替代教师决策

---

## 四、L2 调研数据积累方案（运营驱动）

试点评估包已提供可复用的问卷模板，按以下路径把 L2 证据链跑起来：

| 步骤 | 动作 | 产出 |
|------|------|------|
| 1 | 试点前发《基线问卷》 | 备课/批改/出题的原始耗时基准 |
| 2 | 试点第 4 周发《终期问卷》 | 教师自报每周节省时长（分档）、NPS、满意度 |
| 3 | 汇总样本量 n、分档占比、均值 | "XX% 教师认为每周节省 ≥1 小时（n=__）"式话术 |
| 4 | 标注方法论注脚 | 发放时间、样本量、是否第三方执行——对标 Diffit 的规范做法 |

**纪律**：
- 教师自报数据必须标注"教师自述"，不可与 L1 估算混为一谈
- 样本量 n < 30 时只作内部参考，不对外引用
- 引用前把方法论注脚一并给出，不掐头去尾只报好看的百分比

---

## 五、L3 成果证据（中期，需种子校）

- 寻找 1-2 所种子校做"使用前后备课时长 / 区统考成绩"对照案例
- 对标 Curipod 把成绩单放定价页顶部、Khanmigo 独立 RCT 的做法
- **中国场景合规**：只陈述可核验的校内对照事实，不作"提分"因果承诺；成绩数据使用需学校书面授权与脱敏

---

## 六、代码索引

| 内容 | 位置 |
|------|------|
| 权重表 `DASH_SAVED_RULES` | `server/server.js`「减负估算权重表」块 |
| 口径文案 `SAVED_NOTE` | 同上 |
| 内部调用白名单 `DASH_INTERNAL_KINDS` | 同上 |
| 校长驾驶舱聚合 | `server/server.js` `/api/org/dashboard` |
| 教师个人报告聚合 | `server/server.js` `/api/user/my-usage` |
| 前端人话换算 / 月报 | `src/utils/schoolDash.ts` |
| 看板口径脚注展示 | `src/views/Editor/SchoolDashPanel.vue` |
| 中文名映射 | `src/utils/schoolDash.ts` `DASH_KIND_LABEL` |
| 问卷模板 | `doc/试点评估包/基线问卷模板.md`、`终期问卷模板.md` |

---

*本说明随权重调整与调研数据积累持续更新。改动权重表时必须同步更新本文件与 `SAVED_NOTE`。*