liuchuansenandCursor
6de9272019
包含串口扫描选择、授权状态与更新检查修复，以及此前未单独发布的 Windows 蓝牙电量采集修复。 Co-authored-by: Cursor <cursoragent@cursor.com>
77 lines
5.0 KiB
Markdown
77 lines
5.0 KiB
Markdown
# AgentMate 服务端 v0.7.3
|
||
|
||
发布日期：2026-11-07。
|
||
|
||
源码提交：[6061ee2c94549b88a7d9c6dc0f2136b85d1ad892](https://git.eehut.com/liuchuansen/agentmate_service/commit/6061ee2c94549b88a7d9c6dc0f2136b85d1ad892)。
|
||
|
||
本版本在面板增加串口管理。设备页列出系统串口，只扫描勾选并保存的端口；默认不探测任何串口。取消选择会停止通信并释放连接，避免占用其他程序正在使用的串口。升级后需要在面板中重新勾选 AgentMate 设备所在端口，服务才会探测和连接。
|
||
|
||
同时修复 Claude Code 手动拒绝授权后，设备长时间保持“等待授权”的问题。服务更新检查结果与历史升级记录分开显示；检查更新的总超时为 45 秒，TLS 握手超时为 20 秒。
|
||
|
||
已发布的上一版是 v0.7.1。本版本同时包含当时未单独发布的 Windows 蓝牙键鼠电量采集修复：不再依赖会挂起的 WinRT AEP 查询，改用设备接口枚举，并通过标准 GATT 电量服务或 PnP 缓存属性读取电量。Windows 上的设备身份改为按蓝牙地址计算。该功能在 v0.7.1 的 Windows 上从未成功采集过，没有需要迁移的已保存显示选择。
|
||
|
||
保留蓝牙电量显示、自定义 RGB 时钟配色等既有功能。服务升级不会自动升级设备固件。详细变更见 [CHANGELOG.md](CHANGELOG.md)。
|
||
|
||
## 下载
|
||
|
||
| 平台 | 架构 | 发布包 |
|
||
| --- | --- | --- |
|
||
| macOS | arm64 | [agentmate-v0.7.3-darwin-arm64.tar.gz](agentmate-v0.7.3-darwin-arm64.tar.gz) |
|
||
| macOS | amd64 | [agentmate-v0.7.3-darwin-amd64.tar.gz](agentmate-v0.7.3-darwin-amd64.tar.gz) |
|
||
| Linux | amd64 | [agentmate-v0.7.3-linux-amd64.tar.gz](agentmate-v0.7.3-linux-amd64.tar.gz) |
|
||
| Linux | arm64 | [agentmate-v0.7.3-linux-arm64.tar.gz](agentmate-v0.7.3-linux-arm64.tar.gz) |
|
||
| Windows | amd64 | [agentmate-v0.7.3-windows-amd64.zip](agentmate-v0.7.3-windows-amd64.zip) |
|
||
| Windows | arm64 | [agentmate-v0.7.3-windows-arm64.zip](agentmate-v0.7.3-windows-arm64.zip) |
|
||
|
||
校验清单：[SHA256SUMS](SHA256SUMS)。构建来源及工具链：[BUILDINFO.txt](BUILDINFO.txt)。
|
||
|
||
## 校验与安装
|
||
|
||
macOS／Linux 下载对应发布包和校验清单后，可校验该包；以下以 macOS arm64 为例：
|
||
|
||
```sh
|
||
shasum -a 256 agentmate-v0.7.3-darwin-arm64.tar.gz
|
||
# 将输出与 SHA256SUMS 中对应行比较。
|
||
tar -xzf agentmate-v0.7.3-darwin-arm64.tar.gz
|
||
cd agentmate-v0.7.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/`。
|
||
|
||
## 访问与升级说明
|
||
|
||
- 安装或升级后刷新面板，首次使用会弹窗要求在服务所在电脑设置 8～64 个字符的密码；后续访问需要登录。
|
||
- 在“设置 → 访问与服务”开启“外部访问”，保存后点击“重启服务”，监听从默认 `127.0.0.1` 切换为 `0.0.0.0`，端口保持不变。其他电脑使用服务所在电脑的局域网 IP 访问。
|
||
- 网页重启重新加载配置、释放连接并初始化服务，清空内存会话，不停止 Agent；关闭外部访问后需要回到本机面板。
|
||
- 显式 `-listen` 启动参数优先，使用时页面开关不可编辑；未设密码时外部监听会先退回本机。
|
||
- 面板 HTTP 未加密，仅用于可信局域网。私有 hook 无需面板密码，节点订阅 HTTPS 与设备协议保持不变。
|
||
- 面板 API 调用需先登录并携带 cookie；节点接入信息导出与服务升级继续限制本机操作。
|
||
- 本版本支持在本机面板检查最新稳定版并升级服务，升级要求使用官方用户级安装。使用未提供检查更新功能的旧版本时，先下载对应平台包并运行安装脚本。
|
||
- 早于 v0.5.1 的升级器会把候选程序改为不可执行。从这些版本首次升级时，下载对应平台包并运行安装脚本；已有配置、凭据和 hooks 保留，监控短暂重启，Agent 本身继续运行。macOS／Linux 已配置 hooks 时运行 `./install.sh --skip-hooks`；Windows 运行 `.\install.ps1 -SkipHooks`。
|
||
|
||
## 构建
|
||
|
||
本版本使用源码提交中的 `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` 复制到本仓库对应版本目录，并记录源码提交和构建工具链。真实 USB 连接和其他平台的安装、自启动行为需在对应平台验证。
|