Вынести продуктовый репозиторий из локальной обвязки агента

2026-07-20 18:49:28 +04:00
parent 81493ac4be
commit 59047a8d0e
44 changed files with 18 additions and 6591 deletions
@@ -14,14 +14,15 @@
 - Веб-панель администратора сервера (управление Solana PDA сервера) находится в `shine-UI/`:
 - точка входа `shine-UI/server-ui.html`;
 - остальные файлы серверного UI — в `shine-UI/server-ui/`.
- Локальный Telegram-бот агента-кодера находится в папке `SHiNE-agent-bot-coder/` и не является кодом основного серверного приложения.
+- Локальный Telegram-бот агента-кодера живёт рядом с репозиторием продукта, обычно в `../SHiNE-agent-bot-coder/`, и не входит в публичный код основного приложения.
 - Solana/Anchor-модуль находится в папке `shine-solana/shine/` и ведётся отдельно от основного server/UI деплоя.
 ## Сервис агента-кодера
- В проекте есть локальный Telegram-бот-сервис агента-кодера в папке `SHiNE-agent-bot-coder/`.
+- Локальный Telegram-бот-сервис агента-кодера находится вне этого git-репозитория, обычно в `../SHiNE-agent-bot-coder/`.
 - Сервис принимает сообщения из Telegram, ведёт историю диалога, ставит задачи в очередь и вызывает Codex CLI для обработки запросов по проекту.
- Автоматически читаемые инструкции для Codex внутри сервиса держать в `SHiNE-agent-bot-coder/AGENTS.md`.
+- Рабочая папка Codex для сервиса должна указывать на этот продуктовый репозиторий: `CODEX_WORKDIR=/home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-product`.
- Подробные служебные правила Telegram-обработчика, его очередь, история, systemd-запуск и особенности ответов описывать в `SHiNE-agent-bot-coder/AGENT.md`.
+- Автоматически читаемые инструкции для Codex внутри сервиса держать в `../SHiNE-agent-bot-coder/AGENTS.md`.
 - Подробные служебные правила Telegram-обработчика, его очередь, история, systemd-запуск и особенности ответов описывать в `../SHiNE-agent-bot-coder/AGENT.md`.
 - Если в сообщениях пользователя встречается «агент MD» или похожая формулировка про файл инструкций Codex, считать, что имеется в виду автоматически читаемый `AGENTS.md`.
 ## ESP32 UI homeserver
@@ -5,7 +5,7 @@
@shine-UI/AGENTS.md
 ## Справка по подпроектам
- При работе внутри `SHiNE-agent-bot-coder/` — читать `SHiNE-agent-bot-coder/AGENTS.md` и `SHiNE-agent-bot-coder/AGENT.md`.
+- При работе с локальным агентом-кодером — читать внешние файлы `../SHiNE-agent-bot-coder/AGENTS.md` и `../SHiNE-agent-bot-coder/AGENT.md`.
 - При работе внутри `shine-solana/shine/` — читать `shine-solana/shine/AGENTS.md`.
 - При работе внутри `shine-UI/server-ui/` — читать `shine-UI/AGENTS.md`.
 - При работе внутри `SHiNE-server/` — читать `SHiNE-server/AGENTS.md`.
@@ -1 +0,0 @@
@@ -1 +0,0 @@
@@ -1 +0,0 @@
@@ -1,71 +0,0 @@
 # Задание для Айдара: навести порядок в инструкциях агентов SHiNE
 ## Кратко
 Нужно согласовать и оформить единый порядок инструкций для Codex/Telegram-агентов в проекте SHiNE, чтобы агенты стабильно понимали структуру проекта, границы ответственности и правила работы с сервером, UI, Solana-модулем, Telegram-ботом и игроками.
 ## Зачем это нужно
 Сейчас проект состоит из нескольких связанных, но разных частей:
 - основной сервер `SHiNE-server/`;
 - UI `shine-UI/`;
 - Solana/Anchor-модуль `shine-solana/shine/`;
 - Telegram-агент-кодер `SHiNE-agent-bot-coder/`;
 - TURN-сервер;
 - документация `docs/`;
 - отдельные рабочие папки игроков `Players/`.
 Без явных инструкций агент может путать эти зоны: например, смешать деплой Solana с деплоем сервера, изменить код от имени игрока, не обновить документацию API/DM/блокчейна или неправильно трактовать файл инструкций.
 ## Что предлагается сделать
 1. Утвердить корневой `AGENTS.md` как главный набор правил проекта.
 2. Проверить и при необходимости уточнить локальный `AGENTS.md` внутри `shine-solana/shine/`.
 3. Оставить отдельные служебные инструкции Telegram-агента в `SHiNE-agent-bot-coder/AGENT.md`.
 4. Оставить автоматически читаемые инструкции Telegram-агента в `SHiNE-agent-bot-coder/AGENTS.md`.
 5. Явно закрепить режим игроков:
   - игроки могут задавать вопросы, просить анализ, идеи и ТЗ;
   - игроки не меняют код проекта напрямую;
   - материалы игроков сохраняются только в `Players/<username>/`.
 6. Зафиксировать правило: если пользователь говорит «агент MD» или похожую формулировку, считать, что речь про автоматически читаемый `AGENTS.md`.
 7. Добавить простой процесс согласования изменений инструкций:
   - Дима или другой участник готовит предложение;
   - Айдар получает уведомление/заявку;
   - Айдар отвечает: одобрить, отклонить или попросить доработать;
   - только после одобрения агент вносит изменения в проектные инструкции.
 ## Предлагаемая логика уведомления Айдару
 Минимальный вариант без сложной разработки:
 1. Агент готовит текст заявки.
 2. Текст отправляется Айдару в Telegram или в общий рабочий чат.
 3. В заявке явно указаны варианты ответа:
   - `одобрить`;
   - `отклонить`;
   - `доработать: ...`.
 4. После ответа Айдара агент либо выполняет согласованные правки, либо фиксирует, что задача отклонена/нужна доработка.
 Более удобный вариант на будущее:
 - добавить в Telegram-бота команду или сценарий согласования задач, например:
  - `/approve <id>`;
  - `/reject <id> причина`;
  - `/revise <id> комментарий`.
 Но для начала достаточно простого текстового согласования через Telegram.
 ## Что нужно от Айдара
 Подтвердить, что такой порядок подходит:
 1. Корневой `AGENTS.md` остается главным правилом проекта.
 2. Для Solana, Telegram-агента и игроков сохраняются отдельные локальные правила.
 3. Игроки не меняют код напрямую, а готовят материалы и предложения.
 4. Изменения инструкций выполняются только после явного одобрения Айдара.
 5. Уведомления Айдару на первом этапе можно делать простым текстом в Telegram, без отдельной сложной системы заявок.
 ## Ожидаемый результат
 После одобрения:
 - агенты будут стабильнее понимать границы проекта;
 - снизится риск случайных изменений не в той части системы;
 - появится понятный порядок согласования задач от игроков;
 - Айдар будет явно контролировать изменения в инструкциях и правилах работы агентов.
@@ -1 +0,0 @@
@@ -1 +0,0 @@
@@ -1 +0,0 @@
@@ -1 +0,0 @@
@@ -1 +0,0 @@
@@ -1 +0,0 @@
@@ -1 +0,0 @@
@@ -1,19 +0,0 @@
 TELEGRAM_BOT_TOKEN=replace_me
 OPENAI_API_KEY=replace_me
 ALLOWED_TELEGRAM_USERNAME=AidarKC
 ALLOWED_TELEGRAM_PLAYERS=malvviiina:Милана,zodiaktechnika32:Сергей,oidasyda:Иван,blackbyrd1:Ворон,dimasol1:Дима
 ALLOWED_TELEGRAM_CHANNEL_USERNAME=shine_writing
 BOT_USERNAME=aidar_su_bot
 OPENAI_TRANSCRIBE_MODEL=gpt-4o-mini-transcribe
 TELEGRAM_FILE_DOWNLOAD_TIMEOUT_SECONDS=300
 OPENAI_TRANSCRIBE_TIMEOUT_SECONDS=900
 OPENAI_TTS_MODEL=gpt-4o-mini-tts
 OPENAI_TTS_VOICE=alloy
 OPENAI_TTS_RESPONSE_FORMAT=opus
 OPENAI_TTS_TIMEOUT_SECONDS=180
 OPENAI_TTS_CHUNK_CHARS=3500
 CODEX_BIN=/home/ai/.cache/JetBrains/IntelliJIdea2026.1/aia/codex/bin/codex-x86_64-unknown-linux-musl
 CODEX_WORKDIR=/home/ai/work/SHiNE/SHiNE-server-sha256
 CODEX_TIMEOUT_SECONDS=900
 MAX_RETRIES=3
 DATA_DIR=./data
@@ -1,5 +0,0 @@
 .env
 data/
 logs/
 run/
 __pycache__/
@@ -1,80 +0,0 @@
 # AGENT.md для SHiNE-agent-bot-coder
 Ты запущен как обработчик входящего Telegram-сообщения от пользователя.
 ## Контекст
 - `SHiNE-agent-bot-coder` — локальный Telegram-бот-сервис агента-кодера для работы с этим проектом.
 - Сервис принимает входящие сообщения от пользователя Telegram, сохраняет историю, ставит задачи в очередь и последовательно запускает Codex CLI в рабочем проекте.
 - Текстовые сообщения обрабатываются напрямую, voice/audio сначала распознаются через OpenAI transcription, затем передаются как текстовая задача.
 - История диалога хранится в JSONL-файле, путь передаётся в промпте.
 - Сообщение может быть текстом или результатом распознавания голосового.
 - Ответ пойдёт пользователю в Telegram как обычное текстовое сообщение.
 - Единственная рабочая реализация сервиса — Python-скрипт `py_bot_service.py`; старая Java-реализация удалена как нерабочая и не должна восстанавливаться без отдельного решения Айдара.
 - В репозитории также есть отдельный Solana/Anchor-модуль `shine-solana/shine/`; он логически связан с SHiNE, но не должен автоматически подключаться к основному серверному deploy без отдельной команды.
 - Перед изменениями внутри `shine-solana/shine/` читать локальные инструкции `shine-solana/shine/AGENTS.md`; в git не добавлять локальные ключи, `.git`, `.idea`, `.gradle`, `target`, `node_modules`, `test-ledger`, логи, временные run-отчёты и `.env`-конфиги.
 ## Авторитет команд и история
 - Основной пользователь и источник команд — Айдар: `@AidarKC` / `@aidarkc`.
 - Дополнительно разрешены игроки из whitelist (`ALLOWED_TELEGRAM_PLAYERS`), каждый со своей отдельной историей и рабочей папкой `Players/<username>/`.
 - Игроки работают в режиме вопросов/анализа/подготовки материалов: в промпте явно задано правило не менять код проекта и писать материалы только в своей папке.
 - Для неизвестных пользователей в личном чате сервис отвечает вежливым отказом.
 - В Telegram-канале/группе `@shine_writing` сервис выполняет сообщения только от Айдара, а ответы отправляет в тот же чат.
 - Если Telegram сообщает о миграции обычной группы в supergroup, сервис должен запомнить новый `chat_id` и отправлять ответы уже туда.
 - На события подключения/отключения пользователей (join/leave) сервис не отвечает и ничего не отправляет.
 ## Очередь и состояние
 - Входящие задачи записываются в файловую очередь и обрабатываются строго по одной, чтобы не смешивать изменения в проекте.
 - Сервис ведёт состояние активной задачи и текущего файла истории, а после рестарта продолжает незавершённую обработку с учётом сохранённого состояния.
 - Истории диалогов хранятся в JSONL по каждому разрешённому username отдельно: `data/history/<username>/`.
 - Архив истории после `/new`: `data/history/<username>/archive/`.
 - После `/new` для этого же пользователя должен сбрасываться и контекст продолжения Codex-сессии; следующий запрос запускается как новая сессия, не через resume.
 - Для просмотра истории игрока открывать файлы в его папке истории по username.
 - Дедупликация входящих Telegram update нужна, чтобы одно сообщение не попало в обработку повторно.
 - Если Codex молчит во время активной задачи 2 минуты подряд, сервис отправляет аварийный статус с общим временем работы задачи; при дальнейшем молчании повторяет статус каждые 2 минуты.
 - После успешной обработки задачи из личного чата Айдара сервис должен отправить публичный итоговый отчёт в группу `@shine_writing`: первым сообщением исходный запрос, вторым сообщением-ответом итоговый ответ Codex. Промежуточные статусы в группу не дублировать.
 - Для приватных voice/audio-запросов в публичном отчёте первым сообщением отправлять исходный Telegram voice/audio-файл с подписью, где указан распознанный текст. В пользовательском тексте отчёта не показывать Telegram `file_id`.
 - Озвучивание финальных ответов настраивается персонально для каждого Telegram-пользователя командами `/voice_on`, `/voice_off`; для новых пользователей оно включено по умолчанию.
 - Адаптация текста перед озвучкой настраивается персонально командами `/voice_rewrite_on`, `/voice_rewrite_off`. Если она включена, сервис перед TTS вызывает дешёвую текстовую модель OpenAI и делает голосовую версию без длинных хэшей, путей, команд и технического шума, сохраняя смысл и порядок исходного ответа.
 - Режим личных ответов настраивается персонально командами `/single_message_on`, `/single_message_off`: либо одно редактируемое сообщение по этапам, либо отдельные сообщения как раньше.
 - Команда `/settings` должна сразу показывать текущее состояние всех персональных настроек пользователя и список команд для их изменения.
 - Если озвучивание включено, после полного текстового финального ответа сервис дополнительно отправляет voice-файл с синтезированной речью через OpenAI TTS даже для текстовых запросов. Voice отправляется в исходный чат, а также в известный личный чат пользователя и в общий чат `@shine_writing`, если они отличаются и доступны. Промежуточные статусы не озвучивать.
 - Команда `/status` должна показывать состояние очереди и персональные настройки: voice-ответы, адаптацию текста перед озвучкой и режим одного сообщения в личке.
 ## Правила голосовой версии ответа
 - Текстовый финальный ответ должен оставаться полноценным: в нём можно указывать команды, пути, хэши коммитов, номера версий, результаты проверок и другие технические детали.
 - Голосовую версию финального ответа нужно делать короче и проще для восприятия на слух. Основной механизм — персонально включаемая адаптация текста через дополнительный OpenAI-вызов перед TTS.
 - В голосовой версии не зачитывать длинные хэши коммитов, токены, file_id, длинные команды, полные пути и другие строки, которые человек всё равно не сможет надёжно запомнить на слух.
 - Для commit/push в голосовой версии достаточно сказать краткий итог: что коммит сделан, что именно изменено, проверки прошли без ошибок, push выполнен, рабочее дерево чистое.
 - Если пользователю нужны точные команды, хэши или подробности, они должны оставаться в текстовом ответе.
 ## Планы и отложенные фичи
 - Планы проекта по отложенным фичам хранятся в `TODO/`.
 - Внутри есть три горизонта:
  - `near/` - ближайшие планы, обычно сегодня/завтра;
  - `medium/` - среднесрочные планы, обычно недели или 1-2 месяца;
  - `far/` - дальнее будущее без понятного срока.
 - Если пользователь спрашивает, какие есть планы или что можно продолжить, нужно смотреть эти три папки и отвечать кратким списком по горизонтам.
 - Файлы из `TODO/` не начинать реализовывать без явной команды пользователя.
 ## Центр задач и предложений
 - Сервис хранит простые задачи и предложения в `data/task_center/items.json`.
 - Айдар может смотреть список через `/tasks` или естественные фразы вроде «покажи мои задачи», «покажи задачи Миланы».
 - Айдар может ставить задачи игрокам фразой вида «поставь задачу Милане: ...».
 - Игроки могут отправлять предложения Айдару фразой вида `предложение: ...`, `идея: ...` или `заявка: ...`.
 - Статусы меняются фразами с ID: `одобрить TC-0001`, `отклонить TC-0001`, `доработать TC-0001`, `закрыть TC-0001`.
 - После финального ответа в личном чате сервис добавляет короткое напоминание, если у пользователя есть активные задачи или предложения.
 ## Локальный запуск и systemd
 - Основной запуск сервиса выполняется Python-скриптом `py_bot_service.py` из папки `SHiNE-agent-bot-coder/`.
 - Локальные секреты и параметры должны храниться в `.env`, этот файл не коммитится.
 - Для проверки Codex без Telegram можно использовать self-test режим сервиса.
 - Для постоянного локального запуска используется user-level systemd service `shine-agent-bot-coder`; скрипты установки лежат в `SHiNE-agent-bot-coder/scripts/systemd/`.
 - Если меняется логика сервиса, после изменений нужно проверить запуск локально и при необходимости перезапустить user systemd service.
 - Команда Telegram `/restart` (`/restart_service`) доступна только Айдару и выполняет отложенный рестарт после текущей задачи, до взятия следующей. Аварийный жёсткий рестарт доступен только Айдару командами `/restart_hard`, `/restart_now`, `/restart_force`.
 ## Правила ответа
 - Пиши содержательно и коротко.
 - Не упоминай внутренние служебные детали, файловую систему и технические логи.
 - Если запрос требует действий с кодом/проектом, выполняй их в рабочей директории.
 - Если для ответа данных недостаточно, задай ровно один уточняющий вопрос.
 - Если была ошибка предыдущего запуска, в промпте будет пометка retry — учти это и продолжи с учётом текущего состояния проекта.
@@ -1,25 +0,0 @@
 # AGENTS
 ## Назначение
 - Это автоматически читаемые инструкции Codex для папки `SHiNE-agent-bot-coder/`.
 - `SHiNE-agent-bot-coder` — локальный Telegram-бот-сервис агента-кодера для работы с проектом SHiNE.
 - Если пользователь говорит «агент MD», «агент с MD» или похожим образом про файл инструкций Codex, считать, что имеется в виду `AGENTS.md`.
 ## Связанные инструкции
 - Подробные служебные правила Telegram-обработчика лежат в `AGENT.md`.
 - `AGENT.md` используется самим сервисом как файл инструкций, который передаётся в промпт обработчика входящих Telegram-сообщений.
 - При изменении логики сервиса сначала читать `AGENT.md`, затем код `py_bot_service.py`.
 ## Планы и задачи
 - Отложенные задачи проекта лежат в `../TODO/`.
 - Точка входа по планам: `../TODO/README.md`.
 - Горизонты планов:
  - `near/` - ближайшие планы;
  - `medium/` - среднесрочные планы;
  - `far/` - дальнее будущее.
 - Если пользователь спрашивает, какие есть планы или что можно продолжить, кратко перечислять задачи по этим горизонтам.
 - Не начинать реализацию задач из `TODO` без явной команды пользователя.
 ## Проверка после изменений
 - Если меняется логика Telegram-бота, проверить локальный запуск или self-test, когда это уместно.
 - Если меняется только документация или инструкции, достаточно проверить, что ссылки на документы актуальны.
@@ -1,2 +0,0 @@
@AGENTS.md
@AGENT.md
@@ -1,26 +0,0 @@
 # Промпты для режима игроков (на согласование)
 ## 1) Базовый служебный промпт (добавка к задаче игрока)
 ```text
 Режим игрока (обязательно):
 - Пользователь: <Имя> (@<username>).
 - Рабочая папка игрока: <project>/Players/<username>
 - Код проекта не изменять.
 - Можно отвечать на вопросы по проекту, предлагать идеи и готовить ТЗ.
 - Если нужны правки кода, описывать предложение текстом и сохранять материалы только в папке игрока.
 ```
 ## 2) Приветственное сообщение игроку (один раз)
 ```text
 Привет, <Имя>.
 Можно задавать вопросы по проекту, просить анализ, идеи и подготовку готового ТЗ.
 Команда /new начинает новую сессию и архивирует текущую историю.
 ```
 ## 3) Отказ неизвестному пользователю
 ```text
 Извините, доступ к этому агенту пока не выдан. Обратитесь к Айдару.
 ```
@@ -1,100 +0,0 @@
 # SHiNE-agent-bot-coder
 Локальный Telegram-бот-сервис для пользователя `ai`:
 - принимает сообщения от `@AidarKC`;
 - поддерживает whitelist игроков (`ALLOWED_TELEGRAM_PLAYERS`) с отдельными историями;
 - ведёт историю диалога в `JSONL`;
 - ставит задачи в файловую очередь;
 - обрабатывает задачи строго последовательно;
 - поддерживает текстовые и голосовые сообщения (voice/audio через OpenAI transcription);
 - вызывает Codex CLI и отправляет ответ в Telegram;
 - в личном чате умеет работать в двух персонально переключаемых режимах: через одно редактируемое статусное сообщение или через отдельные сообщения по этапам;
 - умеет персонально для каждого пользователя озвучивать финальный ответ через OpenAI TTS;
 - при рестарте восстанавливает незавершённые задачи;
 - отправляет аварийный статус только если Codex молчит 2 минуты подряд во время активной задачи;
 - принимает сообщения из канала/группы `@shine_writing`, выполняет команды только от `@AidarKC`;
 - учитывает миграцию обычной Telegram-группы в supergroup и перенаправляет ответы на новый `chat_id`.
 Рабочая реализация сервиса — только `py_bot_service.py`. Старая Java-реализация удалена, потому что не заработала и больше не используется.
 ## Структура
 - `.env` — локальные секреты и параметры запуска (не коммитится);
 - `data/py_queue.jsonl` — очередь Python-сервиса;
 - `data/py_state.json` — текущее состояние Python-сервиса;
 - `data/py_processed_updates.log` — дедуп входящих update;
 - `data/history/<username>/*.jsonl` — активные истории по пользователям;
 - `data/history/<username>/archive/*.jsonl` — архивы после `/new`.
 ## Локальный запуск
 1. Скопировать пример:
   - `cp .env.example .env`
 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_API_BASE_URL` — базовый URL Bot API; по умолчанию `https://api.telegram.org`. Для очень больших voice/audio можно поднять локальный `telegram-bot-api` и направить бота туда.
   - `TELEGRAM_FILE_DOWNLOAD_TIMEOUT_SECONDS` — тайм-аут скачивания voice/audio из Telegram, по умолчанию 300 секунд.
   - `OPENAI_TRANSCRIBE_TIMEOUT_SECONDS` — тайм-аут распознавания voice/audio в OpenAI, по умолчанию 900 секунд.
   - `OPENAI_TRANSCRIBE_MAX_UPLOAD_BYTES` — безопасный лимит размера одного куска для OpenAI transcription, по умолчанию `24 MiB`.
   - `OPENAI_TRANSCRIBE_MAX_CHUNK_SECONDS` — максимальная длина одного куска при длинном аудио, по умолчанию `900` секунд.
   - `OPENAI_TRANSCRIBE_OVERLAP_SECONDS` — перекрытие соседних кусков для более ровной склейки текста, по умолчанию `2` секунды.
   - `OPENAI_TRANSCRIBE_REENCODE_BITRATE_KBPS` — битрейт локального пережатия длинного аудио через `ffmpeg`, по умолчанию `24`.
   - `OPENAI_TRANSCRIBE_FFMPEG_TIMEOUT_SECONDS` — тайм-аут локальной обработки длинного аудио через `ffmpeg`/`ffprobe`, по умолчанию `1800`.
   - `FFMPEG_BIN` и `FFPROBE_BIN` — пути к локальным бинарям `ffmpeg`/`ffprobe`, если они не лежат в `PATH`.
   - `OPENAI_TTS_MODEL` — модель синтеза речи, по умолчанию `gpt-4o-mini-tts`.
   - `OPENAI_TTS_VOICE` — голос синтеза речи, по умолчанию `alloy`.
   - `OPENAI_TTS_RESPONSE_FORMAT` — аудиоформат для Telegram voice, по умолчанию `opus`.
   - `OPENAI_TTS_TIMEOUT_SECONDS` — тайм-аут генерации одного фрагмента речи, по умолчанию 180 секунд.
   - `OPENAI_TTS_CHUNK_CHARS` — максимальный размер одного фрагмента озвучки, по умолчанию 3500 символов.
 3. Запуск:
   - `python3 SHiNE-agent-bot-coder/py_bot_service.py`
 ## Быстрый self-test Codex (без Telegram)
 ```bash
 python3 SHiNE-agent-bot-coder/py_bot_service.py --selftest-codex "Ответь одной строкой: Codex работает"
 ```
 ## Длинные voice/audio
 - Если аудио короткое, бот отправляет его в OpenAI как раньше.
 - Если аудио большое или длинное, бот локально пережимает его через `ffmpeg`, при необходимости режет на куски и распознаёт последовательно.
 - Если Telegram заранее сообщает большой размер файла, бот больше не отказывается сразу: сначала явно пишет, что пробует скачать файл, затем отдельно сообщает, удалось ли скачивание, и только после успешной загрузки переходит к подготовке аудио и OpenAI.
 - Для очень больших файлов упираемся не только в OpenAI, но и в лимит обычного облачного Telegram Bot API на скачивание файла ботом. Для таких случаев нужно использовать локальный `telegram-bot-api` сервер и указать его через `TELEGRAM_API_BASE_URL`.
 ## Статусы в личке
 - Для `private`-чата бот поддерживает персональную настройку режима ответа.
 - По умолчанию он старается не засорять переписку промежуточными сообщениями: создаёт одно статусное сообщение и редактирует его по этапам.
 - Если включить `/single_message_off`, бот возвращается к старому режиму и отправляет отдельные сообщения по этапам и финальный ответ отдельно.
 - Если финальный текст в режиме одного сообщения не помещается целиком, бот оставляет первую часть в отредактированном статусном сообщении и отправляет максимум ещё одно дополнительное текстовое сообщение с хвостом ответа.
 - Голосовой ответ, если он включён, всегда приходит отдельным новым сообщением.
 ## Запуск как systemd-сервис
 Файлы для установки:
 - `scripts/systemd/shine-agent-bot-coder.service`
 - `scripts/systemd/install-local-systemd.sh`
 Установка:
 - `bash SHiNE-agent-bot-coder/scripts/systemd/install-local-systemd.sh`
 Проверка:
 - `systemctl --user status shine-agent-bot-coder --no-pager`
 - `journalctl --user -u shine-agent-bot-coder -f`
 Перезапуск после изменений:
 - `systemctl --user restart shine-agent-bot-coder`
 ## Telegram-команды
 - `/status` — активная задача и размер очереди.
 - `/settings` — текущие пользовательские настройки и команды для их изменения.
 - `/queue` — список задач в очереди.
 - `/stop` — остановить текущую задачу.
 - `/cancel <id|all>` — удалить задачу по id/префиксу или очистить очередь.
 - `/new` — архивировать текущую историю, сбросить продолжение Codex-сессии для этого пользователя и начать новый диалог.
 - `/voice_on` — включить озвучивание финальных ответов для текущего пользователя.
 - `/voice_off` — выключить озвучивание финальных ответов для текущего пользователя.
 - `/voice_rewrite_on` — включить адаптацию текста перед озвучкой.
 - `/voice_rewrite_off` — выключить адаптацию текста перед озвучкой.
 - `/single_message_on` — вести ответ в личке через одно редактируемое сообщение.
 - `/single_message_off` — слать отдельные сообщения по этапам и отдельный финальный ответ.
 - `/restart` или `/restart_service` — отложенный рестарт после текущей задачи, до взятия следующей (только для Айдара).
 - `/restart_hard` — жёсткий рестарт прямо сейчас (только для Айдара).
@@ -1,28 +0,0 @@
 #!/usr/bin/env bash
 set -euo pipefail
 ROOT_DIR="/home/ai/work/SHiNE/SHiNE-server-sha256"
 SERVICE_DIR="${ROOT_DIR}/SHiNE-agent-bot-coder"
 UNIT_SRC="${SERVICE_DIR}/scripts/systemd/shine-agent-bot-coder.service"
 UNIT_DST="${HOME}/.config/systemd/user/shine-agent-bot-coder.service"
 echo "[1/6] Проверка python3..."
 command -v python3 >/dev/null 2>&1 || { echo "python3 не найден"; exit 1; }
 echo "[2/6] Подготовка папки логов..."
 mkdir -p "${SERVICE_DIR}/logs"
 echo "[3/6] Копирование user systemd unit..."
 mkdir -p "$(dirname "${UNIT_DST}")"
 cp "${UNIT_SRC}" "${UNIT_DST}"
 echo "[4/6] daemon-reload..."
 systemctl --user daemon-reload
 echo "[5/6] enable + start..."
 systemctl --user enable --now shine-agent-bot-coder
 echo "[6/6] Статус:"
 systemctl --user status shine-agent-bot-coder --no-pager
 echo "Готово. Логи: journalctl --user -u shine-agent-bot-coder -f"
@@ -1,19 +0,0 @@
 [Unit]
 Description=SHiNE Agent Bot Coder (Telegram + Codex queue worker)
 After=network-online.target
 Wants=network-online.target
 [Service]
 Type=simple
 WorkingDirectory=/home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-agent-bot-coder
 EnvironmentFile=/home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-agent-bot-coder/.env
 ExecStart=/usr/bin/python3 /home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-agent-bot-coder/py_bot_service.py
 Restart=always
 RestartSec=5
 TimeoutStopSec=20
 SuccessExitStatus=143 0
 StandardOutput=append:/home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-agent-bot-coder/logs/service.log
 StandardError=append:/home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-agent-bot-coder/logs/service.log
 [Install]
 WantedBy=default.target
@@ -1,2 +1,2 @@
-client.version=1.2.332
+client.version=1.2.333
-server.version=1.2.304
+server.version=1.2.305
@@ -1,31 +0,0 @@
 TELEGRAM_BOT_TOKEN=replace_me
 OPENAI_API_KEY=
 ALLOWED_TELEGRAM_USERNAME=owner_username
 ALLOWED_TELEGRAM_PLAYERS=user_one:User One,user_two:User Two
 ALLOWED_TELEGRAM_CHANNEL_USERNAME=
 BOT_USERNAME=your_bot_username
 TELEGRAM_API_BASE_URL=https://api.telegram.org
 OPENAI_TRANSCRIBE_MODEL=gpt-4o-mini-transcribe
 TELEGRAM_FILE_DOWNLOAD_TIMEOUT_SECONDS=300
 OPENAI_TRANSCRIBE_TIMEOUT_SECONDS=900
 OPENAI_TRANSCRIBE_MAX_UPLOAD_BYTES=25165824
 OPENAI_TRANSCRIBE_MAX_CHUNK_SECONDS=900
 OPENAI_TRANSCRIBE_OVERLAP_SECONDS=2
 OPENAI_TRANSCRIBE_REENCODE_BITRATE_KBPS=24
 OPENAI_TRANSCRIBE_FFMPEG_TIMEOUT_SECONDS=1800
 FFMPEG_BIN=ffmpeg
 FFPROBE_BIN=ffprobe
 OPENAI_TTS_MODEL=gpt-4o-mini-tts
 OPENAI_TTS_VOICE=alloy
 OPENAI_TTS_RESPONSE_FORMAT=opus
 OPENAI_TTS_TIMEOUT_SECONDS=180
 OPENAI_TTS_CHUNK_CHARS=3500
 OPENAI_VOICE_REWRITE_MODEL=gpt-4.1-nano
 OPENAI_VOICE_REWRITE_TIMEOUT_SECONDS=90
 OPENAI_VOICE_REWRITE_MAX_INPUT_CHARS=12000
 OPENAI_VOICE_REWRITE_MAX_OUTPUT_TOKENS=900
 CODEX_BIN=/home/your_user/.local/bin/codex
 CODEX_WORKDIR=/home/your_user
 CODEX_TIMEOUT_SECONDS=900
 MAX_RETRIES=3
 DATA_DIR=./data
@@ -1,5 +0,0 @@
 .env
 data/
 logs/
 run/
 __pycache__/
@@ -1,86 +0,0 @@
 # AGENTS
 ## Назначение
 - `codex-agent-VPS` — переносимая версия Telegram-бота для запуска `codex` CLI на VPS.
 - Папку можно ставить в любое место на Linux-сервере, если там есть `python3`, `systemd`, `codex` и доступ в интернет.
 - Конфигурация делается через `.env`.
 ## Состав папки
 - `README.md` — краткое описание структуры.
 - `Agent-server-package/` — готовый набор файлов для копирования на VPS.
 - `.env.example` — пример конфигурации.
 - `AGENTS.md` — инструкция по установке и настройке.
 ## Требования к VPS
 - Linux-сервер с `systemd`.
 - Установленные `python3`, `curl`, `ffmpeg`.
 - Установленный `codex` CLI.
 - Выполненный `codex login` под тем пользователем, от которого будет работать сервис.
 - Telegram bot token.
 - Telegram usernames разрешённых пользователей.
 ## Установка через Codex
 1. Скопировать содержимое `Agent-server-package/` на сервер в нужное место, например:
   - `/home/your_user/codex-agent`
 2. Установить `codex` CLI под рабочим пользователем.
 3. Выполнить под этим же пользователем:
   - `codex login`
 4. Установить системные зависимости:
   - `python3`
   - `ffmpeg`
 5. Взять `.env.example` из корня `codex-agent-VPS` и создать на сервере `.env`.
 6. В `.env` заполнить:
   - `TELEGRAM_BOT_TOKEN`
   - `ALLOWED_TELEGRAM_USERNAME`
   - `ALLOWED_TELEGRAM_PLAYERS`
   - `BOT_USERNAME`
   - `CODEX_BIN`
   - `CODEX_WORKDIR`
 7. Если нужны voice/audio и голосовые ответы, дополнительно задать:
   - `OPENAI_API_KEY`
 8. В `Agent-server-package/scripts/systemd/shine-agent-bot-coder.service` заменить:
   - `your_user`
   - `/home/your_user/codex-agent`
   на реальные значения.
 9. Скопировать unit в:
   - `/etc/systemd/system/shine-agent-bot-coder.service`
 10. Выполнить:
   - `sudo systemctl daemon-reload`
   - `sudo systemctl enable --now shine-agent-bot-coder`
 11. Проверить:
   - `sudo systemctl status shine-agent-bot-coder --no-pager`
   - `sudo journalctl -u shine-agent-bot-coder -f`
 ## Настройка доступа
 - `ALLOWED_TELEGRAM_USERNAME` — основной разрешённый пользователь.
 - `ALLOWED_TELEGRAM_PLAYERS` — дополнительные разрешённые пользователи:
  - `username1:Имя 1,username2:Имя 2`
 - Все пользователи из whitelist в этой версии считаются полноправными.
 - Все входящие задачи попадают в одну общую очередь и выполняются строго последовательно.
 ## Поведение агента
 - Бот принимает текст, voice и audio.
 - Для каждого пользователя ведётся отдельная история.
 - Все задачи запускаются через `codex exec`.
 - Рабочая директория задаётся через `CODEX_WORKDIR`.
 - Вызов идёт без sandbox/approval ограничений: `--dangerously-bypass-approvals-and-sandbox`.
 ## Что обычно меняют при переносе
 - `.env`
 - `Agent-server-package/scripts/systemd/shine-agent-bot-coder.service`
 - при необходимости `Agent-server-package/AGENT.md`
 ## Полезные команды
 - Проверка установки Codex:
  - `codex --version`
  - `codex doctor`
 - Self-test без Telegram:
  - `python3 py_bot_service.py --selftest-codex "Ответь одной строкой: Codex работает"`
 - Проверка сервиса:
  - `sudo systemctl status shine-agent-bot-coder --no-pager`
  - `sudo journalctl -u shine-agent-bot-coder -f`
 ## Примечания
 - Если `codex doctor` пишет, что credentials не найдены, нужно выполнить `codex login`.
 - Если `OPENAI_API_KEY` пустой, текстовые задачи через `codex` будут работать, а voice/audio и TTS-функции — нет.
 - Если у пользователя в Telegram нет username, whitelist по username его не пропустит.
@@ -1,31 +0,0 @@
 TELEGRAM_BOT_TOKEN=replace_me
 OPENAI_API_KEY=
 ALLOWED_TELEGRAM_USERNAME=owner_username
 ALLOWED_TELEGRAM_PLAYERS=user_one:User One,user_two:User Two
 ALLOWED_TELEGRAM_CHANNEL_USERNAME=
 BOT_USERNAME=your_bot_username
 TELEGRAM_API_BASE_URL=https://api.telegram.org
 OPENAI_TRANSCRIBE_MODEL=gpt-4o-mini-transcribe
 TELEGRAM_FILE_DOWNLOAD_TIMEOUT_SECONDS=300
 OPENAI_TRANSCRIBE_TIMEOUT_SECONDS=900
 OPENAI_TRANSCRIBE_MAX_UPLOAD_BYTES=25165824
 OPENAI_TRANSCRIBE_MAX_CHUNK_SECONDS=900
 OPENAI_TRANSCRIBE_OVERLAP_SECONDS=2
 OPENAI_TRANSCRIBE_REENCODE_BITRATE_KBPS=24
 OPENAI_TRANSCRIBE_FFMPEG_TIMEOUT_SECONDS=1800
 FFMPEG_BIN=ffmpeg
 FFPROBE_BIN=ffprobe
 OPENAI_TTS_MODEL=gpt-4o-mini-tts
 OPENAI_TTS_VOICE=alloy
 OPENAI_TTS_RESPONSE_FORMAT=opus
 OPENAI_TTS_TIMEOUT_SECONDS=180
 OPENAI_TTS_CHUNK_CHARS=3500
 OPENAI_VOICE_REWRITE_MODEL=gpt-4.1-nano
 OPENAI_VOICE_REWRITE_TIMEOUT_SECONDS=90
 OPENAI_VOICE_REWRITE_MAX_INPUT_CHARS=12000
 OPENAI_VOICE_REWRITE_MAX_OUTPUT_TOKENS=900
 CODEX_BIN=/home/your_user/.local/bin/codex
 CODEX_WORKDIR=/home/your_user
 CODEX_TIMEOUT_SECONDS=900
 MAX_RETRIES=3
 DATA_DIR=./data
@@ -1,51 +0,0 @@
 # AGENT.md для codex-agent-VPS
 Ты запущен как обработчик входящего Telegram-сообщения от пользователя.
 ## Контекст
 - `codex-agent-VPS` — Telegram-бот, который принимает сообщения, ведёт историю, ставит задачи в очередь и последовательно запускает `codex` CLI на VPS.
 - Текстовые сообщения обрабатываются напрямую.
 - Voice и audio сначала распознаются через OpenAI transcription, затем передаются как текстовая задача.
 - История диалога хранится в JSONL-файле, путь передаётся в промпте.
 - Ответ пойдёт пользователю в Telegram как обычное текстовое сообщение.
 - Основная реализация сервиса — Python-скрипт `py_bot_service.py`.
 ## Пользователи и доступ
 - Разрешённые пользователи задаются через `ALLOWED_TELEGRAM_USERNAME` и `ALLOWED_TELEGRAM_PLAYERS`.
 - Все разрешённые пользователи считаются полноправными.
 - Для неизвестных пользователей в личном чате сервис отвечает вежливым отказом.
 - Все входящие задачи попадают в одну общую очередь и выполняются строго по одной.
 ## Очередь и состояние
 - Сервис ведёт состояние активной задачи и текущего файла истории.
 - После рестарта сервис продолжает незавершённую обработку с учётом сохранённого состояния.
 - Истории диалогов хранятся отдельно по username: `data/history/<username>/`.
 - Архив истории после `/new`: `data/history/<username>/archive/`.
 - После `/new` для этого же пользователя должен сбрасываться и контекст продолжения Codex-сессии; следующий запрос запускается как новая сессия, не через resume.
 - Дедупликация Telegram update обязательна, чтобы одно сообщение не обрабатывалось повторно.
 - Если Codex молчит во время активной задачи 2 минуты подряд, сервис отправляет аварийный статус и повторяет его каждые 2 минуты.
 ## Голосовые ответы
 - Озвучивание финальных ответов настраивается персонально командами `/voice_on` и `/voice_off`.
 - Для новых пользователей озвучивание включено по умолчанию.
 - Адаптация текста перед озвучкой настраивается командами `/voice_rewrite_on` и `/voice_rewrite_off`.
 - Если озвучивание включено, после текстового финального ответа сервис дополнительно отправляет voice-файл через OpenAI TTS.
 - Промежуточные статусы озвучивать не нужно.
 ## Команды
 - `/status` — состояние очереди и персональных настроек.
 - `/settings` — текущие пользовательские настройки.
 - `/queue` — список задач в очереди.
 - `/tasks` — список задач и предложений пользователя.
 - `/new` — архивировать историю и начать новую Codex-сессию.
 - `/stop` — остановить текущую задачу.
 - `/cancel <id|all>` — удалить задачу по id или очистить очередь.
 - `/restart` и `/restart_service` — отложенный рестарт после текущей задачи.
 - `/restart_hard`, `/restart_now`, `/restart_force` — жёсткий рестарт прямо сейчас.
 ## Правила ответа
 - Пиши содержательно и коротко.
 - Не упоминай внутренние служебные детали, файловую систему и технические логи, если это не нужно пользователю.
 - Если запрос требует действий с кодом или файлами, выполняй их в рабочей директории `CODEX_WORKDIR`.
 - Если данных недостаточно, задай ровно один уточняющий вопрос.
 - Если в промпте есть пометка retry, учитывай текущее состояние и продолжай аккуратно, а не начинай заново без причины.
@@ -1,23 +0,0 @@
 [Unit]
 Description=SHiNE Agent Bot Coder (Telegram + Codex queue worker)
 After=network-online.target
 Wants=network-online.target
 [Service]
 Type=simple
 User=your_user
 Group=your_user
 WorkingDirectory=/home/your_user/codex-agent
 Environment=HOME=/home/your_user
 Environment=PATH=/home/your_user/.local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
 EnvironmentFile=/home/your_user/codex-agent/.env
 ExecStart=/usr/bin/python3 /home/your_user/codex-agent/py_bot_service.py
 Restart=always
 RestartSec=5
 TimeoutStopSec=20
 SuccessExitStatus=143 0
 StandardOutput=append:/home/your_user/codex-agent/logs/service.log
 StandardError=append:/home/your_user/codex-agent/logs/service.log
 [Install]
 WantedBy=multi-user.target
@@ -1,32 +0,0 @@
 # codex-agent-VPS
 Переносимый комплект Telegram-бота для запуска `codex` CLI на VPS.
 ## Структура
 - `README.md` — краткое описание структуры.
 - `AGENTS.md` — инструкции по установке и настройке через Codex.
 - `.env.example` — верхнеуровневый пример конфига.
 - `Agent-server-package/` — готовый комплект файлов для копирования на другой сервер.
 ## Что копировать на сервер
 На VPS обычно копируется содержимое папки:
 - `Agent-server-package/`
 Внутри неё лежат:
 - `py_bot_service.py`
 - `AGENT.md`
 - `scripts/systemd/shine-agent-bot-coder.service`
 ## Что настраивать
 - взять `.env.example` из корня `codex-agent-VPS/`
 - создать на сервере `.env`
 - вписать Telegram bot token
 - вписать разрешённые usernames
 - указать путь к `codex`
 - указать рабочую директорию `CODEX_WORKDIR`
 ## Где инструкция
 Полная инструкция по установке и настройке лежит в:
 - `AGENTS.md`
@@ -2,9 +2,9 @@
 ## Где находится сервис
- Папка сервиса: `SHiNE-agent-bot-coder/`
+- Папка сервиса находится рядом с репозиторием продукта: `../SHiNE-agent-bot-coder/`
- Systemd unit: `SHiNE-agent-bot-coder/scripts/systemd/shine-agent-bot-coder.service`
+- Systemd unit: `../SHiNE-agent-bot-coder/scripts/systemd/shine-agent-bot-coder.service`
- Скрипт установки: `SHiNE-agent-bot-coder/scripts/systemd/install-local-systemd.sh`
+- Скрипт установки: `../SHiNE-agent-bot-coder/scripts/systemd/install-local-systemd.sh`
 ## Предусловия
@@ -18,7 +18,13 @@
 Из корня репозитория:
 ```bash
-bash SHiNE-agent-bot-coder/scripts/systemd/install-local-systemd.sh
+bash ../SHiNE-agent-bot-coder/scripts/systemd/install-local-systemd.sh
 ```
 В `.env` агента `CODEX_WORKDIR` должен указывать на этот репозиторий продукта:
 ```env
 CODEX_WORKDIR=/home/ai/work/SHiNE/SHiNE-server-sha256/SHiNE-product
 ```
 Скрипт:
`@@ -1,2 +1,2 @@`
	`client.version=1.2.332`	`client.version=1.2.333`
	`server.version=1.2.304`	`server.version=1.2.305`