Files
Diabolo/HANDOFF.md
T

219 lines
21 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 исполняемый файл по полному пути запускается через оператор `&`.