Opti2XMX 0.3.3

Opti2XMX 0.3.3

When selecting the upscaler frame-generation input, the interface now asks users to disable in-game frame generation to avoid overlapping paths. For FSR and DLSS frame-generation inputs, it instead tells users to enable the corresponding in-game setting. The guidance is available in Chinese and English.

This is a guidance change; it does not change game settings or fix a confirmed driver defect. Frame generation remains experimental. The final release has not received physical-device acceptance or installer/maintenance upgrade validation.

中文摘要

选择超分输入时，提示先关闭游戏内插帧，避免两套插帧冲突；选择 FSR 或 DLSS 输入时，提示开启游戏内对应的帧生成。支持中英文。

本次只修改提示，不会自动更改游戏设置，也不代表已修复底层驱动问题。最终版本尚未完成实机及安装器／维护升级验收。

Validation

• Source: a2f1084.
• GitHub Linux CI passed typecheck, frontend scenarios, Python tests and packaging: https://github.com/FlightDan/Opti2XMX/actions/runs/41076603582
• The 37 ZIP members match the independently built package byte for byte. ZIP size: 1,487,590 bytes; SHA-256: d0f2973d717861e7a3aa3dcbf5b3c03bc4faf239d4731185fd71b87dbc98cf70.

Opti2XMX 0.3.2

Opti2XMX 0.3.2

• Restore the four-position frame-generation multiplier slider (native, 2×, 3×, 4×) and expand advanced settings by default for each selected game. A manual collapse is retained during the plugin session.
• Identify the current super-resolution component as XeSS 2.0.2 and the existing experimental frame-generation output as XeSS 3. This labels the existing SDK 3 path; it does not add a second super-resolution runtime or a native-game frame-generation override.
• Remove the persistent auto-save descriptions beneath upscaling and multiplier controls. After a successful actual settings change, a brief notice asks the user to restart the game. Failed saves keep their error; unchanged values do not show a restart notice.
• Harden stable OptiScaler archive and extracted-payload verification, and remove implicit development-path dependency discovery. This release retains existing game-file ownership, recovery and local-only source rules.

Validation and limits

The final source and standalone archive are tested separately from the installer integration. XeSS frame generation and multipliers remain experimental: a saved request or an FPS overlay alone does not prove the actual interpolation count. Prior testing used Cyberpunk 2077 on Arc B390 with ray tracing off; the final 0.3.2 UI/game combination has not yet received physical-device acceptance. FSR 4.1.2 Lite XMX still requires the user's locally supplied, verified model archive.

中文摘要

• 恢复原生／2×／3×／4×倍率滑块；选定游戏后高级设置默认展开。
• 超分组件显示 XeSS 2.0.2，既有实验性帧生成输出显示 XeSS 3；不新增另一套超分运行库。
• 移除两处常驻保存说明；设置实际变更并保存成功后提示重启游戏，失败继续显示原因。
• 加强 OptiScaler 归档和解压载荷校验；帧生成仍属实验功能，最终版本的游戏实机验收尚未完成。

Build verification

• Source commit: 727bf64e7264565ad81ddf2ee1b54e30ceb2062a.
• GitHub Linux CI passed frozen dependency installation, typecheck, build, frontend scenarios, all 245 Python tests, and standalone packaging.
• The 37 members of the uploaded ZIP match the independently generated CI archive byte for byte. Archive size: 1,487,450 bytes. SHA-256: 67e0b49feb1b6866cb40f3fced5b6c7103348d699b86a9ace5ab63642e9fc160.
• This does not claim final-version game or hardware acceptance.

Opti2XMX 0.3.1 — local package reuse and per-game setup

Opti2XMX 0.3.1

Opti2XMX now follows the complete game setup sequence rather than showing controls before their prerequisites are ready.

• Opening the plugin refreshes game/component state and prefers the running supported Steam game. Manual game choices survive Steam's native menus. The redundant Refresh button is removed.
• Games with multiple executable candidates show the required executable choice first. Installation, XMX and Opti controls appear after a valid choice. A missing or incomplete Opti installation does not show the overlay control. Record-driven recovery remains accessible when a failed installation needs rollback or launch confirmation.
• Fresh installation, repair and managed installation share the same Opti 10 preview / 0.9.4 / 0.7.9 target selector. Current and target versions are identified separately. Choosing a target does not install it.
• When a matching archive is already cached, Install from local package is the first/default source. The cache is shared across games and is compatible with archives supplied by a Boiler device package. An explicit local source never silently falls back to the network. When absent, the first installation can download and retain the archive; later installations reuse it.
• An explicit installation can temporarily restore an active XMX setup, install and confirm Opti, then re-enable XMX through the freshly detected Opti route. The operation survives Quick Access unmount/remount. Errors retain the actual state and recovery actions; reopening does not retry an operation automatically. Migration continues to preserve adopted files/settings.
• Upscaling, frame-generation, multiplier and GPU selections save automatically. A running game is refused with an exit-game message, and the saved selection stays visible. Native / 2× / 3× / 4× multiplier choices save only the confirmed value. Reset, undo and interrupted-settings recovery remain available.
• Version installation resets upscaling to XeSS and frame generation to native control. Select FSR again afterward to prepare/enable its existing XMX path. FSR 4.1.2 Lite XMX still requires the user's exact locally imported model archive; model DLLs and private caches are not distributed.

Validation

• TypeScript checking, production build and all 23 frontend scenario groups passed. These include fresh and managed installs, executable gating, native menus, active-XMX install ordering, fresh route selection, duplicate-action protection, missing local cache refusal, interrupted installation rollback and launch confirmation.
• All 230 Python fixture tests passed in an isolated Linux directory. They exercise read-only cache discovery, cached source reuse across managers, local-only cache misses without network work, settings preflight and version reset behavior.
• On the test device, all three existing original Opti archives were used with network access prohibited inside the test process. A second pass also prohibited extraction and successfully reused all prepared payloads. No game installation or game settings were changed by this cache check.
• The existing Boiler local OXP3 package's three archive targets, byte sizes and hashes were checked against the plugin's cache contract. The pinned runtime and ordinary public CPU payload remain separate.
• Independent review found and verified fixes for stale snapshot reads, concurrent actions, recovery hidden behind executable selection and an explicit-local choice silently becoming a network source.
• The final new UI/full installation sequence has automated coverage; final physical game installation and native UI acceptance are not claimed. Earlier development candidates do not establish acceptance of this exact release.

This release does not add support for unsupported games/GPUs, prove new performance gains, or distribute the user's FSR model. Existing Opti 10/FSR compatibility limits remain documented in FSR XMX.

中文摘要

• 先确认游戏程序，再显示安装与设置；未装好 Opti 时隐藏覆盖层入口。
• 新装、修复和已安装入口使用同一套三个版本选项；有本地包时默认“从本地安装”，各游戏共用缓存。
• XMX 开启时安装会自动处理临时关闭与恢复；失败保留恢复入口，不在重开时偷偷重试。
• 设置选完自动保存；游戏运行时提示先退出，并保留已保存选项。
• 23 组前端回归及 230 项 Linux 测试通过；三份实机缓存包的禁止联网与二次直接复用验证通过。最终实机新界面和完整游戏安装验收未完成，详见上述验证边界。

Source commit: c99638e3768ddd50326eade01cdd024031096c92

Standalone ZIP SHA-256: d2d6b3ccdfd73c8676450dcce5312330db861276e1ab2062e56efb0ac5043fea

Opti2XMX 0.3.0 — XeSS / FSR 4.1.2 Lite XMX

Opti2XMX 0.3.0

The existing Upscaling output control now offers XeSS and FSR 4.1.2 Lite XMX while XMX is enabled. XeSS remains the default. Selecting FSR prepares the pinned OptiScaler 10 preview, enables the per-game XMX bridge, and saves the selected output for the next Steam launch. GPU identity remains Intel.

FSR requires the user's original FSR-4.1.2-Lite-XMX-OptiClick-0.6.zip. The file picker imports and verifies that exact build locally. Its upscaler, weights and NVIDIA DLL are not distributed in this plugin, the Windows installer or maintenance packages. See FSR XMX for the supported archive and limitations.

The public plugin includes the source and licenses of a small LZMS decompression adapter and wimlib. It uses a private import name and does not replace Wine's Cabinet DLL. The per-game compiler adapter corrects the verified FSR PRE kernel's root-table metadata while preserving its machine code. Other kernels retain their original compiler path.

Turning XMX off returns to XeSS rather than leaving the XMX-only FSR model selected. Per-game preparation, injection toggles, settings undo and uninstall keep recoverable originals. Existing mixed manual Opti 0.9.4 installations can be adopted only when the core matches the exact official release; existing companion files are backed up as user originals.

Validation

• 222 backend tests, frontend behavior checks, TypeScript checking and production build passed.
• The decompression adapter decoded all six real resource packs (136,704,915 output bytes) identically to the reference on Windows and Proton Experimental. Malformed framing, missing dependencies and handle lifecycle checks passed. Repeated builds produced identical DLL hashes.
• SteamOS 3.10 / Intel Arc B390 / the published patched Mesa 26.1.2 runtime / Proton Experimental / Cyberpunk 2077 2.31: FSR completed the 64.20-second benchmark at 30.06 average FPS; switching back to XeSS completed 64.24 seconds at 30.17 FPS. Output was 1920×1200, FSR input 1280×800, frame generation and ray tracing off. Both runs used the managed game setup and showed no device-lost exception.
• Real uninstall restored all 98 original tracked game files byte-for-byte, the original Steam launch options and original game settings. The new installation was then restored with XeSS selected and XMX off.

This is a compatibility feature tested on the configuration above. The two single runs establish that both paths complete; they do not establish a performance advantage. Other GPUs, games, model builds, ray tracing and frame generation combinations remain unverified.

Installer and maintenance delivery retain the separate published XeSS runtime and the two stable Opti archives, and add the pinned nightly-20261025 Opti 10 archive. FSR model import remains a local user action.

OXP3 SteamOS v1.0.6+maintenance.19 — Maintenance Assets

OXP3 SteamOS 1.0.6+maintenance.19

本修订将 Opti2XMX 升级到 0.3.0。现有“超分输出”下拉框增加 FSR 4.1.2 Lite XMX，默认继续选择 XeSS。首次保存 FSR 时准备固定 OptiScaler 10 preview 和每游戏 XMX 兼容组件；关闭 XMX 时恢复 XeSS，避免在系统默认 Vulkan 驱动上启动 XMX 专用模型。

FSR 原始 ZIP 由用户通过插件的本地文件选择器导入。FSR/DLSS 模型 DLL、私人缓存和 Microsoft Cabinet DLL 不进入公开源码或安装包。公开新增载荷包括自有 LZMS 适配器、wimlib、完整对应源码及许可证。原有独立 XeSS 运行库保持不变；离线缓存保留两个稳定 Opti 原档，并新增经过哈希核验的 nightly-20261025。

源码与集成验证：222 项后端测试、前端行为测试、TypeScript 检查和生产构建通过；三份真实 Opti 原档断网提取与缓存复用通过。开源解压组件在 Windows 和 Proton 上对六段真实资源的 136,704,915 字节输出均匹配参考。

实机验证：SteamOS 3.10、Arc B390、已发布 Mesa 26.1.2 XMX 运行库、Proton Experimental、Cyberpunk 2077 2.31。1920×1200 输出、FSR 1280×800 输入、关闭光追和帧生成；FSR 完成 64.20 秒基准，平均 30.06 FPS，切回 XeSS 完成 64.24 秒基准，平均 30.17 FPS，均无设备丢失。两次单轮结果仅验证路径可运行，不作为性能优劣结论。卸载后 98 个原文件逐字节恢复，原 Steam 启动项与游戏设置恢复验证通过。其他 GPU、游戏、模型、光追及帧生成组合仍未验收。

维护升级只替换受管理插件与对应离线载荷，不导入模型、不自动启用游戏 FSR。保留全部受支持组件及旧签名目录引用资产，沿用 .18 的分区预检与 HDR 载荷；不含暂缓公开的动态功耗研究。公开下载、签名与 .18 → .19 升级验收结果记录在最终 Release。

Signed component catalog and referenced assets are complete. Public download and device upgrade acceptance are being verified; Windows Latest remains unchanged until acceptance.

Opti2XMX 0.2.8

修复下载源选择在 Steam 原生下拉菜单关闭、重建快速访问面板后恢复为 GitHub 的问题。普通安装/修复和高级版本安装两个入口均保留所选官方或第三方下载源；刷新、重新打开面板以及下载失败后重试不会丢失选择。

来源保持在当前插件会话中，重载插件后恢复默认官方源。OptiScaler 版本、下载地址及 XMX 20261005 运行库保持不变；已有安装包缓存继续复用。本修复不代表设备 DNS 或第三方镜像连通性问题已解决。

正式 CI 39789900946 通过类型检查、构建、前端生命周期/RPC 回归和 Linux 后端测试；另在掌机临时目录通过 174 项后端测试。新版前端回归可稳定拒绝修复前构建。实际菜单点击和整合维护升级验收另记，不以测试夹具代替实机结果。

源码：56d7b987a8908edd430b4086ea6ff05df2939cfb。附件使用 CI 最终 ZIP，SHA-256 63a25f4911edf9534c6fc8e600287d7b6427216b9da6cd940d98d48a2ed0d9e6。

Fix download-source selection resetting to GitHub across Steam native-menu remounts, in both installation entries. Refresh, reopening and failed-download retries retain the current session choice. Existing archive caches remain shared across sources; runtime binaries and OptiScaler versions are unchanged.

实机补充：OP3 的真实 Steam 高级设置菜单依次选择 ghfast、gh-proxy 和官方源，面板卸载、重建后均显示正确来源；测试后恢复官方源、原游戏和隐藏的快速访问面板，未执行安装或游戏开关，游戏状态及运行库配置保持一致。普通安装入口由前端生命周期/RPC 夹具覆盖，本轮未单独执行该入口的真实游戏安装。正式 ZIP 已从公开入口匿名重新下载，大小及 SHA-256 与 CI 固定值一致。

OXP3 SteamOS v1.0.6+maintenance.9 — Maintenance Assets

OXP3 SteamOS 1.0.6+maintenance.9 的完整签名目录所引用的 Opti2XMX 0.2.8 插件分片与运行库来源描述。

独立插件为 Opti2XMX 0.2.8，源码 56d7b98，CI ZIP SHA-256 63a25f4911edf9534c6fc8e600287d7b6427216b9da6cd940d98d48a2ed0d9e6。修复原生下拉菜单重建面板后丢失下载源选择。

XMX 20261005 原始运行库保持不变，继续引用历史不可变附件；没有增加未公开动态功耗研究。完整维护目录覆盖全部支持组件，Windows 安装器继续承担 Latest。

OXP3 SteamOS v1.0.6+maintenance.18 — Maintenance Assets

OXP3 SteamOS maintenance.18 的正式签名运行库描述。Opti2XMX 插件与 XMX 原始运行库维持既有固定版本、摘要及历史下载地址；不更新插件、运行库算法或历史附件。

先公开本引用元数据，再公开维护目录。维护工具不抢占 Windows 安装器的 Latest。

OXP3 SteamOS v1.0.6+maintenance.17 — Maintenance Assets

maintenance.17完整签名目录引用的既有XMX运行库描述；Opti2XMX0.2.8及原始运行库不变。全部历史分片与资产保留。

OXP3 SteamOS v1.0.6+maintenance.16 — Maintenance Assets

maintenance.16完整签名目录使用的既有XMX运行库描述；Opti2XMX0.2.8与原始运行库未改变，不替换历史运行库二进制。新增组件为独立LSFG可选插件。