Releases: Llliao1113/zcode-plus
Release list
v1.3.2 — macOS/Linux 稳定性修复(Windows 无需升级)
本次更新是针对 macOS 与 Linux 平台的稳定性修复,Windows 平台无已知问题,Windows 用户若 v1.3.0/v1.3.1 使用正常,可不升级。
修复内容
macOS(来自 PR#3,真机实测验证)
- 进程检测改用 ps,规避 pgrep 漏检:部分 macOS 机器上
pgrep看不到正在运行的 ZCode 主进程,导致「原版正在运行」被漏检,ZCode+ 直接拉起第二实例、被单实例锁静默弹回,表现为点击 ZCode+.app 无反应。现改用ps精确匹配(basename 兼容裸名与完整路径两种形态),进程杀灭同步改为按 pid 两段杀。 - 两段杀时序修正:原实现 TERM 后立即检查存活,进程来不及退出、几乎必然被强杀,优雅退出形同虚设;现 TERM 后等待 1.5 秒再对幸存者强杀。
- 剥离内联思考链:部分模型/兼容层(如天翼云 GLM 通道)把思考链内联在正文里返回,会被原样回填进输入框。现在出口统一剥离三种形态:
<think>…</think>成对块、兼容层吞掉开标签只剩孤立</think>的形态、思考被截断的未闭合残块;大小写不敏感。 - 网关瞬时故障重试:天翼云等网关有秒级 500 突发(随后自愈),原实现一次失败即报错。现按 1/3/8/15 秒指数退避最多重试 4 次(总耗时约 27 秒,仍在页面 90 秒预算内);5xx(含 HTML 错误页)与 429 限流均纳入重试,4xx 配置错误与域名不存在不重试。
- 新增
test-strip-thinking.mjs单元测试(11 例,零依赖,node test-strip-thinking.mjs直接运行)。
Linux
- 两段杀同款时序修正(与 macOS 一致):TERM 后等待 1.5 秒再检查存活,修复优雅退出被跳过的问题。
致谢
感谢 @showtimewwx(wwx)贡献 PR#3:在 Apple Silicon 真机(ZCode 3.11.2 + v1.3.1)上实测复现并修复了 macOS 进程检测、思考链回填、网关瞬时 5xx 三个问题,提供了进程名原始数据与完整验证记录,并根据 review 意见完善了正则兼容性、HTML 错误页重试与单元测试。这是 ZCode+ 的第二份社区贡献 🙌
安装
- Windows:下载
ZCodePlus-v1.3.2-win-x64.zip,解压后双击「启动 ZCode+.vbs」(或用旧版目录覆盖升级) - Linux/WSL2:下载
ZCodePlus-v1.3.2-linux-x64.tar.gz,解压后运行./install.sh - macOS(beta):下载
ZCodePlus-v1.3.2-macos-arm64-beta.tar.gz,解压后运行./install.sh;若遇 Gatekeeper 拦截,参见 README 排错章节
v1.3.1 — macOS 支持(beta)
新增:macOS 支持(beta)🎉
macOS 版核心链路由 @SimonUTD 在真机上实现并实测(PR#2),本版本正式收录:
- 自动探测 ZCode.app(/Applications、~/Applications、Spotlight 索引),支持直接填 .app 包路径
- Cmd+A 受信全选回填(Lexical 编辑器真机实测有效)
- osascript 原生弹窗、单实例 pid 锁(重复点击只聚焦已运行窗口)
- ZCode+.app 双击入口(LSUIElement 后台型 + 纯 Node 反色 icns 图标),可拖入 Dock
beta 说明:核心注入链路已真机实测,发行包安装链路仍在验证期。遇问题请提 issue 并附安装目录 zcode-plus.log。
macOS 安装(Apple Silicon)
curl -LO https://github.com/Llliao1113/zcode-plus/releases/download/v1.3.1/ZCodePlus-v1.3.1-macos-arm64-beta.tar.gz
tar -xzf ZCodePlus-v1.3.1-macos-arm64-beta.tar.gz
cd ZCodePlus-1.3.1-macos-arm64-beta
./install.sh- 推荐终端 curl 下载:不触发 macOS 隔离属性,无需处理 Gatekeeper
- 浏览器下载若提示「已损坏,无法打开」:
xattr -dr com.apple.quarantine <解压目录>后重试(与 ZCode 官方排错同款) - Intel 机型请暂用源码方式安装(README「macOS:从源码运行」)
其他改进
- WSL2 镜像网络防护扩展到三平台:CDP 附着前按 User-Agent 判别 Windows / Linux / macOS,杜绝跨系统误附着
- mac 进程关闭改用两段杀(先 TERM 正常收尾,仍存活再 KILL)
- README 三平台化(安装 / 原理 / 配置 / 排错全覆盖)
- 构建链三平台化:
node build-exe.mjs一条命令产出 win / linux / macos 三包
致谢
感谢 @SimonUTD 贡献 macOS 支持的实现与真机验证(PR#2)——包括 .app 探测链、osascript 弹窗转义、Cmd+A 受信回填实测、ZCode+.app 应用入口与单实例锁设计。
感谢 LINUX DO 社区的支持与反馈。
安装包:Windows 解压即用(双击「启动 ZCode+.vbs」);Linux / macOS 解压后运行 ./install.sh。均内嵌官方 Node 运行时,用户机器无需安装任何依赖。
ZCode+ v1.3.0
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:
- 下载下方
ZCodePlus-v1.3.0-win-x64.zip,解压到任意目录(推荐%LOCALAPPDATA%\ZCodePlus) - 双击「启动 ZCode+.vbs」;右键它发送到桌面快捷方式获得「ZCode+」独立入口
- 前置:已安装 ZCode 桌面版;无需安装 Node(发行包内嵌官方运行时)
Linux / WSL2:
- 下载下方
ZCodePlus-v1.3.0-linux-x64.tar.gz,解压后进入目录执行./install.sh - 前置:已安装 ZCode 桌面版(Linux deb 等);无需安装 Node(发行包内嵌官方运行时)
从 v1.2.x 升级
Windows 覆盖解压到原目录、Linux 覆盖解压后重跑 install.sh 即可;已保存的页面设置不受影响,重启 ZCode+ 生效。
系统要求
Windows 10/11 或 Linux(WSL2 需 WSLg)+ 对应平台的 ZCode 桌面版(3.11+ 已适配,旧版同样兼容)
社区支持:LINUX DO
ZCode+ v1.2.4
ZCode+ v1.2.4
适配 ZCode 3.11+ 新版输入框(Lexical 编辑器)的写入通道,新增模型思考模式,并修复增强中「点击停止」无效的问题。
修复
增强回填失败(ZCode 3.11+ 适配):ZCode 3.11 起输入框更换为 Lexical 富文本编辑器,旧版写入方式会被编辑器拦截或回滚,点星芒增强后报「输入框未完整接受写入内容」,且可能把重复内容叠进输入框。现在写入改为三级通道:控制器经 CDP 受信输入(Ctrl+A 全选 + 插入,与真实键盘操作等价)优先,合成粘贴与旧路径兜底;写入后轮询等待编辑器异步提交再校验,换行符自动归一化,失败时恢复原草稿。
增强中点击停止无效:增强等待期间再点星芒按钮不会真正停止,转圈直到生成完成并写回。原因是停止句柄被误存为 Promise 对象(其上没有 reject 方法,调用抛出的 TypeError 被静默吞掉)。现在点击停止立即生效:转圈解除、提示「已停止,原文未改动」、输入框不动,且停止后可立刻发起新一轮增强。说明:停止是页面端不再等待,该轮已发出的模型请求仍会在后台完成(用量照常产生,结果被丢弃)。
新增
- 模型思考模式:设置面板新增开关与强度选择(低/中/高),自动与手动连接均生效。按协议注入参数:Chat Completions 发
reasoning_effort(GLM 系列同步显式开关thinking);Responses 发reasoning.effort;Anthropic Messages 发thinking+ 预算 token(2048/8192/16000)。GLM 系列关闭思考时会显式发送 disabled(GLM 思考默认开启) - 表单实时拉取模型:设置面板填好 Base URL / API Key 后,无需先点保存,「拉取模型」「测试连接」直接按表单当前值请求;拉取模型不再要求预填模型名(原本不填模型会报错,与「用列表选模型」的用途冲突)
内部改进
- 版本号单一来源:版本只在一处定义,构建时自动解析并校验,杜绝版本显示滞后
- 「测试连接」在未填模型名时也能验证连通性并显示目录模型数量
安装
- 下载下方
ZCodePlus-v1.2.4.zip,解压到任意目录(推荐%LOCALAPPDATA%\ZCodePlus) - 双击「启动 ZCode+.vbs」;右键它发送到桌面快捷方式获得「ZCode+」独立入口
- 前置:已安装 ZCode 桌面版;无需安装 Node(发行包内嵌官方运行时)
从 v1.2.1 / v1.2.0 升级
覆盖解压到原目录即可(已保存的页面设置不受影响),重启 ZCode+ 生效。已保存设置会自动补上新增的思考模式字段(默认关闭)。
系统要求
Windows 10/11 + ZCode 桌面版(3.11+ 已适配,旧版同样兼容)
社区支持:LINUX DO
v1.2.1
ZCode+ v1.2.1
修复启动时「未找到 ZCode.exe」的探测缺陷,并新增手动配置 ZCode 路径能力。
修复
路径探测硬编码问题:v1.2.0 的探测列表只含作者本机的三个固定路径,其他机器无论把 ZCode+ 放在哪都会报错。现在按以下顺序自动探测:
- ZCode+ 所在目录及逐级向上(可直接放进 ZCode 安装目录)
- 各盘符根下
zcode目录(如E:\zcode) - Windows 标准安装位置(Program Files / 用户级 Programs)
- 系统 PATH
- 拉起 ZCode 失败时给出带原因的明确弹窗(原为静默超时)
新增
- 默认配置文件:首次运行自动在 ZCode+ 目录生成
zcode-plus-config.json(含中文说明),探测失败时弹窗引导填写zcodePath,可一键用记事本打开编辑、保存后自动重试 - 环境变量
ZCODE_PLUS_ZCODE_PATH亦可指定路径;配置了路径但无效时明确报错,不静默回退
安装
- 下载下方
ZCodePlus-v1.2.1.zip,解压到任意目录(推荐%LOCALAPPDATA%\ZCodePlus) - 双击「启动 ZCode+.vbs」;右键它发送到桌面快捷方式获得「ZCode+」独立入口
- 前置:已安装 ZCode 桌面版;无需安装 Node(发行包内嵌官方运行时)
从 v1.2.0 升级
覆盖解压到原目录即可(已保存的页面设置不受影响);若之前因「未找到 ZCode.exe」无法启动,本版本开箱即用,或在 zcode-plus-config.json 中填 "zcodePath": "E:/zcode/ZCode.exe"(示例,正斜杠写法)。
系统要求
Windows 10/11 + ZCode 桌面版
社区支持:LINUX DO
v1.2.0
ZCode+ v1.2.0
为 ZCode 桌面版注入一键式提示词增强:输入框旁星芒按钮 → 草稿发给模型改写 → 回填 → 撤销。
功能
- 三种增强模式:WorkBuddy 原版(简洁)/ 创意增强(充分展开)/ 自定义模板(
{input}占位符) - 自动跟随 ZCode 当前模型(用户级 + 工作区级 provider 池,自定义请求头透传);也可手动配置 OpenAI 兼容 / Anthropic 服务
- 撤销恢复原文(不请求模型);右键按钮打开设置(模式、连接、诊断)
- 凭据仅存控制器内存,不写盘、不进日志、不回传页面
- 原版 ZCode 快捷方式不受影响;调试端口默认 9333,占用自动顺延
安装
- 下载下方
ZCodePlus-v1.2.0.zip,解压到任意目录(推荐%LOCALAPPDATA%\ZCodePlus) - 双击「启动 ZCode+.vbs」;右键它发送到桌面快捷方式获得「ZCode+」独立入口
- 前置:已安装 ZCode 桌面版;无需安装 Node(发行包内嵌官方运行时)
系统要求
Windows 10/11 + ZCode 桌面版
社区支持:LINUX DO