# 交互载体演示素材库 · 讲师手册

配套「AI 在企业落地的线下培训」第二部分：**对 HTML 的全新认识**（P1 视野页 / P2 阶梯页 / P3 对比页 / P4 收口页）。

---

## 一、怎么打开

解压后**双击 `index.html`** 即可，全部功能离线可用。

- 零 CDN、零外部字体、零 JS 库，图表全部手写 SVG
- 数据走 `<script src="data/hydata.js">` 引入，**不是 fetch**——所以 `file://` 直接双击能跑
- 建议课前在**会议室那台机器**上双击打开一次，确认字体与投影分辨率无碍

## 二、数据是什么

「恒元智造」是一家**虚构**的智能装备企业，2025 年度经营数据由脚本生成：

| 项 | 值 |
|---|---|
| 经营明细 | 1,728 行（12 月 × 18 城 × 8 产品线） |
| 打印成表格文件 | **116 页**（P2 顶部横幅的好论据） |
| 年销售额 | 59,646.1 万元（同比 +24.7%） |
| 综合毛利率 | 31.0%（去年 31.25%，基本持平） |
| 客户 / 重点订单 | 267 家 / 87 笔 |

复现或改数据：`python3 build_data.py` → `python3 export_data_js.py` → `python3 build_l1_excel.py`。
随机种子固定（20250913），重跑结果一致。**改完记得重跑 export，否则页面里还是旧数。**

## 三、P1 演示动线（约 3 分钟）

打开 `index.html`，从上往下讲：

1. 顶部副标题先说清一件事：**多媒体是底层能力，不是第七种形态**，所以六格里没有它。
2. 六格按「看 查 审 算 办 聊」六个动词念一遍，**不要逐格点开**（会失控）。
3. 只点开两格：
   - **「审」`demos/review.html`** —— 零风险，纯静态内容 + 交互。演示动线：
     悬停右侧任意意见卡 → 左栏条款自动高亮 → 点「采纳建议」→ 条款文字被替换成分段付款的安全改法、顶部风险计数从"高 3"变"高 2"。
     口播要点：*"左边原文右边意见，鼠标划过就能对上，我点一下就替换——这比 30 页批注版 Word 有用得多。"*
   - **「聊」`demos/ask.html`** —— 爆点，放最后。见下。
4. 其余四格口头带过，告诉学员"课后这套都会发给你们，自己点"。

## 四、P2 五级阶梯演示动线（约 6 分钟，本段高潮）

同一份数据，五级逐级放大：

| 级 | 打开 | 演示动作 | 一句话 |
|---|---|---|---|
| 1 | `shots/L1_summary-001.png` | 指着那张 Excel 截图 | 看红字那行——"请华南大区说明原因"。**Excel 的终点是把问题甩回给人。** |
| 2 | `demos/report.html` | 往下滚 | 结论和图文自动排好，关键数字自己跳出来。 |
| 3 | `demos/drill.html` | 点黄色异常条 → 一路点到订单 | 四层下钻，见下。 |
| 4 | `demos/calc.html` | 把折扣滑杆从 10.4% 拖到 9% | 毛利率实时从 33.1% 变到 34.1%，结论条自动弹出钩子 B。 |
| 5 | `demos/ask.html` | 点第一个预设问题 | 见下。 |

### 第 3 级下钻的固定动线（已实测可走通）

`全国 → 点异常条 → 华南 → 深圳 → 深圳锐驰科技有限公司 → 订单 HY25-07088`

最后一步屏幕上会直接出现那笔 **4 台 AGV-M3 / 156.2 万元 / 延期至 2025-08** 的订单。
口播：*"我刚才什么筛选都没做，系统自己扫出来的。"*

### 第 5 级「聊」的三个预设问题

1. **"7 月华南为什么掉了？"** ← 主讲这个
   四个步骤逐个打勾 → 流式回答 → 右侧华南逐月图（7 月红柱标 -11.4%）→ 原始凭证卡显示那笔延期单 → 三个动作按钮。
   口播爆点：*"如果只看那张表，结论很可能是'华南大区出了问题'——**这个结论是错的**。同比还有 +8.6%，缺口 156.2 万恰好等于 4 台延期单。剔除后 7 月回到 +1.8%，8 月的冲高也会从 +24.8% 塌回 +8.6%。两个异常，同一个原因。"*
2. **"EM-9 的毛利为什么一直在降？"** —— 折扣率从 8.0% 放到 19.0%，毛利率 34.8%→25.9% 连降 4 个月。
3. **"帮我查查有没有重复报价"** —— 苏州澜石精密被直销/经销各报一次，差 11.4 万。**建议留作悬念**，只说"它还查出一起跨渠道重复报价，课后你们自己点"，现场不演，效果更长。

自由输入框是**真兜底**：问一个数据里没有的（比如"下季度回款"），它会明确回答"当前数据里没有这个口径"，右侧面板切到「边界」视图列出缺什么。
这一下比吹十句能力都有用——**AI 知道自己不知道什么**。

## 五、必须防的翻车点

| 风险 | 应对 |
|---|---|
| 有人问"这是真的 AI 还是录屏" | 「聊」页是**预置回放**（不接模型，零延迟零风险）。后手：当场切千问办公，把同一个问题原样问一遍真跑一次。**课前务必真跑通一次并存成钉钉文档兜底。** |
| 会议室断网 / 内网拦外链 | 整套零外链，双击即开。别临时改成在线版。 |
| 投影分辨率下字太小 | `drill.html` 和 `review.html` 信息密度最高，建议讲到这两页时把浏览器缩放到 110%。 |
| 有人追问数据真实性 | 大方承认是虚构演示数据，并说明"随机种子固定、脚本可复现、每个数都能从明细算回来"——**这是严谨，不是造假**。 |

## 六、页面清单

```
index.html              P1 门户：六格形态 + 五级阶梯入口
demos/report.html       看 · 报告载体（一屏到底年度回顾）
demos/drill.html        查 · 看板载体（四层下钻 + 异常自扫）
demos/review.html       审 · 评审载体（合同左右对照 + 一键采纳）
demos/calc.html         算 · 推演载体（折扣滑杆实时重算）
demos/wizard.html       办 · 流程载体（经销商准入四步向导）
demos/ask.html          聊 · 智能体载体（过程可视化 + 流式 + 一键采纳）
shots/L1_summary-001.png  L1 真 Excel 截图（另含明细页、116 页 PDF）
data/hydata.js          全量数据（含三个钩子的校验值）
SHARED_SPEC.md          数据契约，改页面必读
build_data.py 等         数据生成与导出脚本
```

## 七、数据口径备注（防较真）

- 三个钩子的数值由 `build_data.py` 生成时**程序校验**，见 `校验报告.json`：
  - 钩子 A：延期单金额 156.24 万 **恰好等于** 缺口 156.2 万（不是"约等于"）
  - 钩子 B：EM-9 毛利率 3→7 月 `[34.8, 32.6, 30.6, 28.6, 25.9]` 严格连降
  - 钩子 C：两笔订单价差 `78.6 - 67.2 = 11.4` 万
- `drill.html` 的异常检测用 **leave-one-out 横截面偏离**（同大区对比其他大区均值），
  所以春节效应（2 月普跌、3 月普涨，各大区同向）不会被误报成异常。
  它选出的是"华南 7 月塌、8 月冲"这一对反向离群——比单看环比大小更合理。
- 金额单位统一「万元」，过亿换算成「亿元」保留 2 位小数。

---

## 八、PPT 交付（已精简为一页）

`第二部分-对HTML的全新认识_v1.pptx` —— 千问办公绿模板，16:9，**1 页**，全部真实文本框（未整页转图，可在 PowerPoint 里直接改字）。

**页内结构**：标题「为什么要用 HTML 格式交付」→ 副题一句 → 四张理由卡（① AI 写得动 ② 表达没有上限 ③ 从「读」变成「用」④ 交付之后还活着）→ 六种形态胶囊条（看查审算办聊）→ 底部金句条。

**为什么只留一页**：原设计四页（六格形态 / 五级阶梯 / 五维对比 / 回去改三件事）。实际讲课场景里，"为什么要换"这一个认知点讲透就够，其余信息用 demo 真页面现场讲比静态 PPT 有说服力得多。四页版代码保留在 `build_ppt_4pages_backup.py`，需要时改回 `build_ppt.py` 即可复用。

**这一页不放任何超链接**（已实测的结论）：Mac PowerPoint 会拦本地 `file://` 链接并提示"无法打开"；给文字挂链接还会让整页字色被主题超链接蓝覆盖。演示切换由讲师自己切窗口。

**改文案**：只改 `build_ppt.py` 里的 `WHY` 与 `FORM6` 两个列表，重跑 `python3 build_ppt.py`。

## 九、现场演示怎么切到 demo（推荐路径）

**结论：不要依赖 PPT 内超链接。** 实测 Mac PowerPoint 对 `file://` 本地链接会报"无法打开这个链接"（macOS 版 PowerPoint 有沙盒，禁止打开未授权目录的本地文件），继续投入不划算。

改用**门户作为演示入口**，浏览器里点链接 100% 可靠：

### 课前（2 分钟）

1. 双击 `index.html` 打开门户 —— 它本身就是 P1 那页的内容，六格 + 五级阶梯都在
2. 把六个 demo 各点一个标签页（门户里的格子已设为**新标签打开**）
3. 浏览器窗口拖到副屏，或准备好 `Cmd+Tab` 切换

### 放映时

| 讲到 | 动作 |
|---|---|
| P1 六格 | 讲完一页，`Cmd+Tab` 切到门户，**点对应格子**现场打开该 demo（比 PPT 截图有说服力得多） |
| P2 五级 | 切到门户，从下往上点五级阶梯：L1 看 Excel 截图 → L2 滚动报告 → L3 点异常条下钻 → L4 拖折扣滑杆 → L5 点"7 月华南为什么掉了" |
| P3 / P4 | 纯讲，不切 |

`Cmd+Tab`（macOS）/ `Alt+Tab`（Windows）切回来即可，全程不用等 PowerPoint 反应。

### PPT 里还留着链接吗

留着，但**只挂形状级、不显示任何按钮**（版面已恢复干净）。放映模式下点格子**在 Windows PowerPoint 上大概率能跳**，在 Mac 上会被沙盒拦。所以：
- 在 Windows 会议室机器演示 → 可以先试试直接点 PPT 格子，能用就更顺
- 在 Mac 上 → 走上面的门户路径

如果确实需要"PPT 里点一下就跳"且要跨机器稳定，唯一可靠做法是把 demo 发布成 `https://` 链接（网络 URL 不受 PowerPoint 沙盒限制）。需要的话告诉我，我用 qw-pages 发布并把链接换成 https。

