---
id: cpu-temp-warning
title: CPU Temperature Warning
doc_type: design-record
status: in-dev
target_release: "8.4"
last_updated: 2026-07-09
sources:
  - { type: jira, ref: "V4-2335", url: "https://tvunetworks.atlassian.net/browse/V4-2335" }
  - { type: jira, ref: "V4-2356", url: "https://tvunetworks.atlassian.net/browse/V4-2356" }
  - { type: jira, ref: "V4-1676", url: "https://tvunetworks.atlassian.net/browse/V4-1676" }
  - { type: slack, ref: "Merlin stress-test thread", url: "https://tvunetworks.slack.com/archives/C021E1BNTPF/p1783321555018419?thread_ts=1783301092.542329&cid=C021E1BNTPF" }
  - { type: doc, ref: "异常判定标准文档 (2023-11-14)" }
figma:
  file: 0054ib0nLmt27bC3QlGDl7
  nodes:
    - { id: "9299:2", label: "Touch Screen (LCD) 交付 Section — V4-2335", url: "https://www.figma.com/design/0054ib0nLmt27bC3QlGDl7/Touch-Screen-v7.7---8.0--20240220?node-id=9299-2" }
    - { id: "7662:2", label: "Config-T 交付 Section — V4-2356 (file rJJjWWs51n2iFOlCIC7aYG)", url: "https://www.figma.com/design/rJJjWWs51n2iFOlCIC7aYG/?node-id=7662-2" }
---

# Feature Design Record — CPU Temperature Warning (V4-2335 / V4-2356)

- **JIRA**：[V4-2335](https://tvunetworks.atlassian.net/browse/V4-2335)（LCD Screen）+ [V4-2356](https://tvunetworks.atlassian.net/browse/V4-2356)（Config-T，clones V4-2335）　**Scope**：V4 LCD + Config-T
- **Owner(dev)**：Edward Wu（LCD / V4-2335）· Bonnie Zhou（Config-T / V4-2356）　**PM**：Trevor Yao　**Designer**：Nancy Zeng
- **Status**：mockup 已交付、待 PM review　**日期**：2026-07-09

## 1. 问题与根因
CPU 过热是持续、会恶化的硬件风险，可致降频 / 死机 / 硬件损坏，直播中直接中断推流。当前 GUI（Config-T + Touch Screen）**无任何温度提示**，用户无法及时处理。**非 bug，是新增的主动预警功能**。根因数据：异常判定文档（2023-11-14）定义 V4 CPU 温度 **>88°C 为异常且为最高线**（无更高热保护/关机阈值；V2=90°C、V3=70°C 不在本需求）；Merlin 压测（6×5G Modem、直播）实测四路 TM1100 ~65°C、单路 TM1000 V4 ~53°C。两工单均无 description/评论，需求 context 来自设计沟通 + 上述数据。

## 2. Scope & Non-goals
- **做**：V4（RPS One / TM1100 等）两界面新增 CPU 温度告警（三段阈值 + 滞回 + 通知）。
- **不做（Non-goals）**：V2 / V3；热保护 / 自动关机等**控制动作**（本需求纯提示 notification-only）；LCD 常驻温度读数（LCD 顶栏无空间，仅 Config-T 有常驻读数）。

## 3. Baseline 参考
- **LCD**：V4-2312「Channel Lock/Live Status Indicator」Section `8603:281` — 直接沿用其告警条契约（库 `Message` 组件 + 顶部浮层 banner + frame 外预览+连线范式）；干净直播界面底 clone 自其 S0 Normal `8558:100`。
- **Config-T**：V4-1864/1360 Modem Status 的 AFTER 帧 `6908:2`（Config-T Network 页，完整已开发 GUI）作 state 底；Jira widget / UX Delivery 卡 clone 自 V4-1827（`7455:1416` / `7516:473`）。
- 组件真源：库 `Message` component-set（`prompt message`，SET key `e9574b39…`）—— size L=点击关闭 / M=自动消失，status warning/error/success=琥珀/红/绿。

## 4. 设计 — 状态与指示模型
三段阈值 + 滞回（每 5 秒采样，暂定以 PM 确认）：

| State | 温度 | 通知 | 关闭行为 |
|---|---|---|---|
| S0 Normal | < 78°C | 无 | — |
| S1 Warning | 78–88°C | 琥珀 Message | 手动关闭 |
| S2 Danger | ≥ 88°C | 红 Message | 手动关闭 / 确认 |
| S3 Recovery | 回落正常 | 绿 Message | 手动关闭 + 3 秒自动关闭 |

- **滞回**：解除 = 触发 − 3°C（Warning <75°C、Danger <85°C）；75–78 / 85–88°C 悬空区不重复弹。
- **全局**：通知在任意页面顶部浮层展示。
- **不关闭时**：Warning/Danger 常驻，升级（Warning→Danger）就地替换，回落正常自动撤除。
- **再提醒**（手动关后）：升级立即重弹 / 同段 5 分钟冷却后重弹 / 期间再升 +3°C 提前重弹。
- **界面差异**：LCD 无常驻读数（纯通知，居中距顶 8px 不遮视频，宽 `Module Width/L`=360）；**Config-T 在 Home/System 区常驻显示 CPU 温度读数**（按段配色），Recovery 引导「see Home for live temp」（宽 `Module Width/XL`=480）。

## 5. UX 交付
- **产品 UI 文案 = 英文单语**（避免 dev/test 误解），中文作 `ZH ref` 旁注放通知旁（不入组件，M33 语言隔离）。
- **组件**：通知全部用库 `Message`（Warning=warning,L / Danger=error,L / Recovery=success,L + close off→auto-dismiss）；宽度绑 `Module Width/L`(LCD)·`XL`(Config-T) token。Config-T 常驻读数为 System 区 label+value（按段配色）。
- **注释层（双语，M23）**：每界面 = Jira widget（M23.8 超链接）+ PRD 卡（6 段）+ UX Delivery 卡（Why/Changes/States/Interaction/Data/Acceptance）+ **User Journey Map 卡（5-stage）**。

## 6. 决策记录
| # | 决策 | 理由 |
|---|---|---|
| 1 | 通知组件用库 `Message`（非 Notification）| sibling V4-2312 已锚定；M49 同 semanticClass 同组件 |
| 2 | 取消「常驻温度入口」→ 纯通知（LCD）| LCD 顶栏无空间（owner 拍板；改回 Config-T Home 常驻读数） |
| 3 | 产品英文单语 + 中文旁注 | 组件内混中英文易让 dev/test 误解（owner） |
| 4 | 通知尺寸统一（size=L）+ 宽度用 Module Width token | 三态视觉一致；用 DS 变量而非硬编码 |
| 5 | 全局 + 手动关闭 + 再提醒（升级立即/5min 冷却/+3°C）| 硬件风险安全优先、又不刷屏（owner 确认） |
| 6 | Recovery 手动关 + 3 秒自动关闭 | 正向提示可自动消退、也允许手动 |
| 7 | Config-T Home 加常驻 CPU 温度读数 + Recovery 引导 | Config-T 有空间；给用户主动查看处（owner） |
| 8 | 按界面拆 Jira 单（V4-2335 LCD / V4-2356 Config-T）| 两端不同开发（Edward / Bonnie）|
| 9 | User Journey Map 升为标准交付卡并回流设计系统 | 避免临时随机生成 / 漏 surface（owner 回流，commit c0df637f）|

## 7. 依赖 / 待办
- **固件**：需提供实时 CPU 温度（°C）+ 按三段阈值 + 滞回判定；纯提示不含控制。
- **计时参数暂定，最终以 PM 确认为准**：采样 5s / 同段冷却 5min / 提前重弹步进 +3°C。
- 阈值依据异常判定文档（V4 >88°C）。

## 8. 交付链接
- **LCD（V4-2335）**：Figma Section [`9299:2`](https://www.figma.com/design/0054ib0nLmt27bC3QlGDl7/Touch-Screen-v7.7---8.0--20240220?node-id=9299-2)（Touch Screen 文件 `0054ib0nLmt27bC3QlGDl7`）
- **Config-T（V4-2356）**：Figma Section [`7662:2`](https://www.figma.com/design/rJJjWWs51n2iFOlCIC7aYG/?node-id=7662-2)（Config-T 文件 `rJJjWWs51n2iFOlCIC7aYG`）

## 9. 路由与评审
- **Assignee（按界面）**：V4-2335 LCD → **Edward Wu**；V4-2356 Config-T → **Bonnie Zhou**
- **Reviewer / PM**：**Trevor Yao**
- **FYI**：Dave Hu（项目开发负责人）
- **JIRA 回复评论**：待发（@Trevor review + Figma Section link + FYI @Edward / @Bonnie / @Dave；ADF + accountId 真 mention）