[2026-09-22] eagle: family/how-to/tv-lampac-plugin.md personal/plans/lampac-kraken.md personal/plans/lampac-watchlist-plugin.md personal/tech/lampac-deployment.md

personal/plans/lampac-kraken.md

@@ -49,9 +49,13 @@ related:
 ## Что разворачиваем
 
 `lampac-nextgen/lampac` (MIT, .NET 10), порт **9118**.
-Внутри: TorrServer (subprocess) + JacRed (Jackett-совместимый индексатор) + LampaWeb + TmdbProxy + DLNA.
+Внутри: TorrServer (subprocess) + JacRed (Jackett-совместимый индексатор) + LampaWeb + TmdbProxy + DLNA
++ **Catalog** (каталоги; включён нами — см. шаг 7).
+
+**Плагины для Lampa:**
+- `http://<lampac>:9118/online.js` — онлайн-источники (70+)
+- `http://<lampac>:9118/catalog.js` — каталог «Мой список» (watchlist)
 
-**Плагин для Lampa:** `http://<lampac>:9118/online.js`
 **UI для LG:** `/lg.ipk` отдаёт сам Lampac.
 
 ## Целевой хост
@@ -134,14 +138,21 @@ curl -fsS "http://localhost:9118/version?type=hash"
 - буфер плеера: **50–100 МБ**
 - качество по скорости: до 10 Мбит → 720p; 10–25 → 1080p
 
-### 7. 🔜 Следующий шаг после плана — ПЛАГИН БИБЛИОТЕКИ
+### 7. 🔜 Шаг 7 плана — ВЫПОЛНЕН (серверная часть)
 
-После того как Lampac поднят и Lampa с ним работает — **следующим шагом ставим плагин библиотеки**,
-чтобы ТВ видел фильмы, а не только публичные раздачи.
+**Статус: сделано 2026-09-22.** Отдельный план — [[personal/plans/lampac-watchlist-plugin]].
 
-- Источник библиотеки: медиафайлы на диске Кра́кена
-- Механизм: плагин Lampa, который ходит к библиотеке как к источнику воспроизведения
-- Детали механизма — **отдельный план** после приёмки шагов 1–6
+Итог: `movies-watchlist.md` отдаётся каталогом Lampa через модуль `Catalog`:
+
+- Плагин на ТВ: `http://192.168.1.14:9118/catalog.js` → источник **«Мой список»**
+- 4 категории: Фильмы 360 · Новинки 34 · Мультфильмы 3 · Аниме 7
+- Автообновление: cron `30 2 * * *` → `~/scripts/watchlist-catalog.sh`
+
+⚠️ **Исходная формулировка шага 7 была неточной** («плагин, который ходит к библиотеке
+как к источнику воспроизведения»). Уточнено Alex: задача — **отображение списка**, не плейбэк.
+Механизм — встроенный модуль `Catalog`, свой плагин не писался.
+
+**Осталось:** Alex добавляет плагин на ТВ пультом (1 минута, см. план).
 
 ## Журнал сессии 2026-09-22 (вторая часть)
 
@@ -241,47 +252,85 @@ curl -fsS "http://localhost:9118/version?type=hash"
 **Отключить выбор источника:** Lampa → Настройки → Плагины → выключить `online.js`.
 Останутся только торренты.
 
-### Следующий шаг
+### Следующий шаг — ✅ ВЫПОЛНЕН 2026-09-22
 
-Шаг 7 плана — **плагин библиотеки** (watchlist в UI Lampa).
-Детали — отдельный план `personal/plans/lampac-watchlist-plugin.md`.
-Отдельно решается: [[family/how-to/tv-luna-send]] и [[family/how-to/htpc-webos-luna]].
+Шаг 7 (watchlist в UI Lampa) **сделан**. Полный план и все питфоллы —
+[[personal/plans/lampac-watchlist-plugin]]. Кратко:
 
-### Где что лежит (шаги 1–2, финально)
+- Включён встроенный модуль **`Catalog`** (`SkipModules` без него + `catalog: true`)
+- Написан генератор `gen_watchlist.py`: `movies-watchlist.md` → JSON
+- `init.conf`, `sites/`, `wwwroot/` смонтированы на HDD — правки переживают пересоздание
+- Cron `30 2 * * *` → `~/scripts/watchlist-catalog.sh`
+- Отдача: 4 категории — Фильмы 360 · Новинки 34 · Мультфильмы 3 · Аниме 7
+
+⚠️ **Смонтирован `config-module/init.conf` — это исправляет шаг «init.conf без volume»**,
+который раньше числился в открытых задачах.
+
+Осталось на Alex: добавить на ТВ плагин `http://192.168.1.14:9118/catalog.js` (пультом).
+
+Сопутствующие доки: [[family/how-to/tv-luna-send]], [[family/how-to/htpc-webos-luna]],
+[[family/how-to/tv-lampac-plugin]].
+
+### Где что лежит (финально)
 
 ```
 Кра́кен: /srv/dev-disk-by-uuid-6194539b-03e0-4f33-986b-4da09834e82f/lampac/
-  ├── docker-compose.yml   # lampac + встроенный TorrServer, порт 9118
-  ├── config/              # → /lampac/config
-  ├── cache/               # → /lampac/cache (кэш TorrServer)
-  └── data/                # → /lampac/data (БД JacRed)
+  ├── docker-compose.yml          # lampac + встроенный TorrServer, порт 9118
+  ├── config/                     # → /lampac/config
+  ├── cache/                      # → /lampac/cache (кэш TorrServer)
+  ├── data/                       # → /lampac/data (БД JacRed)
+  ├── config-module/init.conf     # → /lampac/init.conf:ro (включает Catalog)
+  ├── catalog/sites/              # → /lampac/module/Catalog/sites
+  ├── catalog/override/           # → /lampac/module/Catalog/override
+  ├── wwwroot/                    # → /lampac/wwwroot (JSON-каталог)
+  └── scripts/gen_watchlist.py    # генератор .md → JSON
 ```
 
-Содержимое `docker-compose.yml`:
-```yaml
-services:
-  lampac:
-    image: ghcr.io/lampac-nextgen/lampac:latest
-    container_name: lampac
-    platform: linux/arm64
-    restart: unless-stopped
-    ports:
-      - "9118:9118"
-    environment:
-      - TZ=Asia/Bishkek
-      - LANG=ru_RU.UTF-8
-    volumes:
-      - ./config:/lampac/config
-      - ./cache:/lampac/cache
-      - ./data:/lampac/data
-```
+Полный актуальный compose — в [[personal/tech/lampac-deployment]] (раздел docker-compose).
+Здесь не дублирую: файл меняется, а копия в двух местах гарантированно рассинхронизируется.
 
 Управление: `cd /srv/.../lampac && docker compose {up -d,logs -f,restart,down}`.
 Правка compose — без `sudo` (каталог `kraken:kraken`), но создание каталогов — через `sudo mkdir`.
 
-## Журнал сессии 2026-09-22
+## Журнал сессии 2026-09-22 (третья часть) — каталог watchlist
 
-**Итог: правки плана выполнены, шаги 1–6 НЕ начаты.**
+**Шаг 7 выполнен. Все шаги 1–7 базового плана закрыты (кроме шага 3 — лимит кэша).**
+
+Работа велась по отдельному плану [[personal/plans/lampac-watchlist-plugin]].
+Ключевое, что касается этого документа:
+
+**Изменён `docker-compose.yml`** — добавлено 4 монтирования (7 всего):
+
+| Монтирование | Зачем |
+|---|---|
+| `./config-module/init.conf:/lampac/init.conf:ro` | включает модуль Catalog |
+| `./catalog/sites:/lampac/module/Catalog/sites` | описания каталогов |
+| `./catalog/override:/lampac/module/Catalog/override` | переопределения |
+| `./wwwroot:/lampac/wwwroot` | JSON-каталог отдаётся статикой |
+
+**Создан `config-module/init.conf`** — минимальный, перекрывает `base.conf`:
+`SkipModules` без `Catalog` + `LampaWeb.initPlugins.catalog: true`.
+
+🔴 **Питфолл `SkipModules`:** наш `init.conf` **перекрывает** `base.conf`, а не сливается с ним.
+Поэтому список `SkipModules` надо повторять **целиком** — иначе модули из base вернутся к дефолту.
+
+### Ошибки сессии
+
+1. 🔴 **Придумал вопрос «что играть по клику»** (развилка A/B/C про источник воспроизведения).
+   Alex: «я чё тебе сказал в постановке задачи». Задача была — **отображение**, не плейбэк.
+   **Урок:** в постановке было сказано буквально; развилки сверх неё — выдумка.
+2. 🔴 **Полез разбирать `luna-send` наугад**, не прочитав доки по ТВ. Они уже были:
+   [[family/how-to/tv-luna-send]], [[family/how-to/htpc-webos-luna]] — там прямо описан
+   питфолл «пишет в tty, нужен `script -q -c`». Alex: «Доки по тв читал?!».
+   **Урок:** перед работой с хостом — искать док в vault, а не экспериментировать.
+
+### Что осталось
+
+1. **Лимит кэша TorrServer** (шаг 3) — дефолт. Единственный незакрытый шаг. Критичность низкая.
+2. **Alex добавляет плагин на ТВ** пультом — `catalog.js`.
+3. **Проверка полосы на торрент-источнике** — не сделана.
+
+## Журнал сессии 2026-09-22
 
 ### Что сделано
 

personal/plans/lampac-watchlist-plugin.md

@@ -7,7 +7,7 @@ related:
   - '[[family/projects/watchlist-sync]]'
   - '[[family/projects/watchlist-automation]]'
   - '[[family/documents/movies-watchlist]]'
-status: proposed
+status: active
 tags:
   - lampac
   - lampa
@@ -21,16 +21,26 @@ type: plan
 updated: '2026-09-22'
 ---
 
-# Watchlist в UI Lampa — каталог из списка (план)
+# Watchlist в UI Lampa — каталог из списка
 
-> Составлен 2026-09-22, переписан после разведки кода Catalog. Ждёт подтверждения Alex.
+> Реализовано 2026-09-22. План был переписан после разведки кода модуля Catalog.
 > Базовое развёртывание — [[personal/plans/lampac-kraken]] (шаги 1–6 закрыты).
+>
+> **Итог одной строкой:** Lampac отдаёт `movies-watchlist.md` как каталог Lampa
+> через модуль `Catalog` → 4 категории (360/34/3/7 позиций), автообновление кроном 02:30.
+> Работает на стороне сервера; на ТВ остаётся добавить плагин
+> `http://192.168.1.14:9118/catalog.js` (см. «Что осталось на Alex»).
 
 ## Задача
 
 Показывать список фильмов Alex (`family/documents/movies-watchlist.md`) **в UI Lampa на ТВ** — каталогом.
 Не локальный плейбэк. Формулировка Alex: «отображение фильмов из списка».
 
+⚠️ **Что НЕ спрашивать повторно.** Задача — **отображение**, не воспроизведение.
+Список — это перечень, а не источник видео. Вопрос «а что играть по клику?» —
+**выдумка сверх постановки**, Alex на него реагировал раздражением («я чё тебе сказал в постановке задачи»).
+Штатное воспроизведение Lampa (торренты/онлайн) работает само, отдельно решать нечего.
+
 ## ✅ Затык снят: чем это делается
 
 В образе Lampac уже есть модуль **`Catalog`** — YAML-каталоги → плагин Lampa `/catalog.js`.
@@ -139,35 +149,179 @@ Lampa на ТВ: плагин http://192.168.1.14:9118/catalog.js
 
 **Склоняюсь к (1)** — генерировать `wwwroot/watchlist.json`, Lampac отдаёт его сам, без новых сущностей.
 
-## Что показывать в каталоге
+## Обновление каталога — реализовано
 
-Секции берём из самого файла: `## Фильмы`, `## Мультфильмы`, `## Аниме` → три категории меню.
-Поля: `name` (название), `year`, `href` (ссылка на Кинопоиск — уже есть в файле как `[название](https://www.kinopoisk.ru/film/NNN/)`),
-`image` — постер (можно взять через TMDB-кэш Lampac, `tmdbproxy`).
+Скрипт `~/scripts/watchlist-catalog.sh` (root:root, ставить только `sudo install -m 755`):
 
-⚠️ **`href` в файле — ссылка Кинопоиска**, а Lampa ждёт карточку. Отрисовку карточки решает `card_parse`
-(в vokino он ходит по `{host}/view/{uri}`). Для нашего случая возможен режим **только список, без карточки** —
-проверить на этапе реализации.
+1. `python3 $LAMPAC/scripts/gen_watchlist.py <watchlist.md> $LAMPAC/wwwroot/watchlist.json`
+2. `docker restart lampac` — **обязательно**, сбрасывает кэш Catalog (см. питфолл 3)
 
-## Обновление каталога
+Cron: `30 2 * * *` → лог `~/logs/watchlist-catalog.log`.
+Время выбрано после `watchlist-nightly` (01:00) и `watchlist-cleanup` (02:00).
 
-- Генератор дёргать **после** `watchlist-nightly.sh` (уже кроном 01:00 на Кра́кене) — догенерировать JSON
-- ⚠️ `watchlist-nightly.sh` в `~/scripts/` — **root:root**, правка только `sudo install -m 755`
-- Партия данных меняется (`⬇️`, `[x]`, 👍→перенос) — JSON пересобирать после каждого прогона
+Бэкап crontab перед установкой: `~/crontab-backup-20260922-112915.txt`.
 
-## Шаги (черновик, уточняется на этапе реализации)
+⚠️ **`watchlist-catalog.sh` сделан отдельной задачей, а не врезан в `watchlist-nightly.sh`.**
+Причина: `nightly` — рабочий боевой скрипт, его падение остановило бы весь пайплайн списка.
+Отдельный cron падает изолированно.
 
-1. Включить модуль Catalog: `SkipModules` + `catalog: true`, закрепить `init.conf` volume.
-2. Смонтировать `module/Catalog/` (или только `sites/` + `override/`) на HDD — чтобы каталоги не терялись.
-3. Написать генератор `movies-watchlist.md` → JSON (переиспользовать `parser.py` из watchlist-sync).
-4. Положить JSON туда, откуда Lampac отдаёт статику.
-5. Написать `sites/watchlist.yaml` по образцу `vokino.yaml`.
-6. Подключить на ТВ: Lampa → Настройки → Плагины → `http://192.168.1.14:9118/catalog.js`.
-7. **Приёмка:** категории видны в UI Lampa на ТВ, названия совпадают со списком.
+## Что осталось на Alex (единственное незакрытое)
+
+Добавить плагин на ТВ — **пультом**, 1 минута:
+
+1. Lampa → **Настройки → Плагины** → добавить URL `http://192.168.1.14:9118/catalog.js`
+2. Lampa → **Настройки → Источник** → выбрать **«Мой список»**
+
+Приёмка = категории видны в UI Lampa, названия совпадают с `movies-watchlist.md`.
+
+Автоматизация этого шага по SSH **не проверялась** — см. [[family/how-to/tv-lampac-plugin]]
+(там заготовка подхода и питфоллы localStorage).
+
+## Известные ограничения
+
+| Ограничение | Детали |
+|---|---|
+| **Постеров нет** | `image` пустой. Опционально — тянуть через TMDB-кэш Lampac (`tmdbproxy`) |
+| **Карточки нет** | Только список названий. `card_parse` не настроен — Lampa может показывать пустую карточку |
+| **`🗓️` upcoming показываются** | Не прячем. Решение Alex не запрашивалось |
+| **Перезапуск контейнера** | Каждое обновление каталога = `docker restart lampac` (~30 сек простоя). Кэш не инвалидируется иначе |
+
+## ⚠️ Что проверено, а что нет
+
+**Проверено по HTTP (серверная часть):**
+
+| Проверка | Результат |
+|---|---|
+| `/catalog.js` по IP | 200, `api_host:'http://192.168.1.14:9118'` |
+| Каталог в `/catalog` | «Мой список» в списке каналов |
+| JSON-файлы | `watchlist.json` + `watchlist-{films,new,cartoons,anime}.json` — все 200 |
+| Выдача по категориям | films 360 · new 34 · cartoons 3 · anime 7 |
+| Сортировка | ⭐ → рейтинг ↓ → ужасы |
+| Чистота названий | эмодзи-маркеров 0 |
+
+**НЕ проверено:**
+
+- ❌ **UI Lampa на ТВ** — Alex ещё не добавил плагин. Это единственная непроверенная часть.
+- ❌ Боевой прогон крона в 02:30 (скрипт отработал вручную успешно).
+- ❌ Карточка/постеры в UI.
+
+## Файлы реализации (на HDD Кра́кена)
+
+Корень: `/srv/dev-disk-by-uuid-6194539b-03e0-4f33-986b-4da09834e82f/lampac/`
+
+| Путь | Роль |
+|---|---|
+| `config-module/init.conf` | включает Catalog → `/lampac/init.conf:ro` |
+| `catalog/sites/watchlist.yaml` | описание каталога |
+| `catalog/override/` | переопределения (пусто) |
+| `wwwroot/watchlist.json` | все секции |
+| `wwwroot/watchlist-<code>.json` | по файлу на категорию |
+| `scripts/gen_watchlist.py` | генератор |
+| `docker-compose.yml` | 7 монтирований; бэкапы `.bak-*` |
+
+На хосте: `~/scripts/watchlist-catalog.sh`, лог `~/logs/watchlist-catalog.log`.
 
 ## Откат
 
-`catalog: false` + вернуть `Catalog` в `SkipModules`. Ничего в Lampac не патчится.
+```bash
+# выключить каталог
+ssh kraken 'sed -i "s/\"catalog\": true/\"catalog\": false/" \
+  /srv/.../lampac/config-module/init.conf && docker restart lampac'
+# в Lampa убрать плагин catalog.js
+# cron: crontab -l | grep -v watchlist-catalog | crontab -
+```
+
+Ничего в коде Lampac не патчилось — только конфиг и данные.
+
+## Статус: ✅ РЕАЛИЗОВАНО 2026-09-22
+
+Каталог «Мой список» работает, отдаётся в Lampa через `/catalog.js`.
+
+### Что сделано
+
+| # | Шаг | Результат |
+|---|---|---|
+| 1 | Включён модуль Catalog | `SkipModules` без Catalog + `catalog: true` → `/catalog.js` 200 |
+| 2 | `init.conf` смонтирован | `./config-module/init.conf:/lampac/init.conf:ro` — правится на HDD, не теряется |
+| 3 | `sites/` + `override/` смонтированы | `./catalog/sites`, `./catalog/override` |
+| 4 | `wwwroot` смонтирован | `./wwwroot` — Lampac сам отдаёт JSON по HTTP |
+| 5 | Генератор написан | `lampac/scripts/gen_watchlist.py` |
+| 6 | `sites/watchlist.yaml` создан | `lampac/catalog/sites/watchlist.yaml` |
+| 7 | Автообновление в cron | `30 2 * * *` → `~/scripts/watchlist-catalog.sh` |
+| 8 | Проверка | 4 категории: films 360, new 34, cartoons 3, anime 7 |
+
+### Архитектура (финальная)
+
+```
+family/documents/movies-watchlist.md          ← источник
+        │  gen_watchlist.py (свой парсер, ~200 строк)
+        ▼
+lampac/wwwroot/watchlist.json                 ← все секции
+lampac/wwwroot/watchlist-<code>.json          ← по файлу на категорию
+        │  Lampac отдаёт wwwroot по HTTP сам
+        ▼
+lampac/catalog/sites/watchlist.yaml           ← описание для Catalog
+        │  plugin=watchlist, jsonPath: true, nodes: $.items[*]
+        ▼
+Lampa на ТВ: плагин http://192.168.1.14:9118/catalog.js
+```
+
+### 🔴 Питфоллы, найденные по ходу (не повторять)
+
+1. **Catalog ВЫБРАСЫВАЕТ элемент с пустым `href`.**
+   `ListController.cs`: `if (!IsNullOrWhiteSpace(name) && !IsNullOrWhiteSpace(href))`.
+   Симптом: из 404 позиций отдалось 52 — ровно те, у кого есть ссылка Кинопоиска.
+   **Фикс:** генератор подставляет fallback-href
+   `https://www.kinopoisk.ru/index.php?kp_query=<название>`.
+
+2. **Catalog НЕ подставляет `{cat}` в `nodes`.**
+   JSONPath статичен, отфильтровать секцию внутри одного файла нечем.
+   Симптом: все категории отдавали весь список (404 вместо 360/34/3/7).
+   **Фикс:** генератор пишет отдельный плоский файл на категорию
+   (`watchlist-films.json` и т.д.), `nodes: "$.items[*]"` одинаков для всех.
+
+3. **Кэш Catalog без версии данных.**
+   Ключ `catalog:{plugin}:{search}:{sort}:{cat}:{page}` — не зависит от содержимого.
+   Симптом: после перегенерации JSON выдача не менялась.
+   **Фикс:** `docker restart lampac` в скрипте обновления.
+
+4. **`init.conf` не был смонтирован.**
+   Файл живёт в образе; правки через `docker exec` теряются при пересоздании.
+   Правки шли в `current.conf` (сгенерированный) — неверная цель.
+   **Фикс:** volume `:ro` + свой минимальный `init.conf` (перекрывает `base.conf`).
+
+5. **`api_host` подставляется из запроса** (`{localhost}` → хост, по которому пришли).
+   По IP `192.168.1.14` отдаёт правильный адрес — специально ничего настраивать не нужно.
+
+6. **Кириллица в inline-jq внутри `ssh '...'`** ломает команду (tirith + quoting).
+   Выносить в файл или убирать строки с кириллицей.
+
+### Управление
+
+```bash
+ssh kraken
+cd /srv/dev-disk-by-uuid-6194539b-03e0-4f33-986b-4da09834e82f/lampac
+
+# перегенерировать каталог + сбросить кэш
+bash ~/scripts/watchlist-catalog.sh
+
+# логи
+tail -f ~/logs/watchlist-catalog.log
+
+# только генератор (без перезапуска)
+python3 scripts/gen_watchlist.py \
+  /home/kraken/obsidian/family/documents/movies-watchlist.md \
+  wwwroot/watchlist.json
+```
+
+### Откат
+
+```bash
+# выключить каталог
+ssh kraken 'sed -i "s/\"catalog\": true/\"catalog\": false/" \
+  /srv/.../lampac/config-module/init.conf && docker restart lampac'
+# в Lampa убрать плагин catalog.js
+```
 
 ## Правила отбора и сортировки (утверждено Alex 2026-09-22)
 
@@ -204,16 +358,21 @@ Lampa на ТВ: плагин http://192.168.1.14:9118/catalog.js
 Для строк без рейтинга (например `- [ ] Gods don't give gifts`) — сортировать как `0`, в конец группы.
 Опционально: добирать через TMDB (кэш `tmdbproxy` в Lampac) — решить при реализации.
 
-## Открытые вопросы
+## Открытые вопросы (не блокируют, решение Alex не запрошено)
 
-1. **Нужна ли карточка** (описание/рейтинг внутри Lampa), или достаточно списка названий с постерами?
-2. **Постеры** — тянуть через TMDB-кэш Lampac или не тянуть вовсе?
-3. **`🗓️` upcoming** — показывать или прятать? (сейчас по умолчанию показываем)
+1. **Постеры** — тянуть через TMDB-кэш Lampac или не тянуть вовсе? Сейчас пустые.
+2. **Карточка** — нужна ли (описание/рейтинг внутри Lampa), или достаточно списка названий?
+3. **`🗓️` upcoming** — показывать или прятать? Сейчас показываем.
+4. **`❓` ambiguous** — сейчас показываем с названием как есть.
+
+Ни один из них **не мешает работе** — каталог отдаётся, категории на месте.
+Спрашивать только если Alex сам затронет тему.
 
 ## Связанные
 
-- [[personal/plans/lampac-kraken]] — базовое развёртывание
-- [[personal/tech/lampac-deployment]] — эксплуатация, порты, питфоллы
+- [[personal/plans/lampac-kraken]] — базовое развёртывание (шаги 1–6 сделаны)
+- [[personal/tech/lampac-deployment]] — эксплуатация Lampac, модуль Catalog
+- [[family/how-to/tv-lampac-plugin]] — подключение плагина на ТВ
 - [[family/projects/watchlist-sync]] — парсер списка, CLI
 - [[family/projects/watchlist-automation]] — форматы маркеров, cron
 - [[family/documents/movies-watchlist]] — источник данных