# 更新日志

## 2.1 — 2026-10-13

### 串口升级

- 新增备用 OTA 槽升级流程：XMODEM1K／CRC 传输、整文件 SHA-256、长度与 AgentMate 应用身份验证，接收成功后需显式 COMMIT 才切换启动槽。
- 升级页展示接收、验证、完成或失败状态；支持传输取消、原样重传、超时与失败清理，拒绝固件更新期间的普通业务命令。
- 发布 bootloader 启用应用回滚；新镜像首次启动完成硬件、UART、UI／灯环检查并持续健康 10 秒后确认，30 秒未通过则回滚。发布镜像关闭强制自检失败测试选项。

### 待机配色

- 默认采用暖琥珀 AMBER，支持 WHITE、MINT、CODEX 配色与查询，并保存到 NVS。
- 设置成功后立即预览时间待机页 5 秒；等待输入或批准的会话优先显示，重复设置不重复写入 NVS。

### 兼容性

- 软件版本 v2.1，AT 协议仍为 2，引脚和 Flash 分区布局不变。推荐搭配服务 v0.6.0。
- 旧设备必须先安装本版完整烧录包中的回滚 bootloader；单独更新应用无法更新 bootloader。完整烧录保留 NVS，但重置 OTA 槽选择到 ota_0。
- 本次通过构建与主机自动测试，没有执行真机烧录或实际串口 OTA 验收。

## 2.0 — 2026-10-12

### 界面改版

- 按 `docs/design/session_page_five_rows.html` v6.2 实现当前支持的全部页面：启动、连接、Session、时间日期待机、Codex 用量、设备信息和产测。
- 默认屏幕背景统一纯黑；连接顶栏使用更明显的弧形下边界，Session 头部使用 agent 代表色描边和目录文字。
- Session 图标放大并直接融入黑底，主状态与明细合并布局；状态区保留黑底和彩色动态边框，等待输入与批准沿用原有动效。
- 明细按工作时长 10 秒、有效 agent 用量 3 秒、有效上下文 3 秒轮换，无效项跳过。单个用量窗口保持原宽度；配额使用紫色面板，上下文使用蓝色面板。
- 上下文增加 CTX 标题，token 数值右对齐并支持 K／M 单位和三位有效数字；已用与总量使用等高、深浅不同的面板。
- 待机时间采用 52 px 方正数字，日期放大；Codex 待机用量改为卡片，保留百分比、进度条和重置时间，支持双窗口与单窗口。
- 产测页面采用统一中文布局，保留原有颜色、字体、背光、LED 测试和自动测试流程。

### 资源与刷新

- ESP32-C3 目录仅显示可打印 ASCII，其他 Unicode 字符逐个替换为 `?`；协议保存和回读的原始 UTF-8 不变。
- 移除完整中文目录字库，仅保留固定文案字形；数字按字形绘制，继续使用局部刷新与共享小块缓冲。
- 增加弧形顶栏缓存、单双用量切换和产测返回的重绘检查，保持状态边框、冒号闪烁与明细轮换独立更新。

### 验证与兼容性

- 固件构建、主机 ASan／UBSan 渲染回归及真实设备 UI／产测串口检查通过；屏幕颜色与观感仍需目视验收。
- 软件版本升级为 `v2.0`，主机渲染测试从构建配置读取版本；AT 协议仍为 `2`，引脚、分区及 NVS 格式不变。配对认证仍为二期范围。

## 1.4 — 2026-10-09

### 新增

- Codex 会话支持接收和显示上下文已用百分比、已用 token 数和窗口 token 数。
- 会话页图标下方每 5 秒轮换配额组（五小时／七天剩余用量）与上下文组；未知上下文显示灰色 `--`。
- 增加上下文轮换边界、会话切换、局部重绘以及真机 context 写入／回读与非法字段测试。

### 改进

- 普通上下文和配额刷新不重置轮换计时，切换会话、状态组或连接代际后从配额组开始。
- Codex 会话页的五小时用量整体下移 3 px，两组用量数字由 15 px 放大为 17 px。

### 兼容性

- AT 协议保持为 `2`，Codex context 复用现有四字段；服务端与固件需同步升级。
- Codex 四字段全空保留为不支持上下文语义，此时仅显示配额；Claude 显示保持不变。

## 1.3 — 2026-10-06

### 新增

- Codex 会话页在图标下方显示五小时和一周的剩余用量，上下固定排列，不显示窗口标题。
- 每组使用整数数字和下方细进度条；数字保持原有大小，进度条从左到右显示剩余比例。
- 数字和进度条按显示值使用绿色（≥50）、橙色（20–49）或红色（0–19）；未知用量显示 `--` 和空轨道。
- 增加主机像素回归与真机串口测试，覆盖用量舍入、颜色边界、窗口选择、原子提交、清空及局部重绘。

### 改进

- 会话页与独立用量页共用 Codex 配额选择规则，用量刷新不重置会话轮播或页面淡入。
- 主机标识与会话短名之间统一使用中点，例如 `LOCAL·S1`。
- 固件版本更新为 `v1.3`，同步更新主机测试和 AT 指令文档中的版本信息。

### 兼容性

- AT 协议版本保持为 `2`，复用现有 `USAGE` 数据，无需扩展电脑端协议。
- Claude 会话的上下文用量显示保持不变。