nte-ray-tracing-panel

异环怎么开光追：异环光追一键开启 / 一键部署工具

搜索关键词：异环怎么开光追、异环光追怎么开、异环全景光追怎么开、异环没有光追选项、异环光追选项不显示、异环光追打不开、异环光追开不了、异环 5060 没有光追、异环 4060 没有光追、异环 RTX 5060 怎么开光追、异环 RTX 4060 怎么开光追、异环光追一键开启、异环光追一键安装、异环光追一键部署、异环开光追工具、异环光追补丁、异环 OptiScaler 一键安装、异环 winmm.dll 一键安装、异环不改注册表光追、NTE how to enable ray tracing、NTE no ray tracing option、Neverness To Everness how to enable ray tracing、NTE ray tracing fix、NTE one-click ray tracing unlock。

异环光追一键部署面板 / NTE Ray Tracing Panel 是给“异环怎么开光追”“为什么没有光追选项”这类问题准备的本地 WebUI 工具。它可以一键准备 OptiScaler、安装本地 winmm.dll、OptiScaler.ini、OptiScaler\ 和 OptiScaler.log，把当前已验证成功的 GPU spoof 流程做成自动写入、可选择目标显卡、可备份、可恢复的一键开启光追流程。

重要提示：光追选项通常需要默认画质预设在“极致”或以上才会出现。切到自定义低端配置后，设置界面里的选项可能消失，但已经生效的光追状态可能仍保留。

English README: README.en.md

Local URL:

http://127.0.0.1:22642

它不是在线服务，只在本机运行。本机网页负责显示、选择目录和发起操作；Python / exe 后端负责监听 127.0.0.1:22642、下载 OptiScaler、写入文件、备份和恢复。只关闭浏览器标签页不会退出后端服务，需要在面板里点击“退出工具”，或者在任务管理器里结束 NTERayTracingPanel.exe。

搜索关键词 / Search Keywords

异环怎么开光追，异环光追怎么开，异环全景光追怎么开，异环光线追踪怎么开，异环没有光追选项，异环光追选项不显示，异环光追打不开，异环光追开不了，异环光追灰色，异环 RTX 5060 怎么开光追，异环 RTX 4060 怎么开光追，异环 5060 没有光追，异环 4060 没有光追，异环光追一键开启，异环光追一键安装，异环光追一键部署，异环开光追工具，异环光追工具，异环光追补丁，异环 OptiScaler 一键安装，异环 winmm.dll 一键安装，异环不改注册表光追。

NTE how to enable ray tracing, how to enable ray tracing in NTE, Neverness To Everness how to enable ray tracing, Neverness To Everness no ray tracing option, NTE no ray tracing option, NTE ray tracing option missing, NTE ray tracing not showing, NTE ray tracing fix, NTE ray tracing tool, NTE one-click ray tracing unlock, NTE one-click OptiScaler install, NTE OptiScaler setup, NTE winmm.dll installer, Ananta how to enable ray tracing, Ananta no ray tracing option, Ananta ray tracing unlock.

项目定位

这个项目的重点不是“通用 Mod 管理器”，而是把异环这个具体场景里的光追解锁路径做成可复用流程：

• 异环当前测试版本会按 GPU 型号白名单隐藏光线追踪选项。
• 当前默认推荐：通过 OptiScaler DXGI/Streamline spoof 成 RTX 5090，写入 SpoofedGPUName=NVIDIA GeForce RTX 5090、SpoofedDeviceId=0x2B85、DxgiVRAM=32。
• RTX 4090 作为已验证备用 profile 保留。
• 直接改系统显卡注册表是整机级影响，不适合主力开发机。
• 本工具默认只写游戏 Win64 目录内的本地代理文件，并提供 manifest 备份恢复。

能解决什么

部分 RTX 50/40/30 系显卡实际支持光追，但《异环》测试版本会按显卡型号白名单隐藏“光线追踪 / 全景光追”选项。手动改 Windows 显卡注册表是整机级影响，不适合主力开发机。

本工具默认使用 OptiScaler 的 DXGI/Streamline GPU spoof，把 HTGame.exe 看到的 GPU 名称伪装为所选目标显卡，从而解锁游戏里的光追选项。当前 WebUI 提供四档：本机原配置、NVIDIA GeForce RTX 5090、NVIDIA GeForce RTX 4090、NVIDIA GeForce RTX 5080 Laptop GPU。默认推荐 RTX 5090；RTX 4090 作为已验证备用 profile；RTX 5080M profile 目前只能看到“全景光追”和“关”，不推荐作为默认配置。

文档导航

第一次使用建议按顺序看：

1. 快速使用
2. 原理与试错路径
3. 备份恢复与修改范围
4. 发布指南
5. 常见问题

安全边界

• 不使用 ProcMon、Sysmon、驱动监控或内核抓取工具。
• 默认不修改 HKLM\SYSTEM\CurrentControlSet\Enum\PCI 显卡注册表。
• 默认只管理游戏目录内这些路径：
  • winmm.dll
  • OptiScaler.ini
  • OptiScaler.log
  • OptiScaler\
• 不写入、删除或恢复 nvngx.dll、dlsstweaks.ini、dlsstweaks.log。
• 如果检测到 nvngx.dll + dlsstweaks.ini，视为 DLSS Panel 已安装；本工具只显示兼容状态，不接管这些文件。
• 文件归属边界：RT Panel 负责 winmm.dll / OptiScaler，DLSS Panel 负责 nvngx.dll / DLSSTweaks。
• 每次安装前都会创建 _nte_rt_backups\<timestamp>\manifest.json。
• 恢复时严格按 manifest 操作，避免误删非本工具文件。

使用

1. 运行 run.bat，或双击发布版 NTERayTracingPanel.exe。
2. 页面打开后选择《异环》安装根目录，或直接选择 Client\WindowsNoEditor\HT\Binaries\Win64。
3. 点击“下载/准备 OptiScaler”。
4. 选择目标显卡 profile：默认推荐 RTX 5090；RTX 4090 作为已验证备用，本机原配置用于回退识别，RTX 5080M 仅保留作实验对照。
5. 确认游戏和启动器已关闭。
6. 点击“备份并安装光追解锁”。
7. 启动游戏，把默认画质预设调到“极致”或以上，再在画质设置里检查“光线追踪 / 全景光追”选项。

OptiScaler .7z 解压失败

如果“下载/准备 OptiScaler”时报 tar.EXE: LZMA codec is unsupported，这不是本项目 Release .zip / .exe 损坏，而是 OptiScaler 官方 Release .7z 在某些 Windows tar.exe 环境下无法解压。当前版本会先用随包内置的 py7zz / 7zz 解压 .7z，再 fallback 到 py7zr、可用的 7z.exe 和 tar.exe，并在仍失败时提示手动解压路径。

手动兜底：解压下载到的 OptiScaler .7z，把包含 OptiScaler.dll 和 OptiScaler.ini 的文件放到 tools/optiscaler/<版本号> 目录，然后重新运行面板。只设置 .7z 默认打开方式不等于修复，因为面板不会调用系统文件关联。

运行与退出

这个工具分成两层：

• 前端 WebUI：浏览器里的页面，只负责显示状态和发起操作。
• 后端服务：NTERayTracingPanel.exe 或 python app.py，负责监听端口、选择文件夹、写入文件、备份恢复。

所以只关闭网页标签页不会关闭后端服务，22642 端口也会继续被占用。需要退出时，在 WebUI 底部点击“退出工具”。如果页面已经关掉，可以重新打开：

http://127.0.0.1:22642

然后再点击“退出工具”；或者在任务管理器里结束 NTERayTracingPanel.exe。

恢复

在页面的“备份与恢复”卡片里选择最近备份，点击恢复。

也可以用命令行恢复：

python app.py --no-browser

然后在 WebUI 里恢复指定备份。

原理

OptiScaler 的 GPU spoof 能改写游戏进程通过 DXGI/Streamline 读取到的显卡描述、VendorId、DeviceId 和显存信息。本工具会按 WebUI 选择生成配置。四档目标显卡：

• 本机原配置：读取当前 NVIDIA 显卡名称和 DeviceId，适合回到本机识别。
• RTX 5090：SpoofedGPUName=NVIDIA GeForce RTX 5090，SpoofedDeviceId=0x2B85，DxgiVRAM=32。当前默认推荐。
• RTX 4090：SpoofedGPUName=NVIDIA GeForce RTX 4090，SpoofedDeviceId=0x2684，DxgiVRAM=16。已验证备用 profile。
• RTX 5080M：SpoofedGPUName=NVIDIA GeForce RTX 5080 Laptop GPU，SpoofedDeviceId=0x2C59。实验性对照项，实测只出现“全景光追”和“关”，不推荐默认使用。

所有 profile 都会保留这些默认边界：

• TargetProcessName=HTGame.exe
• SpoofedVendorId=0x10de
• Dxgi=true
• StreamlineSpoofing=true
• [Hooks] HookOriginalNvngxOnly=true
• Registry=false
• User32=false

这和全局注册表改名不同：注册表改名会影响整机，DXGI spoof 只在本地代理 DLL 被 HTGame.exe 加载后生效。

版本路线

见 CHANGELOG.md。

核心项目与致谢

• OptiScaler：本项目的 GPU spoof 核心来源。面板会从 OptiScaler 官方 GitHub Release 准备 OptiScaler.dll，并把它安装为《异环》Win64 目录内的本地 winmm.dll 代理。
• DLSSTweaks：相关图形注入/包装工具。nvngx.dll / DLSSTweaks 归 DLSS Panel 管理；本项目不使用 DLSSTweaks 的 DLSS 比例配置流程，也不写入、删除或恢复 nvngx.dll、dlsstweaks.ini。

本项目不是 OptiScaler 本体、不是 DLSSTweaks 分支，也不是 NVIDIA 官方工具；它只是围绕 OptiScaler 的《异环》专用安装、备份、恢复和说明面板。