zai-org / zai-org/feedback

[Bug] ZCode 3.5.3 在无 GPU 的 Windows 服务器上渲染进程启动崩溃 (exit code 18)

Open
#196 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

priority: P2 status: 待评估 type: Bug
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

复现步骤

  1. 在无 GPU 的 Windows 服务器上安装 ZCode 3.5.3
  2. 启动 ZCode
  3. 程序启动后窗口无法显示,渲染进程立即崩溃退出

日志关键错误(每次启动必现)

复现步骤 · Steps to reproduce

exit code 18 + launch-failed 出现在渲染进程,结合无 GPU 环境,高度怀疑是 Chromium GPU 进程初始化失败导致渲染进程无法启动。

已尝试的临时解决方案

  1. ❌ 关闭硬件加速(修改 setting.json 中 desktopChromiumHardwareAccelerationEnabled = false)—— 无效
  2. ❌ 启动参数 --disable-gpu --disable-software-rasterizer --in-process-gpu —— 无效
  3. 启动参数 --disable-gpu --disable-gpu-compositing --disable-software-rasterizer --no-sandbox —— 可正常启动

禁用 GPU 合成 + 沙箱后才能启动,说明问题与 Chromium GPU 合成 / 沙箱在无 GPU 环境下的初始化有关。

期望表现 · Expected behavior

在无 GPU 的服务器环境下,ZCode 应自动检测并回退到纯软件渲染,而不是渲染进程崩溃导致无法启动。建议:

  1. 检测到无 GPU / 服务器环境时,自动启用软件渲染回退
  2. 或在 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

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.