release: 发布服务 v0.7.1 与 AGM-C3 v3.0 蓝牙电量显示

2026-10-25 01:15:28 +08:00
parent 7708930cfc
commit 443d1db68a
20 changed files with 406 additions and 12 deletions
@@ -6,10 +6,11 @@

 | 固件版本 | 发布日期 | AT 协议 | 发布说明 |
 | --- | --- | --- | --- |
+| v3.0 | 2026-10-25 | 2 | [下载与烧录](v3.0/README.md) |
 | v2.2 | 2026-10-24 | 2 | [下载与烧录](v2.2/README.md) |
 | v2.1 | 2026-10-13 | 2 | [下载与烧录](v2.1/README.md) |
 | v1.4 | 2026-10-11 | 2 | [下载与烧录](v1.4/README.md) |

-v2.2 新增自定义 RGB 时间配色及居中的会话状态圆点，过滤已停止会话。v2.1 提供新版界面、待机配色、串口 OTA 和启动回滚，推荐搭配 [AgentMate 服务端 v0.6.0](../../service/v0.6.0/README.md)。旧设备请先安装完整烧录包中的回滚 bootloader。
+v3.0 新增蓝牙外设电量待机页，搭配 [服务端 v0.7.1](../../service/v0.7.1/README.md) 选择最多四台键鼠。保留静态发光会话弧段、自定义时间配色、串口 OTA 与回滚；旧设备请先安装完整烧录包中的回滚 bootloader。

 [设备型号索引](../README.md) · [仓库首页](../../README.md)
@@ -0,0 +1,26 @@
+model=AGM-C3
+firmware_version=3.0
+at_software_version=v3.0
+protocol_version=2
+target=esp32c3
+chip_revision_min=0.3
+flash_size=4MB
+flash_mode=dio
+flash_frequency=80m
+app_offset=0x20000
+app_partition_size=0x1A0000
+app_size_bytes=709344
+bootloader_app_rollback_enabled=1
+ota_test_fail_boot=0
+build_date=2026-10-25
+source_repository=https://git.eehut.com/liuchuansen/agentmate_esp32
+source_commit=6b7551d11b2b08aae95739a8118dd46fa1ee8d4c
+source_tag=v3.0
+components_commit=0d64650af522f1871cf2d96133d9ed78711d8234
+esp_idf=v5.5.1-789-g8d036f2edc
+esptool=4.10.0
+compiler=riscv32-esp-elf-gcc 14.2.0
+configuration=sdkconfig.defaults (fresh SDKCONFIG)
+verification=idf.py build; image version/checksum/hash; font CRC; ASan/UBSan UI/LED/XMODEM/OTA host tests
+hardware_feature_tests=passed on v3.0 release image; serial battery and Go integration
+release_image_hardware_flash_test=passed
@@ -0,0 +1,107 @@
+# 更新日志
+
+## 3.0 — 2026-10-25
+
+- 新增主机选择的蓝牙键盘／鼠标电量待机页，最多 4 台，按 30%／60% 分红、琥珀、绿三级；支持 1～4 台自适应布局、未知／断开占位、数据过期与高优先级提醒抢占。
+- 新增可选 AT+BATTERY 原子快照及能力查询，协议主版本保持 2；设备版本升至 v3.0。
+
+- 普通／当前会话弧段跨度分别缩短至 3.5°／4.5°，保持中心位置，增大段间留白。
+
+- 调整 Session 总数为活动会话与仍保留展示的结束态合集；优先轮播完成组时不隐藏工作会话对应弧段，完成态退出后再减少计数。
+
+- Session 圆点替换为固定圆头短弧段，当前会话固定加粗、中心提亮并带柔和光晕，取消呼吸动效；保留状态配色、居中排列及活动／保留结果计数。
+
+- 修复 Codex 两档用量均不可用时仍显示空用量页的问题，待机与 Session 共用有效读数选择；一档有效时仅显示该档，恢复数据后重新开始待机轮播。
+
+- 修复不活动会话占点和当前标记错位的问题；补充完成、停止、注意组抢占及优先级切换的渲染回归。
+
+## 2.2 — 2026-10-24
+
+### 新增
+
+- 新增 `AT+CLOCKRGB=r,g,b` 和查询接口，各通道范围 0～255；设置后启用 CUSTOM 时间主题，保存自定义颜色并预览 5 秒。
+- 新增 `AT+CLOCKTHEME=CUSTOM`，切换预设仍保留自定义 RGB；主题和 RGB 合并持久化，兼容旧版保存的预设。
+
+### 改进与修复
+
+- Session 指示点移至圆屏下半部边沿，采用左侧 5 个、右侧 3 个固定点位；优先左侧，从中间向上下展开，单会话也显示。
+- 各圆点显示对应会话状态色，当前会话使用更大的实心点并按 1.6 秒周期变化，无外圈。
+- 圆点与会话轮播共用展示资格判断，排除 initializing、ready、ended、offline 和未使用槽位；过滤后重新居中，放大标记始终跟随当前会话。
+- 补充 RGB 参数边界、持久化及预览保护的串口验收，增加圆点数量、配色、居中点位和局部刷新回归检查。
+
+### 兼容性
+
+- 软件版本升级为 `v2.2`，AT 协议仍为 `2`，引脚和 Flash 分区布局保持不变。
+- 从 v2.1 升级时保留预设；降级至旧固件不保证保留新版自定义配色配置。
+
+## 2.1 — 2026-10-13
+
+- 新增 AT + XMODEM 串口 OTA、应用校验、提交重启、启动健康检查和回滚支持。
+- 成功设置时间主题时预览时间日期页 5 秒，保留注意会话保护及现有灯效。
+
+### 时间主题
+
+- 时间日期待机页默认采用 B 版暖琥珀配色；增加原版白色、A 版薄荷绿和 Codex 紫色方案。
+- 新增 `AT+CLOCKTHEME=<AMBER|WHITE|MINT|CODEX>` 与查询指令，立即生效并持久保存，重复设置避免重复写入。
+- 全页面设计稿更新为 v6.3，加入待机配色选择器；该阶段设备侧新增配色能力，AT 协议保持 2。
+
+## 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 会话的上下文用量显示保持不变。
@@ -0,0 +1,68 @@
+# AGM-C3 固件 v3.0
+
+发布日期：2026-10-25。型号 AGM-C3；ESP32-C3（最低修订 v0.3）、4 MB Flash、DIO / 80 MHz；AT 协议仍为 2。
+
+## 新功能
+
+- 新增蓝牙键盘／鼠标电量待机页：由 AgentMate 服务端 0.7.1 选择最多四台外设，设备不自行扫描蓝牙。
+- 1 台大数字、2 台双列、3 台列表、4 台 2×2 卡片，显示名称、类型图标、百分比和电量条。
+- 低于 30% 珊瑚红，30～59% 琥珀色，60～100% 薄荷绿；0% 有效，未知和断开为灰色 `--`。
+- 无选择、全未知或超过 180 秒未续发时跳过本页。存在蓝牙电量时按时间／有效 Codex 用量／蓝牙电量每页 10 秒轮播，工作和等待提醒优先。
+- Session 改为静态发光短弧段，按活动会话加保留完成态统计，弧段间距加大；修复空 Codex 用量页。
+- 保留已有自定义 RGB 时间主题、串口 OTA 和回滚能力。完整变更见 [CHANGELOG.md](CHANGELOG.md)。
+
+## 下载
+
+- [OTA 应用 agentmate-AGM-C3-v3.0.bin](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v3.0/agentmate-AGM-C3-v3.0.bin)
+- [完整烧录包 agentmate-AGM-C3-v3.0.zip](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v3.0/agentmate-AGM-C3-v3.0.zip)
+- [SHA256SUMS](SHA256SUMS) · [BUILDINFO.txt](BUILDINFO.txt)
+
+下载后使用 `shasum -a 256 -c SHA256SUMS` 或 `sha256sum -c SHA256SUMS` 校验。ZIP 内另有逐文件校验清单。
+
+## 从 v2.1／v2.2 更新
+
+已安装兼容分区和回滚 bootloader 的设备，可通过服务端面板检查官方更新或选择本地应用 `.bin`。
+应用 OTA 保留 NVS、字库、bootloader 和分区表，提交后重启并执行健康检查。v1.4 或不确定引导程序的设备先用完整烧录包。
+不要把应用直接写到固定槽地址作为通用升级方式。
+
+## 完整烧录
+
+在面板安全移除设备，关闭串口占用程序，安装配套工具：
+
+```sh
+python -m pip install esptool==4.10.0
+```
+
+解压后进入 `agentmate-AGM-C3-v3.0`，把 PORT 换成实际串口：
+
+```sh
+python -m esptool --chip esp32c3 --port PORT --baud 460800 write_flash @flash_args
+```
+
+| 文件 | 地址 |
+| --- | --- |
+| bootloader.bin | 0x000000 |
+| partition-table.bin | 0x008000 |
+| ota_data_initial.bin | 0x00F000 |
+| agentmate_esp32.bin | 0x020000 |
+| hzk16.bin | 0x380000 |
+
+完整包重置 OTA 启动槽为 ota_0，保留 0x9000 起的 NVS。不要整片擦除 Flash；仅适用于 AGM-C3。
+新设备产测完成后发送 `AT+MODE=NORMAL`。`AT+INFO?` 应报告 AGM-C3、v3.0、协议 2。烧录后恢复面板连接。
+
+## 选择显示的蓝牙外设
+
+安装服务端 0.7.1，在“设备”页的“蓝牙键盘与鼠标”勾选“显示到设备”，最多四台。选择保存在主机私有配置中，默认不选择任何设备。
+选择作用于本节点全部支持此功能的 USB 设备；设备仅接收主机的电量快照。断开、采集失败和过期读数不会作为当前电量显示。
+屏幕长名称会省略，非 ASCII 名称显示为带序号的键盘／鼠标标签；服务面板仍保留完整名称。
+`AT+BATTERY?` 返回最大容量和当前项数。服务端整批下发选项或读数变化，同一快照每分钟续发。
+协议仍为 2；旧固件不会收到不支持的新指令。自定义时钟配色继续断电保存。
+
+## 构建与验证
+
+源码 [6b7551d11b2b08aae95739a8118dd46fa1ee8d4c](https://git.eehut.com/liuchuansen/agentmate_esp32/commit/6b7551d11b2b08aae95739a8118dd46fa1ee8d4c)，标签 v3.0；components 子模块 `0d64650af522f1871cf2d96133d9ed78711d8234`。
+从 sdkconfig.defaults 生成全新发布配置，ESP-IDF v5.5.1-789-g8d036f2edc，GCC 14.2.0、esptool 4.10.0。
+启用应用回滚，强制失败测试关闭，普通 UART0 控制台日志关闭。
+已通过发布构建、图像版本与 checksum/hash、字体 CRC、ASan/UBSan UI／LED／XMODEM／OTA 主机回归。
+本发布镜像已烧录到真实 AGM-C3 并通过串口参数边界、整批错误、断开／未知、待机轮播与提醒优先级检查，
+Go 服务到真机的四项下发、减少及清空也通过。物理屏幕观感仍需目视确认。
@@ -0,0 +1,2 @@
+54451fccd26c95a93112331e39e587cf20072df6f6aee3461d01c06e98eb3947  agentmate-AGM-C3-v3.0.bin
+1c3ec31e0027ff3b890519b69149ecb258a03a04b7d759ca6cd8ee0bc349437d  agentmate-AGM-C3-v3.0.zip
@@ -2,7 +2,7 @@

 | 设备型号 | 芯片与 Flash | 最新版本 | 固件索引 |
 | --- | --- | --- | --- |
-| AGM-C3 | ESP32-C3，4 MB | v2.2 | [版本列表](AGM-C3/README.md) |
+| AGM-C3 | ESP32-C3，4 MB | v3.0 | [版本列表](AGM-C3/README.md) |

 固件按 `device/<设备型号>/v<版本>/` 保存。每次发布同步更新设备型号索引、版本索引和仓库首页。