233 lines
18 KiB
Markdown
233 lines
18 KiB
Markdown
# Вид и каталог
|
||
|
||
Договорённость на срез после событий/сцены и одежды, не текущий код.
|
||
Сцена и тосты: [`events.md`](../11-events/events.md). Портреты: [`portrait-models.md`](../off-queue/portrait-models.md),
|
||
[`portrait-prompt-craft.md`](../off-queue/portrait-prompt-craft.md). Вещи и правила: [`inventory.md`](../07-inventory/inventory.md).
|
||
Экран: [`near-term.md`](../01-shell/near-term.md). Сессия (гость): [`session.md`](../08-session/session.md).
|
||
Протокол: [`protocol.md`](../../protocol.md).
|
||
|
||
Игрок **смотрит** именованную сущность — и может попросить картинку. Каталог `core` перестаёт
|
||
быть «достаточным минимумом»: одежда, комнаты и правила связаны так, чтобы и генератор людей,
|
||
и генератор кадра видели одно и то же. Кадр локации больше не запрещён: это не портрет человека
|
||
без тела, а отдельный субъект.
|
||
|
||
Срез отвечает на вопросы «что можно нарисовать», «почему в промпте худи, а не только рубашка»
|
||
и «какие ещё две ручки дресс-кода отбирают вещи». LLM, ControlNet и бумажной куклы нет.
|
||
|
||
## Что увидит игрок
|
||
|
||
На карточке человека кнопка портрета как сейчас. На панели выбранного узла карты — «создать
|
||
картинку» кабинета, двора, коридора, если у места или его fill есть что сказать генератору.
|
||
В списке одежды, ноши и предметов локации — то же у вещи с непустым `prompt`. Гость смотрящей
|
||
школы жмёт те же кнопки, что хозяин: как `POST .../portrait`, не как pausing-notice.
|
||
|
||
В «Правилах» две новые оси на роль (ученики / сотрудники): аксессуары и обувь. Как форма и
|
||
цвет — с завтрашнего рабочего утра.
|
||
|
||
Новая школа и новый набор одевают шире: худи, пиджак, кеды рядом со старой рубашкой. Живых
|
||
людей молча не переодеваем.
|
||
|
||
## На какие вопросы отвечает
|
||
|
||
- Какой HTTP-субъект кадра, если это не человек: узел карты и тип вещи.
|
||
- Как kind `scene` / `thing` стыкуется с уже собранным портретом, не ломая инварианты 1, 3, 4.
|
||
- Какие дефы ванили получают прозу и fill, чтобы кабинет не рисовался пустым стулом.
|
||
- Как две новые политики одежды фильтруют тот же `Appropriateness`, без нового вида поведения.
|
||
|
||
## Чего нет
|
||
|
||
- LLM-текста, ControlNet, позы в UI, автогенерации всем узлам утром.
|
||
- Спрайтов-слоёв и бумажной куклы: по-прежнему PNG по запросу, слои на карточке — текст и цвет.
|
||
- Картинок у часов, журнала, комбобоксов, тоста без сущности.
|
||
- Группового портрета класса с лицами конкретных учеников.
|
||
- Магазинов, одевания с карточки, новых стран, отдельного пака variety.
|
||
- Черт «любит худи» и экшена `Inspect`.
|
||
- Лифта живых `portraitSettings` и живого гардероба.
|
||
|
||
## Что меняется в уже принятом
|
||
|
||
| Было | Стало | Почему |
|
||
| --- | --- | --- |
|
||
| Kind `scene` запрещён ([`events.md`](../11-events/events.md)) | Узел карты — отдельный субъект кадра | «Просматриваемое» уже есть на панели локации |
|
||
| Картинка только у человека и notice с `personId` | Плюс узел и вещь с непустым вкладом | Иначе кабинет и куртка только текстом |
|
||
| Одежда в промпте из локали карточки | Слой одежды берёт английский `prompt` с ThingDef | RU UI не должен кормить Krea русским существительным |
|
||
| Ванильный гардероб — минимум для генератора | Закрытый расширенный список + цвета | Иначе новые правила не из чего выбирать |
|
||
| Стул и большинство комнат молчат в кадре | Ключевые Room/Thing говорят; `Chair` по-прежнему пустой | Бюджет сцены; не каждый fill |
|
||
| Правила: форма × цвет (и речь сбоку) | Плюс аксессуары и обувь | Две оси, которые уже есть слоями |
|
||
| «Портреты одежды не этот срез» ([`inventory.md`](../07-inventory/inventory.md)) | PNG вещи по кнопке, не спрайт на слое | Просмотр, не кукла |
|
||
| Гость генерирует портрет человека, не notice | Гость генерирует и локацию, и вещь | Смотреть чужую школу иначе слепое |
|
||
|
||
Протокол: новые HTTP маршруты узла и вещи. Версию сокета **не** бампим. Сейв: PNG рядом с
|
||
портретами; у правил одежды два новых поля с подъёмом `free`. Живые `portraitSettings` не
|
||
переписываем: нет kind `scene`/`thing` — fallback из опций.
|
||
|
||
## Этап A — каталог
|
||
|
||
Школа целая без арта кабинета: люди разнообразнее, портрет человека уже видит худи и доску.
|
||
|
||
### Гардероб
|
||
|
||
Закрытый список **новых** `ThingDef` в `core` (слои как в срезе 7, не новые роли):
|
||
|
||
| Def | Слой | Зачем |
|
||
| --- | --- | --- |
|
||
| `Hoodie` | OverTop | Неформальный верх |
|
||
| `Cardigan` | OverTop | Теплее свитера, спокойнее худи |
|
||
| `Vest` | OverTop | Жилет, формальность выше |
|
||
| `Blazer` | OverTop | Пиджак; снимается отдельно от брюк |
|
||
| `Polo` | Top | Между футболкой и рубашкой |
|
||
| `Blouse` | Top | Женский верх, формальность |
|
||
| `Turtleneck` | Top | Водолазка |
|
||
| `Tights` | Socks | Колготки, `sex: female` |
|
||
| `Leggings` | Bottom | Неформальный низ, женский |
|
||
| `Sweatpants` | Bottom | Спортивные штаны не-PE |
|
||
| `Sneakers` | Shoes | Кеды, низкая формальность |
|
||
| `SchoolShoes` | Shoes | Школьные туфли, тег school |
|
||
| `Cap` | Head | Кепка, не шапка от мороза |
|
||
| `Headband` | Head | Ободок |
|
||
| `Raincoat` | Outer | Плащ; не шуба |
|
||
| `PeTrackPants` | Bottom | PE-низ полной длины рядом с шортами |
|
||
|
||
Новые `ColorDef`: `Navy` (`neutral`, `school`), `Brown` (`neutral`), `Burgundy` (`neutral`),
|
||
`Pink` (`bright`), `Yellow` (`bright`). Существующие вещи **могут** получить Navy/Brown в
|
||
`colors`, где это уместно (брюки, пиджак), без смены палитры на радугу.
|
||
|
||
На **каждой** носимой вещи, включая уже существующие `TShirt` / `Shirt` / …, заполняется
|
||
английский блок `prompt` (тот же вид, что у доски). Пустой — вещь в портрете человека
|
||
по-прежнему собирается из подписи; цель ванили — непустой блок, чтобы locale карточки не
|
||
текла в Swarm. Длина фрагмента как у сцены: ≤ 120 символов, иначе ошибка загрузки.
|
||
|
||
Генератор одежды включает новые def в те же броски слоёв (`optionalApparelChance` и выбор
|
||
низа/верха/обуви). Детерминизм: тот же сид + карта + страна → тот же ростер; состав одежды
|
||
на **новой** школе может отличаться от старого золотого отпечатка — фикстуру обновляет эта
|
||
фаза. Живой `people.json` не дополняем худи задним числом; новый набор (create / yearly
|
||
intake) — да.
|
||
|
||
### Комнаты, fill, правила
|
||
|
||
Непустой `prompt` у ванильных мест, которые игрок реально открывает: `Classroom` (уже есть),
|
||
`Library`, `ComputerLab`, `GymHall`, `Cafeteria`, `MedicalOffice`, `PrincipalsOffice`,
|
||
`TeachersRoom`, `SecretaryOffice`, `UtilityRoom`, меняльные, `SchoolYard`, `EntranceHall`,
|
||
`Corridor`. `Restroom` — короткая проза умывальной, не кабинки крупным планом. `Stairwell`,
|
||
этажи и корпуса без текста **молчат** (кнопки не будет).
|
||
|
||
Новые fill-вещи (слоты на def комнаты и/или дефолтной карте, не свободная геометрия):
|
||
|
||
| Def | Куда |
|
||
| --- | --- |
|
||
| `PottedPlant` | класс, библиотека, кабинет директора |
|
||
| `WallPoster` | класс |
|
||
| `NoticeBoard` | холл |
|
||
| `GymMat` | зал |
|
||
|
||
`Chair`, `StudentDesk`, шкафчик без прозы — молчат, как сейчас. Связность: fill с текстом
|
||
попадает в сборщик сцены человека (фаза 66 уже спрашивает fill) и позже в кадр узла.
|
||
|
||
Две оси на `DressRulePair`, те же роли ученики/сотрудники, вступление **с завтра**:
|
||
|
||
| Ось | Значения | Смысл |
|
||
| --- | --- | --- |
|
||
| Аксессуары | `free` / `none` | `none` — слой `Accessory` в школе неуместен (ремень, шарф). Шапка от холода не аксессуар |
|
||
| Обувь | `free` / `uniform` | `uniform` — обувь с тегом цвета `school` и формальностью не ниже обычной; кеды не в школу (PE — свой режим) |
|
||
|
||
Дефолт обеих — `free`, чтобы живая школа без полей вела себя как сегодня. Неизвестный код —
|
||
`400`, как у формы/цвета. Речь не трогаем. Новых `ApparelIssue` достаточно, чтобы утренний
|
||
dresser снял/заменил; ходьбу и магазины не открываем.
|
||
|
||
После этапа портрет человека уже богаче; клик по кабинету ещё может не рисовать.
|
||
|
||
## Этап B — кадр с панели
|
||
|
||
Школа целая: кнопка на том, что уже открыто глазом.
|
||
|
||
### Субъект
|
||
|
||
Три субъекта, не четвёртый kind портрета человека в том же URL:
|
||
|
||
| Субъект | Ключ | PNG | Сборка промпта |
|
||
| --- | --- | --- | --- |
|
||
| Человек | как сейчас | `saves/{id}.portraits/` | внешность + одежда + сцена узла |
|
||
| Узел карты | id узла | `saves/{id}.images/node.{safeId}.png` | место + fill + погода, если улица; **без** лиц карточки |
|
||
| Вещь | `defName` + цвет, если есть | `saves/{id}.images/thing.{def}.{color\|none}.png` | блок вещи + цвет + износ, если смотрим надетое; без человека |
|
||
|
||
HTTP (имена уточнит фаза, смысл нет):
|
||
|
||
- `GET`/`POST` `.../nodes/{nodeId}/image` и `.../image/prompt`
|
||
- `GET`/`POST` `.../things/{defName}/image?color=` и `.../image/prompt`
|
||
|
||
Неизвестный узел / def — `404`. Пустой вклад (нет ни одного фрагмента) — `400` `cannot-generate`,
|
||
Swarm не зовём. Swarm как у портрета: `503` / `502` / `504`. Гость — `201`, не `403`.
|
||
|
||
В шаблоне `swarmui.json` у пресетов появляются shot kind `scene` и `thing` (проза кадра без
|
||
человека). Живая копия без них **не лифтится**: сборщик подставляет fallback из
|
||
`SimulationOptions` (строки по умолчанию, не константы в билдере).
|
||
|
||
Кадр локации не портретирует присутствующих поимённо. Если в узле кто-то есть, допустим **один**
|
||
общий фрагмент из опций («pupils at desks») — не список имён и не их одежда.
|
||
|
||
Вещь на карте — тип fill, без нового instance id в сейве. Вещь на человеке в промпт кладёт
|
||
цвет и полосу износа; ключ кэша PNG — def+цвет, не personId (перегенерация обновляет файл).
|
||
|
||
### Кнопка
|
||
|
||
Панель локации, строка одежды/ноши, строка предмета в локации: кнопка только если GET prompt
|
||
(или эквивалентная проверка вклада) не пустой. «Показать промпт» — тот же текст, что уйдёт в
|
||
Swarm. Открытие панели не генерирует. Строки через `t(...)`.
|
||
|
||
Notice `generateImage` не меняем: по-прежнему человек и хозяин.
|
||
|
||
После этапа клик по кабинету или белой футболке даёт PNG.
|
||
|
||
## Где живёт код
|
||
|
||
Нового проекта нет.
|
||
|
||
| Что | Куда |
|
||
| --- | --- |
|
||
| Новые Thing/Color, `prompt` на одежде и комнатах, слоты fill | `HSchool.Content` + JSONC `core` |
|
||
| Генератор гардероба, золотой ростер | `HSchool.People` |
|
||
| Уместность аксессуаров и обуви | `HSchool.Content.Appropriateness` + dresser в Simulation / People |
|
||
| HTTP картинки узла и вещи, PNG, fallback shot | `HSchool.Server` (сервис портретов / работник спрашивает карту) |
|
||
| Маршруты | `docs/protocol.md` (+ клиент `api.ts`); сокет не трогаем |
|
||
| Кнопки на панели и карточке | `src/HSchool.Client/src/ui` |
|
||
| Kind `scene`/`thing` в шаблоне | `swarmui.json` |
|
||
|
||
Инвариант 4: Simulation по-прежнему не знает Swarm. Сборщик кадра узла — тот же работник, что
|
||
спрашивает комнату для портрета.
|
||
|
||
## Советы, которые стоит принять сразу
|
||
|
||
- Не вешать картинку локации на кадр присутствия 2 Гц: PNG по HTTP, как портрет.
|
||
- Не давать вещи instance id «чтобы кэш был уникальнее». Def+цвет дешевле смены `people.json`.
|
||
- Не лифтить живой гардероб «всем по худи». Разнообразие — create и набор.
|
||
- Не рисовать корпус без `prompt`: этаж в дереве остаётся навигацией.
|
||
- Не складывать `scene` в `PortraitKind` человека: иначе `kind=scene` на `/people/.../portrait`.
|
||
- Гость жжёт GPU на картинке кабинета — это уже так на лице; очередь Swarm общая.
|
||
|
||
## Заведомо не сейчас
|
||
|
||
- LLM, ControlNet, редактор позы, автоген утра.
|
||
- Бумажная кукла, иконки слоёв, арт на каждом ряду дерева сразу (только выбранный узел).
|
||
- Журнал оценок как картинка, погода у часов как PNG.
|
||
- Групповое фото класса, лица с карточек на кадре кабинета.
|
||
- Магазин, стирка, игрок одевает, новые `CountryDef`.
|
||
- Черты вкуса к одежде, `Inspect` как действие ИИ.
|
||
- Лифт `portraitSettings`, возврат SDXL.
|
||
|
||
## Зафиксировано этим разговором
|
||
|
||
| Тема | Решение |
|
||
| --- | --- |
|
||
| Форма | Один срез 16, не два и не side-work |
|
||
| Просматриваемое | Человек, узел карты, надетое/несомое, fill локации |
|
||
| Kind `scene` | Да, без человека в сборке |
|
||
| Каталог | Закрытый список в `core`, не пак |
|
||
| Связность | `prompt`, fill, теги, правила — без новых глаголов ИИ |
|
||
| Правила | Аксессуары `free`/`none`, обувь `free`/`uniform`, с завтра |
|
||
| Гость | Как портрет человека, не как notice |
|
||
| Живые школы | Без лифта лиц и гардероба; правила без полей → `free` |
|
||
| Кэш вещи | def + цвет, не экземпляр |
|
||
| Стоп | После A школа в разнообразии; после B — кнопка на панели |
|
||
| Протокол | HTTP в коммите 87; сокет не +1 |
|
||
| Ваниль/пак | `core` |
|