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

ОБРАБОТЧИК НАСТРОЕК
---------------

ИМЯ ОБРАБОТЧИКА
------------
settings

ОПИСАНИЕ
------------
Обработчик настроек управляет системными настройками в базе данных BACH
(таблица system_config). Настройки представляют собой пары «ключ-значение» с необязательными
Категории, описания и типы распространения (ПОЛЬЗОВАТЕЛЬ/ШАБЛОН/CORE).

ОПЕРАЦИИ
-----------

СПИСОК
----
bach settings list
bach settings list --category=KATEGORIE

Показать все сохраненные настройки. Опционально фильтруется по категориям.
Вывод показывает: Ключ, Значение, Тип, Категория, Описание, Тип Dist (USER/TMPL/CORE)

GET
---
bach settings get <key>

Чтение отдельного значения с полными метаданными.
Показывает: ключ, значение, тип, категорию, описание, тип расстояний, обновленную метку времени

SET
---
bach settings set <key>=<value> [--category=CAT] [--desc=TEXT]

Установить новое значение или обновить существующее.
- Новые настройки получают dist_type=0 (ПОЛЬЗОВАТЕЛЬ)
- Настройки CORE (dist_type=2) изменить нельзя.
- Опция --category: сохранять настройки в категории.
- Опция --desc: добавить описание
- Запускает обновление MD партнера при интеграции.*-Клавиши

RESET
-----
bach settings reset <key>

Удалить настройку. Настройки CORE не могут быть удалены.
Можно удалить только USER и TEMPLATE.

ЭКСПОРТ
------
bach settings export [dateiname]

Экспортируйте все настройки в формате JSON. Вывод на стандартный вывод без имени файла.
Формат: {ключ: {значение, тип, категория, описание, dist_type}}

ИМПОРТ
------
bach settings import <dateiname>

Импортировать настройки из файла JSON. Перезаписывает только ПОЛЬЗОВАТЕЛЬ/ШАБЛОН,
Настройки CORE остаются неизменными. Показывает количество импортированных/пропущенных.

КАТЕГОРИИ
----------
bach settings categories

Показать все доступные категории с количеством записей.

ПРИМЕРЫ
---------

Перечислить все настройки:
Список настроек $ bach

Фильтровать по категории:
Список настроек $ bach --category=security

Читать настройки:
$ bach settings get db.backup_interval

Установить настройку (новую):
$ bach settings set log.level=DEBUG --category=behavior --desc="Подробнее о ведении журнала"

Обновить настройку:
$ bach settings set log.level=INFO

Удалить настройку:
$ bach settings сброс log.level

Экспорт и сохранение настроек:
$bach settings экспорт settings_backup.json

Настройки импорта:
$bach settings import settings_backup.json

Список категорий:
Категории настроек $ bach

ФАЙЛЫ
-------
hub/settings.py Реализация обработчика (относительно Hub/settings.py)
Таблица базы данных bach.db (system_config) (путь: BACH_DB)

СВЯЗАННЫЕ КАТЕГОРИИ
--------------------
claude_permissions Профили разрешений для кода Claude (см. Permissions.txt)

СМ. ТАКЖЕ
----------
hub/base.py BaseHandler (относительно:hub/base.py)
Hub/bach_paths.py Константа BACH_DB (относительно Hub/bach_paths.py)
Hub/claude_permissions.py Обработчик разрешений (относительно Hub/claude_permissions.py)
docs/BACH-SCHEMA.md Схема базы данных (относительно: docs/BACH-SCHEMA.md)
Permissions.txt Профили разрешений кода Claude
