新版zcode启动失败的修复方法

新版zcode升级后，有些用户会出现软件无法打开的问题，提示报错无法完成启动准备。然后用codex修好后，写了个简单的文档。有出现这个问题的佬可以粘贴给codex或者workbuddy来修复一下。

ZCode 启动报 unsupported_runtime 的修复说明

原因：电脑中残留了旧版 zcode-keysmith 的环境变量。新版 ZCode 启动时需要使用内置运行时初始化本地会话存储，但旧代理不兼容，导致启动失败。

修复步骤：

1. 
   

   将 ZCode 升级到最新版。

   
   


2. 
   

   打开“编辑账户的环境变量”。

   
   


3. 
   

   在“用户变量”中删除以下两项：

   
   
   
   
   • ZCODE_AGENT_SERVER_COMMAND
   
   
   • ZCODE_AGENT_SERVER_ARGS_JSON
   
   
   
   


4. 
   

   重启 ZCode；若仍未生效，注销 Windows 或重启电脑后再启动。

   
   

注意：不要删除 C:\Users\用户名\.zcode 文件夹，否则可能丢失 ZCode 的配置、会话和本地索引。