Skip to content

ZCode+ v1.3.0

Choose a tag to compare

View all tags
@Llliao1113 Llliao1113 released this 09 Sep 02:34
· 10 commits to master since this release
v1.3.0
cae19df

ZCode+ v1.3.0

首个双平台版本：新增 Linux / WSL2 支持，并修复三个实测反馈问题（自动模式 401 报错含糊、模型拉取失败无降级、设置面板交叉污染）。

新增

Linux / WSL2 支持：

  • 发行包 linux-x64.tar.gz，解压后执行 ./install.sh 安装到 ~/.local/share/ZCodePlus 并注册应用入口（WSLg 环境下「ZCode+」会自动出现在 Windows 开始菜单）；也可 ./zcode-plus.sh 直接前台运行
  • 自动探测 Linux 版 ZCode（PATH、/opt/ZCode/zcode 等标准位置）；探测失败按提示在 zcode-plus-config.json 手动填 zcodePath
  • WSL2 镜像网络（networkingMode=mirrored）下两侧 127.0.0.1 互通：控制器按平台判别只附着本侧实例，Windows 与 Linux 同时启动互不干扰；调试端口冲突时自动顺延（9334-9350）

修复

自动模式 401 报错含糊：实测确认 ZCode 内置订阅网关存在反自动化限制，会拒绝第三方程序直连（返回 captcha 3007）。这属于服务端行为，客户端无法绕过。现在该错误会翻译为明确指引：建议在设置面板改用手动模式（自备 API Key 直连模型服务）。

模型拉取 / 测试连接失败无降级：/models 接口不可用或返回错误结构时，自动模式自动回退内置本地模型清单（功能继续可用），手动模式给出明确报错，不再直接失败。

设置面板交叉污染（三处）：

  • 拉取模型列表后，点击模型输入框会正常弹出下拉候选（此前受控组件状态未同步，下拉不出现）
  • 打开面板读取已存配置时不再错误回填「协议」字段
  • 从自动模式切到手动模式时，清空自动配置抄来的 Base URL 与模型名，避免拿旧值去请求

内部改进

  • 双平台构建链：一条构建命令同时产出 Windows zip 与 Linux tar.gz（Linux 部分自动委托 WSL，组装在 ext4 完成后打包，规避 9P 文件系统丢失执行位）
  • Linux 进程形态适配：僵尸进程过滤防止「原版在运行」误判，进程名精确匹配大小写两种形态

安装

Windows：

  1. 下载下方 ZCodePlus-v1.3.0-win-x64.zip，解压到任意目录（推荐 %LOCALAPPDATA%\ZCodePlus）
  2. 双击「启动 ZCode+.vbs」；右键它发送到桌面快捷方式获得「ZCode+」独立入口
  3. 前置：已安装 ZCode 桌面版；无需安装 Node（发行包内嵌官方运行时）

Linux / WSL2：

  1. 下载下方 ZCodePlus-v1.3.0-linux-x64.tar.gz，解压后进入目录执行 ./install.sh
  2. 前置：已安装 ZCode 桌面版（Linux deb 等）；无需安装 Node（发行包内嵌官方运行时）

从 v1.2.x 升级

Windows 覆盖解压到原目录、Linux 覆盖解压后重跑 install.sh 即可；已保存的页面设置不受影响，重启 ZCode+ 生效。

系统要求

Windows 10/11 或 Linux（WSL2 需 WSLg）+ 对应平台的 ZCode 桌面版（3.11+ 已适配，旧版同样兼容）

社区支持：LINUX DO

Assets 4
Loading