Skip to content

ZCode Plugins · common 0.6.0 · 网关升级忙退避与幂等锁

Choose a tag to compare

@ONEGAYI ONEGAYI released this 21 Oct 03:34
f212553

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 修复

  • 网关透传任务导航:未登记工作区的会话恢复附着与打开(#133)
  • 网关关闭幂等化;升级关闭失败分支先重探再判超时,瞬断后等待收尾(PR #138 审查修复)

其他改进

  • 规格 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)仍需等待连接断开的保守窗口。