Files
Diabolo/HANDOFF.md
T

571 lines
58 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-29. Рабочая версия: `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-сборки, движок и кэш остаются локально.
На рабочем ПК JariKo свежий EXE пересобран 2026-10-29 из `078cc5b`:
`Demon_v0.19_Windows/Demon.exe`. На других ПК локальные EXE могут быть старее.
- Для запуска текущего состояния открывать `Demon_v0.19/project.godot`.
Инструкции сборки и запуска — в `README.md`.
## Последние выполненные задачи
- **Концепты остальных пяти орудий (2026-10-29):** по стилевому референсу
tools/model_sources/iron_maiden_v01/concept.png встроенным image_gen созданы
колодки, дыба, колесо с чаном, музыкальный стул и котёл. Пять PNG 1536×1024,
по шесть ракурсов, сохранены в tools/model_sources/equipment_concepts_v01/.
README рядом содержит полные промпты и ограничения. Визуальная проверка:
все типы и ракурсы присутствуют, объекты целиком, общий стиль выдержан.
Это концепты, а не точные чертежи: мелкая фурнитура/перспектива расходятся,
динамики стула направлены преимущественно вперёд. До моделирования детали
нужно согласовать. Игровые модели и готовый EXE не менялись.
- **Мах рук при ходьбе уменьшен вдвое (2026-10-29):**
`meshy_gait.gd: ARM_WALK_AMPLITUDE=.4` вместо `.8`. Меняется только добавочный
мах и сгиб локтя при движении героини и помощниц; противофаза шага сохранена.
Поза покоя и удар сохраняют прежние настройки. Границы проверки реального
сгиба/разгибания локтей адаптированы к меньшей амплитуде.
`--test-gait` PASS: героиня и три помощницы, пять скоростей, противофазный
мах/сгиб локтей, опора, остановка, удар, пауза и телепорт.
Импорт/экспорт Godot 4.3 и `--test-gait` готового EXE также PASS.
Сборка из `078cc5b`, Build ID: `0.19-4ecbb79c0a7422a1b44444a0`.
SHA256: `14A132864AC882963823F1E9B611906AFA0B40C2A5EA9D432AACA0436F7A61E0`.
Актуальный запуск: Demon_v0.19_Windows/Demon.exe.
- **Свежий EXE с исправлением поздних тормозов (2026-10-29):** импорт/экспорт
Godot 4.3 PASS из `f4a0105`. Build ID: `0.19-f91972feb5c3064540c0120b`.
SHA256: `7746A602247577F990CDCABCF88A2B95DD225F60E5103A9F451D7780B2872450`.
Готовый EXE прошёл `--test-performance-soak`: полный 65-секундный прогон,
обычный спавн, семь душ в очереди, тайм-ауты и фоновые занятия. На 60-й
секунде медиана 10.85 мс / p95 12.57 мс, без прежнего провала до 15 FPS.
Проверки конкретных контактов физики тоже PASS. Лог qa_v19/exe-late-fps-soak.log,
JSON рядом с EXE в captures/performance-soak. Билд запускается из
Demon_v0.19_Windows/Demon.exe; бинарник и отчёты остаются локальными.
- **Сильные тормоза через 30–60 секунд воспроизведены и устранены в soak-тесте
(2026-10-29).** Уточнение пользователя: после построек и появления душ.
Новый `--test-performance-soak` оставляет обычный спавн и потери очереди,
работает 65 секунд реальными кадрами. Старый maiden-профиль выключал спавн
и не покрывал этот сценарий. В baseline время кадра после 35–45 с достигало
68–77 мс; фоновый демонёнок #19 застревал у Meshy-девы в соседней комнате,
и один capsule move_and_collide занимал 56 мс. Утечка эффектов здесь не причина.
- Фоновые устройства теперь используют общие выпуклые формы по частям видимой
модели вместо дорогой проверки декоративных треугольников. Коллизии и обход
в соседних комнатах сохранены. Видимые модели, текстуры и анимации не менялись.
- Игровая железная дева получила три отдельные облегчённые вогнутые collision
shape (3479 треугольников вместо 91076): корпус остаётся полым, две створки
движутся со своими коллизиями. Ресурсы в art/equipment/iron_maiden_v01/collision,
воспроизведение — tools/bake_maiden_collision.gd (сетка 12 см). Поведенческий
тест проверяет закрытую спину, проход через открытый вход выше основания
и блокировку входа закрытыми дверями.
- Исправлена навигация местных демонят: цель разрешается в свободную точку
с учётом радиуса капсулы и кэшируется до смены цели/планировки; после конца
пути демонёнок больше не идёт к исходной точке внутри устройства. Список
свободных точек хранится при rebuild_nav; выбор ближайшей больше не вызывает
сотни повторных проверок геометрии. Параметры общей капсулы не пересоздаются
без изменения размера, нулевое движение пропускается.
- Результаты: 65 с обычного спавна и очереди — PASS, после 30 с медиана около
12–13 мс вместо 68–77 мс; 65 с шестью устройствами и тремя помощницами —
PASS, на 60 с медиана 15.2 мс / p95 16.3 мс. Контакт на известном фоновом
проблемном месте около .4 мс, в игровой комнате около 3.6 мс. Фоновая
активность, души, работа устройств и сгорание сохранены. Сохраняются отдельные
краткие пики первого появления ресурсов; постоянный провал до 15 FPS в этих
прогонах больше не повторился. Test-only профилирование записывает CPU
workshop/soul и самого дорогого демонёнка, в обычной игре оно выключено.
- Регрессии исправления: `--test-iron-maiden` (включая реальное прохождение
открытого входа и блокировку закрытых створок), `--test-mesh`,
`--test-building` (24), `--test-imps`, `--test-maintenance`, `--test-workflow`
(102) — PASS. Soak-флаг поддерживается также в EXE, отчёт сохраняется рядом
с EXE в captures/performance-soak, а не в недоступный для записи res://.
- **Актуальный EXE после F5/оптимизации девы (2026-10-29):** импорт/экспорт
Godot 4.3 PASS из `c48761e`; готовый EXE прошёл `--test-economy` (251)
и `--test-iron-maiden` без ошибок. Build ID: `0.19-0ca1f6fa08323c398f7be46c`.
SHA256: `2A8E88B95F757BD0F345F37387294F48937D2BFAC28C299360B8C4C76EDBFF89`.
Запуск: `Demon_v0.19_Windows/Demon.exe`. Сопроводительные документы и
локальный BUILD_MANIFEST.json обновлены; EXE и QA-логи не публикуются в Git.
- **F5 и нагрузка железной девы (2026-10-29):** одно нажатие теперь добавляет
1000 золота, 1000 душ и опыт до следующего уровня. Один новый уровень даёт
одно очко; на уровне 10 добавляются только валюты. Эхо/отпускание клавиши
бонус не повторяют. `--test-economy` PASS, 251 проверка, включая неполный
уровень, максимум, потраченные очки и сохранение.
- Внутренняя отделка девы облегчена с 195048 до 49272 треугольников:
низкая детализация поперечного сечения мелких трубок/заклёпок, без изменения
внешней Meshy-сетки, рисунка отделки, PBR-карт и петель. Геометрия отделки
и обшивки кэшируется между устройствами, материалы нагрева независимы.
Убраны тени и отдельные коллайдеры внутренней отделки: физика внешнего
корпуса/створок сохранена. Остывший источник накала скрывается; параметры
нагрева отправляются в материалы только при изменении.
- Добавлен `--test-maiden-performance`: реальные кадры основного игрового цикла,
три использования, сгорание/остывание, сценовые объекты/видеопамять,
четыре девы и отдельный замер с замороженными демонятами. Навигация после
размещения перестраивается, как в настоящем строительстве. В раннем варианте
проверки не хватало этой перестройки; его FPS не считать сравнением игры.
После исправления сценария: стабильного накопления душ/эффектов/видеопамяти
и постоянного падения FPS после циклов на этом ПК не подтверждено.
Повторное создание девы: около 0.87–0.88 с до оптимизации против 0.12 с
после; четыре девы: около 15.17 млн против 9.63 млн отрисованных примитивов.
Медиана кадра с четырьмя девами в обоих корректных прогонах около 9.46 мс:
не обещать рост FPS пропорционально снижению геометрии. Пики времени кадра
зависят также от движения демонят/активностей; для дальнейшей диагностики
их CPU-время выводится при включённом test-only профилировании life.update.
Результаты и логи остаются в локальных captures/qa_v19.
- Проверки правок: `--test-maiden-performance`, `--test-iron-maiden`,
`--test-mesh`, `--test-building` (24), `--test-single-punishment` — PASS.
Проверены независимость нагрева кешированных устройств, общие текстуры,
отсутствие коллизий/теней внутреннего декора и выключение остывшего света.
Открытая дева просмотрена визуально. Исправлен старый fixture в mesh-тесте:
перед спавном тестовой души теперь устанавливается устройство.
- **Билд для игры на рабочем ПК (2026-10-29):** повторный импорт и экспорт
Godot 4.3 прошли, сборка из `b0f3b02`, игровой код тот же, что в `ebe00c3`.
Build ID: `0.19-3feb996c59044da8438841ea`.
SHA256: `A0249B2DD91CA71E60FC272B4D8432774476E5CCD242F93414F7E5128EF08B28`.
Обновлены сопроводительные README, credits и локальный BUILD_MANIFEST.json,
чтобы они соответствовали текущему EXE. Запущен для пользователя.
Предыдущий экспорт тех же игровых исходников прошёл `--test-gait`:
героиня/три помощницы, пять скоростей, опора, повороты, остановка, удар,
пауза и телепорт. Повторно этот набор не запускался.
EXE и логи остаются локальными; игровой код не менялся.
- **Амплитуда рук −20% (2026-10-29):** ARM_WALK_AMPLITUDE=0.8 уменьшает мах
плеча и добавочный сгиб локтя относительно положения покоя. Цикл сгибания
вперёд/разгибания назад сохранён; максимум сгиба теперь около 50,8° вместо
60°. Принятый айдл не менялся. `--test-gait` PASS: героиня/3 помощницы,
5 скоростей, мах, углы локтей, опора, остановка, удар, пауза, телепорт.
Изменения в исходниках; EXE не пересобирался.
- **Человеческий цикл рук, итерация 3 (2026-10-28):** локоть больше не остаётся
постоянно согнутым. На передней половине маха плавное сгибание от прежних
14° к 60°, при возврате к бедру и небольшом заднем махе — разгибание.
Фаза общая с шагом, руки и ноги в противофазе. Принятый айдл сохранён.
`--test-gait` PASS: героиня/3 помощницы, 5 скоростей, фактические углы
разгибания <23° и сгибания >50°, передний сгиб минимум на 20° больше
заднего, мах, стопы, остановка, удар, пауза и телепорт. Боковые кадры
просмотрены; `reviews/human_arm_swing_v03/walk.gif`. EXE не пересобирался.
- **Локти при ходьбе, итерация 2 (2026-10-28):** по отзыву пользователя
усилен только сгиб локтей в движении. Принятый айдл сохранён. Предплечья
вращаются относительно маха плеча: центр 52°, вариация ±8° по фазе шага.
При остановке плавный возврат к прежней расслабленной позе; удар не менялся.
`--test-gait` PASS для героини + 3 помощниц на 5 скоростях, включая измерение
локтей 38–68°, противофазный мах, стопы, остановку, удар, паузу и телепорт.
Боковая анимация просмотрена и сохранена: `reviews/walking_elbows_v02/walk.gif`.
Инструмент съёмки дополнен --run-only / --side. EXE не пересобирался.
- **Руки суккубы / айдл / пропуск вступления (2026-10-28):**
`meshy_gait.gd` опускает видимые руки вдоль корпуса, оставляет небольшой
сгиб локтей, задаёт противофазный мах при движении. Учтена разница между
широкой позой скульпта Meshy и наследованным скелетом; сам GLB не изменён.
Поза плавно возвращается после удара, Whip во время удара не перезаписывается.
Усилены дыхание (4,2 с), небольшое расширение грудной клетки, покачивание
плеч/головы, крыльев и хвоста. При движении/ударе айдл затухает; пауза
замораживает его, опорные стопы остаются на месте.
- В `main._input` пробел пропускает активную вступительную сцену, останавливает
голос и возвращает камеру/HUD/управление. Отпускание и автоповтор клавиши
не пропускают сцену; событие поглощается до игрового ввода.
- Проверки: Godot 4.3 import PASS; окончательный `--test-gait` PASS (героиня +
3 помощницы, 5 скоростей, локти/мах рук, усиленный айдл, стопы, остановка,
удар, пауза, телепорт). `--test-intro` PASS: полная запись и 2+2 с сохранены,
дополнительно проверен Space во время lead/речи/tail, камера/голос/HUD,
отсутствие изменения денег/позиции, отпускание и автоповтор.
Крупные планы покоя, бега и удара просмотрены; пятисекундный айдл сохранён
в `reviews/relaxed_arms_v01/idle.gif`, съёмка — tools/capture_relaxed_arms.gd.
Изменения в исходниках; EXE не пересобирался.
- **Внутренняя отделка и накал девы (2026-10-28):** `maiden_interior.gd`
добавляет усилительные рёбра, клёпаные пояса, парные завитки/вензеля,
медальоны и решётчатый пол. Декор створок привязан к существующим петлям;
неподвижные детали объединены по металлу отдельно для каждой части.
Внутренние панели и декор используют исходные PBR-карты Meshy снаружи:
цвет, normal, metallic и roughness, с UV на участки железа/латуни атласа.
Добавлена мягкая внутренняя подсветка, чтобы отделка читалась в цехе.
- `maiden_material.gd` сохраняет исходные карты и параметры металла в
едином PBR-шейдере `maiden_heat.gdshader`. Накал усиливается от красного
до яркого оранжево-жёлтого, с сохранением рельефа, отражённым светом и
плавным остыванием. Высота считается в мировых координатах относительно
станции: локальные оси импортированной GLB отличаются от осей Godot.
Новый шейдер заменяет прежний слабо видимый material_overlay.
- Проверки: импорт Godot 4.3 PASS; `--test-iron-maiden` PASS (общие PBR-карты
внутри/снаружи, привязка декора к обеим створкам, красная стадия, полный
накал, свет, закрытие/награда/открытие/остывание). `--test-single-punishment`
PASS для шести устройств и двух полов душ. Просмотрены открытый вид и
стадии нагрева; кадры сохранены в `reviews/iron_maiden_v02/`.
Эти правки в исходниках; новый EXE в этой задаче не заказывался и не собран.
- **Windows-билд для просмотра новой девы (2026-10-28):** собран из общего
актуального checkout, включая Meshy-суккубу и исправленную железную деву.
EXE: `Demon_v0.19_Windows_maiden_20261028/Demon.exe` (локальный артефакт).
Build ID: `0.19-c732448ff6be2727ffbc0663`; уникальный ID сбрасывает прогресс.
SHA256: `C1EB94181FA6BED4CBDDEECB764839840A34575B3A032ED7D5DC5DD1BA1F93AF`.
Импорт и экспорт PASS. Проверка готового EXE `--test-iron-maiden` PASS без
ERROR; проверка походки предыдущего экспорта этой же задачи PASS.
В iron_maiden_tests исправлен путь кадров в EXE: они пишутся рядом с ним,
а не в доступный только для чтения res://. Изменение касается только QA.
Старый `Demon_v0.19_Windows/Demon.exe` не перезаписан.
- **Актуальная суккуба: Meshy v02 включена в игру и Windows-билд.**
Красная кожа, чёрный комплект/волосы/крылья; исправлены полосы на руках,
добавлен плавный айдл. Подробности — в последнем разделе этого handoff
и `art/succubus/meshy_v02/README.md`. Предыдущая Infernal сохранена.
- **Железная дева Meshy v01 (2026-10-28):** по утверждённому арту создана и
включена вместо процедурной модели. `art/equipment/iron_maiden_v01/`:
GLB, три PBR-карты 4K, manifest и import sidecars. Высота 3,10 м, 92 228
треугольников, отдельные Body / LeftDoor / RightDoor и гладкая внутренняя
обшивка без шипов. Створки получены из закрытого корпуса, а не ошибочного
открытого ракурса арта; нулевые углы собирают исходный закрытый силуэт.
`iron_maiden.gd` подключает модель через equipment.gd. В apparatus_motion
нагрев новой модели использует material_overlay, сохраняя PBR-текстуры.
- Исходник Meshy: multi-image-to-3d `01a1845b-d214-7150-8267-02bdbab6abd8`,
фактический расход 30 кредитов, одна генерация. `tools/model_sources/
iron_maiden_v01/` содержит исходный GLB, утверждённый арт, превью и Blender.
Воспроизводимые команды: build_iron_maiden.py / review_iron_maiden.py.
Ранний локальный вариант выглядел расплавленным: устранены неверные
custom normals после разрезания и Solidify мелких декоративных деталей.
Окончательный вариант пересчитывает нормали и использует отдельную обшивку.
- Проверки девы: Godot 4.3 import PASS без ошибок; `--test-iron-maiden` PASS:
PBR, две независимые петли, 19 промежуточных положений, закрытие/нагрев/
награда/повторное открытие. `--test-single-punishment` PASS для всех шести
устройств, мужской/женской души, сгорания и однократной награды. Рендеры
открытого/промежуточного/закрытого состояния и игровые кадры просмотрены.
Сохранённый обзор: `reviews/iron_maiden_v01/preview.png` и `in-game.png`.
Изменены исходники; Windows EXE не пересобирался.
- **Вступление (готово):** новая смена запускает облёт главной героини.
Через 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 ниже.
Вступление опубликовано в origin/main вместе с остальными накопившимися
коммитами после исправления OAuth 2026-10-28 (см. раздел авторизации).
- **STL INFERNAL: согласован пользователем и включён в игру.**
Образец и включение в игру опубликованы в origin/main. Отправлены все пять
накопившихся коммитов до 7f66396, в том числе вступление и прошлый образец.
Успешно загружены все 8 новых LFS-объектов (254 МБ).
`reviews/infernal_v01/` содержит GLB, три карты 4K, GIF ходьбы/оборота/удара/лица,
manifest, validation и отдельную сцену просмотра. По просьбе «добавляй и запусти»
игровая копия включена в art/succubus/infernal_v01/infernal_game.glb; SHA256
совпадает с согласованным образцом. succubus_actor.gd использует её по умолчанию
для героини и помощниц, с модельной меткой infernal_v01.
infernal_gait.gd содержит согласованную походку, стопы, крылья и хвост;
игровой код не зависит от сцен просмотра. Старые модели сохранены.
- Сохранены пользовательские исходники `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; дальнейшая правка должна
повторять запись, а не использовать кадры от прежних вариантов.
- Проверки включения в игровую сцену: импорт Godot 4.3 PASS, `--test-gait`
PASS (героиня + три помощницы, пять скоростей, повороты, остановка, удары,
пауза, телепорт). `--test-intro` PASS с новой героиней и полной записью.
Кадр облёта просмотрен. Запускается актуальный проект, EXE не пересобирался.
- Сборка: 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 на этом компьютере
2026-10-28 устранена повторявшаяся ошибка OAuth:
`a grant exists with different scope` / `Missing code in response`.
Существующий доступ Git Credential Manager был выдан с `write:repository`,
а новый запрос отправлялся с пустым scope. Отзывать доступ и создавать токен
не потребовалось; восстановлен прежний scope локально для этого checkout:
```powershell
git config --local credential.https://gt.arcade.4bqb.com.oauthScopes write:repository
```
Не удалять эту настройку при дальнейшей работе. Она находится в `.git/config`,
не содержит секрета и не расширяет прежние права. Вход использует существующее
OAuth-приложение Git Credential Manager на том же сервере. Секреты в исходники
и конфигурацию проекта не добавлялись.
После исправления `git push origin main` завершился успешно: удалённый main
перешёл с 3c488b5 на 7f66396; все 8 LFS-объектов (254 МБ) загружены. Таким
образом, модель, её включение в игру, вступление с записью и предыдущие
локальные коммиты опубликованы. После этой записи выполняется отдельный
коммит handoff и завершающий push.
В терминале Codex доступен встроенный Git. Пользовательский PowerShell может
не видеть его в PATH. На этом компьютере полный путь:
`C:/Users/jaros/.cache/codex-runtimes/codex-primary-runtime/dependencies/native/git/cmd/git.exe`.
В PowerShell исполняемый файл по полному пути запускается через оператор `&`.
## Meshy: вариант суккубы для сравнения, 2026-10-28
В `tools/model_sources/meshy_v01/` сохранены GLB, четыре исходных вида,
превью, гифка оборота, измерения и воспроизводимые скрипты проверки.
Задача `multi-image-to-3d` / `01a18440-82d5-70e3-bd4f-720763eae473`
завершена SUCCEEDED, фактический расход 40 кредитов. Повторных платных запусков нет.
Meshy восстановил близкую форму без подставки, но сохранил белую окраску,
несмотря на запрос красной кожи и чёрной одежды. В GLB 1 351 422 треугольника,
нет скелета и анимаций; для игры ещё нужны оптимизация, покраска и риг.
Осмотрены превью спереди/сзади и локальный рендер. В игру вариант не включён,
текущая утверждённая Infernal остаётся активной. Игровые тесты не повторялись:
изменений runtime нет. Подробности и локальный путь Meshy-проекта — в README
рядом с моделью. Сырые ответы с временными ссылками не публикуются.
## Болотные демонята — 28 октября 2026
По запросу пользователя все четыре местных и 24 соседних демонёнка заменены на
модель из `Meshy_AI_Swamp_demon_20250714_texture_fbx.zip`. Исходные FBX и PNG
сохранены в `tools/model_sources/swamp_demon/`; SHA256 записаны в
`Demon_v0.19/art/imps/swamp_v01/manifest.json`. Это пользовательский ассет;
лицензия в архиве отсутствует, происхождение или лицензию от себя не назначали.
Исходный FBX содержит 14 998 вершин / 30 000 треугольников, без скелета и клипов.
`tools/build_swamp_imp.py` воспроизводит нормализацию до 1,28 м, скелет из 14
костей, веса кожи с разделением близких кистей/стоп и экспорт GLB со встроенной
исходной текстурой. Редактируемый `swamp_imp.blend` хранится рядом с исходником,
за пределами игровых ресурсов. FBX, BLEND и GLB хранятся в Git LFS.
`imp_skin.gd` связывает кожу с процедурной походкой и действиями. Ширина шага
берётся из новой анатомии, колени сгибаются в направлении исходной стойки.
Сохранены IK стоп, повороты, остановки и отсутствие марша при блокировке.
Уборка, швабра и рисование используют IK рук; кисти удерживают реквизит,
переход к ходьбе сглажен. Напевание, звук, пауза и очистка реквизита сохранены.
Капсула местных/соседних демонят увеличена до радиуса 0,34 м и высоты 1,18 м;
межперсонажное разделение также учитывает ширину новой модели.
Проверено на Godot 4.3 / Vulkan, RTX 4070 SUPER:
- `--test-imps`: PASS, 30/60/144 fps, две скорости, повороты, остановки,
стопы, переходы действий, все 28 экземпляров, 14 костей, реальные skin binds,
нормализованные веса и конечные ограниченные координаты всех вершин.
- `--test-maintenance`: PASS, четыре действия, реквизит, прерывание, звук,
пауза и очистка. Тест теперь обновляет кожу через gait при съёмке действий.
- `--test-building`: PASS (24), столкновения, обход, перенос при строительстве.
- `--test-sentences`: PASS, составные задания и маршруты помощниц.
- `--test-workflow`: PASS (102), очередь, потери, размещение, расширения и посадки.
- `--test-intro`: PASS, полная запись, блокировка/возврат управления и пауза.
Старый `--test-mode` НЕ PASS: существующий `workshop_tests.gd`, проверка #2,
требует одну душу сразу после `start_game()` при пустом цехе. Это устаревшее
ожидание уже отмечено выше: теперь души появляются после первого орудия.
Этот старый сценарий не переписывался в рамках замены модели; актуальный
workflow и sentences проходят. Не считать старый общий набор полностью зелёным.
Просмотрены игровые крупные планы покоя, шага и рабочих действий в
`captures/imps-v02/`. Кадры и логи остаются локально. Новый EXE/ZIP не создавался.
## Meshy: покраска суккубы на согласование, 2026-10-28
В `tools/model_sources/meshy_v01/painted_v02/` сохранены покрашенный GLB,
цветной референс, гифка оборота, четыре вида и крупные планы лица/корсета.
Retexture `01a18454-81f3-762f-b9b7-57b5e54af4a9`, родитель — прежняя задача
`multi-image-to-3d` / `01a18440-82d5-70e3-bd4f-720763eae473`.
Завершено SUCCEEDED, фактический расход 15 кредитов, повторных запусков нет.
Использован цветной референс пользователя, исходные UV, PBR, 8K base color.
Красная кожа и чёрные одежда, волосы, крылья присутствуют. Локальные рендеры
спереди/сзади, лица и корсета просмотрены; серебристый декор у выреза/воротника
неровный, глаза в текстуре недостаточно чёткие. Вариант ожидает согласования.
GLB структурно проверен: прежние 1 351 422 треугольника, скелета/анимаций нет.
В runtime не включён, игровые тесты не повторялись. Подробности и путь
Meshy-проекта — в README рядом с моделью; временные ссылки не публикуются.
## Meshy: включение в билд, руки и айдл, 2026-10-28
По просьбе пользователя покрашенная Meshy-суккуба включена для героини и помощниц:
`art/succubus/meshy_v02/succubus_game.glb`, `succubus_actor.gd`, `meshy_gait.gd`.
Сетка локально уменьшена с 1 351 422 до 100405 треугольников;
сохранены UV/PBR и карта 8K, перенесены 166 костей, Idle/Walk/Whip и плеть.
Новых платных задач Meshy нет. Воспроизводимая подготовка —
`tools/build_meshy_succubus.py`; исходный painted GLB, старый Infernal BLEND
и производная маска кожи сохранены в tools/model_sources.
Исправлен видимый графический дефект рук: часть предплечья ошибочно получала
веса крыла, а частичная коррекция позы создавала раздвоение. Теперь форма рук
цельная, назначены анатомические веса; совпадающие вершины плечевого шва
получают одинаковые сглаженные веса. Разделены печатные контакты ног/хвоста.
Максимальный рост ребра в пробах удара 0.05535 м, веса нормализованы.
Айдл: дыхание 4,8 с, мягкие движения рук/головы/плеч, крылья и хвост;
плавное затухание при ходьбе и ударе, пауза замораживает, стопы закреплены.
Проверки: повторный импорт PASS без ошибок; --test-gait PASS (героиня и
три помощницы, пять скоростей, повороты, остановки, удар, пауза, телепорт;
добавлены проверки движения айдла, неподвижных стоп и заморозки времени).
--test-intro PASS, полная запись, 2+2 с, блокировка ввода и возврат камеры.
Просмотрены крупные планы idle/walk/whip в игре после исправлений.
Собран `Demon_v0.19_Windows/Demon.exe`; сам EXE проходит --test-gait,
запущен для пользователя (PID 51680, лог captures/meshy-running.log).
Важная особенность текущего запуска: во время работы другой чат изменял
main.gd/equipment.gd и добавлял iron_maiden.gd, ссылающийся на ещё не готовый
ресурс. Их незавершённое состояние не перезаписывалось и не коммитилось
вместе с этой задачей. Для проверок/EXE использован изолированный снимок
49cf962 + изменения суккубы/айдла в captures/meshy-integration/build_source.
Первый импорт снимка сообщал о ещё не импортированных шрифтах и старом LOD;
повторный импорт и игровые/EXE-проверки проходят без SCRIPT ERROR/ERROR.
После завершения параллельной работы общий EXE следует пересобрать из checkout.
Билд и технические кадры/логи локальные; исходники и игровой ассет отправляются в Git.