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

ИМЯ ОБРАБОТЧИКА
===

настройка


ОПИСАНИЕ
===

Полная настройка системы BACH: установка сервера MCP (npm), проверка
Зависимости, синхронизация секретов и профилей пользователей, а также выполнение предполетных проверок.
через. Часть версии PEANUT (B37) с дополнительным менеджером n8n MCP.


ОПЕРАЦИИ
===

mcp Устанавливает серверы MCP (codecommander, filecommander) глобально через npm.
                и обновленная конфигурация кода Claude (~/.claude.json).

n8n Устанавливает дополнительный пакет n8n-manager-mcp и регистрируется в
                Код Claude MCP-Config.

check Проверяет, все ли зависимости присутствуют и настроены:
                npm, пакеты MCP, файл секретов, bach.db, USER.md.

secrets Инициализирует или синхронизирует ~/.bach/bach_secrets.json с
                база данных секретов.

пользователь Управляет USER.md: персонализируется из БД, если все еще шаблон,
                или синхронизирует проанализированные данные обратно в БД.

preflight Выполняет предустановочные проверки: Python >= 3.10, доступен npm,
                данные/доступны для записи, > 100 МБ свободного места.

prosync Настраивает ProSync для использования в нескольких системах.
                --multi-system Включает синхронизацию БД (BACH на нескольких компьютерах)
                --single-system Отключить синхронизацию БД (только для этой системы)
                Без флага: отображает текущий статус. По умолчанию: одиночная система.

hooks Устанавливает перехватчики кода Claude (защита БД и т. д.) в
                Настройки кода Claude (~/.claude/settings.json).

hooks-remove Удаляет установленные BACH перехватчики кода Claude (обратимые).
                Удаляет только записи перехватчиков, зарегистрированные BACH.

lang <de|en> Промежуточные корневые документы (README, QUICKSTART и т. д.).
                Немецкий и английский.

полная установка Полная установка за один раз (предварительная проверка, просинхронизация,
                mcp, хуки, секреты, пользователи). Необязательно: --with-n8n или --config <json>.


ПРИМЕРЫ
===

bach setup mcp
  Установлены codecommander-mcp и filecommander-mcp, обновлен ~/.claude.json

bach setup check
  Проверяет все зависимости с выводом статуса

bach setup n8n
  Устанавливает n8n-manager-mcp (необязательно)

bach setup preflight
  Проверяет Python, npm, дисковое пространство перед установкой

bach setup prosync
  Показывает текущий статус ProSync (несколько или одна система)

bach setup prosync --multi-system
  Включает ProSync: локальную базу данных (~/.bach/bach.db) + OneDrive Transit Sync

bach setup prosync --single-system
  Отключает ProSync (по умолчанию для новых установок)

bach setup full-install --with-n8n
  Полная установка, включая менеджер n8n

bach setup user
  Персонализирует USER.md из БД или синхронизирует изменения USER.md с БД


FILES
===

hub/setup.py Этот обработчик
data/bach.db База данных BACH (assistant_user_profile, Секреты)
data/bach_secrets.json Хранилище секретов (~/.bach/bach_secrets.json)
../USER.md Профиль пользователя (шаблон или персонализированный)
~/.claude.json Конфигурация сервера Claude Code MCP


СМ. ТАКЖЕ
===

hub/base.py BaseHandler (суперкласс)
hub/secrets_handler.py SecretsHandler (управление секретами)
docs/help/check.txt Проверка после установки
docs/help/install.txt Первоначальная установка и сценарии
docs/help/db_sync.txt ProSync: синхронизация мультисистемной базы данных
