Repository navigation
Releases
Releases · MUHUIX/Zcode-Tools
zcode-pilot 0.9.3 · 新对话可切自动继续;看护心跳单例根治换机失效
zcode-pilot 0.9.3
自动继续体验
- 新对话未发消息也能直接切「自动继续」:draft 态照常切换,意图先暂存,发出首条消息、正式会话建立后自动带入(10s 证据窗口双重防误写,切去看别的对话绝不误伤);
- 输入框开关右侧的状态文字移除,语义由轨道配色、悬停提示与读屏标签承载;
- 失败轮兜底更可靠:暂时性拒绝(如 still-streaming)改为延迟重判,官方重试耗尽后的轮次不再被误放弃。
看护(无感自愈)加固 —— 根治「换台电脑,完全退出也不注入」
- 两段式启动:计划任务点火后必须确认看护进程真的现身(心跳确认),pythonw 被杀软拦截 / Store Python 别名损坏等「无声失败」不再被当成成功;
- 三级兜底:PowerShell →
schtasks.exe直接点火(绕开 PowerShell 依赖与受限语言模式)→ Popen(留痕); - 心跳单例:
~/.zcode/pilot/watchdog.beat成为「看护是否在跑」的唯一事实源,防 Windows PID 复用把无关进程当成看护、导致看护永不重拉;双看护竞态由心跳裁决自动让位; - 钩子 Python 发现链加宽:
python → python3 → py -3(Windows 官方安装器的 py launcher 未进 PATH 的机器也能接住); zcp_doctor.py增强:直接报告「最近一次看护拉起方式」与「看护是否在跑(心跳确认)」;--fix清理陈旧锁改心跳口径。
排查指引(换电脑不生效时)
按 README「方案 C」:更新插件后先开新会话发条消息、再完全退出;仍不生效跑 --fix 单行自愈命令,看输出里「拉起方式」与「心跳确认」两行即可定位。
验证:全量回归 520 项通过;真机实测「PowerShell 点火 → 心跳确认 → 计划任务·树外」全链路落地。
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 全命中,补丁逻辑零改动——本次故障与客户端结构无关,纯属看护启动方式缺陷。
升级方式:设置 → 插件 → 刷新市场 → 更新,然后完全退出一次(托盘右键 → 退出)。本次修复后,这一次退出,看护才真正活得到写入那一刻。
zcode-pilot 0.9.0 · 适配 ZCode 3.18.0
zcode-pilot 0.9.0
本次为 ZCode 3.18.0 适配版,同时完成脚本与注入变量的命名去重。
适配 ZCode 3.18.0
- 复核并实测:asar 注入锚点、渲染层
data-testid、DOM 契约(data-workspace-conversation-frame/data-session-id/data-turn-id/data-settings-*)与遥测字段(turnHeader.*DurationMs、usage.delta)全部命中; - 八项补丁在 3.18.0 上重新注入全部成功,用量图两条补丁按弹性正则正常落位。
自动再注入
- 客户端升级:下次会话启动用指纹(版本 + asar 大小)识别 → 重打包补丁整批排给看护 → 完全退出一次即写入并自动拉起;
- 插件市场更新:退出瞬间比对注入版本,直接用新版目录的脚本重写
app.asar; - 新增回归测试,锁死「升级后整批排期 + 待重注入标记」;看护入口兼容新旧两种脚本名。
命名去重(zcp 前缀)
zcp_patcher/zcp_sync/zcp_doctor/zcp_watchdog/zcp_hook/zcp_loopguard/zcp_modelpull/zcp_probe/zcp_tap/zcp_restore/zcp_polish_doctor/zcp_console;- 仓根入口:
zcp_bootstrap.py/zcp_pipeline.py/zcp-run.sh/zcp-run.cmd; sync.py、doctor.py保留转发壳,保证 0.8.x 旧看护在升级当次仍能找到新版入口;- 注入脚本全局变量改为
__zcpMeter*/__zcpPolish*/__zcpCore*,模型拉取样式前缀改为zcp-pull-*。
升级方式
在 ZCode「设置 → 插件」刷新市场,看到「有更新」后点更新;随后完全退出一次(托盘右键 → 退出),等看护自动拉起即可。
498 项单元/集成测试与
zcp_pipeline.py --no-deploy全绿。