[Bug] ZCode 3.5.3 在无 GPU 的 Windows 服务器上渲染进程启动崩溃 (exit code 18)
Nobody has claimed this yet.
- Dominant language
- No language data
- Stars
- 22
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
提交前确认 · Pre-submission checklist
- 我已搜索过现有 issue,确认这不是重复 / I searched existing issues and confirmed this isn't a duplicate.
- 我已阅读 CONTRIBUTING.md / I've read CONTRIBUTING.md.
问题类别 · 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
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the attached 2026-07-28.log and compare the renderer launch failure on Windows Server 2019 with the listed startup flags. Then trace how desktopChromiumHardwareAccelerationEnabled and the GPU-related flags are handled during startup. Done means ZCode launches on a GPU-less Windows server without requiring the manual workaround.
Written by the indexing model from the issue text.
Assessment
- Domain
- desktop, operating-systems
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100