398 lines
22 KiB
Markdown
398 lines
22 KiB
Markdown
---
|
||
created: '2026-09-22'
|
||
namespace: personal
|
||
related:
|
||
- '[[personal/plans/lampac-kraken]]'
|
||
- '[[personal/tech/lampac-deployment]]'
|
||
- '[[family/projects/watchlist-sync]]'
|
||
- '[[family/projects/watchlist-automation]]'
|
||
- '[[family/documents/movies-watchlist]]'
|
||
status: active
|
||
tags:
|
||
- lampac
|
||
- lampa
|
||
- watchlist
|
||
- catalog
|
||
- webos
|
||
- plugin
|
||
- kraken
|
||
title: Watchlist в UI Lampa — каталог из списка
|
||
type: plan
|
||
updated: '2026-09-22'
|
||
---
|
||
|
||
# Watchlist в UI Lampa — каталог из списка
|
||
|
||
> Реализовано 2026-09-22. План был переписан после разведки кода модуля Catalog.
|
||
> Базовое развёртывание — [[personal/plans/lampac-kraken]] (шаги 1–6 закрыты).
|
||
>
|
||
> **Итог одной строкой:** Lampac отдаёт `movies-watchlist.md` как каталог Lampa
|
||
> через модуль `Catalog` → 4 категории (360/33/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`.
|
||
Сейчас **выключен**. Писать плагин с нуля **не нужно**.
|
||
|
||
## Как работает Catalog (разобрано по коду 2026-09-22)
|
||
|
||
**Файлы в контейнере:** `/lampac/module/Catalog/` — `Controllers/`, `plugin.js`, `README.md`,
|
||
`sites/*.yaml` (10 готовых примеров: `vokino`, `rezka`, `kinopub`, `anime`, …).
|
||
|
||
### Механика
|
||
|
||
| Что | Как |
|
||
|---|---|
|
||
| Данные | `sites/<site>.yaml` — описание сайта: `host`, `menu`, `search`, `list`, `content` |
|
||
| Подстановки | `override/<site>.yaml` и `override/_.yaml` — переопределения поверх базового |
|
||
| Роуты | `/catalog.js` (плагин), `/catalog` (JSON каналов), `/catalog/list`, `/catalog/card` |
|
||
| WAF | `^/catalog/` → **10 запросов/сек** |
|
||
| Имя файла | только `[a-z0-9-]`; есть fallback-поиск по `displayname` |
|
||
|
||
### Ключевое: обязателен HTTP
|
||
|
||
```csharp
|
||
if (!url.StartsWith("http"))
|
||
url = $"{init.host}/{url}"; // ListController.cs:87
|
||
```
|
||
`host` из YAML сканируется **по HTTP** (`Http.Get` / Playwright / RCH).
|
||
**Локальные файлы напрямую Catalog читать не умеет** — только HTTP-ответ.
|
||
|
||
### Два режима парсинга
|
||
|
||
```csharp
|
||
bool? jsonPath = contentParse.jsonPath ?? init.jsonPath;
|
||
|
||
if (jsonPath == true) json = JToken.Parse(html); // JSON-режим
|
||
else doc.LoadHtml(html); // HTML-режим
|
||
```
|
||
|
||
- `jsonPath: true` → ответ парсится как **JSON**, элементы берутся по `nodes` (`$.channels[*].details`)
|
||
- иначе → HTML через HtmlAgilityPack
|
||
|
||
🔴 **Это и есть рычаг:** любой **свой HTTP-эндпоинт, отдающий JSON нужной формы**, подойдёт как `host`.
|
||
Тогда задача сводится к генерации JSON + YAML-обёртки, без правки кода Lampac.
|
||
|
||
### Форма элемента (`content` в YAML)
|
||
|
||
```yaml
|
||
content:
|
||
nodes: "$.channels[*].details" # jsonPath-выражение (JSON) или CSS/XPath (HTML)
|
||
name: { attribute: name }
|
||
original_name:{ attribute: originalname }
|
||
href: { attribute: ident }
|
||
image: { attribute: poster }
|
||
year: { attribute: released }
|
||
serial_key: { attribute: type, format: | return value is "serial" ? value : null; }
|
||
args:
|
||
- { name_arg: vote_average, attribute: rating_kp }
|
||
```
|
||
|
||
Карточка — отдельная секция `card_parse` + `card_args` (описание, рейтинги, жанры, страна).
|
||
Полный живой пример — `sites/vokino.yaml` (копия в [[personal/tech/lampac-deployment]], раздел Catalog).
|
||
|
||
## Включение модуля — 2 правки
|
||
|
||
```jsonc
|
||
// current.conf (внутри контейнера /lampac/current.conf)
|
||
"SkipModules": [ "Tracks", "Transcoding", ... ] // ← убрать "Catalog" (строка ~277)
|
||
"plugins": { ..., "catalog": true } // ← было false (строка ~1653)
|
||
```
|
||
|
||
🔴 **ПИТФОЛЛ — `init.conf` НЕ смонтирован.** В нашем `docker-compose.yml` нет volume на `/lampac/init.conf`,
|
||
файл живёт в образе. Правки через `docker exec` **исчезнут при пересоздании контейнера**
|
||
(`docker compose up`, watchtower-обновление образа). Варианты:
|
||
- (а) добавить volume `./config/init.conf:/lampac/init.conf:ro` — надёжно, но нужен первичный `docker cp`
|
||
- (б) править через **AdminPanel** `/adminpanel` (модуль, правит `init.conf` + `current.conf`)
|
||
- (в) `docker cp` + commit — плохо
|
||
|
||
**Рекомендация: (а)** — конфиг на HDD, переживает пересоздание.
|
||
|
||
## Архитектура решения
|
||
|
||
```
|
||
family/documents/movies-watchlist.md ← источник (vault, git-синхрон)
|
||
│ существующий парсер: watchlist-sync/parser.py
|
||
▼
|
||
генератор (Python, на Кра́кене)
|
||
│ пишет JSON нужной формы
|
||
▼
|
||
/lampac/... JSON-эндпоинт, доступный по HTTP с Lampac
|
||
│
|
||
▼
|
||
sites/watchlist.yaml ← Catalog-описание, host=<наш JSON URL>
|
||
menu: Фильмы / Мультфильмы / Аниме (по секциям .md)
|
||
│
|
||
▼
|
||
Lampa на ТВ: плагин http://192.168.1.14:9118/catalog.js
|
||
```
|
||
|
||
**Откуда отдавать JSON — варианты (выбрать на этапе реализации):**
|
||
|
||
| # | Где | Плюс | Минус |
|
||
|---|---|---|---|
|
||
| 1 | **статика в `/lampac/wwwroot/`** | ничего не поднимать, Lampac сам отдаёт | только чтение, обновление = перезапись файла |
|
||
| 2 | **отдельный лёгкий HTTP-сервер** на Кра́кене | есть API/логика | ещё один контейнер |
|
||
| 3 | `file://` | — | ❌ не поддерживается (только http) |
|
||
|
||
**Склоняюсь к (1)** — генерировать `wwwroot/watchlist.json`, Lampac отдаёт его сам, без новых сущностей.
|
||
|
||
## Обновление каталога — реализовано
|
||
|
||
Скрипт `~/scripts/watchlist-catalog.sh` (root:root, ставить только `sudo install -m 755`):
|
||
|
||
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).
|
||
|
||
Бэкап crontab перед установкой: `~/crontab-backup-20260922-112915.txt`.
|
||
|
||
⚠️ **`watchlist-catalog.sh` сделан отдельной задачей, а не врезан в `watchlist-nightly.sh`.**
|
||
Причина: `nightly` — рабочий боевой скрипт, его падение остановило бы весь пайплайн списка.
|
||
Отдельный cron падает изолированно.
|
||
|
||
## Что осталось на Alex (единственное незакрытое)
|
||
|
||
Добавить плагин на ТВ — **пультом**, 1 минута:
|
||
|
||
1. Lampa → **Настройки → Плагины** → добавить URL `http://192.168.1.14:9118/catalog.js`
|
||
2. **Полностью перезапустить Lampa** (не сворачивать) — каталоги регистрируются только при старте
|
||
3. На главной встать на ряд каталога и нажать **влево** → в выехавшей панели выбрать **«Мой список»**
|
||
|
||
🔴 **Пункта «Настройки → Источник» в Lampa НЕ СУЩЕСТВУЕТ** — я его выдумал, Alex дважды указал на ошибку.
|
||
Источник переключается панелью слева в меню каталогов. Подробно: [[family/how-to/tv-lampac-plugin]].
|
||
|
||
Приёмка = категории видны в 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, ~32 КБ, `api_host:'http://192.168.1.14:9118'` |
|
||
| Каталог в `/catalog` | **7 ключей**, «Мой список» первым (Rezka, Kinobase, FilmixApp, VoKino, Eneyida, KinoUkr, Мой список) |
|
||
| JSON-файлы | `watchlist.json` + `watchlist-{films,new,cartoons,anime}.json` — все 200 |
|
||
| Выдача по категориям | films 360 · new **33** · cartoons 3 · anime 7 (после фикса сирот 2026-09-22) |
|
||
| Формат ответа `/catalog/list` | `{page, results, total_pages}`, `total_pages: 1` для films |
|
||
| Сортировка | ⭐ → рейтинг ↓ → ужасы |
|
||
| Чистота названий | эмодзи-маркеров 0 |
|
||
| Сирота «Конец света» | ❌ отсутствует во всех 4 категориях |
|
||
|
||
**НЕ проверено:**
|
||
|
||
- ❌ **UI Lampa на ТВ** — Alex добавил плагин, но каталог в UI не увидел.
|
||
Соединений ТВ → `:9118` на момент диагностики — **ноль**. Гипотеза: не сделан полный
|
||
перезапуск 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`.
|
||
|
||
## Откат
|
||
|
||
```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).
|
||
Выносить в файл или убирать строки с кириллицей.
|
||
|
||
7. **Осиротевшие строки в `## Новинки` давали дубли в каталоге.**
|
||
Строки без `👍`/`👎` (например `- [ ] ⬇️ Название`) `process-thumbs` не трогал —
|
||
они висели в Новинках навсегда. Если фильм уже `[x]` в главном списке — получался дубль:
|
||
непросмотренный «Конец света» при просмотренном оригинале.
|
||
**Фикс в `watchlist-sync/parser.py`** (удаление сирот + флаг `_patch_dropped`) и `cli.py`.
|
||
Разбор: [[family/projects/watchlist-automation]], секция «ОСИРОТЕВШИЕ СТРОКИ».
|
||
|
||
8. **Двойное экранирование при правке `parser.py` скриптами.**
|
||
`r'\1'` превращался в байт `\x01`, `r'\b'` — в `\x08`. Синтаксис валиден, регекспы молчат.
|
||
**Проверять файл на `chr(1)` и `chr(8)` после патча.**
|
||
|
||
### Управление
|
||
|
||
```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)
|
||
### Фильтрация
|
||
|
||
| Правило | Действие |
|
||
|---|---|
|
||
| `[ ]` непросмотренные | **показывать** |
|
||
| `[x]` просмотренные | ❌ скрыть |
|
||
| `👎` | ❌ скрыть |
|
||
| `🗓️` upcoming | показывать (решить при реализации — есть в файле) |
|
||
| `❓` ambiguous | показывать (название как есть) |
|
||
|
||
### Сортировка внутри списка — трёхключевая
|
||
|
||
1. **`⭐` (U+2B50) — первыми**
|
||
2. **Рейтинг — по убыванию** (IMDb/KP из строки файла; строки `[название](kp) (год) IMDb N.N KP N.N`)
|
||
3. **Ужасы (`🧟♀️`, TMDB genre_id=27) — последними**
|
||
|
||
⚠️ **Только `⭐` (U+2B50)** — как в `sync-down` (см. [[family/projects/watchlist-automation]]).
|
||
`✭` (U+272D) приоритетом **не является**.
|
||
|
||
### Порядок секций
|
||
|
||
1. **Главный список — первым.** Это `## Фильмы`
|
||
2. Дальше — **остальные по порядку в файле**: `## Новинки - 👍/👎`, `## Мультфильмы`, `## Аниме`, …
|
||
|
||
⚠️ `## Новинки👎` — **не показывать** (это скрытая секция отказов).
|
||
⚠️ Секция `## Новинки` содержит `👍`/`👎`; `👎`-строки прячем, `👍` показываем.
|
||
|
||
### Источник рейтинга
|
||
|
||
В строках со ссылками Кинопоиска рейтинг **уже в тексте**: `IMDb 7.6 KP 8.2`.
|
||
Для строк без рейтинга (например `- [ ] Gods don't give gifts`) — сортировать как `0`, в конец группы.
|
||
Опционально: добирать через TMDB (кэш `tmdbproxy` в Lampac) — решить при реализации.
|
||
|
||
## Открытые вопросы (не блокируют, решение Alex не запрошено)
|
||
|
||
1. **Постеры** — тянуть через TMDB-кэш Lampac или не тянуть вовсе? Сейчас пустые.
|
||
2. **Карточка** — нужна ли (описание/рейтинг внутри Lampa), или достаточно списка названий?
|
||
3. **`🗓️` upcoming** — показывать или прятать? Сейчас показываем.
|
||
4. **`❓` ambiguous** — сейчас показываем с названием как есть.
|
||
|
||
Ни один из них **не мешает работе** — каталог отдаётся, категории на месте.
|
||
Спрашивать только если Alex сам затронет тему.
|
||
|
||
## Связанные
|
||
|
||
- [[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]] — источник данных
|