# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17
# Ресурсы: [memory_lessons table,hub/lesson.py, bach_api.lesson]

ИЗВЛЕЧЕННЫЕ УРОКИ — Управление знаниями
====================================

Статус: 2026-02-08

Система для сбора и получения аналитических данных, исправлений ошибок и передового опыта.
Уроки являются основой «обратной связи» с поведением системы.

КОМАНДЫ CLI
-----------
  bach lesson add "Titel: Loesung"     Добавить новый урок
  bach lesson edit ID [Optionen]       Редактировать урок (v1.1.70)
  bach lesson deactivate ID [-r REASON] Deaktivieren (v1.1.70)
  bach lesson last [n]                 Последние n уроков (по умолчанию: 5)
  bach lesson search "keyword"         Просмотреть
  bach lesson show ID                  Показать детали и метаданные

LIBRARY API
-----------
  из урока по импорту bach_api
  урок.add("Название: Решение", "--category", "ошибка")
  урок.список("ошибка")
  урок.edit(42, "--title", "Новый заголовок")
  урок.деактивировать(42, "--reason", "Устарело")
  урок.шоу(42)

КАТЕГОРИИ (текущие)
--------------------
  ошибка Исправления ошибок и обходные пути
  рабочий процесс Расширенные рабочие процессы (например, Multi-LLM)
  инструмент Знание конкретных инструментов
  интеграция Интеграция с внешними системами
  Производительность Оптимизация производительности
  общие Общие архитектурные решения

СЕРЬЕЗНОСТЬ
------------
  низкий Просто для вашей информации
  средний Рекомендуемый стандарт
  высокий Важное правило (приоритет форсунок)
  критические знания критических систем (правила защиты)

ПРИМЕРЫ
=========

  # Исправление ошибки в документе
  bach lesson add "SQLite Lock: WAL-Mode aktivieren" --category bug --severity high

  # Документооборот
  bach lesson add "Multi-LLM: Immer llm lock vor Schreibzugriff" --category workflow

  # Оптимизация производительности
  bach lesson add "DB-Queries: Index auf created_at" --category performance

  # Знания об интеграции
  bach lesson add "OCR: Tesseract braucht PATH-Variable" --category integration

  # Редактировать урок
  bach lesson edit 42 --title "Neuer Titel" --severity critical

  # Деактивировать урок
  bach lesson deactivate 42 --reason "Durch bessere Loesung ersetzt"

ИЗВЕСТНЫЕ ПРОБЛЕМЫ И РЕШЕНИЯ (отрывок)
=====================================

1. ОБЩИЕ ФАЙЛЫ MULTI-LLM (рабочий процесс)
   Проблема: условия гонки во время одновременного редактирования.
   Решение: ВСЕГДА используйте `bach ​​llm lock <file>` перед доступом на запись.

2. CLI-ПЕРВЫЙ ПРИНЦИП (рабочий процесс)
   Проблема: ручное редактирование файлов обходит форсунки/мониторинг.
   Решение: ВСЕГДА делайте все, что работает, через CLI (задача, урок, память) через CLI.

3. КОДИРОВАНИЕ WINDOWS (ошибка)
   Проблема: смайлы часто приводят к сбою стандартной консоли Windows.
   Решение. В Python используйте `io.TextIOWrapper` с резервной версией UTF-8 для стандартного вывода.

4. ЗАБЛОКИРОВАТЬ ФАЙЛ БД (производительность)
   Проблема: ошибка блокировки при параллельном доступе многих процессов.
   Решение: короткие транзакции и режим WAL (ведение журнала упреждающей записи).

5. ОБНОВЛЕНИЕ ДОКУМЕНТОВ (ошибка)
   Проблема: устаревшие версии блокируют сеансы SKILL.md.
   Решение: регулярно запускайте `python Tools/doc_update_checker.py`.

ИНТЕГРАЦИЯ
-----------
Уроки автоматически переходят в **Систему динамического обучения**:
- Генерация триггеров: ключевые слова в заголовках генерируют подсказки для инжекторов.
- Активация: `is_active=1` определяет, какие правила будут представлены LLM.

СМОТРИ ТАКЖЕ
----------
  docs/help/memory.txt Модель когнитивной памяти
  docs/help/consolidation.txt От мероприятия к уроку
  ROADMAP.md этапы развития
