feat: 添加节点自动更新功能，支持手动触发更新

docs/deployment.md

@@ -229,7 +229,14 @@ curl -fsSL https://raw.githubusercontent.com/Rain-kl/ATSFlare/main/scripts/insta
 
 ### 7.3 Agent 自动更新
 
-在管理端 **运维设置** 中启用「Agent 自动更新」后，Agent 会在每次心跳周期检查 GitHub Releases，发现新版本时自动下载并重启。
+Agent 自动更新默认为关闭。
+
+在管理端 **节点管理** 页面中可以：
+
+* 为单个节点开启「自动更新」
+* 为单个节点点击「立即更新」，下发一次性更新指令
+
+节点在收到对应心跳响应后，会检查 GitHub Releases，发现新版本时自动下载并重启。
 
 ---
 
@@ -252,9 +259,15 @@ GitHub Release 中的 Agent 二进制命名格式：
 | AgentHeartbeatInterval | 心跳间隔（毫秒）     | heartbeat_interval |
 | AgentSyncInterval      | 同步间隔（毫秒）     | sync_interval      |
 | NodeOfflineThreshold   | 节点离线阈值（毫秒） | -                  |
-| AgentAutoUpdate        | 是否启用自动更新     | auto_update        |
 | AgentUpdateRepo        | 自动更新仓库         | update_repo        |
 
+节点管理页下发的字段：
+
+| 参数                   | 说明               | Agent 字段  |
+| ---------------------- | ------------------ | ----------- |
+| Node.AutoUpdateEnabled | 节点是否自动更新   | auto_update |
+| Node.UpdateRequested   | 节点一次性更新请求 | update_now  |
+
 ---
 
 ## 10. 当前已知限制

docs/design.md

@@ -347,7 +347,6 @@ Agent 接口当前覆盖：
   * `AgentHeartbeatInterval`：Agent 心跳上报间隔（毫秒），默认 30000
   * `AgentSyncInterval`：Agent 配置同步间隔（毫秒），默认 30000
   * `NodeOfflineThreshold`：节点离线判定阈值（毫秒），默认 120000
-  * `AgentAutoUpdate`：是否允许 Agent 自动更新（`true`/`false`），默认 `false`
   * `AgentUpdateRepo`：Agent 自动更新 GitHub 仓库地址，默认 `Rain-kl/ATSFlare`
 * 环境变量类设置（`SESSION_SECRET`、`SQLITE_PATH`、`PORT`）不迁移，保留原有方式
 * 前端在设置页面新增「运维设置」Tab
@@ -364,8 +363,9 @@ Agent 接口当前覆盖：
 * 心跳响应新增 `agent_settings` 字段，包含 Server 端可控的运行时参数：
   * `heartbeat_interval`（毫秒）
   * `sync_interval`（毫秒）
-  * `auto_update`（布尔值）
+  * `auto_update`（节点级布尔值）
   * `update_repo`（GitHub 仓库名）
+  * `update_now`（一次性手动更新指令）
 * Agent 收到心跳响应后，动态调整本地定时器间隔
 * 当 Server 未返回 `agent_settings` 或字段为空时，Agent 保持本地值不变
 * Agent 不持久化 Server 下发的间隔值，重启后以本地 `agent.json` 为准，再由下次心跳覆盖
@@ -378,7 +378,7 @@ Agent 接口当前覆盖：
 
 第三版变更：
 
-* Agent 在收到 `auto_update=true` 时：
+ * Agent 在收到 `auto_update=true` 或 `update_now=true` 时：
   * 通过 GitHub Releases API 查询 `update_repo` 的最新 Release
   * 比较本地 `agent_version` 与远端 tag
   * 若存在更新，下载对应平台的二进制文件
@@ -387,6 +387,8 @@ Agent 接口当前覆盖：
 * 更新过程中不中断当前同步任务
 * 更新失败不影响正常心跳与同步
 * Agent 二进制文件命名约定：`atsflare-agent-{os}-{arch}`
+ * `auto_update` 默认关闭，由节点管理页逐节点开启
+ * `update_now` 由节点管理页手动触发，一次心跳消费一次
 
 ### 11.5 Agent 一键部署
 
@@ -443,13 +445,14 @@ Agent 接口当前覆盖：
   * Agent 心跳间隔
   * Agent 同步间隔
   * 节点离线阈值
-  * Agent 自动更新开关
   * Agent 更新仓库
   * 全局 Discovery Token 展示与重新生成
   * Agent 一键部署命令展示（根据当前 ServerAddress 和 DiscoveryToken 动态生成 curl 命令）
 * 节点列表页优化：
   * 时间显示改为友好的相对时间格式
   * 节点状态使用颜色标识
+  * 支持逐节点开启自动更新
+  * 支持逐节点手动触发一次 Agent 更新
 
 ---
 

docs/development-guidelines.md

@@ -205,7 +205,7 @@ Agent 必须满足：
 V3 新增行为：
 
 * 心跳响应包含 `agent_settings` 时，动态调整定时器间隔
-* `auto_update=true` 时在每次心跳后检查 GitHub Releases 更新
+* `auto_update=true` 或 `update_now=true` 时在每次心跳后检查 GitHub Releases 更新
 * 自我更新失败不影响心跳与同步
 * Server 下发的间隔值不持久化到 `agent.json`，重启后以本地为准
 * Agent 新增 `internal/updater` 模块处理自我更新逻辑

docs/development-plan.md

@@ -53,7 +53,6 @@
    * `AgentHeartbeatInterval`（默认 30000ms）
    * `AgentSyncInterval`（默认 30000ms）
    * `NodeOfflineThreshold`（默认 120000ms）
-   * `AgentAutoUpdate`（默认 false）
    * `AgentUpdateRepo`（默认 `Rain-kl/ATSFlare`）
 2. 在 `model/option.go` 的 `InitOptionMap()` 注册新选项
 3. 在 `model/option.go` 的 `updateOptionMap()` 增加对新选项的同步
@@ -101,13 +100,14 @@
    * 下载对应平台二进制
    * 替换自身并重启（exec syscall）
 2. 在 `runner.go` 心跳循环中集成更新检查
-3. 更新触发条件：`auto_update=true` 且存在新版本
+3. 更新触发条件：节点 `auto_update=true` 或收到一次性 `update_now=true` 且存在新版本
 
 验收标准：
 
 * Agent 能正确检测新版本
 * 能下载并替换自身二进制
 * 更新后自动重启并恢复心跳
+ * 默认不自动更新，需由控制面板逐节点开启或手动触发
 * 更新失败不影响正常运行
 
 ### 3.4 阶段四：GitHub Actions 完善与 Agent 一键部署