--- /dev/null
+# AI吊坠(双按键+三色指示灯)交互规范 — 新旧变更说明
+
+> **对比范围**
+> - 旧版:[交互规范.md](./AI吊坠(双按键+三色指示灯)交互规范.md)
+> - 新版:[交互规范_new.md](./AI吊坠(双按键+三色指示灯)交互规范_new.md)
+>
+> **说明**:下列仅列**产品行为 / 规则**差异。新增 REQ-ID 编号、LED `period_ms` 术语表、详设链接、实现状态摘要等**文档结构**不计入变更。
+
+---
+
+## 1. 基础约定
+
+| 变更 | 旧版 | 新版 |
+|------|------|------|
+| 按键分工 | 短按/双击均可用于唤醒、打断、**复读** | 短按 = 唤醒/打断;**仅 Power 双击**切换单/长对话;**取消 AI 双击业务** |
+
+---
+
+## 2. 备注 / 待机
+
+| 变更 | 旧版 | 新版 |
+|------|------|------|
+| 正常待机 | 未单独约定 | 待机**指示灯灭**;约 **2 分钟**无交互进入**休眠**(休眠无灯、无音) |
+| 播放灯 | 备注写「绿灯长亮」 | 统一为 TTS 时**绿灯常亮**(去掉易误解的「绿闪」表述) |
+
+---
+
+## 3. Power 键
+
+| 变更 | 旧版 | 新版 |
+|------|------|------|
+| 长按 8s 强关 | **红快闪 3 次** + **三声短滴** 后关机 | **无灯、无提示音**,直接关机 |
+| 待机短按 | **无操作**(灯、音均无变化) | **进入休眠模式** |
+| AI 交互中短按 | 停对话进待机,灯**保持当前交互状态** | 停对话后进待机,灯**熄灭**(与正常待机灭灯一致) |
+| 双击切模式 | 仅在**待机**下切换单/长对话 | **任意状态**可双击;若正在对话则**先停对话**再设模式并进待机 |
+
+---
+
+## 4. AI 键
+
+| 变更 | 旧版 | 新版 |
+|------|------|------|
+| AI 双击复读 | 可选:TTS 结束后 1 分钟内双击,**复读上一轮 TTS** | **删除**该能力 |
+| 单对话 + TTS 中短按 | 未单独规定 | **仅停播**,灯灭 idle;续聊须**再长按** |
+| 单对话 + 非 TTS 短按 | 未单独规定 | **短按无效**(吞掉);开录只能**长按** |
+| 单对话长按(松开) | 「曾——」约 1 秒长音,进入思考 | 「**层**」+ 蓝绿交替,协议 **`audio.completed`** 结束上行 |
+
+**未变更**:长对话下四条短按(待机 / 聆听 / TTS 播报 / 思考中 → 打断并开麦),新旧行为一致。
+
+---
+
+## 5. 电量 / 充电
+
+**无实质行为变更**(低电 10%~30%、空电 <10%、充电红常亮、充满红→绿等与旧版一致)。
+
+---
+
+## 6. 异常
+
+| 变更 | 旧版 | 新版 |
+|------|------|------|
+| 网络异常 | 固定:蓝绿慢交替 + 「网络异常信号弱」**每 5 秒循环** | **分两种**:信号弱(CSQ)→ 蓝绿慢交替;**连接失败** → 以 **TTS 提示**为主;弱网灯由硬件状态采样 |
+| AI 处理超时 | **先蓝常亮**,再红蓝快闪 2 次,再待机灭灯 | **思考阶段长时间无 TTS**:直接红蓝快闪 2 次,**重启会话**后待机灭灯(**不再要求**超时前先蓝常亮) |
+
+**未变更**:语音识别失败 → 红蓝快闪 2 次 → 待机灭灯,新旧一致。
+
+---
+
+## 7. 补充规范
+
+| 变更 | 旧版 | 新版 |
+|------|------|------|
+| 误触 / 双击 | 已写「AI 无双击」 | 明确 **Power 双击**为唯一模式切换入口(与删除 AI 复读、单对话短按规则一致) |
+
+---
+
+## 8. 变更项汇总(12 条)
+
+| # | 类别 | 变更摘要 |
+|---|------|----------|
+| 1 | 约定 | 取消 AI 双击及「复读」定位 |
+| 2 | 待机 | 待机灭灯 + 约 2 分钟无交互进休眠(休眠无灯无音) |
+| 3 | Power | 8s 强关:红闪+三声 → 无灯无声 |
+| 4 | Power | 待机短按:无操作 → 进休眠 |
+| 5 | Power | 交互中短按停对话:灯保持 → **熄灭** |
+| 6 | Power | 双击切模式:仅待机 → 任意状态且可先停对话 |
+| 7 | AI | 删除双击复读 TTS |
+| 8 | AI | 单对话 TTS 中短按:仅停播 |
+| 9 | AI | 单对话非 TTS 短按:无效,须长按开录 |
+| 10 | AI | 单对话松手:「曾——」→「层」+ audio.completed |
+| 11 | 异常 | 网络异常:单一描述 → CSQ 灯效 vs 断连 TTS |
+| 12 | 异常 | AI 超时:去掉蓝常亮前置,改为思考超时红蓝闪+重启会话 |
+
+---
+
+## 9. 不计入「新旧变更」的说明
+
+| 话题 | 说明 |
+|------|------|
+| **开录专用提示音** | 旧版表内单对话长按为「滴」,**未**要求必须播放 `start.mp3`;备注附件为可选资源。工程 `RECORD_START_TONE_FILE=None` 为产品配置,**不是**相对旧版需求表的变更。 |
+| **收音灯快慢闪** | 长对话聆听 **蓝慢闪**、单对话 **蓝快闪** 旧版表中已有(长对话各行 + 单对话长按行),新版在文首与 REQ-NOTE-02 **显式归纳**,属表述补全,非行为变更。 |
+
+---
+
+## 相关文档
+
+| 文档 | 说明 |
+|------|------|
+| [详设-对照与决策.md](./AI吊坠(双按键+三色指示灯)详设-对照与决策.md) | 需求—设计—实现矩阵;已实现 **IMP**、开放 **GAP** |
+| [交互规范_new.md](./AI吊坠(双按键+三色指示灯)交互规范_new.md) | 当前产品需求正文(准绳) |
| **慢交替/交替慢闪** | 约 **1 s 换一色** | `1000` |
-**工程映射(默认)**:聆听蓝 **慢闪**、低电红 **慢闪**、正常待机 **灭灯**(`LED_IDLE_MODE=off`)→ 聆听/低电 `1000`;思考蓝绿 **交替** → `500`;弱网蓝绿 **慢交替** → `1000`;异常红蓝快闪 → `250`(约 2 次/秒)。正文若写「快闪 / 2 次/秒」等,表示周期短于「闪」,工程可按场景单独设 `period_ms`,与上表不冲突。
+**工程映射(默认)**:低电红 **慢闪**、正常待机 **灭灯**(`LED_IDLE_MODE=off`)→ `1000`;思考蓝绿 **交替** → `500`;弱网蓝绿 **慢交替** → `1000`;异常红蓝快闪 → `250`(约 2 次/秒)。
+
+**收音态 `listening`(按对话模式区分,与代码一致)**:
+
+| 对话模式 | 灯效 | 默认 `period_ms` | 说明 |
+| -------- | ---- | ---------------- | ---- |
+| 长对话 | 蓝 **慢闪**(约 1 次/秒) | `1000` | 短按唤醒/打断后进聆听、VAD 开麦 |
+| 单对话 | 蓝 **快闪**(约 2 次/秒) | `250` | 长按开录至松手前 |
+
+开录阶段**不以专用提示音表示**(`RECORD_START_TONE_FILE=None`);仅用上述灯效区分模式。正文若写「快闪 / 2 次/秒」等,表示周期短于「闪」,工程可按场景单独设 `period_ms`,与上表不冲突。
## 备注
| REQ-ID | 说明 |
| ------ | --- |
| REQ-NOTE-03 | 休眠模式:无灯光,无提示音(最低电量消耗) |
-| REQ-NOTE-02 | 聆听模式:蓝灯闪(1 分钟内无交互,自动进入待机模式) |
+| REQ-NOTE-02 | 聆听/收音:长对话 **蓝慢闪**;单对话 **蓝快闪**(见文首「收音态 listening」) |
| REQ-NOTE-02 | 思考模式:蓝绿交替闪 |
-| REQ-NOTE-02 | 播放模式:绿灯闪 |
+| REQ-NOTE-02 | 播放模式:绿灯常亮(TTS 播报,`ai_state=playing`) |
| REQ-NOTE-01 | 正常待机(part3):指示灯灭;2 分钟无交互进入休眠(REQ-NOTE-03)。旧工程绿灯慢闪可通过 `LED_IDLE_MODE=green_blink` 恢复 |
-è¿\9bå\85¥è\81\86å\90¬æ¨¡å¼\8fï¼\9aå\8d\95声â\80\9cæ»´â\80\9dï¼\88ç\9fä¿\83ï¼\89
+è¿\9bå\85¥è\81\86å\90¬æ¨¡å¼\8fï¼\88é\95¿å¯¹è¯\9dç\9fæ\8c\89å\94¤é\86\92ç\89ï¼\89ï¼\9aå\8f¯ç\94¨ç\9fä¿\83ã\80\8cæ»´ã\80\8dä½\9cæ\93\8dä½\9c确认ï¼\88ä¸\8e**å¼\80å½\95ä¸\93ç\94¨æ\8f\90示é\9f³**æ\97 å\85³ï¼\9bæ\9c¬äº§å\93\81线å¼\80å½\95ä»\85以ç\81¯æ\8f\90示ï¼\8c`RECORD_START_TONE_FILE` å\85³é\97ï¼\89ã\80\82
-[请至钉钉文档查看附件《start.mp3》。](https://alidocs.dingtalk.com/i/nodes/KGZLxjv9VGj15aBlU1wKrXGzW6EDybno?iframeQuery=anchorId%3DX02moo4wrj78r6ita1utoy&utm_scene=person_space)
+附件《start.mp3》为历史/可选资源,**非**强制开录提示音。
接入拾音/进入思考:单声“层”(短促,有尾音)
| REQ-PWR-01 | Power键 长按3秒 | 关机状态 | 绿色灯常亮(持续3秒,同步长按时间),然后熄灭 | 现有设备开机提示音(后续视需求可修改) | 设备开机,进入正常待机状态 |
| REQ-PWR-02 | Power键 长按8秒 | 任何状态(死机/卡死/异常) | 无变化 | 无提示音 | 设备关机,切断所有电源 |
| REQ-PWR-03 | Power键 短按(单击) | 待机状态 | 无指示灯 | 无提示音 | 进入休眠模式 |
-| REQ-PWR-04 | Power键 短按(单击) | AI交互中(聆听/处理/TTS) | 绿色慢闪 | 无提示音 | 停止对话,进入待机模式 |
+| REQ-PWR-04 | Power键 短按(单击) | AI交互中(聆听/处理/TTS) | 指示灯灭(进入 idle,与 REQ-BAT-01 一致) | 无提示音 | 停止对话(`Close`),进入待机模式 |
| REQ-PWR-05 | Power键 短按(双击) | 待机状态(任意状态) | 无变化 | 播报:单对话模式/长对话模式 | 如果对话时停止对话,设置对话模式,进入待机模式, 非对话模式,设置对话模式直接进入待机模式 |
| REQ-AI-04 | AI键 短按1次 | 长对话模式 | 思考中(蓝绿交替闪) | 切换为蓝色慢闪 | 单声“滴”(短促) | 进入语音聆听状态,开始收音(用户可说话) |
| REQ-AI-05 | AI键 短按1次 | 单对话模式 | TTS播报中(绿色常亮) | 灯灭→idle | 无(或极短停播) | **仅停播**,不开录;续聊须再 **长按**(见 [DES-SCN-020.3](AI吊坠(双按键+三色指示灯)详设-场景与协议流程.md)) |
| REQ-AI-06 | AI键 短按1次 | 单对话模式 | 待机/思考/聆听(非TTS播放) | 无变化(短按吞掉) | 无 | 无业务;开录须 **长按**(见 [DES-SCN-020](AI吊坠(双按键+三色指示灯)详设-场景与协议流程.md)) |
-| REQ-AI-07 | AI键 长按(按下) | 单对话模式 | 待机状态/思考状态/播报状态 | 蓝色快闪(频率加快,2次/秒) | 开录提示音(start.mp3) | 进入收音状态;TTS中重开见 [DES-SCN-020.2](AI吊坠(双按键+三色指示灯)详设-场景与协议流程.md) |
+| REQ-AI-07 | AI键 长按(按下) | 单对话模式 | 待机状态/思考状态/播报状态 | 蓝色快闪(约 2 次/秒) | **无开录提示音**(仅以灯表示收音) | 进入收音状态;TTS中重开见 [DES-SCN-020.2](AI吊坠(双按键+三色指示灯)详设-场景与协议流程.md) |
| REQ-AI-08 | AI键 长按(松开) | 单对话模式 | 聆听中(蓝快闪) | 蓝绿交替闪 | “层”(接入拾音/思考提示) | 结束上行,进入思考;协议 `audio.completed`(见 [DES-SCN-020.6](AI吊坠(双按键+三色指示灯)详设-场景与协议流程.md)) |
| REQ-ID | 异常场景 | 指示灯状态 | 提示音 | 处理方式 |
| ------ | ---------------- | ------------------------ | ------------------- | -------------------- |
| REQ-ERR-01 | 语音识别失败(未听清/无法识别) | 红蓝快闪2次(2次/秒)→ 回到待机状态(灯灭) | “滴、滴”(2声短促,与灯光同步) | 用户可再次短按AI键,重新唤醒聆听 |
-| REQ-ERR-02 | 网络异常(无法请求AI) | 蓝绿交替慢闪(1次/2秒),持续闪烁 | “网络异常信号弱”(每5秒1次,循环) | 检查网络连接,恢复网络后自动回到待机状态 |
-| REQ-ERR-03 | AI处理超时 | 蓝色常亮→红蓝快闪2次→回到待机状态(灯灭) | “滴、滴”(2声短促) | 处理失败,用户可重新发起语音请求 |
+| REQ-ERR-02 | 网络异常(无法请求AI) | CSQ 弱时蓝绿慢交替(`signal=weak`);连接失败时以 TTS 提示为主 | “网络异常/信号弱”类提示(`xinhaoruo1` 等,可循环) | 恢复网络后重连;弱网灯由 `AI_hw_status` 采样 |
+| REQ-ERR-03 | AI处理超时(思考阶段无 TTS) | 红蓝快闪 2 次(2次/秒)→ 重启会话后待机灭灯 | “滴、滴”(2声短促,可选) | `thinking_timeout` 触发 `alert` 后 `AI_VC_start`;用户可重新发起语音 |
## 第五部分:补充规范(工程&用户体验)
| 文档 | 用途 |
| --- | --- |
-| **[详设-对照与决策.md](./AI吊坠(双按键+三色指示灯)详设-对照与决策.md)** | 架构、需求-设计-实现矩阵、GAP 双轨决策(**评审入口**) |
+| **[交互规范-新旧变更说明.md](./AI吊坠(双按键+三色指示灯)交互规范-新旧变更说明.md)** | 相对旧版 `交互规范.md` 的**实质行为变更**(不含 REQ-ID 等结构差异) |
+| **[详设-对照与决策.md](./AI吊坠(双按键+三色指示灯)详设-对照与决策.md)** | 矩阵 §3、**已实现 IMP §4**、开放 GAP §5、状态报告 §8(**评审入口**) |
| **[详设-场景与协议流程.md](./AI吊坠(双按键+三色指示灯)详设-场景与协议流程.md)** | 按键/协议步骤、时序图(联调深读) |
-上表 `REQ-*` 编号与详设主文档第 3、4 章一一对应。
\ No newline at end of file
+上表 `REQ-*` 编号与详设主文档第 3、4 章一一对应。
+
+### 实现状态摘要(2026-05-16,需求已按 IMP 决策同步)
+
+| 类别 | 结论 |
+| --- | --- |
+| **AI 按键 / 单长对话** | REQ-AI-01~08 已实现(IMP-001~003) |
+| **电量 / 待机灯** | REQ-BAT-01~05 已实现(IMP-005/007/008);PWR-04 停对话后灭灯(IMP-009) |
+| **灯效措辞** | 播放绿**常亮**、待机**灭灯** 已与需求表对齐(IMP-009/010) |
+| **异常灯** | ASR 空、thinking 超时 `rb_flash_2`(IMP-006);弱网见 REQ-ERR-02 开放项 |
+| **Power 键** | 双击切模式已实现;3s/8s 开关机在电源模块(非 `ai_VC`) |
+| **版本号** | `k8_V1.2_yyyy_MM_dd_HH_mm` + `version_util` frozen + 构建脚本已统一 |
+
+完整矩阵与 **IMP 实现项** 见 **[详设 §3~§4](./AI吊坠(双按键+三色指示灯)详设-对照与决策.md)**。
\ No newline at end of file
| **实现** | `ai_VC.py` 等 | 代码现在怎么做? |\r
\r
\r
-评审流程:**第 3 章矩阵** 标 `状态` → 不一致项查 **第 4 章 GAP** → 在 **决策** 列填 `采纳甲` / `采纳乙` / `搁置` / `改需求` → 再改代码或改需求,避免三方漂移。\r
+评审流程:**第 3 章矩阵** 标 `状态` → 已关闭差异见 **第 4 章 IMP(实现项)** → 仍开放项见 **第 5 章 GAP**。\r
\r
### 0.2 准绳优先级\r
\r
-1. 你已勾选的 GAP **决策**(最高)\r
-2. 需求文档(产品对外承诺)\r
-3. 本文设计规格(工程应然)\r
-4. 当前代码(现状,直至按决策修改)\r
+1. 已关闭的 **IMP 决策**(第 4 章,最高)\r
+2. 需求文档 `交互规范_new.md`(已与 IMP 同步)\r
+3. 本文设计规格 `DES-*`(工程应然)\r
+4. 当前代码(开放 GAP 项除外,以 IMP 为准)\r
\r
### 0.3 要点摘要(评审速览)\r
\r
-- **长对话**:短按打断 TTS / **思考中** → `RequestToSpeak` → `VC_init` → `cancel` → `canceled` → `uplink_start`(见 `DES-SCN-010.2`~`010.4`、`DES-SCN-011`)。 \r
-- **单对话**:长按开录 / 松手 `audio.completed`;TTS 中短按仅停播,续聊须再长按(见 `DES-SCN-020.6`)。 \r
-- **待机灯**:正常待机 **灭灯**(`LED_IDLE_MODE=off`,GAP-005 方案甲)。 \r
-- **电量阈值**:低电 `soc<30%`、空电 `soc<10%`(GAP-007 方案甲)。 \r
-- **异常灯**:`set_led_state.alert=rb_flash_2` 红蓝快闪 2 次后回表(GAP-006 已落实 ASR 空结果、thinking 超时)。\r
+- **长对话**:短按打断 TTS / **思考中** → `RequestToSpeak` → `VC_init` → `cancel` → `canceled` → `uplink_start`(**IMP-001**,见 `DES-SCN-010.2`~`010.4`)。 \r
+- **单对话**:长按开录 / 松手 `audio.completed`;TTS 中短按仅停播(**IMP-003**,见 `DES-SCN-020.6`)。 \r
+- **待机 / 停对话灯**:正常待机与 Power 短按结束对话均为 **灭灯**(**IMP-005/009**)。 \r
+- **播放灯**:TTS 阶段 **绿常亮**(**IMP-010**)。 \r
+- **电量阈值**:低电 `soc<30%`、空电 `soc<10%`(**IMP-007**)。 \r
+- **异常灯**:`alert=rb_flash_2`(**IMP-006**:ASR 空、thinking 超时)。\r
\r
---\r
\r
| DES-L1-02 | 单对话:AI **长按** 开录、**松开** `audio.completed` | `ptt_begin`、`_ai_key_release_handle_ptt` |\r
| DES-L1-03 | 单对话:TTS 中 **短按** 仅停播,不开录 | `_ai_key_press_ptt_mode` |\r
| DES-L1-04 | Power **双击** 切换 `VC_mode` 并 TTS 播报 | `pwk_key_double_press` |\r
-| DES-L1-05 | Power 交互中 **短按** `Close` 断会话进待机 | `pwk_key_press` 等 |\r
+| DES-L1-05 | Power 交互中 **短按** `Close` 断会话进待机(灯灭) | `_handle_pwk_short_release`→`Close`→`idle` |\r
\r
\r
### 2.2 L2 会话与协议(`DES-L2`)\r
## 3. 需求 — 设计 — 实现对照矩阵\r
\r
\r
-| REQ-ID | 需求摘要 | 设计规格 | 实现锚点 | 状态 | GAP-ID |\r
+| REQ-ID | 需求摘要 | 设计规格 | 实现锚点 | 状态 | IMP-ID |\r
| ----------- | ------------------------- | ----------------------- | ---------------------------- | ----- | ------- |\r
| REQ-PWR-01 | 关机时长按 Power 3s 开机,绿灯常亮 3s | (电源模块) | 电源键 / `ui` | 需求未定义 | — |\r
| REQ-PWR-02 | 死机长按 8s 强制关机,无灯无音 | (电源模块) | 电源键 | 需求未定义 | — |\r
| REQ-PWR-03 | 待机短按 Power 进休眠,无灯 | DES-L1-05 | `pm.autosleep` 等 | 部分一致 | — |\r
-| REQ-PWR-04 | AI 交äº\92ä¸ç\9fæ\8c\89 Power å\81\9c对è¯\9dè¿\9bå¾\85æ\9cºï¼\8c绿æ\85¢é\97ª | DES-L1-05 | `Close` | é\83¨å\88\86ä¸\80è\87´ | â\80\94 |\r
+| REQ-PWR-04 | AI 交äº\92ä¸ç\9fæ\8c\89 Power å\81\9c对è¯\9dè¿\9bå¾\85æ\9cºï¼\8cç\81¯ç\81 | DES-L1-05 | `Close`â\86\92`ai_state=idle` | ä¸\80è\87´ | IMP-009 |\r
| REQ-PWR-05 | Power 双击切换单/长对话并播报 | DES-L1-04 | `pwk_key_double_press` | 一致 | — |\r
-| REQ-AI-01 | 长对话待机短按:蓝慢闪+滴,开麦 | DES-L1-01、DES-SCN-010.5 | `_ai_key_press_long_dialogue_wake`→`AI_VC_start` | 一致 | GAP-002 |\r
+| REQ-AI-01 | 长对话待机短按:蓝慢闪+滴,开麦 | DES-L1-01、DES-SCN-010.5 | `_ai_key_press_long_dialogue_wake`→`AI_VC_start` | 一致 | IMP-002 |\r
| REQ-AI-02 | 长对话聆听中短按:重开麦 | DES-SCN-010.3 | `request_uplink_start` | 一致 | — |\r
| REQ-AI-03 | 长对话 TTS 中短按:打断并聆听 | DES-SCN-010.2 | `_ai_key_press_long_dialogue_interrupt` | 一致 | — |\r
-| REQ-AI-04 | 长对话思考中短按:打断并聆听 | DES-SCN-010.4 | `_ai_key_press_long_dialogue_interrupt` | 一致 | GAP-001 |\r
+| REQ-AI-04 | 长对话思考中短按:打断并聆听 | DES-SCN-010.4 | `_ai_key_press_long_dialogue_interrupt` | 一致 | IMP-001 |\r
| REQ-AI-05 | 单对话 TTS 中短按:仅停播 | DES-L1-03、DES-SCN-020.3 | `_ai_key_press_ptt_mode` | 一致 | — |\r
-| REQ-AI-06 | 单对话非 TTS 短按:无操作 | DES-L1-03 | `return True` 吞掉 | 一致 | GAP-003 |\r
+| REQ-AI-06 | 单对话非 TTS 短按:无操作 | DES-L1-03 | `return True` 吞掉 | 一致 | IMP-003 |\r
| REQ-AI-07 | 单对话长按:蓝快闪+开录音 | DES-L1-02、DES-SCN-020.2 | `ptt_begin` | 一致 | — |\r
| REQ-AI-08 | 单对话松手:思考灯+层音+completed | DES-L1-02 | `AI_client_VC_end_speech` | 一致 | — |\r
-| REQ-BAT-01 | 正常待机灯灭 | DES-L3-01 默认 | `_set_off`(`LED_IDLE_MODE=off`) | 一致 | GAP-005 |\r
-| REQ-BAT-02 | 低电 10%~30% 红慢闪+双滴 | DES-L3-02 | `battery=low`(SoC<30%) | 一致 | GAP-007 |\r
-| REQ-BAT-03 | 电量<10% 红快闪 3 次后关机 | DES-L3-02 | `battery=empty`(SoC<10%) | 一致 | GAP-007 |\r
-| REQ-BAT-04 | 充电中红常亮+滴 | DES-L3-02 | `charging=charging` | 一致 | GAP-008 |\r
+| REQ-BAT-01 | 正常待机灯灭 | DES-L3-01 默认 | `_set_off`(`LED_IDLE_MODE=off`) | 一致 | IMP-005 |\r
+| REQ-BAT-02 | 低电 10%~30% 红慢闪+双滴 | DES-L3-02 | `battery=low`(SoC<30%) | 一致 | IMP-007 |\r
+| REQ-BAT-03 | 电量<10% 红快闪 3 次后关机 | DES-L3-02 | `battery=empty`(SoC<10%) | 一致 | IMP-007 |\r
+| REQ-BAT-04 | 充电中红常亮+滴 | DES-L3-02 | `charging=charging` | 一致 | IMP-008 |\r
| REQ-BAT-05 | 充满红→绿常亮+长滴 | DES-L3-02 | `charging=full` | 一致 | — |\r
-| REQ-ERR-01 | ASR 失败:红蓝快闪 2 次→待机灭 | DES-L3 P0 `alert` | `_vc_led_alert_rb_flash`(asr 空) | 一致 | GAP-006 |\r
-| REQ-ERR-02 | 网络异常:蓝绿慢交替+语音循环 | DES-L3-02 B4 | `websocket_error`、`bg_alt` | 部分一致 | GAP-006 |\r
-| REQ-ERR-03 | AI 超时:蓝常亮→红蓝闪→灭 | DES-L3 P0 `alert` | `thinking_timeout`→`alert` | 部分一致 | GAP-006 |\r
-| REQ-NOTE-01 | 备注:会话空闲后进入休眠前灯态 | DES-L3 默认灭灯;可选绿闪 | `LED_IDLE_MODE` | 已对齐 part3 | GAP-005 |\r
-| REQ-NOTE-02 | 备注:聆听蓝闪、思考交替、播放绿闪 | DES-L3-01 P2/P3/P1 | `set_led_state` | 部分一致 | — |\r
+| REQ-ERR-01 | ASR 失败:红蓝快闪 2 次→待机灭 | DES-L3 P0 `alert` | `_vc_led_alert_rb_flash`(asr 空) | 一致 | IMP-006 |\r
+| REQ-ERR-02 | 网络异常:弱网慢交替+语音提示 | DES-L3-02 B4 | `AI_hw_status`/`websocket_error` | 部分一致 | GAP-011 |\r
+| REQ-ERR-03 | 思考超时:红蓝闪→重启/待机灭 | DES-L3 P0 `alert` | `thinking_timeout`→`alert`+`AI_VC_start` | 一致 | IMP-006 |\r
+| REQ-NOTE-01 | 备注:会话空闲后进入休眠前灯态 | DES-L3 默认灭灯;可选绿闪 | `LED_IDLE_MODE` | 一致 | IMP-005 |\r
+| REQ-NOTE-02 | 备注:聆听蓝闪、思考交替、播放绿常亮 | DES-L3-01 P2/P3/P1 | `set_led_state` | 一致 | IMP-010 |\r
| REQ-NOTE-03 | 休眠无灯光 | (休眠策略) | `ui.py` / `pm` | 部分一致 | — |\r
-| REQ-SUP-01 | 充电中 AI 交互优先 AI 灯 | DES-L3-01 | `_apply_by_table` | 一致 | GAP-008 |\r
+| REQ-SUP-01 | 充电中 AI 交互优先 AI 灯 | DES-L3-01 | `_apply_by_table` | 一致 | IMP-008 |\r
| REQ-SUP-02 | 按键后灯音延迟≤100ms | DES-SCN-003 | `VC_init` 优先 | 一致 | — |\r
\r
\r
---\r
\r
-## 4. å·®å¼\82ç\99»è®°ç°¿ï¼\88GAP)\r
+## 4. å·²å®\9eç\8e°å\86³ç\96项ï¼\88IMP)\r
\r
-> **决策**列请产品/固件填写:`采纳甲` | `采纳乙` | `搁置` | `改需求`\r
+> 原 **GAP-001~010** 均已决策并关闭;需求文档 `交互规范_new.md` 已按下列决策同步(2026-05-16)。\r
\r
\r
-| GAP-ID | 需求 | 设计目标 | 实现现状 | 风险 | 方案甲:架构精简·安全·实用 | 方案乙:改动最小 | 决策 | 影响面 |\r
-| ------- | --------------------- | ------------------ | ---------------------------------------------- | --------- | ----------------------------------------------- | -------------------------------------- | -------------------------------- | -------------------------------------- |\r
-| GAP-001 | REQ-AI-04 | 思考中短按统一打断并开麦 | 仅 TTS 忙走 `cancel`;纯 `Thinking` 可能 `Deny START` | 用户按了没反应 | `turn==Thinking` 走 `RequestToSpeak`→`cancel`→开麦 | 详设标注限制;或单行门控热修 | **采纳甲**(已改代码) | `AI_key_press`、`_ai_key_press_long_dialogue_interrupt` |\r
-| GAP-002 | REQ-AI-01 | 待机短按直达唤醒 | 兜底 `Close`+`AI_VC_start`+`sleep(500)` | 唤醒慢/偶发断链感 | 去掉兜底 `Close`;未连接单一路径 `AI_VC_start` | 保留现状,联调看 `[KEY]` | **采纳甲**(已改代码) | `AI_key_press`、`_ai_key_press_long_dialogue_wake` |\r
-| GAP-003 | REQ-AI-06 | 单对话非 TTS 短按无操作 | 非播放态 `return True` 吞掉 | 低(防误触) | 保持为设计,REQ 已对齐 | 若需短按开录:改 `_ai_key_press_ptt_mode`+改需求表 | **采纳甲** | `_ai_key_press_ptt_mode` |\r
-| GAP-005 | REQ-BAT-01 vs NOTE-01 | part3 灯灭 vs 备注绿灯慢闪 | idle 默认 `green_blink` | 产品表述冲突 | `AI_led` idle 灭灯 | **改需求** part3 为绿灯慢闪 | **采纳甲**(`LED_IDLE_MODE=off`) | `AI_led._apply_by_table` |\r
-| GAP-006 | REQ-ERR-01~03 | 红蓝快闪等专用灯序 | 无 `alert` 模式;TTS/弱网替代 | 异常辨识度弱 | 新增 `alert` 键+优先级+业务触发 | 需求降级为语音+弱网灯;接受现状 | **采纳甲**(ASR 空、thinking 超时已接 alert) | `AI_led`、`ai_VC` 异常分支 |\r
-| GAP-007 | REQ-BAT-02~03 | 10%/30% 阈值 | SoC 5%/20% 工程档 | 提醒时机偏差 | `AI_hw_status` 阈值可配置并对齐需求 | 需求脚注「以 OCV/工程档为准」 | **采纳甲**(30%/10%) | `default_config`、`AI_hw_status` |\r
-| GAP-008 | REQ-BAT-04、SUP-01 | 充电红常亮 vs AI 覆盖 | AI 非 idle 盖住充电灯 | 充电中不易见红常亮 | 保持 AI 优先(交互反馈优先) | 充电中插入充电指示(需产品确认) | **采纳甲** | `AI_led` 优先级 |\r
+| IMP-ID | 原 GAP | 决策摘要 | 关联 REQ | 落地说明 / 实现锚点 |\r
+| ------- | ------ | ---- | ------ | ------------- |\r
+| IMP-001 | GAP-001 | 采纳甲 | REQ-AI-04 | `turn==Thinking` 走 `_ai_key_press_long_dialogue_interrupt`→`RequestToSpeak`→`cancel`→开麦 |\r
+| IMP-002 | GAP-002 | 采纳甲 | REQ-AI-01 | `_ai_key_press_long_dialogue_wake` 直接 `AI_VC_start`,去掉 `Close`+`sleep` 兜底 |\r
+| IMP-003 | GAP-003 | 采纳甲 | REQ-AI-06 | 单对话非 TTS 短按 `return True` 吞掉;需求表已写明 |\r
+| IMP-005 | GAP-005 | 采纳甲 | REQ-BAT-01、NOTE-01 | `LED_IDLE_MODE=off`,待机灭灯 |\r
+| IMP-006 | GAP-006 | 采纳甲 + 改需求 | REQ-ERR-01、ERR-03 | `alert=rb_flash_2`;ASR 空、thinking 超时;ERR-03 不再要求「蓝常亮前置」 |\r
+| IMP-007 | GAP-007 | 采纳甲 | REQ-BAT-02、03 | `BATTERY_LOW_SOC_PERCENT=30`、`EMPTY=10` |\r
+| IMP-008 | GAP-008 | 采纳甲 | REQ-BAT-04、SUP-01 | AI 交互灯优先于充电指示 |\r
+| IMP-009 | GAP-009 | **改需求(乙)** | REQ-PWR-04 | 停对话后 **灭灯**(与 BAT-01 一致),非绿慢闪 |\r
+| IMP-010 | GAP-010 | **改需求(乙)** | REQ-NOTE-02 | 播放阶段 **绿常亮**(`playing`→`green_on`),非绿闪 |\r
\r
-\r
-### 4.1 整体姿态对比(选默认路线)\r
-\r
-\r
-| 维度 | 姿态 A:架构精简·安全·实用 | 姿态 B:改动最小 |\r
-| ------ | -------------------- | ------------------ |\r
-| 目标 | 需求↔实现长期一致 | 冻结现状,文档吸收差异 |\r
-| LED/异常 | 倾向 GAP-005/006 **甲** | 倾向 **乙**(改需求或接受现状) |\r
-| 按键/FSM | 倾向 GAP-001/002 **甲** | 倾向 **乙**(标注已知限制) |\r
-| 代码工作量 | 中~高 | 低(0~2 处热修) |\r
-\r
-\r
-**建议**:先填齐上表 **决策** 列,再批量改需求或 `ai_VC.py`。\r
-\r
-### 4.2 GAP-001:为何 `RequestToSpeak` 必须先 `cancel` 再开麦\r
+### 4.1 IMP-001:`RequestToSpeak` 必须先 `cancel` 再开麦\r
\r
长对话在 `turn==Thinking` 或 TTS 播放中,若直接 `uplink_start`,`_uplink_request_start` 会因 `turn` 非 `Listening/SpeechEnded` 而 **Deny START**;若先开麦再 `cancel`,本地/服务端旧轮下行可能与新一轮上行竞态。\r
\r
\r
---\r
\r
-## 5. 联调索引\r
+## 5. 开放差异(GAP)\r
+\r
+> 仅保留 **未关闭** 或需联调收敛项。新差异请用 GAP-012 起编号。\r
\r
-### 5.1 检查清单(原 E8)\r
+\r
+| GAP-ID | 关联 REQ | 说明 | 建议 |\r
+| ------- | -------- | --- | --- |\r
+| GAP-011 | REQ-ERR-02 | 弱网:`AI_hw_status` 可驱动 `signal=weak`→蓝绿慢交替;`websocket_error` 以 TTS+重连为主,与「每 5 秒循环弱网语音」表述需联调确认 | 实机测 CSQ<10 与断网两种场景,必要时统一 TTS 间隔文案 |\r
+| — | REQ-PWR-03 | 待机短按进休眠 vs `Close` 路径边界 | 对照 `ui.py`/`pm` 用例 |\r
+| — | REQ-NOTE-03 | 2 分钟无交互进休眠、休眠无灯 | 测 `idle_L2` + `sys_sleep_cb` |\r
+| — | REQ-PWR-01/02 | 3s 开机 / 8s 强关 | 电源模块单独需求,不在 `ai_VC` |\r
+\r
+---\r
+\r
+## 6. 联调索引\r
+\r
+### 6.1 检查清单(原 E8)\r
\r
\r
| # | 检查项 | 长对话 | 单对话 |\r
| 6 | 串口日志 | `[KEY]`、`[FSM]`、`[VC][proto]` | 同左 |\r
\r
\r
-### 5.2 日志关键字(原 E12)\r
+### 6.2 日志关键字(原 E12)\r
\r
\r
| 日志 | 含义 |\r
| `[VC] init audio_queue` | 清播放队列成功 |\r
\r
\r
-### 5.3 调试 API\r
+### 6.3 调试 API\r
\r
`EventMesh.publish("get_led_debug_state")` → `{ ai, charging, battery, signal, mode, period_ms }`\r
\r
---\r
\r
-## 6. 引用与场景索引\r
+## 7. 引用与场景索引\r
\r
\r
| 文档 | 路径 |\r
| 旧附录(已迁移) | [交互规范_附录-工程与代码审查.md](./AI吊坠(双按键+三色指示灯)交互规范_附录-工程与代码审查.md) |\r
\r
\r
-### 6.1 场景详设索引(`DES-SCN-`*)\r
+### 7.1 场景详设索引(`DES-SCN-`*)\r
\r
\r
| ID | 内容 |\r
| DES-SCN-050 | 服务端事件对照 |\r
\r
\r
+---\r
+\r
+## 8. 实现状态报告(代码审查)\r
+\r
+> **审查基准**:`2.sdk/project/7PIN_1_5/.../ai_VC.py` + `2.sdk/new_*.bat` \r
+> **审查日期**:2026-05-16(**需求已与 IMP 决策同步**) \r
+> **产品配置**:`product_k8.ini`,`PRODUCT_NAME=k8`\r
+\r
+### 8.1 总览\r
+\r
+\r
+| 维度 | 一致/已实现 | 部分一致 | 未定义/非本模块 |\r
+| --- | ---: | ---: | ---: |\r
+| 交互需求(第 3 章,不含 PWR-01/02) | **22** | **2**(PWR-03、NOTE-03) | 2 |\r
+| IMP 已关闭(原 GAP-001~010) | **10** | 0 | — |\r
+| 开放 GAP(第 5 章) | — | **1**(GAP-011) | 3 项联调备注 |\r
+| 版本与构建链 | **8** ✅ | 1 ⚠️ 遗留脚本 | — |\r
+\r
+\r
+**结论**:需求—设计—实现三角已对齐 **IMP-001~010**;`交互规范_new.md` 中 PWR-04、NOTE-02 播放行、ERR-02/03 已按决策改写。后续联调聚焦 **GAP-011(弱网)**、休眠(PWR-03/NOTE-03)、电源 3s/8s。\r
+\r
+### 8.2 版本与构建(摘要)\r
+\r
+| 项 | 状态 |\r
+| --- | --- |\r
+| `k8_V1.2_yyyy_MM_dd_HH_mm` + `version_util` frozen | ✅ |\r
+| `new_version.bat` 单次调用、`new_clean` release 路径、QP_LOG 默认关 | ✅ |\r
+| `ai_VC_coze.py` / `usr/test1.py` 旧版本串 | ⚠️ 非主路径,建议清理 |\r
+\r
+### 8.3 联调优先级(更新)\r
+\r
+| 优先级 | 项 |\r
+| ---: | --- |\r
+| P0 | 长对话打断、单对话 PTT(IMP-001~003) |\r
+| P1 | GAP-011 弱网 CSQ vs `websocket_error` |\r
+| P1 | OTA 登记 `k8_V1.2_*` |\r
+| P2 | PWR-03/NOTE-03 休眠;清理遗留版本脚本 |\r
+\r