Leonid PershinandCursor
b24c1b5d4b
Align architecture/cli/decisions with modules and Debug API; cross-link seed overlays and scrape→FTS so user docs match 0.2.0. Co-authored-by: Cursor <cursoragent@cursor.com>
55 lines
3.5 KiB
Markdown
55 lines
3.5 KiB
Markdown
# Локальные папки приложения
|
||
|
||
Все живут в корне gpu-rent.
|
||
|
||
**Одно правило:** пусто (только README / `.gitkeep`) → ничего не синхронизируем. Появился файл → на `up` (или отдельной командой) едет инкремент по SHA256. С сервера лишнее **не** удаляем.
|
||
|
||
```powershell
|
||
# положил LoRA / wildcard / workflow локально
|
||
.\gpu-rent.ps1 push # или просто следующий up
|
||
.\gpu-rent.ps1 pull-output # картинки с VM → ./Output
|
||
```
|
||
|
||
| Локально | На VM | Направление | Обязательно |
|
||
| --- | --- | --- | --- |
|
||
| `Models/` | `/mnt/swarm_data/Models/` | push | да, если не пусто; см. [models.md](models.md) |
|
||
| `Wildcards/` | `/mnt/swarm_data/Data/Wildcards/` | push | да, если не пусто |
|
||
| `CustomWorkflows/` | `/mnt/swarm_data/CustomWorkflows/` → bind в ComfyUI CustomWorkflows | push | да, если не пусто |
|
||
| `Output/` | `/mnt/swarm_data/Output/` | **pull**, опционально | нет; флаг `PULL_OUTPUT`; `stop --no-pull` отключает на этот раз |
|
||
|
||
Веса, картинки, воркфлоу в git не коммитить (`.gitignore` + `.gitkeep`).
|
||
|
||
## Seed overlay (не `gpu-rent push`)
|
||
|
||
Другой механизм — не SHA256-синк четырёх деревьев выше:
|
||
|
||
| Локально | На VM | Когда |
|
||
| --- | --- | --- |
|
||
| `assistent-personas/` | `/mnt/swarm_data/Assistent/personas/<id>/` | `up` / `seed-personas`; см. [extensions.md](extensions.md) |
|
||
| `datasets/civitai/search.jsonl` | `Assistent/civitai-examples.jsonl` | `up` / `seed-personas`, если файл есть; см. [datasets/README](../datasets/README.md) |
|
||
|
||
## Push (Models / Wildcards / CustomWorkflows)
|
||
|
||
Как у моделей: нет содержимого кроме README/`.gitkeep` — skip. Новый или изменённый файл — SFTP. Метадата рядом с весами едет парой. Команда на все три дерева: `gpu-rent push`.
|
||
|
||
Wildcards: `.txt` (одна строка — один вариант), как в доке SwarmUI `Data/Wildcards`.
|
||
|
||
CustomWorkflows: JSON воркфлоу Comfy/Swarm. После заливки на живой UI — refresh, если API это умеет; иначе `systemctl restart swarmui` только если без refresh файлы не видны (spike).
|
||
|
||
Пока идёт push крупных файлов — idle-killer на паузе.
|
||
|
||
## Pull Output (опционально)
|
||
|
||
`PULL_OUTPUT=false` по умолчанию. Включить: `PULL_OUTPUT=true` или `gpu-rent pull-output`.
|
||
|
||
Когда включено:
|
||
|
||
- на **`stop`** — забрать с VM файлы, которых нет локально или чей sha другой;
|
||
- на **`up`**, если VM уже жива и флаг включён — то же (подтянуть картинки с прошлой сессии, не дожидаясь stop).
|
||
|
||
Пустой локальный `Output/` — норма. С сервера ничего не стираем. Не тащить гигабайты видео без нужды: только новые/изменённые.
|
||
|
||
`gpu-rent stop --no-pull` — выключить pull на этот раз.
|
||
|
||
Отдельная команда всегда: `gpu-rent pull-output` (нужны живая VM и SSH).
|