Files
Diabolo/HANDOFF.md
T

539 lines
55 KiB
Markdown
Raw Normal View History

# 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 из `c48761e`:
`Demon_v0.19_Windows/Demon.exe`. На других ПК локальные EXE могут быть старее.
- Для запуска текущего состояния открывать `Demon_v0.19/project.godot`.
Инструкции сборки и запуска — в `README.md`.
## Последние выполненные задачи
- **Сильные тормоза через 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.