# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

ГЕНЕРАТОР ПОДСКАЗОК BACH
---------------------

Генератор подсказок — это плата с графическим интерфейсом для создания, управления и
Отправка запросов в сеансы Claude - вручную или автоматически.

СТАТУС: ФУНКЦИОНАЛЬНЫЙ (веб-интерфейс, служба реализована)
ОБРАБОТЧИК: НЕ ЗАРЕГИСТРИРОВАН (без интеграции с bach.py)
СЕРВИС: хаб/_services/prompt_generator/
Графический интерфейс: gui/templates/prompt-generator.html (веб-интерфейс)
ПРИМЕЧАНИЕ. Настольное приложение (prompt_manager.py, PyQt6) было удалено (v1.1.8).


КОНЦЕПЦИЯ
-------

Плата обеспечивает общесистемное управление подсказками со следующими функциями:

  1. Текстовый редактор приглашения к запуску (с функцией сброса)
  2. Выбор шаблона (Система/Агенты/Свой)
  3. Четыре варианта отправки
  4. Управление демоном (расписание)


ОПЦИИ ОТПРАВКИ (4 режима)
----------------------

  1. КАК ЗАДАЧА
     - Быстро ставится в очередь как задача
     - Асинхронная обработка следующей сессией Claude
     - Никакого немедленного исполнения

  2. ПРЯМОЕ ЗАСЕДАНИЕ
     - Немедленно начинается новая сессия Клода.
     - Подсказка отправляется посредством быстрого ввода (Ctrl+Alt+Пробел).
     - Блокировка до конца сеанса

  3. КОПИРОВАТЬ ТЕКСТ
     - Копирует приглашение в буфер обмена.
     - Пользователь вставляет вручную в Клод
     - Для корректировки перед отправкой

  4. УПРАВЛЕНИЕ ДЕМОНАМИ
     - Автоматическое оперативное выполнение
     - Настраиваемые: интервал, время блокировки, максимальное количество сеансов.
     - Ротация с одним или несколькими подсказками


СИСТЕМА ШАБЛОНОВ
---------------

  Системные шаблоны (не редактируемые, для сброса):
    - минимальный.txt. Основа: прочитать SKILL.md, выполнить bach.py.
    - Task.txt Выполнение задачи с выводом JSON
    - проверка кода review.txt с оценкой

  Шаблоны агентов:
    - разработка программного обеспечения ati.txt (агент ATI)
    - Tax.txt бухгалтерский (налоговый агент)
    - Maintenance.txt Обслуживание системы BACH

  Собственные шаблоны:
    - Пользовательские/настраиваемые подсказки
    - Хранится в БД (таблица Prompt_templates)


DAEMON CONTROL
----------------

Дополнительные параметры для автоматических сеансов:

  Интервал: минуты между сеансами (по умолчанию: 30).
  Максимальное количество сеансов: лимит на запуск (0 = неограниченно)
  Время блокировки: начало/окончание периода отдыха (по умолчанию: 22:00–8:00)
  Максимальная продолжительность: Макс. минут за сеанс (по умолчанию: 15)

  Режимы:
    Одиночное приглашение: Всегда одно и то же приглашение
    Мультиподсказка: чередование различных шаблонов

  Однострочный: одновременно активен только 1 сеанс (по умолчанию)


СХЕМА ГИП (gui/prompt_manager.py – РЕАЛИЗОВАНО)
---------------------------------------------------

  Менеджер темных тем на базе PySide6 с:
  - Вкладка 1: Редактор подсказок + Шаблоны (Система/Агенты/Пользовательские)
  - Вкладка 2: Управление демоном (интервалы, время отдыха, профили)
  - Вкладка 3: Управление шаблонами.
  - Вкладка 4: Управление профилем.
  - Значок на панели задач
  - Блокировка одного экземпляра

  Вызов: python system/gui/prompt_manager.py


КОМАНДЫ CLI (ТЕКУЩИЙ)
---------------------

ПРЯМОЙ ВЫЗОВ (сценарий службы):
  cd system/hub/_services/prompt_generator
  Список Python Prompt_generator.py
  python Prompt_generator.py получить <путь>
  python Prompt_generator.py генерирует <путь>
  python Prompt_generator.py копировать <путь>
  сеанс python Prompt_generator.py [агент]
  python Prompt_generator.py start [агент]
  статус python Prompt_generator.py

НАЧАТЬ GUI:
  python system/gui/prompt_manager.py

ИНТЕГРАЦИЯ BACH.PY:
  ОТСУТСТВУЕТ – обработчик не зарегистрирован!
  «Список подсказок Python bach.py» НЕ работает
  «python bach.py --prompt list» НЕ РАБОТАЕТ


ОПРЕДЕЛЕНИЕ: ТРИ СИСТЕМЫ ОБРАБОТЧИКА
--------------------------------

  ┌────────────────────────────────────────────────────────────────┐
  │ ГЕНЕРАТОР ПОДСКАЗКИ │
  ├────────────────────────────────────────────────────────────────┤
  │ Создание, управление и отправка подсказок │
  │ Ручной или автоматический │
  │ Общесистемный для всех агентов │
  │ Обработчик: ОТСУТСТВУЕТ (нет в реестре) │
  │ Сервис:hub/_services/prompt_generator/prompt_generator.py │
  │ Графический интерфейс: gui/prompt_manager.py (PySide6, автономный) │
  │ Демон: ДА (session_daemon.py) │
  │ API: ОТСУТСТВУЕТ (нет в bach_api.py) │
  └──────────────────────────────── ────────────────────────────────┘

┌────────────────────────────────────────────────────────────────┐
  │ ОБСЛУЖИВАНИЕ (docs/help/maintenance.txt) │
  ├────────────────────────────────────────────────────────────────┤
  │ Выполнение команд оболочки/Python (резервное копирование, очистка) │
  │ Никаких подсказок, только команды │
  │ Обработчик:hub/daemon.py (зарегистрирован) │
  │ Сервис: gui/api/daemon_api.py + DB │
  │ Графический интерфейс: /daemon (веб-панель) │
  │ Демон: ДА (собственный процесс) │
  └───────────────────────────────── ──────────────────────────────┘

  ┌────────────────────────────────────────────────────────────────┐
  │ ПОВТОРЯЮЩИЕСЯ (docs/help/recurring.txt) │
  ├────────────────────────────────────────────────────────────────┤
  │ Создает задачи в качестве напоминаний │
  │ Без оперативной отправки │
  │ Обработчик:hub/recurring.py (зарегистрирован) │
  │ Сервис: хаб/_services/recurring/ │
  │ Графический интерфейс: НЕТ (только CLI) │
  │ Демон: НЕТ (проверять при вызове) │
  └──────────────────────────────────────────── ──────────────────────────┘


ТЕХНИЧЕСКАЯ БАЗА
----------------

  Папка сервиса:hub/_services/prompt_generator/
    ├── Документация README.md
    ├── Конфигурация config.json (настройки демона)
    ├── основная логика Prompt_generator.py (CLI + API)
    ├── шаблоны/папка шаблонов
    │ ├── системные/шаблоны только для чтения
    │ │ ├── минимальный.txt
    │ │ ├── Task.txt
    │ │ └── обзор.txt
    │ └── Агенты/Редактируемые шаблоны
    │ ├── ati.txt
    │ ├── налог.txt
    │ └── Maintenance.txt
    └── профили/профили демонов
        ├── ati.json
        └── Maintenance.json

  Графический интерфейс: gui/prompt_manager.py (PySide6, автономный)

  ОТСУТСТВИЕ ИНТЕГРАЦИИ:
    - Нет обработчика в хабе/(нет в реестре)
    — Нет модуля bach_api (отсутствует в bach_api.py).
    - Вызов через «подсказку bach.py» НЕВОЗМОЖЕН


ИЗВЕСТНЫЕ ПРОБЛЕМЫ
-----------------

1. НЕТ ИНТЕГРАЦИИ BACH.PY
   - Сервис работоспособен, но его нет в реестре bach.py
   - «Список подсказок python bach.py» → Ошибка
   - Обходной путь: прямой вызов службы (см. КОМАНДЫ CLI)

2. НЕТ ИНТЕГРАЦИИ BACH_API
   — Нет модуля «подсказки» в bach_api.py.
   - API библиотеки не может быть использован.
   - Обходной путь: импортируйте службу напрямую

3. НЕСООТВЕТСТВИЕ ПУТИ
   - Файл справки по навыкам/_services/ (старый)
   - На самом деле в хабе/_services/ (правильно)

ТРЕБУЕТСЯ МИГРАЦИЯ:
  — Создайте обработчик вhub/prompt.py.
  - Зарегистрируйтесь в реестре (класс BaseHandler)
  - разверните bach_api.py с помощью Prompt = _HandlerProxy("prompt")


СМОТРИ ТАКЖЕ
----------

  помощь в обслуживании работ по техническому обслуживанию (команды оболочки)
  помощь повторяющиеся напоминания о повторяющихся задачах (без графического интерфейса)
  Помогите агенту разработчика программного обеспечения ATI
  демон помощи Управление демоном (обслуживание или демон сеанса)
