47 lines
4.0 KiB
Markdown
47 lines
4.0 KiB
Markdown
# books.ruzzy.dev — читалка с ИИ
|
||
|
||
Личная веб-читалка владельца (только его Telegram ID): загрузка PDF/EPUB → главы по оглавлению →
|
||
чтение в браузере (iPhone, Boox, Mac) → выделил текст → **перевести / объяснить / спросить**; **рекапы глав**
|
||
(ИИ пишет, владелец правит), **вопросы по книге и по всей библиотеке** с цитатами [гл. N, с. P] и проверкой фактов
|
||
по интернету; поиск по книгам и рекапам (RAG).
|
||
|
||
## Как устроено
|
||
|
||
- `app/library.py` — разбор: PDF — PyMuPDF (оглавление; если его нет — заголовки «Глава N/Chapter N» в начале
|
||
страниц, колонтитулы отсекаются; иначе — по 20 страниц), EPUB — свой разбор (nav/NCX + spine; у PyMuPDF нет
|
||
оглавления EPUB 3), «страница» EPUB ≈ 2000 символов. Хранение — SQLite `data/books.db`. Поиск — гибрид:
|
||
FTS5 (BM25) + эмбеддинги `paraphrase-multilingual-MiniLM-L12-v2` (fastembed/ONNX, на CPU fr1, модель в `data/models`),
|
||
слияние по рангам (RRF). Рекапы тоже попадают в индекс.
|
||
- `app/llm.py` — ИИ: **Claude Code в фоновом режиме** (`claude -p --output-format stream-json`) по подписке владельца
|
||
(`CLAUDE_CODE_OAUTH_TOKEN` из `claude setup-token`), **без инструментов** (`--tools ""`) — текст книги и выделения
|
||
чужие, в них может быть внедрённая инструкция. Для «проверить по интернету» — только `WebSearch`. Модели:
|
||
`MODEL_MAIN=sonnet` (рекапы, вопросы), `MODEL_FAST=haiku` (перевод, объяснение). До 3 запросов параллельно.
|
||
⚠️ `--bare` нельзя: в нём Claude Code принимает только API-ключ, не OAuth подписки.
|
||
- `app/main.py` — FastAPI: вход **Telegram Login Widget** (проверка HMAC подписи ключом sha256(токен бота),
|
||
`auth_date` ≤ сутки, ID из `ALLOWED_TG_IDS`), сессия — подписанная cookie на 30 дней. Ответы ИИ — потоком.
|
||
`noindex` везде, `robots.txt` — Disallow.
|
||
- Интерфейс — серверные шаблоны + `static/app.js` без сборки; вёрстка под e-ink (чёрное на белом, без анимаций).
|
||
Markdown ответов рендерится после экранирования — HTML из ответа ИИ не исполняется.
|
||
|
||
## Установка на fr1
|
||
|
||
```bash
|
||
rsync -a --exclude data --exclude .env stacks/books/ rus-161:books/
|
||
ssh rus-161 'cd ~/books && docker compose up -d --build'
|
||
sudo sh ~/books/nginx/install.sh # vhost + certbot (на fr1, один раз)
|
||
```
|
||
|
||
`.env` (только на сервере, 600): `TG_BOT_NAME`, `TG_BOT_TOKEN` (бот для входа; у @BotFather `/setdomain` →
|
||
books.ruzzy.dev), `ALLOWED_TG_IDS=607015`, `SESSION_SECRET` (случайный, сменить = разлогинить всех),
|
||
`CLAUDE_CODE_OAUTH_TOKEN`, `MODEL_MAIN`, `MODEL_FAST`. После правки — `docker compose up -d`.
|
||
|
||
## Данные
|
||
|
||
`~/books/data/`: `books.db` (книги, главы, текст, рекапы, вопросы, индекс), `files/` (оригиналы), `models/`
|
||
(эмбеддинги, ~0,5 ГБ, скачиваются при первом запуске), `claude/` (конфиг Claude Code, `CLAUDE_CONFIG_DIR`).
|
||
|
||
## Потом
|
||
|
||
- Интеграция с малиной: рекапы → vault `Книги/<книга>.md`, вопросы из Telegram через Astra (отдельный этап).
|
||
- Импорт библиотеки из OneDrive (229 PDF в `Ruslan/Книги`), OCR сканов.
|