# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Статус: СТАТУС — Преемник: Служба чата BACH (help bach_chat)

CLAUDE BRIDGE — Telegram <-> Интеграция CLI кода Claude (LEGACY)
==================================================================

ПРИМЕЧАНИЕ: Claude Bridge заменен службой чата BACH.
         Новый сервис предлагает 5 бэкэндов, API управления, веб-панель.
         и кроссплатформенный системный лоток. См.: help bach_chat

ОПИСАНИЕ
------------
Claude Bridge — это обработчик бота Telegram, обеспечивающий двустороннюю связь.
между чатами Telegram и CLI BACH/Claude Code. Демон
работает в фоновом режиме, обрабатывает входящие сообщения, делегирует
более длинные задачи в рабочие потоки и отправляет результаты через Telegram.

Архитектура:
  - Чат-Клод: обрабатывает каждое сообщение Telegram в новом контексте.
  - Рабочий-Клод: для более длительных/автономных задач (с обновлением статуса)
  - Демон: контролирует разрешения, бюджет и жизненный цикл.
  - Безопасность: система вызова-ответа с настраиваемым паролем


ОПЕРАЦИИ
-----------
  bach claude-bridge start              Запуск демона в фоновом режиме
  bach claude-bridge stop               Завершение демона
  bach claude-bridge status             Статус: демон, рабочие, бюджет, режим
  bach claude-bridge mode               Показать режим разрешений (из конфигурации)
  bach claude-bridge test "msg"         Имитировать тестовое сообщение (локально)
  bach claude-bridge logs [N]           Последние N строк журнала (по умолчанию: 20)
  bach claude-bridge workers            Последние 10 рабочих со статусом/ошибкой
  bach claude-bridge password <pw>      Изменить пароль на полный доступ
  bach claude-bridge setup              Мастер интерактивной настройки для новых пользователей
  bach claude-bridge challenge [user]   Создать запрос безопасности
  bach claude-bridge verify <ans>       Проверить ответ на запрос [--user=ID]


ТЕЛЕГРАММНЫЕ КОМАНДЫ (активировать в чате)
-------------------------------------
  включить/выключить полный доступ (автоблокировка на 1 час)
  режим Показать текущий режим
  бюджет Посмотреть статус бюджета
  работники Обзор последнего работника
  остановить Немедленно прекратить работу рабочих


ПРИМЕРЫ
---------
  # Запустите демон и подождите 2 секунды, затем проверьте статус
  Начало $bach claude-bridge
  $сон 2
  $ статус клод-бриджа Баха

  # Имитируем тестовое сообщение локально
  $ тест Клод-Бридж "Привет, как дела?"

  # Показать последние 50 строк журнала
  Бревна $ bach claude-bridge 50 

  # Установите новый пароль (затем перезапустите демон)
  Пароль $ bach claude-bridge "MyNewPW123"
  $ Бах Клод-Бридж остановка
  $ Бах Клод-Бридж старт

  # Создайте и проверьте запрос безопасности
  вызов $bach claude-bridge user_123
  $ bach claude-bridge проверить "AnswerText" --user=user_123


ФАЙЛЫ
-------
  Обработчик:hub/claude_bridge.py
  Демон:hub/_services/claude_bridge/bridge_daemon.py
  Конфигурация:hub/_services/claude_bridge/config.json
  Настройка:hub/_services/claude_bridge/setup_wizard.py
  Безопасность: Hub/_services/claude_bridge/security.py.
  Журналы: data/logs/claude_bridge.log
  БД: data/bach.db (таблица: claude_bridge_workers)


КОНФИГУРАЦИЯ
-------------
См. config.json:
  - Permissions.default_mode: «ограниченный» | "интерактивный" | "полный"
  - Permissions.password: Пароль для полного доступа.
  - telegram.token: токен бота (устанавливается при настройке)
  - Workers.max_concurrent: Макс. одновременные рабочие (по умолчанию: 3)
  - Budget.hourly_limit: лимит стоимости API в час


СМОТРИ ТАКЖЕ
----------
  справка по разъему Система разъемов (Telegram и т. д.)
  партнерская система помощи партнерам (Multi-LLM)
  каталог обработчика Hub/_services/claude_bridge/
