Repository navigation
ZCode Plugins · common 0.6.0 · 网关升级忙退避与幂等锁
common 0.6.0 - 2026-10-21
本版本主线:网关升级从"要求用户手动暂停远控"演进为忙时自动退避、空闲闪断切换、事务幂等防重入(GUL 系列 #134–#137),另修复网关任务导航透传。
新功能
网关升级忙退避与空闲闪断(#136)
- Restart/Remove 在远控忙时自动指数退避重探(2 秒起步、15 秒封顶、默认 60 秒上限,
-BusyTimeoutSec可调),不再要求手动暂停远控 - V2 协议下连接空闲(无飞行操作)即闪断升级:Desktop V2 连接层自动重连并重放未确认请求,等价于一次网络抖动
- 超时仍忙则放弃本次切换并输出
remote_busy,旧服务保留、配置与任务不动,稍后重试即可 - 旧网关(健康无
rpc_in_flight字段)或 V1 协议保守等待连接断开,不对 V1 Desktop 误发闪断
升级空闲信号与关闭端点(#134)
/health新增rpc_in_flight:请求在飞计数,含建桥等待与手机远端透传保守占忙;订阅与纯连接不计/shutdown?idle=1升级关闭:Desktop 在连但无飞行操作时放行,忙时 409;旧关闭语义不变
切换事务幂等锁(#135)
upgrade.lock独占句柄锁覆盖切换全程(含共享启动器写入),并发安装拿锁失败即明确报错(含持锁 pid)且不动任何文件- 持锁进程崩溃或被杀由系统自动释放,无需陈旧清理
Bug 修复
其他改进
- 规格 7.2、仓库约定、安装技能与 README 端点表同步升级新语义(#137)
附带说明
- title 0.2.0、app-mcp 0.11.0 输入未变复用原字节
- editor 0.4.0 仅 release.json 的最低公共版本声明联动至 0.6.0,业务行为零变化
⚠️ 升级注意:手机 App 断线重连表现为外部行为,首次真实升级时建议观察远控会话恢复;V1 协议(3.16 前 Desktop)仍需等待连接断开的保守窗口。