HoYoShade Hub 1.4.6.5

HoYoShade Hub 1.4.6.5

恢复覆盖包至 1.4.6（1.4.6.0）原版功能，并修复两处阻止游戏启动的问题。

• 覆盖包识别、安装、动作确认、启动器设置、INI 配置和 once 账本保持 v1.4.6 原版实现，保留 runOnLaunch 行为。
• 覆盖包动作批次遇到 pending 等状态时停止该批次，游戏按现有设置继续启动；取消和页面切换仍停止启动。
• 首次启动缺少 ReShade.ini 时，在执行覆盖包初始化动作前先从宿主模板补齐，避免 set_ini_keys 因文件不存在而失败。
• 修复升级后 OptiScaler 缺少基线、遗留配置事务或双边配置变化导致的“启动配置准备失败”。启动恢复前完整备份原始配置至构建目录的 profile-recovery 文件夹。
• 有基线时保留双方修改的不同 INI 键；同键冲突或缺少基线时优先保留当前运行配置，并留存原始文件。中断的跨游戏切换从目标游戏自身配置恢复，避免串用配置。
• 恢复后的运行配置按原流程保存回所选命名预设，预设原文件和元数据也会备份。显式套用新预设仍强制应用所选配置，不被冲突恢复取消。
• 无法读取、备份或写入时仍停止配置恢复，保留原始文件并报告错误。

GitHub 提供普通 x64 便携包，Full 完整包保留本地。构建和离线测试不等于真实游戏验收。

HoYoShade Hub 1.4.6.3

HoYoShade Hub 1.4.6.3

• 修复旧覆盖包动作处于 pending 状态时，启动器反复中断游戏启动准备的问题。
• 覆盖包动作（包括 set_ini_keys）仅在明确安装并确认时执行。游戏启动路径不再执行或检查 runOnLaunch 动作，也不再自动应用 ini_config.json。
• 每次安装创建独立事务；重新安装同一个包也重新执行一次，其他覆盖包可以覆盖原有配置。旧动作账本保留归档，不按内容哈希跳过重新安装。
• 安装时先准备游戏 INI，再应用覆盖包配置和动作。写入失败会明确提示，避免将失败误报为“无改动”。

验证：扩展回归 1190 项通过；安装事务集成测试 28 项通过，覆盖真实 ZIP 安装 A、同包重装、B 覆盖 A、旧 pending 恢复及每次安装仅执行一次；INI 专项 13 项通过；启动引导 113 项通过；once/导航测试 165 项通过。Release/x64 编译通过。

上述为构建和离线验证，尚未在反馈用户的机器或真实游戏中验收。升级后可直接尝试启动；如需重新完整应用覆盖包配置，请明确重新安装覆盖包并确认动作。

GitHub 提供普通 x64 便携包；Full 完整包保留本地。

HoYoShade Hub 1.4.6.2

HoYoShade Hub 1.4.6.2

• 修复覆盖包含第三方 manifest.json 时被误识别为标准扩展，提示“扩展的清单不完整，无法安装”的问题。覆盖包结构优先识别，标准扩展清单检查身份和安装规则。
• 修复覆盖包 ini_config.json 在后续游戏启动时重复写入配置的问题。每次明确安装覆盖包后仅应用一次，再次安装允许重新应用。
• 支持新覆盖包覆盖已安装的覆盖包。

验证：Release/x64 构建成功；扩展回归 1190 项通过、0 失败；含同名第三方清单的覆盖包已通过隔离安装测试；星穹铁道6倍覆盖包 2.9 已通过隔离目录安装验证。未进行真实游戏运行验证。

GitHub 提供普通 x64 便携包；Full 完整包按现有分发规则保留本地。

HoYoShade Hub 1.4.6

HoYoShade Hub 1.4.6

GitHub Release 正文底稿。范围：1.4.5.5 之后至 2026-10-15 当前工作树中的启动器、插件管理、覆盖包、注入链和构建维护变更。
GitHub 仅发布普通 x64 便携包；带 HoYoShade 框架的 *_Full.zip 只保留本地，不作为 Release 资产上传。

注入链与游戏启动

• 官方 XXMI、XXMI 手动模式和 Rocket 模式统一维护 Bridge / 额外模块 / OptiScaler 的有序注入链。
• 取消 Rocket、模块或自动动作时回收旧链清单和残留 DLL，保持幂等，避免旧配置继续注入。
• Rocket 模式扩展到原神、崩铁、绝区零、鸣潮和终末地等支持 XXMI 且具备 Rocket 后端的游戏；非原神按游戏插件 DLL 列表顺序加载。
• 注入模式允许 XXMI 手动模式共存；官方 XXMI 模式与 Hub 管线冲突时给出明确提示。
• 鸣潮改为识别真身 Client-Win64-Shipping.exe，支持本体目录 ReShade 安装、启用、停用和双 ReShade 检测。
• XXMI 实例查找增加后台执行、时间盒、缓存和负缓存，支持带版本后缀的实例目录；Mod 卡片读取自带 preview.png。

覆盖包与插件安装

• 修复本地覆盖包/扩展包被外层工作锁直接跳过的问题。
• 覆盖包解压、复制、版本归档移到后台执行，增加识别、解压、复制、归档和刷新阶段进度条。
• 修复 ZIP tar 兜底 stdout/stderr 顺序读取可能造成的等待；增加取消、路径穿越、临时文件清理和占用文件反馈。
• 覆盖包安装减少无关游戏缓存扫描和重复目录创建，保留一次性动作、同意记录和内容哈希保护。
• 扩展清单只认 ZIP 根目录或一层包装目录，避免误把 Streamline SDK 内部 manifest.json 当成扩展包。
• 插件页刷新、异步请求、页面卸载和旧结果发布增加生命周期与最新请求保护。

OptiScaler、模块与配置

• 模块目录和远端组件条件继续去代码化，支持用户级模块配置、历史 DLL 别名、版本归档和覆盖包落位。
• OptiScaler 配置/迁移、构建选择、profile 完整性、DLSS-G、Streamline 和插件状态检查继续统一到启动管线。
• 增加下载续传、安装事务、CAS/硬链接安全、失败回滚和本地包路径校验。
• 更新、便携目录、后台任务和设置状态增加稳定性保护，避免旧请求覆盖新页面状态。

ReShade 与界面

• 完善 ReShade 注入部署、AddonPath、游戏 ReShade.ini / ReShade2.ini 引导和原版 ReShade 管理。
• 插件管理页、OptiScaler 页、模块页、设置页和游戏启动页补充状态、进度、错误原因及刷新保护。
• 覆盖包、Mod、Rocket、XXMI 等入口保留一次性动作约束：页面刷新不会自动重复执行，内容变化需重新确认。

构建与验证

• 完整包构建默认清理未启用的搞怪滤镜，保留预设启用项、include 依赖和共享材质；-KeepNoveltyShaders 可关闭清理。
• 1.4.6 普通包不上传 HoYoShadeHub_Portable_1.4.6_x64_Full.zip；Full 包只作为本地测试/分发产物保存。
• 覆盖包安装、一次性动作、启动器回归和 UI 生命周期测试均纳入本轮验证。

已知边界

• 本版编译和离线回归不等于所有游戏实测；不同游戏的注入链、XXMI、Rocket 和 ReShade 兼容性仍需按游戏单独验收。
• Full 包中的 HoYoShade 框架与滤镜材质不作为 GitHub Release 资产上传。

HoYoShadeHub 1.4.5.5

v1.4.5.5

• 原神普通启动改为「与 EXE 同批的有序注入」：由启动器在创建进程后按 Bridge → 用户勾选的额外模块 → FFX12 → OptiScaler → ReShade 顺序逐个注入，不再由 Dx11FsrBridge.chain.txt 作为这些层的加载器。注入是串行 LoadLibraryW 并等待上一个结束，不是无序同时注入。该路径会撤走旧的原神普通 chain，避免 Bridge 重复加载 OptiScaler/ReShade；Bridge 仍只在原神模块开关开启时存在，崩铁/绝区零不加载原神桥。火箭模式与 XXMI 模式保持不变：仍然使用 Dx11FsrBridge.chain.txt 注入法。

v1.4.5

v1.4.5

• 模块系统去代码化：模块/组件来源改远端配置（含 RankFTW、DLSS-Enabler、DLSS NR 310.8.Lecram），支持从仓库添加模块与用户模块目录。
• 鸣潮：启动项改为「启用 ReShade」（未安装显示安装按钮），注入本体目录 dxgi.dll，可一键移除。
• XXMI：注入模式下支持手动模式；找不到实例 60 秒内快速失败；mod 卡片读自带 preview.png。
• 火箭模式：支持原神/星铁/绝区零/鸣潮/终末地，非原神按顺序注入 OptiScaler→ReShade。

HoYoShadeHub 1.4.4.1

上次发布（1.4.3.3）之后的全部改动都合并在本版。

新增

• Rocket 联动模式：勾选后点启动，启动器只准备配置，游戏由你在 Rocket 里启动。
• FSR 桥深度插件：已上架组件目录，三个 6 倍覆盖包内置并默认开启。
• 崩铁 XXMI 配套启动：不再依赖官方 XXMI Launcher。
• 桥版本提示：插件页显示桥支持的版本，不匹配只提醒。

修复

• 覆盖包默认动作会误关深度插件，导致「装了没生效」。
• 原神注入时而失败、启动闪退；走 XXMI 时出现两份 d3d11.dll 导致 Mod 失效。
• 插件名写成 显示名@文件名 时解析错误；覆盖包动作失败不再被永久跳过。

改进

• 完整包瘦身（滤镜 766 → 14、材质 161 → 2），不再带打包机的插件开关出厂。
• 插件页恢复拖放安装；会话日志新增几 KB 的摘要，便于贴出来排查。

注意

• 帧率解锁默认 120 → 119：超过 119 每次保存都提示一次风险，只提示、不拦。
• 原神走最终 DX12 时，主 DX11 那份 ReShade.ini 是被抑制的，菜单键位/HUD 请调到最终 DX12 那份。

HoYoShadeHub 1.4.3.3

HoYoShadeHub 1.4.3.3

• 原神早期图形栈注入优化与反作弊拦截修复：
  • 在原神早期启动分支中，将 ReShade 改为在 CreateProcess 阶段直接由父进程最高权限句柄批量有序注入（[Bridge -> FFX12 -> OptiScaler -> ReShade64]），彻底杜绝游戏启动后反作弊驱动挂钩拦截导致的“在目标进程里申请内存失败：拒绝访问”报错。
• OptiScaler 启动探测冲突根除：
  • 在多显卡探测逻辑中增加对 NVIDIA 显卡的跳过保护，默认配置 Fsr4ForceModel = auto 与 PreferFirstDedicatedGpu = true，消除多线程临时 D3D12 设备反复横跳与 Unity 主线程 D3D11 初始化冲突闪退（退出码 -1073741819 / 0xC0000005）。
• 组件与模块下载修复：
  • 修复 FSR Bridge 下载时被部分下载器改名为 OptiScaler.dll 导致桥缺失的问题，自动识别桥与 OptiScaler 对应关系。
  • 组件目录新增 GITC Uplift (DLSS-NR) 扩展支持。
• 覆盖包兼容性加固：
  • 修复 ZIP 压缩包 UTF-8 文件名编码标志，彻底解决星穹铁道覆盖包导入无反应以及原神覆盖包解压后配置名乱码（40-ԭ x6）的问题。

HoYoShadeHub 1.4.3.1

HoYoShadeHub 1.4.3.1

• DLSS5 兼容性检测优化：
  • RTX HDR 检测：当显示器未开启 Windows HDR 时直接判定为通过（绿），不再提示失效警告及弹出开启系统 HDR 按钮。
  • 显卡驱动版本：移除 616.64 驱动版本上限限制，驱动大于等于 616.56 均判定满足要求；插件管理页同步解除上限限制。
  • 移除「每游戏插件包：这个游戏在用哪一版 / 和共享目录是否同步」检测项，不再在 DLSS5 兼容性检测中提示。
• 原神帧率解锁优化：
  • 拓宽游戏设置页中「目标帧率」输入框宽度，解决输入数值时文字被右侧加减步进按钮遮挡的问题。
• 启动选项优化：
  • 移除主界面启动选项上方关于「OptiScaler 与 HoYoShade 同时启用可能出现插件冲突或兼容性问题」的提示横幅与跑马灯。
• 原神 FSR Bridge 运行库：
  • 固定渲染精度缓存为 0.6，并在配置 Bridge 时自动准备 OptiScaler 挂载状态。

下载说明

GitHub 仅提供普通版 HoYoShadeHub_Portable_1.4.3.1_x64.zip，包含启动器本体。
完整版 HoYoShadeHub_Portable_1.4.3.1_x64_Full.zip 仅在本地打包分发，不上传 GitHub。

HoYoShadeHub 1.4.3

HoYoShadeHub 1.4.3

• 兼容性检测新增 Windows 硬件加速 GPU 计划（HAGS）检测。
• 兼容性检测改为后台执行并显示阶段进度条，避免窗口看起来卡死。
• OptiScaler 安装/覆盖包处理会同时补齐构建根目录和 OptiScaler 组件目录中的 nvngx_dlss.dll、nvngx_dlssd.dll；DLSSG/Streamline 文件保持完整。
• 原神启用 OptiScaler 时自动关联 Genshin FSR Bridge。
• 改进米家游戏安装路径识别，支持注册表路径与实际目录结构不一致的情况。

已知问题

XXMI 与原神、崩坏：星穹铁道及 OptiScaler 的兼容问题仍在后续修复中。

下载

GitHub 仅提供普通版 HoYoShadeHub_Portable_1.4.3_x64.zip，不包含 HoYoShade 框架、OptiScaler、Bridge 或游戏覆盖包。
完整版仅本地打包，不上传 GitHub。