Grigo/Home_assistant
1
0
Fork 0
Code Issues 10 Pull Requests Packages Projects Releases Wiki Activity

added docs

Browse Source
This commit is contained in:
Grigo
2026-06-22 06:50:13 +00:00
parent 99565ca107
commit 166b9eb4f9
30 changed files with 5912 additions and 3380 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+5 -5
View File
@@ -12,7 +12,7 @@
- Персонаж и генерация картинок (ComfyUI / RP Chat)
- Интеграции: Taiga, Gitea, погода, утренний дайджест, Netdata
- Мультипользовательская авторизация по API-токену (`/login`)
- Веб-интерфейс: Чат, Помидоро, Персонаж, Память, Фитнес, Покупки, Календарь, Настройки
- Веб-интерфейс: Чат, Помидоро, Персонаж, Память, **Документы**, Фитнес, Покупки, Календарь, Настройки
- REST API для внешних клиентов — см. [Telegram-бот](telegram-bot/README.md)
## Быстрый старт
@@ -250,8 +250,8 @@ SQLite-файл **не удаляется** — остаётся бэкапом.
1. `RAG_ENABLED=true` в `.env` (Qdrant должен быть доступен)
2. Toggle «RAG включён» в **Настройки** (веб-UI)
Загрузка документов: Settings → документы, или `POST /api/v1/documents/upload` (текст: `.txt`, `.md`, `.json`, `.csv`).
Tool в чате: `search_documents`.
Загрузка документов: вкладка **Документы** в веб-UI (список, загрузка, удаление, переиндексация), или `POST /api/v1/documents/upload` (`.txt`, `.md`, `.json`, `.csv`, `.docx`, текстовые `.pdf`).
Для документов сохраняются метаданные источника: тип файла, страницы PDF, заголовки/разделы DOCX, `chunk_id` и ссылка на фрагмент. Tool в чате: `search_documents`; при вопросах по ГОСТам/ТЗ ассистент должен отвечать с указанием документа, страницы или раздела.
Backfill существующих фактов:
@@ -259,7 +259,7 @@ Backfill существующих фактов:
docker compose exec backend python -m app.rag.migrate_memory_to_qdrant
```
Ограничения: нет API удаления документов; session summaries индексируются, но в чате читаются из SQLite; при ошибке embedding — fallback на топ фактов из БД.
Ограничения: сканированные PDF требуют отдельного OCR; старый Word `.doc` не поддерживается без конвертации в `.docx`; session summaries индексируются, но в чате читаются из SQLite; при ошибке embedding — fallback на топ фактов из БД.
## Фитнес-трекер
@@ -339,7 +339,7 @@ pytest tests/ -q
- Taiga/fitness в утреннем дайджесте
- LLM-мотивация в фитнес-напоминаниях (сейчас шаблонные строки)
- API удаления документов и re-index при включении RAG задним числом
- re-index при включении RAG задним числом для старых документов без метаданных
## Модель