71 lines
3.2 KiB
Markdown
71 lines
3.2 KiB
Markdown
# Поисковый индекс
|
||
|
||
## Зачем
|
||
|
||
Поиск подстрокой не находил книги по автору или серии, а «огонь» не попадал
|
||
в «Обсидиановый огонь» при неверном регистре. Теперь есть полнотекстовый
|
||
индекс с ранжированием.
|
||
|
||
## Что внутри
|
||
|
||
SQLite FTS5, `/var/lib/hub-search/index.db`:
|
||
|
||
| Источник | Что индексируется |
|
||
|---|---|
|
||
| Calibre (CT111) | название, авторы, серия, путь |
|
||
| Paperless | название и текст документа (первые 3000 символов) |
|
||
| Mealie | название и описание рецепта |
|
||
|
||
Токенизатор `unicode61 remove_diacritics` — нормально работает с русским.
|
||
|
||
## Как искать
|
||
|
||
- `!найди herbert` → 3 книги Дюны, отсортированы по релевантности
|
||
- `!найди огонь` → «Обсидиановый огонь»
|
||
- API: `GET /search?q=огне*`
|
||
|
||
Ответ содержит блок **«🔎 Точное совпадение»** — ранжированный, и ниже
|
||
поиск по сервисам (фильмы, продукты, документы).
|
||
|
||
## Обновление
|
||
|
||
Таймер `hub-search-index` — ежедневно 06:20.
|
||
|
||
Ручной запуск:
|
||
|
||
```bash
|
||
/opt/music-tools/venv/bin/python /opt/hub-core/search_index.py
|
||
```
|
||
|
||
## Состояние на 21.10.2026
|
||
|
||
```
|
||
индекс: 13 (книги 13, документы 0, рецепты 0)
|
||
```
|
||
|
||
Документов и рецептов пока нет — базы пустые.
|
||
|
||
## Ловушки
|
||
|
||
1. **`pct exec … python3 -c` с длинным кодом ломается на кавычках.**
|
||
Надёжнее: `pct push` скрипта в контейнер и запуск файла.
|
||
2. **У таблицы `books` в Calibre нет колонок `series` и `comments`** —
|
||
серия берётся через `books_series_link`.
|
||
3. **FTS не переводит языки**: «нейромант» не найдёт «Neuromancer».
|
||
Нужен либо перевод в индексе, либо поиск на языке оригинала.
|
||
|
||
## Обновление 22.10
|
||
|
||
В индекс добавлена **документация репозитория** (`ops/**/*.md`):
|
||
373 записи + 13 книг. Раньше полнотекстовый поиск находил только книги.
|
||
|
||
Найдено и исправлено: `c.commit()` стоял **до** вставки markdown-строк,
|
||
поэтому они молча терялись при закрытии соединения.
|
||
|
||
## Изменения 22.10
|
||
|
||
- **Индексируется документация** `ops/**/*.md` — 373 записи (всего 386 с книгами).
|
||
- Исправлен порядок: `commit()` теперь после вставки markdown-строк.
|
||
- Ссылка на поиск добавлена на страницу «Моё».
|
||
- Хранение архивов конфигов: **14 → 7 дней** (архив вырос до 244 МБ).
|