Files
buryan-infra/ops/hub/SEARCH-INDEX.md
T

71 lines
3.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Поисковый индекс
## Зачем
Поиск подстрокой не находил книги по автору или серии, а «огонь» не попадал
в «Обсидиановый огонь» при неверном регистре. Теперь есть полнотекстовый
индекс с ранжированием.
## Что внутри
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 МБ).