Repository navigation
zcode-pilot 0.9.2 · 看护树外启动修复
这个版本解决什么
「按提示完全退出了 ZCode,但增强功能永远注入不上」——Windows 上的看护进程由 SessionStart 钩子直接 Popen 拉起,是 ZCode 进程树的后代;托盘退出时客户端把整棵后代树一起收掉,看护在观测到退出的前一秒就被绞杀(2026-11-12/13 实测两代看护无声消失,日志里只剩「启动待命」一行)。用户无论重退多少次都复现,因为每一代新看护仍挂在树上;历史 5 次成功全靠「启动时客户端本就没跑」的巧合。
修复
- Windows 上看护改由系统计划任务启动(Task Scheduler / svchost 派生,父链与 ZCode 完全无关):注册 → 立即启动 → 删除任务定义,一气呵成,不留任何计划残留;pythonw 起进程无窗口;
- 计划任务不可用(组策略禁用 / 无 PowerShell / 任何异常)时自动降级回原 Popen 方式并在日志标注「树内」——同步成功日志现显示「已启动退出后看护(计划任务·树外)」;
- POSIX 行为不变(start_new_session 本就不受此问题影响);
- 新增 tests/test_watchdog_launch.py(9 项回归),全量 507 项通过。
3.18.2 适配复核
check_client_contract.py 实测 ZCode 3.18.2 契约 42/42 全命中,补丁逻辑零改动——本次故障与客户端结构无关,纯属看护启动方式缺陷。
升级方式:设置 → 插件 → 刷新市场 → 更新,然后完全退出一次(托盘右键 → 退出)。本次修复后,这一次退出,看护才真正活得到写入那一刻。