release: 发布 AgentMate 服务端 v0.3.3 全平台安装包

2026-10-11 10:31:13 +08:00
commit 1074976b18
14 changed files with 171 additions and 0 deletions
@@ -0,0 +1 @@
+.DS_Store
@@ -0,0 +1,41 @@
+# AgentMate 发布仓库
+
+本仓库集中保存 AgentMate 服务端预编译发布包和 ESP32 设备固件；源码在独立仓库维护。
+
+- [服务端版本索引](service/README.md)
+- [ESP32 固件索引](device/README.md)
+- [服务端源码](https://git.eehut.com/liuchuansen/agentmate_service)
+
+## 最新服务端：v0.3.3
+
+发布日期：2026-10-11。修复 Codex resume 状态恢复，以及不同设备先后使用同一串口时的发现与安全移除问题。
+
+| 平台 | 架构 | 下载 |
+| --- | --- | --- |
+| macOS | arm64（Apple Silicon） | [agentmate-v0.3.3-darwin-arm64.tar.gz](https://git.eehut.com/liuchuansen/agentmate_release/raw/branch/main/service/v0.3.3/agentmate-v0.3.3-darwin-arm64.tar.gz) |
+| macOS | amd64（Intel） | [agentmate-v0.3.3-darwin-amd64.tar.gz](https://git.eehut.com/liuchuansen/agentmate_release/raw/branch/main/service/v0.3.3/agentmate-v0.3.3-darwin-amd64.tar.gz) |
+| Linux | amd64（x86_64） | [agentmate-v0.3.3-linux-amd64.tar.gz](https://git.eehut.com/liuchuansen/agentmate_release/raw/branch/main/service/v0.3.3/agentmate-v0.3.3-linux-amd64.tar.gz) |
+| Linux | arm64（aarch64） | [agentmate-v0.3.3-linux-arm64.tar.gz](https://git.eehut.com/liuchuansen/agentmate_release/raw/branch/main/service/v0.3.3/agentmate-v0.3.3-linux-arm64.tar.gz) |
+| Windows | amd64（x64） | [agentmate-v0.3.3-windows-amd64.zip](https://git.eehut.com/liuchuansen/agentmate_release/raw/branch/main/service/v0.3.3/agentmate-v0.3.3-windows-amd64.zip) |
+| Windows | arm64（ARM64） | [agentmate-v0.3.3-windows-arm64.zip](https://git.eehut.com/liuchuansen/agentmate_release/raw/branch/main/service/v0.3.3/agentmate-v0.3.3-windows-arm64.zip) |
+
+[发布说明与安装方法](service/v0.3.3/README.md) · [SHA256 校验清单](service/v0.3.3/SHA256SUMS) · [修改日志](service/v0.3.3/CHANGELOG.md)
+
+每份服务端发布包均包含可执行文件、安装脚本、平台安装说明和构建信息，解压后无需安装 Go。macOS 两种架构均启用 cgo，保留 CH340 USB 串口自动发现能力。
+
+## 设备固件
+
+目前尚未发布 ESP32 固件；后续按设备型号和固件版本存放，并在 [设备索引](device/README.md) 中添加下载和烧录说明。
+
+## 目录约定
+
+```text
+service/
+  README.md
+  v<版本>/               # 服务端各平台发布包、校验值、构建信息和说明
+device/
+  README.md
+  <设备型号>/v<版本>/    # 对应硬件固件、校验值和烧录说明
+```
+
+发布新版本时新增版本目录，保留旧版本产物，并同步更新顶层 README 和分类索引。
@@ -0,0 +1,9 @@
+# ESP32 设备固件索引
+
+目前尚未发布设备固件。本次发布仅包含 [AgentMate 服务端](../service/README.md)。
+
+后续固件按 `device/<设备型号>/v<版本>/` 保存。每次发布在此添加设备型号、固件版本、下载链接及对应服务端兼容信息。
+
+每个固件版本目录应包含固件产物、`SHA256SUMS` 和 `README.md`；烧录说明应标明硬件型号、Flash 布局、烧录地址和命令，避免不同设备的固件混用。
+
+烧录前在 AgentMate 面板中安全移除当前设备，等待串口释放；烧录完成并关闭烧录工具后再恢复连接。
@@ -0,0 +1,9 @@
+# AgentMate 服务端版本索引
+
+| 版本 | 发布日期 | 平台 | 发布说明 |
+| --- | --- | --- | --- |
+| v0.3.3 | 2026-10-11 | macOS、Linux、Windows；均含 amd64／arm64 | [下载与安装](v0.3.3/README.md) |
+
+最新版本的各平台直接下载链接见 [仓库首页](../README.md)。
+
+每个版本目录保存六个平台包、`SHA256SUMS`、`BUILDINFO.txt`、`CHANGELOG.md` 和安装说明。发布包来自 [服务端源码仓库](https://git.eehut.com/liuchuansen/agentmate_service)，不在本仓库保存源码。
@@ -0,0 +1,8 @@
+version=0.3.3
+source_repository=https://git.eehut.com/liuchuansen/agentmate_service
+source_commit=6227189ff69545dee404900116c1454e8044a492
+build_date=2026-10-11
+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
+go version go1.27.1 darwin/arm64
@@ -0,0 +1,38 @@
+# Changelog
+
+本文件记录 AgentMate 的用户可见变更。版本号遵循语义化版本，源码默认值见 `internal/version.Version`。
+
+## [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` 执行；没有旧任务时直接跳过。
@@ -0,0 +1,59 @@
+# AgentMate 服务端 v0.3.3
+
+发布日期：2026-10-11。
+
+源码提交：[6227189ff69545dee404900116c1454e8044a492](https://git.eehut.com/liuchuansen/agentmate_service/commit/6227189ff69545dee404900116c1454e8044a492)。
+
+本版本修复 Codex resume 后的会话状态恢复和设备投影，并将串口发现、设备身份、历史记录与临时释放操作解耦。详细变更见 [CHANGELOG.md](CHANGELOG.md)。
+
+## 下载
+
+| 平台 | 架构 | 发布包 |
+| --- | --- | --- |
+| macOS | arm64 | [agentmate-v0.3.3-darwin-arm64.tar.gz](agentmate-v0.3.3-darwin-arm64.tar.gz) |
+| macOS | amd64 | [agentmate-v0.3.3-darwin-amd64.tar.gz](agentmate-v0.3.3-darwin-amd64.tar.gz) |
+| Linux | amd64 | [agentmate-v0.3.3-linux-amd64.tar.gz](agentmate-v0.3.3-linux-amd64.tar.gz) |
+| Linux | arm64 | [agentmate-v0.3.3-linux-arm64.tar.gz](agentmate-v0.3.3-linux-arm64.tar.gz) |
+| Windows | amd64 | [agentmate-v0.3.3-windows-amd64.zip](agentmate-v0.3.3-windows-amd64.zip) |
+| Windows | arm64 | [agentmate-v0.3.3-windows-arm64.zip](agentmate-v0.3.3-windows-arm64.zip) |
+
+校验清单：[SHA256SUMS](SHA256SUMS)。构建来源及工具链：[BUILDINFO.txt](BUILDINFO.txt)。
+
+## 校验与安装
+
+macOS／Linux 下载对应发布包和校验清单后，可校验该包；以下以 macOS arm64 为例：
+
+```sh
+shasum -a 256 agentmate-v0.3.3-darwin-arm64.tar.gz
+# 将输出与 SHA256SUMS 中对应行比较。
+tar -xzf agentmate-v0.3.3-darwin-arm64.tar.gz
+cd agentmate-v0.3.3-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/`。
+
+## 构建
+
+本版本使用源码提交中的 `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 连接和其他平台的安装、自启动行为需在对应平台验证。
@@ -0,0 +1,6 @@
+f9699ef8ab8eeeabe976500a073b46c4db40e35313b412dea4ec0f77e468c2ad  agentmate-v0.3.3-darwin-arm64.tar.gz
+816c9347e2a41c8f2d299ee37f60a6c530fa3429dce1144ad76bd940ab597515  agentmate-v0.3.3-darwin-amd64.tar.gz
+3a985e3c218b59f2b565103cfc6e367cde6dca865b3233f924230d9c4cc5491b  agentmate-v0.3.3-linux-amd64.tar.gz
+6344f342eaa46ffe6c14e731e81e2a5ca0ac20f59b4e9f07e28cebfae6d564d0  agentmate-v0.3.3-linux-arm64.tar.gz
+2b4b558f7c26e313e50a22b2cd1f75f5d0803a8208fefacb08d8cb5c820ea0b3  agentmate-v0.3.3-windows-amd64.zip
+8d6b31d406732d315248a9529f7989dd51fca05813098f6b9f9722b62ba10f82  agentmate-v0.3.3-windows-arm64.zip