From 74baf8b4e21c9f868a138d38679a21d180f4d17d Mon Sep 17 00:00:00 2001 From: chexit Date: Sat, 21 Nov 2026 15:55:14 +0300 Subject: [PATCH] Document the libclang auto-install The zero-step Windows+RTX toolchain now also covers libclang: LLVM is no longer a build prerequisite, the detected or downloaded directory is passed as LIBCLANG_PATH, and the cache layout gains .horizon-cache/libclang//. Manual override (winget install LLVM.LLVM + LIBCLANG_PATH) and the Unable to find libclang troubleshooting note remain. Co-Authored-By: Kimi Code --- docs/DLSS-TESTING.md | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) diff --git a/docs/DLSS-TESTING.md b/docs/DLSS-TESTING.md index 128d345..a1ec81a 100644 --- a/docs/DLSS-TESTING.md +++ b/docs/DLSS-TESTING.md @@ -64,9 +64,9 @@ DLSS Super Resolution: [1280, 720] -> [1920, 1080] ## Сборка самостоятельно вместо готового архива -Нужны только инструменты сборки: Rust (с `x86_64-pc-windows-msvc` и `wasm32-unknown-unknown`) и Visual Studio Build Tools с C++, а также LLVM/clang — bindgen из `dlss_wgpu` требует `libclang`. Ветка — `kimi-work`. +Нужны только Rust (с `x86_64-pc-windows-msvc` и `wasm32-unknown-unknown`) и Visual Studio Build Tools с C++. Ветка — `kimi-work`. -NVIDIA DLSS SDK и Vulkan SDK ставить вручную больше не нужно: на Windows с NVIDIA RTX `airdef.py` сам скачивает всё, что читает `dlss_wgpu` при сборке, и кладёт `nvngx_dlss.dll` рядом с `horizon-client.exe`. +NVIDIA DLSS SDK, Vulkan SDK и LLVM ставить вручную больше не нужно: на Windows с NVIDIA RTX `airdef.py` сам скачивает всё, что читает `dlss_wgpu` при сборке (включая `libclang.dll` для bindgen), и кладёт `nvngx_dlss.dll` рядом с `horizon-client.exe`. ```powershell git clone --branch kimi-work https://gitea.maoniao.team/chexit/airdef.git @@ -80,19 +80,25 @@ py tools\airdef.py all 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`. +4. Ищет уже установленный `libclang.dll` (`LIBCLANG_PATH`, `PATH`, `C:\Program Files\LLVM\bin`, LLVM из Visual Studio). Если его нет — скачивает NuGet-пакет [`libclang.runtime.win-x64`](https://www.nuget.org/packages/libclang.runtime.win-x64) (~34 МБ) и распаковывает из него только `runtimes/win-x64/native/libclang.dll`. +5. Собирает с `--features mods,dlss`, передавая `DLSS_SDK`, `VULKAN_SDK` и `LIBCLANG_PATH` в окружение 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 +.horizon-cache/libclang// libclang.dll + airdef-install.json ``` Повторный запуск видит маркер и полный набор файлов и ничего не скачивает. Удалить кэш можно целиком — при следующей сборке он появится снова. -Ручное переопределение по-прежнему работает и имеет приоритет: если задать `DLSS_SDK` (корень с `include/nvsdk_ngx*.h` и `lib/Windows_x86_64/x64/`) и/или `VULKAN_SDK` (с `Include/vulkan/vulkan.h`), автоскачивание для этого компонента не выполняется. Если явный путь неполный, `airdef.py` предупреждает и собирает `mods`; чтобы вернуть автоскачивание, убери переменную. +Ручное переопределение по-прежнему работает и имеет приоритет: если задать `DLSS_SDK` (корень с `include/nvsdk_ngx*.h` и `lib/Windows_x86_64/x64/`), `VULKAN_SDK` (с `Include/vulkan/vulkan.h`) и/или `LIBCLANG_PATH` (каталог с `libclang.dll`), автоскачивание для этого компонента не выполняется. Если явный путь неполный, `airdef.py` предупреждает и собирает `mods`; чтобы вернуть автоскачивание, убери переменную. -При любой сетевой ошибке, недоступном GitHub или неполном скачивании сборка не падает: печатается предупреждение, ставится `--features mods`, и игра остаётся на native TAAU. На macOS и Linux, а также на Windows без RTX, автоскачивания нет — сразу `mods`. +Ручная альтернатива для libclang: `winget install LLVM.LLVM`, затем задать `LIBCLANG_PATH` на каталог `bin` установленного LLVM (там лежит `libclang.dll`). + +При любой сетевой ошибке, недоступном GitHub/nuget.org, неполном скачивании или если libclang так и не нашёлся, сборка не падает: печатается предупреждение, ставится `--features mods`, и игра остаётся на native TAAU. На macOS и Linux, а также на Windows без RTX, автоскачивания нет — сразу `mods`. + +Если bindgen всё же пишет `Unable to find libclang`, проверь `LIBCLANG_PATH`: он должен указывать на каталог, в котором лежит `libclang.dll` (не на сам файл). Удобно один раз выполнить `winget install LLVM.LLVM` и указать `C:\Program Files\LLVM\bin`. Если `nvngx_dlss.dll` нужен отдельно (например, для ручной раскладки), он лежит в кэше: `.horizon-cache/dlss-sdk//lib/Windows_x86_64/rel/nvngx_dlss.dll`. Его версия совпадает с самым новым тегом, который нашёл `airdef.py`.