Files
Diabolo/HANDOFF.md
T

215 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.
- **STL INFERNAL: образец готов, согласование внешнего вида ожидается.**
Коммит образца сохранён локально. Push этой задачи также заблокирован
авторизацией GCM/OAuth: `Missing code in response; could not read Username`.
В origin новые изменения ещё не опубликованы.
`reviews/infernal_v01/` содержит GLB, три карты 4K, GIF ходьбы/оборота/удара/лица,
manifest, validation и отдельную сцену просмотра. В рабочую игру НЕ включён:
по умолчанию по-прежнему `art/succubus/succubus_v02.glb`.
- Сохранены пользовательские исходники `tools/model_sources/infernal.stl`
(1 569 740 треугольников; байты сверены с infernal.zip), color_reference.png,
SOURCES.json, редактируемый infernal_game.blend. Новая игровая сетка:
45 493 вершины / 90 801 треугольник, 166 костей; подставка удалена, подошвы
закрыты. Печатные контакты рук и соединение ботинок разделены. Idle (73),
Walk (33), Whip (65 кадров) перенесены со старого скелета, 24 fps.
- Покраска: красная кожа, чёрный комплект, волосы, крылья, рога и хвост.
По замечанию пользователя исправлено попадание чёрного цвета на открытую
кожу: отдельный материал рук, непрерывные маски, уменьшены лучи запекания.
По дополнительной просьбе пользователя контуры перерисованы по реальным
швам скульпта: чашки, фигурный подол, воротник, ободки сапог. Присланная
оранжевая обводка сохранена как tools/model_sources/approved_paint_boundary.png.
Проекция по глубине отделяет ткань от руки за ней; скрытые складки получают
окраску по соседней поверхности. Контуры — infernal_seams.py.
Глаза/губы выровнены по скульпту; воротник заканчивается ниже подбородка.
Плеть сохранена со старыми morph-анимациями, добавлен радиус шнура 8 мм.
- У крыльев и хвоста лёгкое вторичное движение в покое и при ходьбе. Походка
образца: короткий шаг, раздельные дорожки стоп, IK, ограничение разворота 22°.
Результаты Godot: PASS, ошибка IK <0,000003 м; два масштаба, четыре скорости,
30/60 fps, поворот/остановка, мягкие движения крыльев и хвоста.
- `tools/validate_infernal.py` PASS: три клипа с шагом 4 кадра, нормализованные
веса, конечные координаты, отсутствие подставки, защищённый материал кожи,
три карты 4096²; max edge growth Idle .00234 / Walk .03596 / Whip .06717 м.
GIF сняты заново с окончательного GLB в Godot; дальнейшая правка должна
повторять запись, а не использовать кадры от прежних вариантов.
- Сборка: tools/build_infernal.py -- --bake, модули infernal_skinning/surface/
facepaint/bake/whip/seams.py. Локально finish_infernal.py повторяет покраску из
checkpoint в captures. encode_infernal_review.py кодирует GIF. Полные команды
в reviews/infernal_v01/README.md. Исходники STL/BLEND/GLB через LFS.
- captures/.gdignore исключает технические большие BLEND и кадры из импорта.
Перечисленные ниже модели красного комплекта и реконструкция по картинкам
являются историческими вариантами; их заменил запрос на пользовательский STL.
- Подготовлен **образец на согласование**, ещё не включённый в игровую сцену:
`Demon_v0.19/reviews/heels_v01`. Пользователь запросил каблуки и исправление
стоп при ходьбе, затем уточнил чёрные остроносые ботфорты на широком каблуке,
красный кожаный корсет с воротником/кольцами, ремнями, задней шнуровкой,
наплечниками-крыльями и большие крылья с лёгким покачиванием при ходьбе.
`walking.gif`, `boots.gif`, `outfit.gif` показывают настоящий 3D-образец.
Этот исторический образец заменён текущим STL; в игровую сцену не включён. Исходный `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 исполняемый файл по полному пути запускается через оператор `&`.