# 工单 XY-014 · 录入端 v3.0「河流版」：把楼拆成河

- 时间：2026-11-14 06:05（北京时间）
- 责任人：小心同学（总协调）
- 状态：**已上线可用**（同一链接，路径不变）
- 上一版：XY-013 / v2.0 卡片流（抽屉墙 + 二级卡片流 + 返回键）

## 一、古老师原话（这次的产品判断源头）

> 「一个点击一个，录完又要点左上角返回抽屉，你觉得这个路径会不会…我觉得很难受。
> 我觉得这个首页每一个，它就应该是 9:16 个手机尺寸。点击下一页都是可以滑动的，那为什么首页不能够滑动关联呢？跟二级菜单。」

判断成立，而且比原话更严重：不是"首页能不能滑"，是**「楼」这个模型错了**——首页做的是"选择"（15 选 1），二级做的是"前进"（连续推进）。用网格做选择没错，错的是把"选择"放到了主路径上。

## 二、V3.0 改了什么（结构级，不是皮肤）

| 项 | v2.0 | v3.0 |
|---|---|---|
| 首页 | 15 格抽屉墙（需滚动，看不全） | **取消**。打开就是第一道没录的题 |
| 层级 | 楼：首页 → 抽屉 → 题 | **河**：一条 55 卡的纵向流，章节变路标 |
| 返回 | 左上角「‹ 抽屉墙」 | **删掉**。无返回，只有前进 |
| 手势 | 二级横滑翻题，一级点击 | 纵向滑＝前进（主）；横滑＝跳章（辅） |
| 抽屉 | 15 个可点目标 | 15 张薄过渡卡（34vh），滑过即过，1.5s 自动继续 |
| 录完 | 弹一句「回抽屉墙看下一个」 | **字段齐了自动保存 + 自动前进** |
| 露头 | 无 | 卡片下方露下一张 10px 白边（可滑的唯一暗示） |
| 锚点 | 全局 12/55 | 3px 顶进度条 + 章节 pill + 卡右下「还剩 N 句·约 M 分钟」 |

## 三、人体工学的账

旧版：录音条 y≈780pt，返回键 (20,100)。单程 750pt，往返 1500pt × 15 个抽屉 = 22500pt ≈ **4.1 米**纯拇指位移，还不含"这次进哪个"的认知停顿。v3.0 归零。

## 四、修掉的三个真 bug

1. **`pointerleave` 误中断**：球只有 54pt 高，拇指轻微偏移就断录音 → 改为 `setPointerCapture` + 只在 pointerup/cancel 结束
2. **手势区被底部条吃掉**：滑动手势挂在卡片区，但录音条 fixed 覆盖下三分之一 → 改为挂全屏滚动容器，仅排除按钮
3. **索引表漏 kind 字段**：章节卡没进索引 → 当前卡判定失败、保存后不前进、录音接不上（这是本轮最难查的一个）

## 五、真机尺寸验证（393×852，iPhone 14 Pro）

无头 Chromium 逐项实测，不是看 DOM：

| 检查项 | 结果 |
|---|---|
| 55 张题卡 + 15 张章节卡全部渲染 | ✅ |
| 打开自动落到第一道未录题（1-4） | ✅ |
| 章节卡停 1.5s 自动滑到本章第一题 | ✅ |
| 顶部 pill → 导航带 → 跳 05 章 | ✅ |
| 打字保存 → 自动前进到下一题 | ✅（5-2 → 5-3） |
| 录音：转写 → 字段 → 缺项 → 自动保存 → 前进 | ✅（假接口跑通全链路） |
| 最长题卡（4-4）展开态不溢出、页脚贴底 | ✅ 734/734 |
| 露头 10px、卡高 734（safe-area 0 时） | ✅ |
| JS 错误 | 0 |

## 六、数据迁移

`localStorage` KEY 仍是 `xz_kz_answers_v2`，**已录的 12 项和语音记录一条不丢，不用重录**。

## 七、入口（链接不变）

- 录入端：https://a62221698cdc8bd9d.app.workbuddy.host/lu/?sharecode=C74CULHVDI
- 合成器：https://a62221698cdc8bd9d.app.workbuddy.host/?sharecode=C74CULHVDI

## 八、待观察 / 下一版

1. 真机（微信内置浏览器）的 scroll-snap 手感：若出现"卡一跳"，降级方案＝关 snap + 手动吸附
2. 15 章顺序仍是系统模块序（01 概览 → 15 配置），未按"人说话的顺序"重排——等古老师一句话
3. v3.1 储备（古老师已说"看完 3.0 再说"）：常开麦 + VAD 断句，手不用抬

## 九、修订 v3.0.1 · 录音按钮微信化（2026-11-14 16:50）

古老师首次真机打开 demo 的第一条反馈：

> 「我想像微信语音聊天那种体验——摁住的时候机器在记录我的声音、识别我的意图，松开大拇指就发送，发送完之后按钮颜色会变成绿色，这样我就知道它发送完了，心里有安全感。」

判断成立：旧球的状态机缺了"发送成功"的绿色确认信号（按住→红→松手→灰"识别中"→又变回棕色），松手后用户心里没底。

改后的完整状态机：

| 阶段 | 球的样子 | 心理 |
|---|---|---|
| 按住 | 🔴 红 + 呼吸脉冲 | 在录了 |
| 松手 | ⏳ 灰「发送中…」 | 发出去了 |
| 发送完成 | ✅ **绿「已发送 · 下一题」** | 收到了，安心 |
| 有缺项 | ✅ 绿「已发送 · 还差 N 项」→ 2.2s 复位 | 收到了，但要补 |
| 翻到下一题 | 自动复位「按住说话」 | 继续 |

顺带修掉一个隐蔽 bug：`recBusy` 在录音结束后从未复位，导致"识别完不自动前进 + 横滑失灵"。已改为发送完成时统一 `ballUnlock()` 解锁。

验证（393×852 无头实测）：发送前 idle → 发送后 `ball.sent` 绿「已发送·下一题」→ 翻页 g4→g5 → 复位 idle；缺项场景绿「已发送·还差 1 项」→ 2.2s 复位；JS 错误 0。已发布，链接不变。

—— 小心同学 · 心源AI资产项目责任有限公司
