Files
Diabolo/HANDOFF.md
T

219 lines
21 KiB
Markdown
Raw Normal View History

# Handoff — Diabolo / DEMON
Обновлено: 2026-10-28. Рабочая версия: `Demon_v0.19`.
## С чего продолжать
- Актуальные исходники, ассеты и тесты: `Demon_v0.19/`.
- Движок: Godot 4.3 stable. Git-ветка: `main`.
- Репозиторий: https://gt.arcade.4bqb.com/jariko/Diabolo.git
- Большие `.glb` хранятся в Git LFS. После клонирования выполнить `git lfs pull`.
- Старые папки версий, ZIP, готовые Windows-сборки, движок и кэш остаются локально.
Имеющаяся локальная сборка EXE устарела относительно исходников.
- Для запуска текущего состояния открывать `Demon_v0.19/project.godot`.
Инструкции сборки и запуска — в `README.md`.
## Последние выполненные задачи
- **Вступление (готово):** новая смена запускает облёт главной героини.
Через 2 секунды проигрывается целиком пользовательская запись Serafina
(`audio/intro_serafina.mp3`, исходный ElevenLabs MP3 от 2026-10-28 18:59:40,
13,087 с). После сигнала AudioStreamPlayer.finished ещё 2 секунды камера
плавно возвращается, затем включается HUD и управление. Симуляция и ввод
во время сцены заблокированы; Idle героини продолжает работать.
Громкость соответствует настройке голоса, фон приглушён. Потеря фокуса
приостанавливает голос и камеру вместе. Продолжение из паузы без повтора.
Код: intro_cinematic.gd, интеграция main.gd и cinematic_idle в succubus_actor.
- Проверки вступления: импорт Godot 4.3 PASS; `--test-intro` PASS (полная запись,
lead/tail, блокировка F5/B/T/Esc, неизменность денег/позиции, движение и возврат
камеры, suspend/resume, отмена при reset, продолжение из паузы). После правки
очистки при shutdown лог без SCRIPT ERROR. `--test-camera-controls` PASS.
Кадр `captures/intro-camera.png` просмотрен: героиня в центре, HUD скрыт.
Запускать «Новая игра»; существующий EXE не пересобирался.
- Вступление коммитится отдельно от незавершённой переработки STL ниже.
Push origin/main выполнен и заблокирован авторизацией GCM/OAuth:
`Missing code in response; could not read Username`. Локальный коммит
сохранён, вступление ещё не опубликовано в origin.
- **Текущая задача (в работе):** пользователь остановил реконструкцию по
изображениям и передал `C:/Users/jaros/Downloads/infernal.zip` с единственной
`infernal .stl`. Исходник извлечён в `tools/model_sources/infernal.stl`
(1 569 740 треугольников). Новый ориентир покраски: красная кожа, чёрные волосы,
корсет, сапоги и крылья; картинка с этой же статуэткой. Нужно убрать подставку,
перенести прежний скелет/анимации и подправить их. Запрос GIF на согласование
по-прежнему действует. Предыдущие картинки и красный комплект ниже больше
не являются текущим вариантом.
- Инструменты STL: `tools/build_infernal.py` (Blender 5), `inspect_infernal.py`,
`probe_infernal.py`, `probe_infernal_rig.py`, `render_infernal_check.py`.
Модель нормализована до 2,2 м по полному STL, подставка срезана на z=.150 м,
подошвы закрыты и сдвинуты к z=0. После среза 1 402 834 треугольника; рабочая
сетка 45 378 вершин / 91 184 треугольника. Готовятся 4K basecolor/normal/ORM.
- Старый `succubus_v02.glb` импортируется в Blender как источник 166 костей и
Idle (73 кадра), Walk (33), Whip (65), 24 fps. Новые rest bones подогнаны
к STL по исходному Idle frame 1. Ключи переносятся по world-space delta
относительно этого Idle, чтобы не опустить руки второй раз из старой A-позы.
Веса тела переносятся от исходной позированной поверхности через KDTree;
крылья/хвост отделяются по геодезической связности поверхности. Это ещё
проверяется: первые прямоугольные маски ошибочно захватывали внутренние
перепонки в запястья, что растягивало их при Whip. Последний build уточняет
цилиндрические arm-seeds и wing-seeds; результат надо пересмотреть.
- Текущие файлы STL-образца: `reviews/infernal_v01/infernal_game.glb`, manifest,
`infernal_gait.gd`, `review.gd`, `review.tscn`. Editable source:
`tools/model_sources/infernal_game.blend`. Пока без baked textures; для
финальной сборки: Blender `--background --python tools/build_infernal.py -- --bake`.
Пакет в игре ещё НЕ включён, по умолчанию по-прежнему старый succubus_v02.
В Godot preview ходьбы IK уже давал ошибку <0,000002 м, но были артефакты
весов, поэтому этот ранний preview НЕ выдавать как готовый результат.
- Служебный `captures/.gdignore` необходим: внутри captures лежит большой
`infernal-inspect/source_inspection.blend`; без .gdignore Godot зависал на его
автоматическом Blender-импорте. Рендеры и инспекционные файлы не игровые ассеты.
При финальном commit добавить только этот marker принудительно, не captures.
- Новый актуальный ориентир пользователя после красного комплекта: три вида
суккубы (спереди, сзади и сбоку), чёрное бикини и броня/ботфорты на каблуках,
длинный высокий чёрный хвост волос, длинные рога, низкие коричневые крылья
с кожистой неровной перепонкой и тонкий шипастый хвост. Запрошены максимальная
точность, реализм и качество текстур. У пользователя нет исходного 3D-файла
и ссылки на автора; это реконструкция по изображениям, точное совпадение
исходной сетки и текстур не подтверждено. Этот референс заменяет красный
комплект ниже. Исправление стоп и слабое покачивание крыльев сохраняются.
- Подготовлен **образец на согласование**, ещё не включённый в игровую сцену:
`Demon_v0.19/reviews/heels_v01`. Пользователь запросил каблуки и исправление
стоп при ходьбе, затем уточнил чёрные остроносые ботфорты на широком каблуке,
красный кожаный корсет с воротником/кольцами, ремнями, задней шнуровкой,
наплечниками-крыльями и большие крылья с лёгким покачиванием при ходьбе.
`walking.gif`, `boots.gif`, `outfit.gif` показывают настоящий 3D-образец.
Ожидается согласование внешнего вида и движения перед подключением героине
и помощницам. Исходный `art/succubus/succubus_v02.glb` не менялся.
- В образце стопы перепривязаны: сустав поднят на 8 см в координатах модели,
исправлены inverse bind matrices и трансляции клипов; подошва жёсткая,
отдельно от каблука, не деформируется пальцами. Предварительная походка:
короче шаг, больше зазор между обувью, разворот опорной стопы ограничен 22°.
Крылья на существующих `Wing.L/R` покачиваются примерно на 2,3° с фазовой
задержкой и затухают при остановке. Сам образец воспроизводится скриптами
`tools/preview_succubus_heels.py`, `succubus_review_outfit.py`,
`review_mesh_cut.py`, `encode_succubus_review.py`.
- Проверки образца `reviews/heels_v01/review_tests.gd`: PASS, размеры героини
и помощницы, 4 скорости, 30/60 fps, поворот 90°, остановка, IK, высота стоп,
ограничение разворота и малая амплитуда крыльев. Максимальная ошибка IK
менее 0,000005 м. `--test-gait`: PASS для прежней основной походки, героини
и трёх помощниц на пяти скоростях, с поворотами, паузой, плетью и телепортом.
Общий `catwalk.gd` получил настраиваемые параметры и метод ориентации стопы
с прежними значениями по умолчанию; `succubus_actor.gd` — необязательную
подстановку PackedScene для отдельной review-сцены. Обычная игра использует
прежние настройки. Остаётся старое предупреждение LOD о вырожденной нормали.
- Туман после последних уточнений опущен ниже колен, ближе к полу:
`knee_fog.gdshader`, `density=.38675` (ещё -30% от `.5525`),
`surface_height=.45` м вместо `.78`. Объём по высоте уменьшен до `.9` м.
Широкие медленно дрейфующие пятна разрежены: пороги шума `.42–.76`,
множитель покрытия `.02–1.5`, больше открытого пола между клубами;
свечение следует пятнам и пропорционально плотности.
Крупные пятна и мелкие клубы движутся общим медленным потоком:
`drift_velocity=Vector2(.16,-.07)` м/с (около 17 см/с); мелкий шум слегка
меняет форму. Плотность и высота при добавлении дрейфа сохранены.
Есть движение мелких клубов, мягкая верхняя граница и расхождение вокруг ног
суккубы. Общий дальний фон остаётся слабым (`.0015`). Объём расширяется вместе
с комнатой. Плотность/высоту пользователь планирует отрегулировать после просмотра.
`--test-camera-controls` и `--test-room-decor` прошли; кадры с персонажами
и максимальным расширением проверены визуально.
- Из комнаты убраны декоративные столы, полки, трубы и мелкий реквизит.
Осталось шесть жаровен: четыре по углам, две у центров противоположных стен.
Симметрия, свет и огонь сохраняются на всех трёх расширениях.
- В пустой мастерской души не появляются. После установки первого орудия
начинается отсчёт пяти секунд. При отсутствии станков таймер стоит,
ворота закрыты, интерфейс предлагает установить первое орудие.
- По последней просьбе пользователя полностью удалена прокрутка камеры
при наведении мыши на края экрана. Следование за суккубой сохранено.
В строительстве работают WASD и средняя кнопка мыши.
- Реплики помещаются в компактное окошко одной строкой. Убраны принудительная
высота, перенос после имени и пустое место снизу; позиция учитывает размер окна.
## Важное поведение и исправления
- Каждой душе назначается ровно одно орудие. После его завершения душа сгорает:
скрытие на 1,7 секунде, удаление тела и эффекта на 2 секунде.
- `workshop.update()` должен вызывать `g.life.update(dt)` один раз за кадр,
вне цикла станков и условий видимости контекстного окна. Ошибка отступа здесь
уже замораживала сгорание и демонят. Для проверки нужен реальный игровой цикл,
а не только прямые вызовы обновления в тесте.
- Поднять орудие: удерживать ЛКМ одну секунду (есть круговой индикатор).
Затем мышь можно отпустить; следующий клик ставит орудие.
Наведение на нижнюю красную полосу продаёт его без клика.
Название и кнопка удаления при переносе не показываются.
- Сетка строительства содержит только полные метровые клетки.
Расширение сохраняет вид камеры и не ограничивает её старыми границами.
- В прокачке нет улучшений характеристик орудий. Уровни навыков отмечены
рубинами; изученные карточки сохраняют яркость. Текст карточек центрирован.
- Неоткрытые орудия в каталоге строительства затемнены.
- Модели суккубов используют `art/succubus/succubus_v02.glb`;
мужчины-души — `art/souls_v04`. Исходные варианты сохранены для переработки.
- Души плавно поворачиваются к носителю, следуют с левитацией и движением
опущенных рук; короткие лоскуты ткани колышутся в полёте.
- Походка демонят привязана к пройденному расстоянию с фиксацией опорной ноги.
Есть периодические занятия: уборка орудий, мытьё пола, рисунок и напевание.
- Реплики душ сейчас отключены (`dialogue.souls_enabled=false`).
## Проверки
Последние прогоны до первоначального переноса в Git:
| Проверка | Результат |
| --- | --- |
| `--test-camera-controls` | PASS после удаления краевой прокрутки и изменения реплик |
| `--test-economy` | PASS, 249 проверок, включая отсутствие душ до первой постройки |
| `--test-room-decor` | PASS, шесть жаровен и симметрия при всех расширениях |
До последних небольших правок также проходили проверки строительства,
расширений, рубинов, сгорания в реальном цикле, полёта душ и походки демонят.
Это не означает, что весь старый набор тестов повторно прогнан на текущем состоянии.
Часть старых сценариев может предполагать душу сразу после старта; теперь нужно
сначала установить орудие и дождаться спавна.
```powershell
& tools/godot/Godot_v4.3-stable_win64_console.exe --path Demon_v0.19 -- --test-camera-controls
& tools/godot/Godot_v4.3-stable_win64_console.exe --path Demon_v0.19 -- --test-economy
```
Графические проверки запускать с обычным рендерером. В `--headless` dummy renderer
выдаёт ошибки для этих моделей. Скриншоты и логи генерируются локально и игнорируются Git.
## Дальнейшая работа
Пользователь подтвердил 2026-10-28: дальнейшую разработку вести в клоне
`Diabolo/Demon_v0.19`, полученном из Git, и сохранять/отправлять все дальнейшие
изменения в репозиторий. Историческая папка `../Demon_v0.19` больше не является
рабочей версией на этом компьютере.
Клон получен с `origin/main` на коммите `3c488b5`; все 27 объектов LFS загружены.
Первичный импорт ресурсов завершён, повторный импорт Godot 4.3 прошёл без
ошибок. Игра запущена из клона с обычным рендерером Vulkan; стартовый лог без
ошибок. Игровой код при получении и запуске не менялся; полный набор тестов
повторно не запускался.
Постоянное правило пользователя: после каждой завершённой задачи коммитить
все изменения по задаче и отправлять в `origin`, обновляя этот handoff в том же
коммите. Повторное подтверждение обычного commit/push не требуется.
Правило для следующих сессий закреплено в `AGENTS.md`.
Обновлять этот файл в том же коммите, что и изменения: текущее состояние,
проверенные результаты, известные ограничения и незавершённая работа.
Подробная история предыдущих задач — `PROJECT_NOTES.md`.
Незавершённых игровых правок нет. Исходники опубликованы в `origin/main`:
первый коммит `2b9ae06`, 347 файлов. Успешно загружены все 27 объектов Git LFS
(539 МБ). Локальная ветка `main` отслеживает `origin/main`.
## Авторизация Git на этом компьютере
Для сервера настроен браузерный OAuth через Git Credential Manager и встроенное
приложение Gitea. Запрашивается `write:repository`; настройки находятся только
в локальном `.git/config`, секреты в исходники не добавляются.
Первая попытка без OAuth не прошла из-за отсутствия входа; после настройки OAuth
полный push исходников и LFS завершился успешно.
В терминале Codex доступен встроенный Git. Пользовательский PowerShell может
не видеть его в PATH. На текущем компьютере полный путь:
`C:\Users\JariKo\.cache\codex-runtimes\codex-primary-runtime\dependencies\native\git\cmd\git.exe`.
В PowerShell исполняемый файл по полному пути запускается через оператор `&`.