diff --git a/docs/DLSS-TESTING.md b/docs/DLSS-TESTING.md index c300ebd..128d345 100644 --- a/docs/DLSS-TESTING.md +++ b/docs/DLSS-TESTING.md @@ -64,18 +64,35 @@ DLSS Super Resolution: [1280, 720] -> [1920, 1080] ## Сборка самостоятельно вместо готового архива -Нужны Visual Studio Build Tools с C++, Rust, clang, Vulkan SDK и NVIDIA DLSS SDK v310.9.1. Ветка — `kimi-work`. +Нужны только инструменты сборки: Rust (с `x86_64-pc-windows-msvc` и `wasm32-unknown-unknown`) и Visual Studio Build Tools с C++, а также LLVM/clang — bindgen из `dlss_wgpu` требует `libclang`. Ветка — `kimi-work`. -`python3 tools/airdef.py game` сам добавляет `dlss` к features на Windows с NVIDIA RTX, если заданы `DLSS_SDK` и `VULKAN_SDK`; без них он предупреждает и собирает только `mods`. Ручная сборка ниже делает то же самое явно. +NVIDIA DLSS SDK и Vulkan SDK ставить вручную больше не нужно: на Windows с NVIDIA RTX `airdef.py` сам скачивает всё, что читает `dlss_wgpu` при сборке, и кладёт `nvngx_dlss.dll` рядом с `horizon-client.exe`. ```powershell git clone --branch kimi-work https://gitea.maoniao.team/chexit/airdef.git cd airdef rustup target add x86_64-pc-windows-msvc wasm32-unknown-unknown -$env:DLSS_SDK = "C:\path\to\DLSS" -$env:VULKAN_SDK = "C:\path\to\VulkanSDK" -cargo build --manifest-path horizon/Cargo.toml -p horizon-client --target x86_64-pc-windows-msvc --features "mods,dlss" -py tools\airdef.py mod +py tools\airdef.py all ``` -Скопируй `horizon/target/x86_64-pc-windows-msvc/debug/horizon-client.exe`, `airdef-mod/target/horizon-mod/airdef.hmod`, `dist/play.bat`, `dist/test-dlss.bat`, `dist/test-native.bat` и `$env:DLSS_SDK/lib/Windows_x86_64/rel/nvngx_dlss.dll` в одну папку. Для реальной игры нужен и `latest.log` с фактическим backend/кадрами. +`all` делает `fork`, `game`, `mod`, `install`. На Windows + RTX шаг `game`: + +1. Определяет новейший стабильный тег `v310.9.x` в [NVIDIA/DLSS](https://github.com/NVIDIA/DLSS) через GitHub API; при недоступности API берёт закреплённый `v310.9.1`. +2. Скачивает выборочно (не весь репозиторий): `include/*.h`, `lib/Windows_x86_64/x64/nvsdk_ngx_d.lib` и `nvsdk_ngx_s.lib`, `lib/Windows_x86_64/rel/nvngx_dlss.dll` (~59 МБ). Итог — около 67 МБ один раз. +3. Скачивает только заголовки [KhronosGroup/Vulkan-Headers](https://github.com/KhronosGroup/Vulkan-Headers) в `Include/`: полный LunarG SDK не нужен, `build.rs` линкует Vulkan сам. +4. Собирает с `--features mods,dlss`, передавая `DLSS_SDK` и `VULKAN_SDK` в окружение cargo, затем копирует свежий `nvngx_dlss.dll` рядом с собранным `horizon-client.exe`. + +Кэш и повторные сборки: + +```text +.horizon-cache/dlss-sdk// include/ + lib/Windows_x86_64/{x64,rel} + airdef-install.json +.horizon-cache/vulkan-headers// Include/vulkan/ + Include/vk_video/ + airdef-install.json +``` + +Повторный запуск видит маркер и полный набор файлов и ничего не скачивает. Удалить кэш можно целиком — при следующей сборке он появится снова. + +Ручное переопределение по-прежнему работает и имеет приоритет: если задать `DLSS_SDK` (корень с `include/nvsdk_ngx*.h` и `lib/Windows_x86_64/x64/`) и/или `VULKAN_SDK` (с `Include/vulkan/vulkan.h`), автоскачивание для этого компонента не выполняется. Если явный путь неполный, `airdef.py` предупреждает и собирает `mods`; чтобы вернуть автоскачивание, убери переменную. + +При любой сетевой ошибке, недоступном GitHub или неполном скачивании сборка не падает: печатается предупреждение, ставится `--features mods`, и игра остаётся на native TAAU. На macOS и Linux, а также на Windows без RTX, автоскачивания нет — сразу `mods`. + +Если `nvngx_dlss.dll` нужен отдельно (например, для ручной раскладки), он лежит в кэше: `.horizon-cache/dlss-sdk//lib/Windows_x86_64/rel/nvngx_dlss.dll`. Его версия совпадает с самым новым тегом, который нашёл `airdef.py`.