AgentMate 服务端 v0.7.1
发布日期：2026-10-25。
源码提交：46ad572ad7353a821874d40e6c87fbc5373714a9。
本版本增加 macOS、Linux、Windows 蓝牙键鼠电量采集，以及最多四台外设的“显示到设备”选择。 设备页可勾选要显示的键盘／鼠标，选项保存后同步到本节点所有支持蓝牙电量页的设备；默认不选择任何设备。 与 AGM-C3 v3.0 配合，待机显示 1～4 台设备的名称、百分比和电量条，按 30%／60% 分红、琥珀、绿三级。 旧固件按能力查询保留原有会话、用量和时钟功能，不会收到新指令。服务升级不会自动升级设备固件。
电量来源依赖系统、外设与授权：macOS 原生补充采集可能需要蓝牙／输入监控授权；Linux 需要 BlueZ，Windows 使用系统／PnP／BLE 读数。 未知、断开和过期数据不会作为当前电量下发；选项保存在配置目录的 peripheral-display.json，仅存身份与名称，电量仍在内存中。 选择作用于本节点，不包含远程来源外设；设备页名称受圆屏字体限制，中文名以类型和编号显示，面板保留完整名称。 保留自定义 RGB 时钟配色等既有功能。详细变更见 CHANGELOG.md。
下载
| 平台 | 架构 | 发布包 |
|---|---|---|
| macOS | arm64 | agentmate-v0.7.1-darwin-arm64.tar.gz |
| macOS | amd64 | agentmate-v0.7.1-darwin-amd64.tar.gz |
| Linux | amd64 | agentmate-v0.7.1-linux-amd64.tar.gz |
| Linux | arm64 | agentmate-v0.7.1-linux-arm64.tar.gz |
| Windows | amd64 | agentmate-v0.7.1-windows-amd64.zip |
| Windows | arm64 | agentmate-v0.7.1-windows-arm64.zip |
校验清单：SHA256SUMS。构建来源及工具链：BUILDINFO.txt。
校验与安装
macOS／Linux 下载对应发布包和校验清单后，可校验该包；以下以 macOS arm64 为例：
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 中进入包目录运行：
.\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 工具。源码检出对应提交后运行：
TMPDIR=/tmp go test ./...
./release/build.sh
将 release/dist/ 的六份归档和 SHA256SUMS 复制到本仓库对应版本目录，并记录源码提交和构建工具链。服务与设备使用 AT 协议 2；真实 USB 连接和其他平台的安装、自启动行为需在对应平台验证。