# 流放之路：降临 — 卡顿问题反馈

---

## 用户环境

| 项目 | 详情 |
|------|------|
| 操作系统 | Windows 11 24H2 64-bit（Build 26100） |
| 显卡 | Intel Arc A770 Graphics (16GB VRAM) |
| 显卡驱动 | 32.0.101.8826（2026-05-29） |
| 渲染器 | Direct3D 12 |
| 游戏版本 | poe2_production_tc / tags/4.5.3 |
| 引擎版本 | 2.8.0 (Build Revision 312717) |
| 游戏平台 | WeGame |

---

## 故障现象

游戏全程存在明显卡顿，具体表现为：

1. **启动卡顿**：每次启动进入游戏后持续数分钟的周期性卡顿（Shader 编译卡顿 Stutter）
2. **场景切换卡顿**：切换地图、进入新场景时瞬时掉帧
3. **UI 延迟**：打开背包、技能树、商城等 UI 面板时有明显加载延迟
4. **大规模战斗掉帧**：大量怪物/特效场景帧率骤降
5. **内嵌浏览器异常**：游戏内商城、bilibili 等内置页面加载极慢或无法正常使用

---

## 根因分析（3 个核心故障点）

### 故障点 1 [严重] Chromium CEF GPU 缓存创建失败 + GPU 进程连锁崩溃

**日志证据**（`qbclient64/debug.log`，每次启动稳定复现）：

```
cache_util_win.cc(20) → Unable to move the cache: 拒绝访问。 (0x5)
disk_cache.cc(205) → Unable to create cache
gpu_disk_cache.cc(673) → Gpu Cache Creation failed: -2
gpu_process_host.cc(991) → GPU process exited unexpectedly: exit_code=1073807364
network_service_instance_impl.cc(539) → Network service crashed, restarting service.
```

**故障说明**：游戏内嵌 Chromium/CEF 浏览器尝试在 `%LOCALAPPDATA%` 下创建 GPU 磁盘缓存时遭遇文件权限错误（拒绝访问 0x5），导致 GPU 进程异常退出，GPU 加速渲染完全回退到软件模式。GPU 进程崩溃后触发 Network Service 连锁崩溃，内嵌浏览器功能几乎瘫痪。

**与 Arc 驱动的关联**：此问题与 Intel Arc A770 驱动（32.0.101.8826）的 CEF 缓存路径兼容性相关，属于稳定复现的 Bug。

**建议修复**：
- 启动时检查并修复 `%LOCALAPPDATA%` 下 qbclient64 缓存目录的 NTFS 权限
- 或添加 `--disable-gpu-cache` 启动参数改用内存缓存以临时规避
- 升级 CEF 版本以修复与 Arc 驱动的已知兼容问题

---

### 故障点 2 [严重] Shader PSO Cache 被全局禁用 + 每次启动擦除 ShaderCache

**日志证据**（`logs/LatestClient.txt`）：

```
Wiping ShaderCache
Wiping minimap cache
Wiping DailyDeal cache
Shader PSO Cache: Disabled
```

**故障说明**：Pipeline State Object 缓存被完全禁用的同时，引擎每次启动还主动擦除 ShaderCache。这意味着每次启动后所有 Shader 变体必须从零重新编译。D3D12 下 PSO 编译是极其昂贵的操作，是游戏启动和场景切换卡顿的核心原因。Arc A770 驱动对 PSO 编译的优化不如 NVIDIA/AMD，进一步放大了影响。

**建议修复**：
- 启用 Shader PSO Cache，使用 D3D12 Pipeline Library 持久化到磁盘
- 将 ShaderCache 擦除改为版本校验机制：仅在 Shader 版本变更时擦除，而非每次启动
- Minimap / DailyDeal 缓存的启动擦除疑似 Debug 构建残留，Release 构建应移除
- 考虑在安装包中预编译常用 Shader PSO 变体

---

### 故障点 3 [中] 其他累积性性能问题

| 问题 | 日志证据 | 影响 | 建议 |
|------|---------|------|------|
| UI 初始化时序错误 | `Failed to preload UI assets, UI::Core is not initialised yet.` (CRIT 级别) | UI 面板首次打开有延迟 | 调整初始化顺序 |
| 特效资源缺失触发 Fallback | `VertexFlipBookOffset` 节点不存在、`red_buff.epk` 文件缺失 | 特效渲染降级，增加 CPU 端 Fallback 开销 | 补全资源或清理废弃引用 |
| WeGame Token 刷新过频 | 每 2-5 分钟刷新一次 | 不必要的网络开销，可能阻塞主线程 | 改为预刷新机制 |
| WeGame 用户信息获取失败 | 错误码 1010001，每次启动必现 | 启动时额外等待/重试 | 排查 SDK 接口 |

---

## 总结

故障点 1（GPU 缓存权限）导致内嵌浏览器 GPU 加速完全不可用，故障点 2（PSO Cache 禁用 + 缓存反复擦除）导致 Shader 反复编译。两个问题叠加后，在 Intel Arc A770 上表现尤为严重。