agentmate/agentmate_release
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source
This commit is contained in:
liuchuansen
2026-10-25 01:15:28 +08:00
parent 7708930cfc
commit 443d1db68a
20 changed files with 406 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+10 -10
View File
@@ -6,20 +6,20 @@
- [ESP32 固件索引](device/README.md) - [ESP32 固件索引](device/README.md)
- [服务端源码](https://git.eehut.com/liuchuansen/agentmate_service) - [服务端源码](https://git.eehut.com/liuchuansen/agentmate_service)
## 最新服务端：v0.7.0 ## 最新服务端：v0.7.1
发布日期：2026-10-24。新增时钟自定义 RGB 配色、颜色选择器与 CUSTOM 主题恢复。自定义配色按设备固件能力启用，旧固件继续使用已有预设。 发布日期：2026-10-25。新增蓝牙键鼠电量采集、最多四台外设的显示选择，并接通 AGM-C3 v3.0 蓝牙待机页；保留时钟自定义 RGB 配色。
| 平台 | 架构 | 下载 | | 平台 | 架构 | 下载 |
| --- | --- | --- | | --- | --- | --- |
| macOS | arm64（Apple Silicon） | [agentmate-v0.7.0-darwin-arm64.tar.gz](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.0/agentmate-v0.7.0-darwin-arm64.tar.gz) | | macOS | arm64（Apple Silicon） | [agentmate-v0.7.1-darwin-arm64.tar.gz](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.1/agentmate-v0.7.1-darwin-arm64.tar.gz) |
| macOS | amd64（Intel） | [agentmate-v0.7.0-darwin-amd64.tar.gz](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.0/agentmate-v0.7.0-darwin-amd64.tar.gz) | | macOS | amd64（Intel） | [agentmate-v0.7.1-darwin-amd64.tar.gz](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.1/agentmate-v0.7.1-darwin-amd64.tar.gz) |
| Linux | amd64（x86_64） | [agentmate-v0.7.0-linux-amd64.tar.gz](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.0/agentmate-v0.7.0-linux-amd64.tar.gz) | | Linux | amd64（x86_64） | [agentmate-v0.7.1-linux-amd64.tar.gz](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.1/agentmate-v0.7.1-linux-amd64.tar.gz) |
| Linux | arm64（aarch64） | [agentmate-v0.7.0-linux-arm64.tar.gz](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.0/agentmate-v0.7.0-linux-arm64.tar.gz) | | Linux | arm64（aarch64） | [agentmate-v0.7.1-linux-arm64.tar.gz](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.1/agentmate-v0.7.1-linux-arm64.tar.gz) |
| Windows | amd64（x64） | [agentmate-v0.7.0-windows-amd64.zip](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.0/agentmate-v0.7.0-windows-amd64.zip) | | Windows | amd64（x64） | [agentmate-v0.7.1-windows-amd64.zip](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.1/agentmate-v0.7.1-windows-amd64.zip) |
| Windows | arm64（ARM64） | [agentmate-v0.7.0-windows-arm64.zip](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.0/agentmate-v0.7.0-windows-arm64.zip) | | Windows | arm64（ARM64） | [agentmate-v0.7.1-windows-arm64.zip](https://git.eehut.com/agentmate/agentmate_release/raw/branch/main/service/v0.7.1/agentmate-v0.7.1-windows-arm64.zip) |
[发布说明与安装方法](service/v0.7.0/README.md) · [SHA256 校验清单](service/v0.7.0/SHA256SUMS) · [修改日志](service/v0.7.0/CHANGELOG.md) [发布说明与安装方法](service/v0.7.1/README.md) · [SHA256 校验清单](service/v0.7.1/SHA256SUMS) · [修改日志](service/v0.7.1/CHANGELOG.md)
每份服务端发布包均包含可执行文件、安装脚本、平台安装说明和构建信息，解压后无需安装 Go。macOS 两种架构均启用 cgo，保留 CH340 USB 串口自动发现能力。 每份服务端发布包均包含可执行文件、安装脚本、平台安装说明和构建信息，解压后无需安装 Go。macOS 两种架构均启用 cgo，保留 CH340 USB 串口自动发现能力。
@@ -27,7 +27,7 @@
| 设备型号 | 最新固件 | 下载与说明 | | 设备型号 | 最新固件 | 下载与说明 |
| --- | --- | --- | | --- | --- | --- |
| AGM-C3（ESP32-C3，4 MB Flash） | v2.2 | [烧录包、应用固件与安装说明](device/AGM-C3/v2.2/README.md) | | AGM-C3（ESP32-C3，4 MB Flash） | v3.0 | [烧录包、应用固件与安装说明](device/AGM-C3/v3.0/README.md) |
完整设备版本列表见 [设备索引](device/README.md)。服务端与设备固件分别维护版本号。 完整设备版本列表见 [设备索引](device/README.md)。服务端与设备固件分别维护版本号。
device/AGM-C3/README.md
+2 -1
View File
@@ -6,10 +6,11 @@
| 固件版本 | 发布日期 | AT 协议 | 发布说明 | | 固件版本 | 发布日期 | AT 协议 | 发布说明 |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| v3.0 | 2026-10-25 | 2 | [下载与烧录](v3.0/README.md) |
| v2.2 | 2026-10-24 | 2 | [下载与烧录](v2.2/README.md) | | v2.2 | 2026-10-24 | 2 | [下载与烧录](v2.2/README.md) |
| v2.1 | 2026-10-13 | 2 | [下载与烧录](v2.1/README.md) | | v2.1 | 2026-10-13 | 2 | [下载与烧录](v2.1/README.md) |
| v1.4 | 2026-10-11 | 2 | [下载与烧录](v1.4/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) [设备型号索引](../README.md) · [仓库首页](../../README.md)
device/AGM-C3/v3.0/BUILDINFO.txt
+26
View File
@@ -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
device/AGM-C3/v3.0/CHANGELOG.md
+107
View File
@@ -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 会话的上下文用量显示保持不变。
device/AGM-C3/v3.0/README.md
+68
View File
@@ -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 服务到真机的四项下发、减少及清空也通过。物理屏幕观感仍需目视确认。
device/AGM-C3/v3.0/SHA256SUMS
+2
View File
@@ -0,0 +1,2 @@
54451fccd26c95a93112331e39e587cf20072df6f6aee3461d01c06e98eb3947 agentmate-AGM-C3-v3.0.bin
1c3ec31e0027ff3b890519b69149ecb258a03a04b7d759ca6cd8ee0bc349437d agentmate-AGM-C3-v3.0.zip
device/AGM-C3/v3.0/agentmate-AGM-C3-v3.0.bin
BIN
View File
Binary file not shown.
device/AGM-C3/v3.0/agentmate-AGM-C3-v3.0.zip
BIN
View File
Binary file not shown.
device/README.md
+1 -1
View File
@@ -2,7 +2,7 @@
| 设备型号 | 芯片与 Flash | 最新版本 | 固件索引 | | 设备型号 | 芯片与 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<版本>/` 保存。每次发布同步更新设备型号索引、版本索引和仓库首页。 固件按 `device/<设备型号>/v<版本>/` 保存。每次发布同步更新设备型号索引、版本索引和仓库首页。
service/README.md
+1
View File
@@ -2,6 +2,7 @@
| 版本 | 发布日期 | 平台 | 发布说明 | | 版本 | 发布日期 | 平台 | 发布说明 |
| --- | --- | --- | --- | | --- | --- | --- | --- |
| v0.7.1 | 2026-10-25 | macOS、Linux、Windows；均含 amd64／arm64 | [下载与安装](v0.7.1/README.md) |
| v0.7.0 | 2026-10-24 | macOS、Linux、Windows；均含 amd64／arm64 | [下载与安装](v0.7.0/README.md) | | v0.7.0 | 2026-10-24 | macOS、Linux、Windows；均含 amd64／arm64 | [下载与安装](v0.7.0/README.md) |
| v0.6.0 | 2026-10-13 | macOS、Linux、Windows；均含 amd64／arm64 | [下载与安装](v0.6.0/README.md) | | v0.6.0 | 2026-10-13 | macOS、Linux、Windows；均含 amd64／arm64 | [下载与安装](v0.6.0/README.md) |
| v0.5.1 | 2026-10-11 | macOS、Linux、Windows；均含 amd64／arm64 | [下载与安装](v0.5.1/README.md) | | v0.5.1 | 2026-10-11 | macOS、Linux、Windows；均含 amd64／arm64 | [下载与安装](v0.5.1/README.md) |
service/v0.7.1/BUILDINFO.txt
+9
View File
@@ -0,0 +1,9 @@
version=0.7.1
source_repository=https://git.eehut.com/liuchuansen/agentmate_service
source_commit=46ad572ad7353a821874d40e6c87fbc5373714a9
source_tag=v0.7.1
build_date=2026-10-25
build_script=release/build.sh
targets=darwin/arm64 darwin/amd64 linux/amd64 linux/arm64 windows/amd64 windows/arm64
cgo_enabled=darwin:1 linux:0 windows:0
verification=go test ./...; race tests; panel behavior; archive metadata; hardware battery forwarding
service/v0.7.1/CHANGELOG.md
+91
View File
@@ -0,0 +1,91 @@
# Changelog
本文件记录 AgentMate 的用户可见变更。版本号遵循语义化版本，源码默认值见 `internal/version.Version`。
## [0.7.1] - 2026-10-25
- 增加最多四台蓝牙键鼠“显示到设备”选择，私有配置持久化；接通 AGM-C3 v3.0 原子电量同步与旧固件能力兼容。
- 面板和设备使用 30%／60% 电量分级；采集失败、断开或过期不会向设备传递旧读数。
### Added
- 服务端面板“设备”页增加本机蓝牙键盘、鼠标电量：macOS 系统／HID／BLE 与 Logitech HID++ 查询，Linux BlueZ 系统总线，以及 Windows 系统／PnP 属性与 BLE 电量服务。
- 新增受面板认证保护的只读 `GET /v1/peripherals`；后台每分钟采集，显示未知电量、低电量、充电状态与采集失败后的过期提示，按设备身份区分同名外设。
### Compatibility
- 外设快照仅保存在内存中，仅展示服务所在电脑的数据，不同步到远程节点；可将最多四台选中外设同步到本节点 USB 设备，按可选 AT+BATTERY 能力兼容旧固件。电量可用性取决于外设、驱动与系统授权；macOS 原生补充采集需要 cgo。
## [0.5.1] - 2026-10-11
### Fixed
- 修复 macOS／Linux 自动升级在候选程序版本检查时报 `permission denied` 的问题：候选程序使用保留执行权限的私有保护，Unix 权限为 `0700`，Windows 继续使用当前用户与 SYSTEM 的 ACL。
- 增加完整升级准备流程的回归测试，实际执行解包后的候选程序并检查候选程序及独立 updater 的权限，避免仅验证下载或解包而漏掉执行失败。
### Compatibility
- 已运行的旧版升级器仍包含此权限缺陷，首次升级到修复版需要下载对应平台包并运行安装脚本；安装保留配置与 hooks，重启监控服务，不停止 Agent。
## [0.5.0] - 2026-10-11
### Added
- Web 面板增加密码登录，首次打开时弹窗设定 8～64 个字符的密码；首次设密仅允许本机访问，密码采用随机盐与 PBKDF2-SHA256 哈希存储。
- 设置页增加“外部访问”开关：默认监听 `127.0.0.1`，开启并重启后监听 `0.0.0.0`，保持端口不变；局域网用户登录后可查看会话、管理来源和本节点设备。
- 支持在网页请求重启服务，重新读取配置、释放连接并初始化运行时；适用于手动运行及系统管理的服务，保留当前登录并清空内存会话，不停止 Agent。
- 支持修改密码、退出登录、24 小时登录有效期和登录尝试限流；修改密码会注销其他浏览器，页面数据接口要求认证，写操作要求同源请求。
### Changed
- Web 面板调整为会话、来源、设备与设置四个页面，改进会话状态和来源筛选、上下文占用、任务结果详情及连接中断提示。
- 未设置密码时，即使配置了外部监听，也先退回同端口的本机监听；显式 `-listen` 参数优先于保存的配置，页面显示当前监听及是否需要重启。
- 保留独立的 Unix socket／Windows 回环 hook 接口；显式面板 HTTP hook 地址仅接受本机非浏览器客户端，无需面板密码。节点凭据导出和服务升级继续限制为本机操作。
### Compatibility
- 面板 HTTP 仍未加密，外部访问适用于可信局域网；节点订阅 HTTPS 和设备协议保持不变。
- 面板 API 客户端需先调用密码登录接口并携带登录 cookie；健康检查及私有 hook 投递不受影响。
## [0.4.0] - 2026-10-11
### Added
- 本机 Web 面板与 HTTP API 支持手动检查最新稳定版和服务升级，使用公开发布仓库、当前平台包与 SHA256 校验。
- 三平台通过独立用户管理任务执行升级，保留服务定义、配置及 hooks；启动失败时回退旧二进制，并通过持久化升级记录在重启后展示结果。
- 更新接口限制为本机同源，不提供预发布、降级、定时升级、远程节点或设备固件升级。
## [0.3.3] - 2026-10-11
### Fixed
- 修复 Codex resume 后会话状态无法恢复和投影到设备的问题；通过新 turn 与替代 CLI 进程确认恢复，并保留已结束 turn 的守卫，避免迟到事件重新打开旧工作。
- 解耦串口发现与设备历史：先检查串口，再通过 HELLO 验证设备，最后按设备 ID 更新历史，支持不同设备先后使用同一串口及同一设备更换串口。
- 修复历史设备误显示“识别中”和误操作旧串口的问题；安全移除只作用于当前已识别的连接，恢复后以实际接入的设备 ID 为准。
- 检测到串口拔出时中断对应连接；避免并发枚举的旧结果解除新建的串口暂停，保留烧录期间的串口释放保证。
## [0.3.2] - 2026-10-09
### Added
- 设备投影支持 Codex 上下文读数：已知时下发 token 数、窗口大小、已用百分比和采集时间，未知或读数失效时下发四个 `?`。
- 支持固件在会话页每 5 秒轮换五小时／七天配额与当前会话上下文。
- 增加 Codex 上下文更新、清除、revision 递增及无变化不重复发送的设备回归测试。
### Compatibility
- AT 协议保持为 `2`，使用现有 SESSION 字段；需与支持 Codex context 的新版固件同步升级。
## [0.3.1] - 2026-10-06
### Added
- 面板和节点配置支持会话空闲超时（`session_timeout`），默认 5 分钟，可在本机设置中调整。
- 设备卡片支持“安全移除”和“重新连接”：烧录前释放串口并暂停自动重连，完成后可恢复，不影响其他设备与会话监控。
- 设备列表增加 `released`、`ejecting` 状态，以及 `can_eject`、`can_reconnect` 操作能力字段。
### Fixed
- 修复 Codex 运行时等待状态投影：等待用户输入或授权时不再被普通 active/idle 观察误判为结束或重新开工。
- 改进 Codex 上下文占用读取，减少窗口大小未知或订阅失败时的错误展示。
- 修复 Windows 首次安装失败：停止计划任务不再通过 `powershell -Command` 内联脚本（命令行转义会破坏脚本），改为写入 `stop-tasks.ps1` 后以 `-File` 执行；没有旧任务时直接跳过。
service/v0.7.1/README.md
+83
View File
@@ -0,0 +1,83 @@
# AgentMate 服务端 v0.7.1
发布日期：2026-10-25。
源码提交：[46ad572ad7353a821874d40e6c87fbc5373714a9](https://git.eehut.com/liuchuansen/agentmate_service/commit/46ad572ad7353a821874d40e6c87fbc5373714a9)。
本版本增加 macOS、Linux、Windows 蓝牙键鼠电量采集，以及最多四台外设的“显示到设备”选择。
设备页可勾选要显示的键盘／鼠标，选项保存后同步到本节点所有支持蓝牙电量页的设备；默认不选择任何设备。
与 [AGM-C3 v3.0](../../device/AGM-C3/v3.0/README.md) 配合，待机显示 1～4 台设备的名称、百分比和电量条，按 30%／60% 分红、琥珀、绿三级。
旧固件按能力查询保留原有会话、用量和时钟功能，不会收到新指令。服务升级不会自动升级设备固件。
电量来源依赖系统、外设与授权：macOS 原生补充采集可能需要蓝牙／输入监控授权；Linux 需要 BlueZ，Windows 使用系统／PnP／BLE 读数。
未知、断开和过期数据不会作为当前电量下发；选项保存在配置目录的 peripheral-display.json，仅存身份与名称，电量仍在内存中。
选择作用于本节点，不包含远程来源外设；设备页名称受圆屏字体限制，中文名以类型和编号显示，面板保留完整名称。
保留自定义 RGB 时钟配色等既有功能。详细变更见 [CHANGELOG.md](CHANGELOG.md)。
## 下载
| 平台 | 架构 | 发布包 |
| --- | --- | --- |
| macOS | arm64 | [agentmate-v0.7.1-darwin-arm64.tar.gz](agentmate-v0.7.1-darwin-arm64.tar.gz) |
| macOS | amd64 | [agentmate-v0.7.1-darwin-amd64.tar.gz](agentmate-v0.7.1-darwin-amd64.tar.gz) |
| Linux | amd64 | [agentmate-v0.7.1-linux-amd64.tar.gz](agentmate-v0.7.1-linux-amd64.tar.gz) |
| Linux | arm64 | [agentmate-v0.7.1-linux-arm64.tar.gz](agentmate-v0.7.1-linux-arm64.tar.gz) |
| Windows | amd64 | [agentmate-v0.7.1-windows-amd64.zip](agentmate-v0.7.1-windows-amd64.zip) |
| Windows | arm64 | [agentmate-v0.7.1-windows-arm64.zip](agentmate-v0.7.1-windows-arm64.zip) |
校验清单：[SHA256SUMS](SHA256SUMS)。构建来源及工具链：[BUILDINFO.txt](BUILDINFO.txt)。
## 校验与安装
macOS／Linux 下载对应发布包和校验清单后，可校验该包；以下以 macOS arm64 为例：
```sh
shasum -a 256 agentmate-v0.7.1-darwin-arm64.tar.gz
# 将输出与 SHA256SUMS 中对应行比较。
tar -xzf agentmate-v0.7.1-darwin-arm64.tar.gz
cd agentmate-v0.7.1-darwin-arm64
./agentmate version
./install.sh
```
Linux 也可用 `sha256sum` 校验。Linux 安装方式相同，按系统和架构替换文件名。
Windows 解压对应 ZIP 后，在 PowerShell 中进入包目录运行：
```powershell
.\agentmate.exe version
.\install.ps1
```
Windows 可用 `Get-FileHash` 计算下载包的 SHA256，再与校验清单比较。
安装默认使用脚本旁的二进制；包内 `README.md` 提供对应平台的详细说明。安装后面板地址为 `http://127.0.0.1:8765/`。
## 旧版升级器的引导安装
旧版升级器会把候选程序改为不可执行的 `0600`，下载修复包也无法修复正在运行的旧升级器。首次升级到修复版需下载对应平台包，解压后运行安装脚本；已有配置、凭据和 hooks 保留，监控短暂重启，Agent 本身继续运行。无需 sudo，也无需删除失败记录或修改候选文件。
macOS／Linux 已配置 hooks 时运行 `./install.sh --skip-hooks`；Windows 运行 `.\install.ps1 -SkipHooks`。之后使用修复版的页面升级功能。macOS／Linux 的私有候选程序权限为 `0700`，Windows 使用当前用户与 SYSTEM 的 ACL。
## 访问与升级说明
- 安装或升级后刷新面板，首次使用会弹窗要求在服务所在电脑设置 8～64 个字符的密码；后续访问需要登录。
- 在“设置 → 访问与服务”开启“外部访问”，保存后点击“重启服务”，监听从默认 `127.0.0.1` 切换为 `0.0.0.0`，端口保持不变。其他电脑使用服务所在电脑的局域网 IP 访问。
- 网页重启重新加载配置、释放连接并初始化服务，清空内存会话，不停止 Agent；关闭外部访问后需要回到本机面板。
- 显式 `-listen` 启动参数优先，使用时页面开关不可编辑；未设密码时外部监听会先退回本机。
- 面板 HTTP 未加密，仅用于可信局域网。私有 hook 无需面板密码，节点订阅 HTTPS 与设备协议保持不变。
- 面板 API 调用需先登录并携带 cookie；节点接入信息导出与服务升级继续限制本机操作。
- 本版本支持在本机面板检查最新稳定版并升级服务，升级要求使用官方用户级安装。使用未提供检查更新功能的旧版本时，先下载对应平台包并运行安装脚本。
## 构建
本版本使用源码提交中的 `release/build.sh`，构建 macOS、Linux、Windows 的 amd64／arm64 六种目标；macOS 启用 cgo，Linux／Windows 不启用 cgo。每份包包含安装脚本、平台 README、`BUILDINFO.txt`、统一节点说明和服务升级说明。
完整构建需要 macOS、Go、Xcode Command Line Tools、tar、zip 和 SHA256 工具。源码检出对应提交后运行：
```sh
TMPDIR=/tmp go test ./...
./release/build.sh
```
将 `release/dist/` 的六份归档和 `SHA256SUMS` 复制到本仓库对应版本目录，并记录源码提交和构建工具链。服务与设备使用 AT 协议 `2`；真实 USB 连接和其他平台的安装、自启动行为需在对应平台验证。
service/v0.7.1/SHA256SUMS
+6
View File
@@ -0,0 +1,6 @@
7692ca6533170442312759bd181c1f48607a572b576ac7d89e470c07779d334c agentmate-v0.7.1-darwin-arm64.tar.gz
835e712f3baf79bfeeaf56321574a87a4de9d710c469fba8e4dc139c97ad59d8 agentmate-v0.7.1-darwin-amd64.tar.gz
9a91422d04c63bd0c9ffc3c62750a9a96bc0522114b87d1087fdef9bbe472756 agentmate-v0.7.1-linux-amd64.tar.gz
8e74c4b9c86562a8a2d99eb5411bdb0b6e55a800115123ff9c7e3fd09ab11a7b agentmate-v0.7.1-linux-arm64.tar.gz
bb5e5d4afbca442963fae9f9b827d056d9ec2afd5181cb1fc6963d68f7e585ce agentmate-v0.7.1-windows-amd64.zip
87e4cb4acc8e22d31148e31564410e99dcf8eef699192db6962a07cf365225a6 agentmate-v0.7.1-windows-arm64.zip
service/v0.7.1/agentmate-v0.7.1-darwin-amd64.tar.gz
BIN
View File
Binary file not shown.
service/v0.7.1/agentmate-v0.7.1-darwin-arm64.tar.gz
BIN
View File
Binary file not shown.
service/v0.7.1/agentmate-v0.7.1-linux-amd64.tar.gz
BIN
View File
Binary file not shown.
service/v0.7.1/agentmate-v0.7.1-linux-arm64.tar.gz
BIN
View File
Binary file not shown.
service/v0.7.1/agentmate-v0.7.1-windows-amd64.zip
BIN
View File
Binary file not shown.
service/v0.7.1/agentmate-v0.7.1-windows-arm64.zip
BIN
View File
Binary file not shown.