oasx启动白屏

[wao3427]

在提问之前...

• 我已经搜索了现有的 issues
• 我在提问题之前至少花费了 5 分钟来思考和准备
• 我已经阅读了文档中的 常见问题(FAQ)
• 这个问题出现了至少三次，不是偶发的
• 我使用 OAS 的 dev 分支

描述你的问题

oasx启动白屏，已经尝试重新解压一份 群友提供的思路 删除GetStorage.bak GetStorage.gs两个文件 但启动oasx的时候又会生成这两份文件同时白屏 后续又尝试设置只读这俩文件（oasx无法启动）、 新建空白的这俩文件（启动白屏）管理员启动白屏都无法解决 网页版正常使用

如何复现

1. 前往 '...' 自己电脑上是稳定双击启动复现 群友表示正常
2. 点击 '....'
3. 滑动到 '....'
4. 出现问题

预期行为

No response

相关 Logs

报错时游戏的截图/别的截图

No response

还有别的吗？

No response

[github-actions]

当前还不能继续做有效的 bug 定位,原因是 issue 关键信息不完整,尤其是 相关 Logs 为空。按仓库的 bug 处理流程,没有日志时无法建立可靠证据链,也无法区分是 OASX 本体启动异常、配置损坏、运行环境依赖缺失,还是本地存储文件读写异常。

请补充以下信息:

检查项	预期	实际	结果
搜索确认	应勾选	已勾选	PASS
5分钟思考	应勾选	已勾选	PASS
阅读FAQ	应勾选	已勾选	PASS
描述信息	不能为空	已填写	PASS
重现步骤	不能为空	已填写,但较粗略	PASS
日志	必须有文本内容	为空	FAIL
截图	建议有	未提供	FAIL

请至少补充:

1. 相关 Logs 中的文本日志,尤其是 oasx 启动时控制台/窗口日志、logs/ 目录下最近一次启动相关日志。
2. 如果有报错弹窗,请附上完整报错文本。
3. 如果有白屏截图,也请一并上传。
4. 补充你的系统环境信息,例如 Windows 版本、是否安装过 WebView2、是否开启过代理/安全软件拦截。

目前基于你提供的信息,只能初步判断问题范围更偏向 oasx 启动环境或本地存储初始化,而不是具体 tasks/ 脚本逻辑问题。

补充信息后请Close issue 然后Reopen issue重新触发机器人运行。

Warning

Firewall blocked 2 domains

The following domains were blocked by the firewall during workflow execution:

• api.github.com
• github.com

[!TIP]
api.github.com is blocked because GitHub API access uses the built-in GitHub tools by default. Instead of adding api.github.com to network.allowed, use tools.github.mode: gh-proxy for direct pre-authenticated GitHub CLI access without requiring network access to api.github.com:

tools:
  github:
    mode: gh-proxy

See GitHub Tools for more information on gh-proxy mode.

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "api.github.com"
    - "github.com"

See Network Configuration for more information.

Generated by Issue Handle Bug for issue #1656 · 20.8 AIC · ⌖ 3.33 AIC · ⊞ 18.1K · ◷

[wao3427]

════════════════════════════════════════════════════════════════════════════════
──────────────────────────────────── START ─────────────────────────────────────
════════════════════════════════════════════════════════════════════════════════
2026-06-29 21:08:05.192 | logger.py:0312 | INFO | <<< LAUNCHER CONFIG >>>
2026-06-29 21:08:05.195 | logger.py:0320 | INFO | [Host] 0.0.0.0
2026-06-29 21:08:05.198 | logger.py:0320 | INFO | [Port] 22267
2026-06-29 21:08:05.200 | logger.py:0320 | INFO | [Reload] False
2026-06-29 21:08:06.868 | app.py:0058 | INFO | OAS web service startup done

这是运行时候的日志 未开启代理工具 未安装过 WebView2 电脑未win11

[github-actions]

Issue 概要

dev 分支下,oasx 双击启动后出现白屏,但内置网页服务本身已经正常启动,因此问题范围更接近桌面 GUI 渲染/资源加载层,而不是 tasks/ 脚本逻辑。

关键证据链

点击此处展开

观察1: 你补充的日志里只有启动器配置和 OAS web service startup done,没有 Python traceback,也没有服务启动失败信息。
→ 推论1: 后端 FastAPI 服务已经成功启动,问题不在 server 启动阶段。

观察2: 仓库中服务启动成功日志来自 module/server/app.py 的 on_startup(),对应代码只表示 Web 服务初始化完成。
→ 推论2: 既然该日志已经出现,说明 oasx 白屏时,至少服务端主流程没有卡死。

观察3: gui.py 启动的是 module.gui.fluent_app.FluentApp(),其底层使用的是 PySide6 + QQmlApplicationEngine 加载 module/gui/qml/app.qml,不是浏览器 WebView2 架构。
→ 推论3: 这次问题和“未安装 WebView2”并不吻合,更像是 Qt/QML 桌面界面自身没有正确渲染出来。

观察4: 仓库内没有直接读写 GetStorage.bak / GetStorage.gs 的 Python 代码,且相关文件名没有出现在 tasks/、module/server/、module/gui/ 代码搜索结果中。
→ 推论4: 这两个文件更像是 GUI 层或其依赖组件生成的本地存储文件,删除它们并不能触及真正的故障点,只是在重复触发初始化流程。

观察5: 用户反馈“网页版正常使用”。
→ 推论5: 说明 OAS 后端接口与基本业务逻辑大概率是可用的,故障集中在桌面壳 oasx,而不是脚本任务本身。

观察6: 当前 issue 和评论里仍缺少 GUI 启动期的 Qt/QML 报错日志、白屏窗口截图、以及系统图形环境细节。
→ 推论6: 目前可以把范围稳定收敛到 module/gui,但证据还不足以把根因进一步锁死到某个 QML 资源、FluentUI 插件、字体/显卡兼容、或 Qt 平台插件加载失败。

结论: 现阶段最可信的判断是 oasx 桌面 GUI 层启动后未正常渲染,后端服务正常;属于 module/gui 范围,需要进一步补 Qt/QML 侧日志来确认单点根因。

最终 bug 原因

• 直接结论:当前更可能是 module/gui 下的 PySide6/QML/FluentUI 桌面界面初始化或渲染异常,导致窗口白屏;不是 tasks/ 任务代码问题,也不是后端服务没有起来。
• 证据链:补充日志已显示 OAS web service startup done;gui.py 走的是 PySide6 + QQmlApplicationEngine 加载本地 QML;网页版正常可用;仓库内没有 GetStorage.* 的直接 Python 读写点。

给用户的建议

• 用户现在可以直接尝试的动作:
  1. 从命令行启动 oasx,不要双击,保留控制台窗口,抓取白屏当下的完整报错文本,尤其是 QML、module "FluentUI"、plugin、Qt platform、failed to load component 这类信息。
  2. 补一张白屏窗口截图,最好能包含窗口标题栏和是否有局部控件渲染出来。
  3. 补充系统信息:Windows 具体版本、显卡型号、是否远程桌面/云电脑环境、系统缩放比例。
  4. 如果方便,尝试在终端中直接运行 python gui.py,看是否会打印 QML/Qt 的加载错误。
• 是否建议升级 / 重下完整包 / 同步资源 / 重置配置:单纯删除 GetStorage.bak / GetStorage.gs 目前看不是有效修复路径;可以保留“重下完整包”作为排除资源损坏的辅助手段,但不是当前最强结论。
• 是否需要等待开发者修复:如果后续补出的 Qt/QML 报错指向 FluentUI 插件、QML 资源或 PySide6 兼容问题,则需要开发者处理。
• 是否有临时绕过方案:当前可继续使用网页版,因为现有证据表明服务端功能是正常的。

给开发者的修复方案

点击此处展开

• 代码 / 资源 / 配置层修复:
  1. 在 module/gui/fluent_app.py 的 QQmlApplicationEngine 上补充 warnings/objectCreationFailed 类日志输出,把 engine.load(...) 失败时的 QML 报错落盘,而不是仅 sys.exit(-1)。
  2. 检查 module/gui/FluentUI/fluentuiplugin.dll、qmldir、字体资源、res_rcc 与运行目录之间的相对路径依赖,确认 dev 分支打包产物是否完整。
  3. 评估是否在 GUI 启动前加入对关键依赖的自检,例如 PySide6、QML plugin、资源文件完整性检查,避免用户只看到白屏。
  4. 若 GetStorage.* 实际来自 GUI 前端依赖,可在启动日志里把该存储初始化异常单独打印出来,避免用户误判为配置文件损坏。
• 需要补充的日志或截图:Qt/QML 控制台报错、白屏截图、系统图形环境信息。
• 需要补充的测试:
  1. 在干净 Windows 环境验证 dev 分支 GUI 首次启动。
  2. 覆盖缺失/损坏 QML 资源、FluentUI 插件缺失、显卡渲染异常时的错误提示是否可见。

---

分支: dev
代码范围: module/gui
相关类似 Issue: 暂未检索到可以直接判定为同一根因的开放 issue

Warning

Firewall blocked 2 domains

The following domains were blocked by the firewall during workflow execution:

• api.github.com
• github.com

[!TIP]
api.github.com is blocked because GitHub API access uses the built-in GitHub tools by default. Instead of adding api.github.com to network.allowed, use tools.github.mode: gh-proxy for direct pre-authenticated GitHub CLI access without requiring network access to api.github.com:

tools:
  github:
    mode: gh-proxy

See GitHub Tools for more information on gh-proxy mode.

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "api.github.com"
    - "github.com"

See Network Configuration for more information.

Generated by Issue Handle Bug for issue #1656 · 105.5 AIC · ⌖ 5.53 AIC · ⊞ 18.1K · ◷