release: 发布 AGM-C3 v1.4 固件与烧录包

device/AGM-C3/v1.4/README.md

@@ -0,0 +1,67 @@
+# AGM-C3 固件 v1.4
+
+发布日期：2026-10-11。设备型号：`AGM-C3`；芯片：ESP32-C3，最低修订版本 v0.3；Flash：4 MB，DIO / 80 MHz；AT 协议：`2`。
+
+本版本支持 Codex 会话的上下文占用读数，并每 5 秒轮换配额与上下文显示。推荐搭配 AgentMate 服务端 v0.3.3；具体变更见包内或版本目录中的 `CHANGELOG.md`。
+
+## 下载
+
+- [完整烧录包 agentmate-AGM-C3-v1.4.zip](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v1.4/agentmate-AGM-C3-v1.4.zip)：包含应用、bootloader、分区表、OTA 初始化数据、字库和烧录说明。
+- [单独应用固件 agentmate-AGM-C3-v1.4.bin](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v1.4/agentmate-AGM-C3-v1.4.bin)：仅供已有兼容 bootloader 和分区布局的设备更新应用，不能直接用于空白芯片。
+- [下载校验清单 SHA256SUMS](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/device/AGM-C3/v1.4/SHA256SUMS)。
+
+下载后用 `shasum -a 256 <文件>`、`sha256sum <文件>` 或 PowerShell `Get-FileHash <文件> -Algorithm SHA256` 与清单中的对应行核对。解压后还可使用包内 `SHA256SUMS` 校验全部烧录文件。
+
+## 烧录准备
+
+在 AgentMate 面板安全移除当前设备，等待显示“已移除，可烧录”，关闭其他串口工具。电脑需要 Python 和 esptool；以下命令使用本次构建配套的 esptool 4.10.0：
+
+```sh
+python -m pip install esptool==4.10.0
+```
+
+将命令中的 `PORT` 替换为实际端口，例如 macOS `/dev/cu.usbserialXXXX`、Linux `/dev/ttyUSB0` 或 Windows `COM3`。
+
+## 首次烧录或完整安装
+
+解压 ZIP，进入 `agentmate-AGM-C3-v1.4` 目录，执行：
+
+```sh
+python -m esptool --chip esp32c3 --port PORT --baud 460800 write_flash @flash_args
+```
+
+`flash_args` 使用下列文件及地址，来自本次构建的分区表和烧录配置：
+
+| 文件 | 烧录地址 | 用途 |
+| --- | --- | --- |
+| bootloader.bin | 0x000000 | 引导程序 |
+| partition-table.bin | 0x008000 | 分区表 |
+| ota_data_initial.bin | 0x00F000 | 选择初始 OTA 应用槽 |
+| agentmate_esp32.bin | 0x020000 | v1.4 应用，写入 ota_0 |
+| hzk16.bin | 0x380000 | 16×16 汉字库 |
+
+以上命令保留 `0x9000` 开始的 NVS 分区，不包含清空整片 Flash 操作；完整安装会重置 OTA 槽选择到 ota_0。不要将这份固件用于其他设备型号。
+
+## 已有设备仅更新应用
+
+仅适用于相同分区布局、当前从 ota_0（0x20000）启动的 AGM-C3。使用 ZIP 内的 `agentmate_esp32.bin`：
+
+```sh
+python -m esptool --chip esp32c3 --port PORT --baud 460800 write_flash --flash_mode dio --flash_freq 80m --flash_size 4MB 0x20000 agentmate_esp32.bin
+```
+
+若仅下载单独应用文件，将最后的文件名替换为 `agentmate-AGM-C3-v1.4.bin`。分区布局或当前 OTA 槽不确定时，使用完整烧录包；不清空 NVS 即可保留设备 ID、模式及亮度等设置。
+
+## 首次启动与恢复连接
+
+新 NVS 首次启动进入 `FACTORY` 产测模式。产测完成后，通过 UART0（115200、8N1、CRLF）发送 `AT+MODE=NORMAL`；设备保存模式并重启。`AT+INFO?` 应报告型号 `AGM-C3`、软件版本 `v1.4` 和协议 `2`。
+
+关闭烧录或串口工具后，在 AgentMate 面板点击“重新连接”，或拔出后再插入设备。
+
+## 构建来源与验证
+
+源码提交：`eaf25e125e30b95789eaabe2cbb35a960209ae6a`；components 子模块：`0d64650af522f1871cf2d96133d9ed78711d8234`。固件版本来自源码根目录 `CMakeLists.txt` 的 `project(... VERSION 1.4)`。
+
+使用 ESP-IDF `v5.5.1-789-g8d036f2edc`，从受版本控制的 `sdkconfig.defaults` 生成独立发布配置。包内 `BUILDINFO.txt`、`sdkconfig` 和 `partitions.csv` 记录本次构建信息与 Flash 布局。
+
+已通过 ESP-IDF 构建、镜像校验、字库 CRC 校验及主机 UI/LED 回归测试。本次没有执行真机烧录或串口验收。