Подготовка данных

CodeMetadataSearchServer требует данные, выгруженные из Конфигуратора 1С.

Необходимые выгрузки

Выгрузка	Назначение	Как получить
Отчет из конфигурации	Метаданные объектов	Конфигурация → Отчет из конфигурации
Выгрузка в файлы	Код модулей	Конфигурация → Выгрузить в файлы

Шаг 1: Создание папок

New-Item -ItemType Directory -Force -Path @(
    "E:\1C_Export\Report",
    "E:\1C_Export\Files"
)

Шаг 2: Отчет из конфигурации

1. Откройте конфигурацию в Конфигураторе

2. Меню Конфигурация → Отчет из конфигурации

3. Настройте параметры:

   • Включите все разделы (справочники, документы, регистры и т.д.)

   • Формат: текстовый файл

4. Сохраните в папку E:\1C_Export\Report

Рекомендуемые настройки

• ✅ Справочники

• ✅ Документы

• ✅ Регистры сведений

• ✅ Регистры накопления

• ✅ Регистры бухгалтерии

• ✅ Обработки

• ✅ Отчёты

• ✅ Общие модули

• ✅ Перечисления

• ✅ Планы видов характеристик

Шаг 3: Выгрузка в файлы

1. Меню Конфигурация → Выгрузить конфигурацию в файлы

2. Укажите папку E:\1C_Export\Files

3. Дождитесь завершения выгрузки

Альтернатива: EDT

Если вы используете 1C:EDT, укажите путь к рабочей директории проекта вместо выгрузки.

Структура после выгрузки

E:\1C_Export\
├── Report\
│   └── Report.txt          # Отчет по метаданным
└── Files\
    ├── Catalogs\           # Справочники
    ├── Documents\          # Документы
    ├── CommonModules\      # Общие модули
    ├── DataProcessors\     # Обработки
    ├── Reports\            # Отчёты
    └── ...

Оптимизация: выборочная индексация

Не обязательно индексировать всё! Если вам не нужен поиск по определённым объектам конфигурации, просто удалите соответствующие папки из выгрузки перед запуском индексации.

Пример: индексация только общих модулей и обработок

# После выгрузки удалите ненужные папки
Remove-Item -Recurse -Force "E:\1C_Export\Files\Catalogs"
Remove-Item -Recurse -Force "E:\1C_Export\Files\Documents"
Remove-Item -Recurse -Force "E:\1C_Export\Files\InformationRegisters"
# ... оставьте только нужные папки

Преимущества выборочной индексации

• Ускорение индексации — меньше файлов = быстрее

• Экономия дискового пространства — меньший размер векторной БД

• Более точный поиск — меньше шума в результатах

Что обычно можно исключить

• ExternalDataSources — внешние источники данных

• WebServices — веб-сервисы (если не используете)

• HTTPServices — HTTP-сервисы (если не используете)

• Папки с формами, если вам нужен только поиск по коду

Проверка выгрузки

Проверка отчета

# Должен существовать текстовый файл
Get-ChildItem "E:\1C_Export\Report" -Filter "*.txt"

Проверка файлов

# Должны быть папки с модулями
Get-ChildItem "E:\1C_Export\Files" -Directory

Обновление данных

При изменении конфигурации:

1. Повторите выгрузку из Конфигуратора

2. Перезапустите контейнер с RESET_DATABASE=true

docker rm -f 1c_code_metadata_mcp

docker run -d -p 8000:8000 `
  --name 1c_code_metadata_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -e RESET_DATABASE=true `
  -e METADATA_PATH="/app/metadata" `
  -e CODE_PATH="/app/code" `
  -v "E:/1C_Export/Report:/app/metadata" `
  -v "E:/1C_Export/Files:/app/code" `
  -v "E:/bases/mcp_codemetadata:/app/chroma_db" `
  comol/1c_code_metadata_mcp:latest

Частые проблемы

Файлы в неправильной кодировке

Убедитесь, что выгрузка выполнена в UTF-8.

Пустой отчет

Проверьте настройки отчета — должны быть включены все разделы.

Ошибка "path not found"

Проверьте пути в команде Docker — используйте прямые слеши.