chore: зафиксированы все текущие изменения проекта

SHiNE-agent-bot-coder/README.md

@@ -2,6 +2,7 @@
 
 Локальный Telegram-бот-сервис для пользователя `ai`:
 - принимает сообщения от `@AidarKC`;
+- поддерживает whitelist игроков (`ALLOWED_TELEGRAM_PLAYERS`) с отдельными историями;
 - ведёт историю диалога в `JSONL`;
 - ставит задачи в файловую очередь;
 - обрабатывает задачи строго последовательно;
@@ -9,8 +10,7 @@
 - вызывает Codex CLI и отправляет ответ в Telegram;
 - при рестарте восстанавливает незавершённые задачи;
 - отправляет аварийный статус только если Codex молчит 2 минуты подряд во время активной задачи;
-- принимает сообщения из канала/группы `@shine_writing`, выполняет команды только от `@AidarKC`, а сообщения других авторов сохраняет как контекст;
-- на сообщения других участников группы отвечает в тот же чат коротким подтверждением получения, не создавая задачу Codex;
+- принимает сообщения из канала/группы `@shine_writing`, выполняет команды только от `@AidarKC`;
 - учитывает миграцию обычной Telegram-группы в supergroup и перенаправляет ответы на новый `chat_id`.
 
 Рабочая реализация сервиса — только `py_bot_service.py`. Старая Java-реализация удалена, потому что не заработала и больше не используется.
@@ -20,8 +20,8 @@
 - `data/py_queue.jsonl` — очередь Python-сервиса;
 - `data/py_state.json` — текущее состояние Python-сервиса;
 - `data/py_processed_updates.log` — дедуп входящих update;
-- `data/history/*.jsonl` — активные истории;
-- `data/history/archive/*.jsonl` — архив историй после `/new`.
+- `data/history/<username>/*.jsonl` — активные истории по пользователям;
+- `data/history/<username>/archive/*.jsonl` — архивы после `/new`.
 
 ## Локальный запуск
 1. Скопировать пример:
@@ -29,7 +29,10 @@
 2. Заполнить секреты в `.env`.
    - `TELEGRAM_BOT_TOKEN` — токен рабочего Telegram-бота.
    - `ALLOWED_TELEGRAM_USERNAME` — пользователь, чьи сообщения выполняются как команды.
+   - `ALLOWED_TELEGRAM_PLAYERS` — whitelist игроков в формате `username:Имя,username2:Имя2`.
    - `ALLOWED_TELEGRAM_CHANNEL_USERNAME` — канал, из которого принимаются `channel_post`; обычные group/supergroup-сообщения обрабатываются как `message`.
+   - `TELEGRAM_FILE_DOWNLOAD_TIMEOUT_SECONDS` — тайм-аут скачивания voice/audio из Telegram, по умолчанию 300 секунд.
+   - `OPENAI_TRANSCRIBE_TIMEOUT_SECONDS` — тайм-аут распознавания voice/audio в OpenAI, по умолчанию 900 секунд.
 3. Запуск:
    - `python3 SHiNE-agent-bot-coder/py_bot_service.py`
 
@@ -59,4 +62,4 @@ python3 SHiNE-agent-bot-coder/py_bot_service.py --selftest-codex "Ответь
 - `/stop` — остановить текущую задачу.
 - `/cancel <id|all>` — удалить задачу по id/префиксу или очистить очередь.
 - `/new` — архивировать текущую историю и начать новый диалог.
-- `/restart_service` — перезапустить сервис; systemd должен поднять процесс заново.
+- `/restart_service` — перезапустить сервис (только для Айдара); systemd должен поднять процесс заново.