update-management

name	update-management
description	自更新管理：检查更新状态、执行更新、选择更新通道与更新向导。当需要更新 Crab Claw 版本、切换更新通道或查看更新状态时使用此技能。
tools	gateway
metadata	{"category":"operations","emoji":"⬆️","tree_id":"system/gateway","tree_group":"system","min_tier":"task_write","intent_priority":15,"intent_keywords":{"zh":["更新","检查更新","升级版本","自动更新","更新通道","beta版本","稳定版","nightly","升级","新版本"],"en":["update","check update","upgrade","update channel","beta","stable","nightly"]},"scene_hint":"更新Crab Claw版本/切换通道用此→修改其他系统配置用system-config→更新失败排查用doctor-diagnostics"}

自更新管理技能

适用场景

用户需要更新 Crab Claw 到新版本、查看更新状态或切换更新通道时触发。

选择原则

场景	工具/技能
更新 Crab Claw 本体	本技能
修改系统配置	→ system-config
系统诊断（含更新检查）	→ doctor-diagnostics

一、检查更新状态

crabclaw update status

返回：

• 当前版本
• 最新可用版本
• 当前更新通道
• 上次检查时间
• 是否有可用更新

二、执行更新

2.1 标准更新

crabclaw update run

更新到当前通道的最新版本，完成后自动重启 Gateway 服务。

2.2 指定通道更新

crabclaw update run --channel <channel>

通道	说明
stable	稳定版（默认），经过充分测试
beta	测试版，包含新功能，可能有边缘问题
nightly	每日构建，最新但最不稳定

2.3 不重启更新

crabclaw update run --no-restart

更新文件但不重启 Gateway，适用于手动控制重启时机的场景。

三、更新向导

crabclaw update wizard

交互式向导，引导用户：

1. 查看当前版本与可用更新
2. 选择更新通道
3. 确认更新内容
4. 执行更新并显示变更日志

四、通过 Gateway RPC 触发更新

gateway(action="update.run")

与 CLI update run 等效，通过 Gateway RPC 触发更新流程。

五、更新注意事项

1. 活跃会话：更新会重启 Gateway，活跃会话会中断。建议在无活跃会话时更新
2. Daemon 服务：如果 Gateway 以 daemon 方式运行，更新后会自动重启 daemon
3. 桌面应用：桌面端有独立的更新机制（应用内更新提示），但 Gateway 组件仍通过此命令更新
4. 回退：当前不支持版本回退。如更新后出现问题，建议 crabclaw doctor --repair

六、CLI 命令对照

CLI 命令	说明
crabclaw update status	查看更新状态
crabclaw update run	执行更新
crabclaw update run --channel beta	切换到 beta 通道更新
crabclaw update run --no-restart	更新但不重启
crabclaw update wizard	交互式更新向导