提交前确认 · Pre-submission checklist
问题类别 · Category
UI / 界面体验 · UI / UX
涉及的 Agent 框架 · Agent framework
ZCode Agent(自研)
严重程度 · Severity
阻塞使用 · Blocking (无法使用核心功能 / core function unusable)
复现频率 · Reproducibility
必现 · Always
问题描述 · Description
问题描述
ZCode 桌面端从 3.4.x 自动升级到 3.5.3 后,在无独立显卡的 Windows 服务器上无法启动,渲染进程启动即崩溃,程序随后退出。每次自动升级后都会复现此问题。
环境
- OS: Windows Server (无独立显卡 / 无 GPU)
- ZCode 版本: 3.5.3(从 3.4.0 / 3.4.1 自动升级而来)
- 安装路径: D:\Program Files\ZCode
- 配置: desktopChromiumHardwareAccelerationEnabled = true
复现步骤
- 在无 GPU 的 Windows 服务器上安装 ZCode 3.5.3
- 启动 ZCode
- 程序启动后窗口无法显示,渲染进程立即崩溃退出
日志关键错误(每次启动必现)
复现步骤 · Steps to reproduce
exit code 18 + launch-failed 出现在渲染进程,结合无 GPU 环境,高度怀疑是 Chromium GPU 进程初始化失败导致渲染进程无法启动。
已尝试的临时解决方案
- ❌ 关闭硬件加速(修改 setting.json 中
desktopChromiumHardwareAccelerationEnabled = false)—— 无效
- ❌ 启动参数
--disable-gpu --disable-software-rasterizer --in-process-gpu —— 无效
- ✅ 启动参数
--disable-gpu --disable-gpu-compositing --disable-software-rasterizer --no-sandbox —— 可正常启动
禁用 GPU 合成 + 沙箱后才能启动,说明问题与 Chromium GPU 合成 / 沙箱在无 GPU 环境下的初始化有关。
期望表现 · Expected behavior
在无 GPU 的服务器环境下,ZCode 应自动检测并回退到纯软件渲染,而不是渲染进程崩溃导致无法启动。建议:
- 检测到无 GPU / 服务器环境时,自动启用软件渲染回退
- 或在
desktopChromiumHardwareAccelerationEnabled = false 时,连带禁用 GPU 合成和沙箱(目前单独设为 false 不生效)
实际表现 · Actual behavior
所有在无显卡 Windows 服务器上部署 ZCode 的用户,升级到 3.5.3 后将完全无法使用。
ZCode 版本 · ZCode version
3.5.3
设备 / 系统 / 浏览器 · Device / OS / Browser
windows server 2019
截图 / 录屏 / 日志 · Screenshots / Recordings / Logs
2026-07-28.log
提交前确认 · Pre-submission checklist
问题类别 · Category
UI / 界面体验 · UI / UX
涉及的 Agent 框架 · Agent framework
ZCode Agent(自研)
严重程度 · Severity
阻塞使用 · Blocking (无法使用核心功能 / core function unusable)
复现频率 · Reproducibility
必现 · Always
问题描述 · Description
问题描述
ZCode 桌面端从 3.4.x 自动升级到 3.5.3 后,在无独立显卡的 Windows 服务器上无法启动,渲染进程启动即崩溃,程序随后退出。每次自动升级后都会复现此问题。
环境
复现步骤
日志关键错误(每次启动必现)
复现步骤 · Steps to reproduce
exit code 18+launch-failed出现在渲染进程,结合无 GPU 环境,高度怀疑是 Chromium GPU 进程初始化失败导致渲染进程无法启动。已尝试的临时解决方案
desktopChromiumHardwareAccelerationEnabled = false)—— 无效--disable-gpu --disable-software-rasterizer --in-process-gpu—— 无效--disable-gpu --disable-gpu-compositing --disable-software-rasterizer --no-sandbox—— 可正常启动禁用 GPU 合成 + 沙箱后才能启动,说明问题与 Chromium GPU 合成 / 沙箱在无 GPU 环境下的初始化有关。
期望表现 · Expected behavior
在无 GPU 的服务器环境下,ZCode 应自动检测并回退到纯软件渲染,而不是渲染进程崩溃导致无法启动。建议:
desktopChromiumHardwareAccelerationEnabled = false时,连带禁用 GPU 合成和沙箱(目前单独设为 false 不生效)实际表现 · Actual behavior
所有在无显卡 Windows 服务器上部署 ZCode 的用户,升级到 3.5.3 后将完全无法使用。
ZCode 版本 · ZCode version
3.5.3
设备 / 系统 / 浏览器 · Device / OS / Browser
windows server 2019
截图 / 录屏 / 日志 · Screenshots / Recordings / Logs
2026-07-28.log