Об этом проекте

# Skyrim Creation Kit Agent Этот репозиторий содержит исследовательские и инженерные артефакты для разработки AI-ассистированного агента авторинга модов для *The Elder Scrolls V: Skyrim Special Edition* и *Anniversary Edition*. Проект сосредоточен на методологиях с приоритетом безопасности, преобразующих высокоуровневое намерение моддинга в типизированные, обратимые и подтверждённые доказательствами операции. ## Основная философия Система работает на четырёх принципах: 1. **AI решает ЧТО**: LLM/планировщик определяет желаемую операцию. 2. **Детерминированное ПО решает КАК**: типизированные воркеры выполняют действия. 3. **Валидаторы решают, СРАБОТАЛО ЛИ ЭТО**: автоматические проверки обеспечивают целостность. 4. **Человек решает, ПРИНЯТЬ ЛИ ЭТО**: перед применением требуется финальное одобрение. Целевой продукт — гибридный оркестратор, где основной путь является headless и детерминированным. Creation Kit рассматривается как узкая возможность, а не ядро системы. ## Текущий статус **Исследование + проверенный синтетический proof of concept.** Это ещё не универсальный агент авторинга модов, и он в настоящее время не автоматизирует Creation Kit напрямую. Текущий вердикт Gate-1 — «VIABLE WITH LIMITATIONS». Хотя большинство операций на уровне записей, вероятно, могут избежать Creation Kit, несколько областей остаются нерешёнными (например, FaceGen, navmeshes, сложная семантика квестов). ### Словарь статусов - `VERIFICADO`: подтверждено прямыми доказательствами или воспроизводимым тестом. - `PASS`: эксперимент выполнен и прошёл определённые гейты. - `NO VERIFICADO`: правдоподобно, но не воспроизведено здесь. - `HIPOTESIS`: предложенный эксперимент или проектное утверждение. - `EXPERIMENTAL`: реализовано только как эксперимент. - `BLOQUEADO`: невозможно продолжить в доступной среде. - `DESCARTADO`: явно отклонено. - `LEGAL_REVIEW_REQUIRED`: технический путь существует, но последствия лицензирования/EULA не решены. ## Архитектура Рекомендуемая форма продукта — **гибридный оркестратор + headless-first основной путь**: ```text User Intent ↓ Intent normalizer ↓ Planner / LLM ↓ Typed ModPlan ↓ Policy / safety engine ↓ Capability router ├─ Headless plugin worker ├─ Papyrus worker ├─ xEdit validator └─ Creation Kit worker [disabled until independently verified] ↓ Candidate workspace ↓ Validator ↓ Human approval ``` Планировщик не должен получать произвольные shell-команды или примитивы автоматизации GUI. Операции маршрутизируются к конкретным воркерам в зависимости от типа. ## Проверенная реализация: POC-002 `research/poc_002/` — первый исполняемый proof of concept: - Использует только синтетические TES4-фикстуры. - Реализует строгий парсер с закрытыми перечислениями операций. - Обеспечивает рабочие пространства только для кандидатов с ограничением путей. - Гарантирует fail-closed оркестрацию и квитанции без перезаписи. - Поддерживает инварианты SHA-256 для исходных файлов. - Включает 44 автоматических теста (начальная база: 43; +1 состязательная регрессия). Чтобы запустить POC-002: ```bash cd research/poc_002 python -m compileall . python -m unittest test_suite.py -v ``` Примечание: это не доказывает совместимость с произвольными реальными плагинами Skyrim, поведением среды выполнения Creation Kit, xEdit, PapyrusCompiler, Mutagen или корректностью в игре. ## UI исследования Discovery Desk Репозиторий сохраняет небольшое исследовательское приложение Next.js + Drizzle/PostgreSQL под названием «Discovery Desk». - `src/app/`, `src/db/` и `src/lib/research/` принадлежат этому UI. - Это **не** среда выполнения будущего агента авторинга. - Для разработки требуется переменная окружения `DATABASE_URL` (см. `.env.example`). Процесс сборки быстро завершается с ошибкой, если переменная отсутствует, но для CI не нужен живой сервер PostgreSQL, так как пул соединений ленивый. ## Правила безопасности - Никогда не изменяйте единственную копию плагина пользователя. - Оригиналы — неизменяемые входные данные; записи идут в кандидаты. - Никаких произвольных shell-команд в планах, сгенерированных AI. - Никакой автоматизации GUI с кликами по координатам в качестве основного пути. - Отсутствие доказательств завершения — это неудача, а не успех. - Никогда не коммитьте бинарники игр/редакторов Bethesda, ванильные плагины или ванильные исходники Papyrus. - Изоляция процессов — это техническая граница, а не автоматический вывод о лицензировании. ## Лицензирование - **Основной код, созданный в репозитории**: лицензия MIT. - **Mutagen / Synthesis / Spriggit**: GPL-3.0-only. Комбинированные работы требуют соблюдения GPL. - **xEdit**: upstream MPL-2.0. Предназначен для внешнего выполнения, никогда не вендорится. - **CKPE**: код LGPLv3 плюс EULA/правовой слой Creation Kit. Статус: `LEGAL_REVIEW_REQUIRED`. - **Creation Kit, PapyrusCompiler, ванильные ассеты**: проприетарные компоненты, устанавливаемые пользователем. Никогда не распространяются повторно. Сторонние npm-пакеты и шрифты OFL имеют отдельные уведомления. У импортированных исследовательских ZIP-архивов нерешённое происхождение. ## Связь с Sky-Claw Это отдельный репозиторий и исследовательское направление. Позже он может интегрироваться со Sky-Claw через документированный протокол, но должен оставаться независимо тестируемым и не должен предполагать внутренности Sky-Claw в качестве своей границы безопасности. ## Отказ от ответственности Не связан с Bethesda Game Studios, ZeniMax Media, Valve, Nexus Mods или авторами сторонних инструментов.