Files
cc-1c-skills/docs/db-guide.md
T
Nick Shirokov 01315839fb docs: add .v8-project.json reference guide
Consolidate project config documentation into a single guide covering all
fields (v8path, databases, webPath, ffmpegPath, tts, webUrl), with "who fills"
column and resolution algorithm. Replace duplicated format sections in
db-guide.md and web-guide.md with links to the new guide.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-03 13:14:08 +03:00

5.1 KiB
Raw Blame History

Базы данных 1С

Навыки группы /db-* позволяют управлять информационными базами 1С из Claude Code: создавать базы, загружать и выгружать конфигурации, обновлять БД, запускать предприятие, загружать изменения из Git.

Навыки

Навык Скрипт Описание
/db-list Управление реестром баз (.v8-project.json)
/db-create Создание информационной базы
/db-dump-cf Выгрузка конфигурации в CF-файл
/db-load-cf Загрузка конфигурации из CF-файла
/db-dump-xml .ps1 Выгрузка конфигурации в XML-файлы (полная/инкрементальная/частичная)
/db-load-xml .ps1 Загрузка конфигурации из XML-файлов (полная/частичная)
/db-update Обновление конфигурации БД
/db-run Запуск 1С:Предприятие
/db-load-git .ps1 Загрузка изменений из Git в базу

Рабочий цикл

.v8-project.json → /db-create → /db-load-cf или /db-load-xml → /db-update → /db-run
                                                                    ↑
                                 /db-dump-xml ←→ правки в исходниках → /db-load-git → /db-update

Типичный цикл разработки

  1. Настройка/db-list add зарегистрировать базу в .v8-project.json
  2. Создание/db-create создать базу (если нет)
  3. Загрузка/db-load-xml или /db-load-cf загрузить конфигурацию
  4. Обновление/db-update применить к БД
  5. Работа — редактирование XML-исходников
  6. Синхронизация/db-load-git загрузить изменения из Git
  7. Обновление/db-update применить
  8. Запуск/db-run открыть предприятие

Формат .v8-project.json

Полное описание формата — в справочнике .v8-project.json.

Разрешение базы

Все навыки db-* (а также epf-build, epf-dump, erf-build, erf-dump) используют единый алгоритм:

  1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
  2. Если указал базу по имени — ищи: idaliases (с учётом морфологии) → name (нечёткое)
  3. Если не указал — сопоставь текущую ветку Git с branches (точно или по glob-паттерну)
  4. Fallback на default
  5. Если не найдено — спроси пользователя
  6. После выполнения: если использованная база не зарегистрирована — предложи добавить через /db-list add

Сценарии использования

Создать базу и загрузить конфигурацию

> Создай файловую базу C:\Bases\Test и загрузи в неё конфигурацию из C:\WS\cfsrc

Claude вызовет /db-create/db-load-xml -Mode Full → предложит /db-update.

Загрузить изменения из Git

> Загрузи мои последние правки в базу разработки

Claude вызовет /db-load-git dev -Source All → предложит /db-update.

Выгрузить конфигурацию

> Выгрузи конфигурацию из тестовой базы в C:\WS\cfsrc

Claude вызовет /db-dump-xml test C:\WS\cfsrc -Mode Full.

Работа с расширениями

> Выгрузи расширение МоёРасширение из базы dev в C:\WS\ext_src

Claude вызовет /db-dump-xml dev C:\WS\ext_src -Extension МоёРасширение.

> Загрузи расширение обратно в базу

Claude вызовет /db-load-xml C:\WS\ext_src dev -Extension МоёРасширение → предложит /db-update -Extension МоёРасширение.

Запустить предприятие

> Запусти базу разработки

Claude вызовет /db-run dev.

Спецификации

  • build-spec.md — пакетный режим конфигуратора 1С (CREATEINFOBASE, DESIGNER, ENTERPRISE, параметры, коды возврата)