Мод «Better Mod Sort(And Error Inspector)» для Rimworld (v1.6)

Установили кучу модов, но не знаете, как их правильно расположить?

Этот мод может подключаться к большим языковым моделям (LLM) и позволять ИИ предлагать более разумный порядок загрузки на основе вашего списка модов и фактических отчетов об ошибках.

Чтобы ИИ знал, какие моды могут конфликтовать, этот мод будет автоматически перехватывать ошибки во время выполнения в фоновом режиме, анализировать, какой мод их вызвал, и записывать эту информацию в качестве справочных данных для сортировки ИИ.

Таким образом, типичный рабочий процесс выглядит так: сначала запустите игру обычным способом (или хотя бы загрузите игру один раз), чтобы мод собрал достаточно информации об ошибках, а затем используйте сортировку ИИ. Это даст лучшие результаты.

Конечно, сама функция анализа ошибок также полезна. Даже если вы не используете сортировку ИИ, она может помочь вам точно определить, чья вина в красном тексте.

Сортировка с помощью ИИ (экспериментальная функция) — это основная функция мода. По умолчанию она отключена и требует ручного включения в настройках мода, а также настройки ключа API LLM.
После включения кнопка «Автосортировка» в списке модов запустит процесс ИИ:

1. Для экономии токенов движок не будет отправлять подробные описания всех ваших модов. Он собирает только основную информацию (название и требования к загрузке, такие как `loadBefore` / `loadAfter`).
2. Только для «подозрительных модов», которые ранее были зарегистрированы в ошибках, ИИ извлечет их полные описания и сократит их до кратких сводок (они кэшируются локально).
3. Отправит эту оптимизированную информацию вместе с записями об ошибках в LLM.
4. LLM вернет предложения по сортировке, которые затем внедряются в стандартный механизм топологической сортировки для выполнения сортировки.

Поэтому, чтобы ИИ выполнял сортировку точно, лучше всего запустить игру один раз с вашим текущим списком модов, чтобы система анализа ошибок накопила некоторые данные.
Сортировка возможна и при первом использовании, даже если данных об ошибках нет, но у ИИ будет меньше информации для анализа.

! Примечание: сортировка ИИ потребляет токены API. Для списка из 300 модов ввод данных потребует примерно 10 000 токенов! !

Анализ источников ошибок.

Эта функция автоматически активируется после установки и не требует дополнительных действий. Она предоставляет данные для сортировки ИИ и может также использоваться независимо в качестве инструмента для устранения неполадок.

При возникновении ошибок в игре мод проводит глубокий анализ по следующим параметрам:
- Отображение трассировки стека DLL — извлекает сборку, соответствующую каждому кадру, из стека вызовов исключения, чтобы определить, к какому DLL мода оно относится.
- Локализация исключений при разборе XML — перехватывает базовые процедуры обработки XML, напрямую сопоставляя точные узлы XML, вызвавшие исключение, с их исходными файлами, модами и конкретными путями к узлам XML.
- Анализ ошибок конфигурации Def — перехватывает ошибки конфигурации Def, отслеживает их фактические исходные файлы, извлекает всю цепочку наследования `ParentName` и идентифицирует все операции Patch, примененные к этому Def и его родительским узлам.
- Поиск перекрестных ссылок — глубоко анализирует ошибки типа «Не удалось разрешить перекрестную ссылку», чтобы найти точный Def, файл и конкретный XML-узел, которые использовали отсутствующую ссылку, и перечисляет все задействованные патчи.
- Атрибуция совместимости с CE — устраняет ошибки «нет поддержки Combat Extended», глубоко анализируя параметры стека кадров, чтобы точно определить конкретные Def предметов или рас, которые несовместимы с CE.
- Извлечение пути к файлу и идентификатора мастерской— Извлекает локальные пути из ошибок, таких как «Невозможно загрузить текстуру» или отсутствующие файлы, сопоставляя их с корневыми каталогами активных модов или декодируя идентификаторы Steam Workshop для поиска мода.

Результаты анализа будут сохранены в файл `BetterModSort.Error.txt` в каталоге сохранения, а предыдущие результаты будут сохранены в файле `BetterModSort.Error.prev.txt`.

! Примечание : Если вам необходимо сообщить об ошибках другим авторам модов, пожалуйста, предоставьте полный файл Player.log или скопируйте исходные красные сведения об ошибке из окна журнала. Файл BetterModSort.Error.txt , созданный этим модом, содержит только сводку анализа для сортировки ИИ и краткую справочную информацию и может не содержать важных технических деталей, необходимых авторам для исправления ошибок.

Совместимость и внешние инструменты:
- Полная совместимость с Mod Manager и Prestarter. После включения сортировки ИИ в настройках этого мода, нажатие на встроенную кнопку «Автосортировка» автоматически запустит процесс сортировки ИИ этого мода!
- Экспорт в RimSort: Поддерживает автоматическое сохранение текущего списка активных модов в XML-файл, совместимый с RimSort, после завершения сортировки ИИ (можно включить в экспериментальных настройках).

Поддержка языков: английский, упрощенный китайский и русский.

Для работы мода требуется: Harmony.

Мод проверен на версии игры: 1.6