Files
cc-1c-skills/docs/db-guide.md
T
Nick Shirokov d6ad1eacdb feat(db): add 9 database management skills
- db-list: manage .v8-project.json registry (CRUD, resolve by id/alias/branch)
- db-create: CREATEINFOBASE for file and server databases
- db-dump-cf / db-load-cf: dump/load configuration as CF binary
- db-dump-xml: dump configuration to XML (full/incremental/partial/updateInfo)
- db-load-xml: load configuration from XML (full/partial)
- db-update: UpdateDBCfg with dynamic/background options
- db-run: launch 1C:Enterprise in user mode
- db-load-git: detect Git changes and partial-load into database
- Add db-guide.md, update README.md and build-spec.md

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-15 19:55:56 +03:00

5.9 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

Файл размещается в корне проекта (рядом с .git/).

{
  "v8path": "C:\\Program Files\\1cv8\\8.3.25.1257\\bin",
  "databases": [
    {
      "id": "dev",
      "name": "Разработка",
      "type": "file",
      "path": "C:\\Bases\\MyApp_Dev",
      "user": "Admin",
      "password": "",
      "aliases": ["dev", "разработка"],
      "branches": ["dev", "develop"],
      "configSrc": "C:\\WS\\myapp\\cfsrc"
    },
    {
      "id": "test",
      "name": "Тестовая",
      "type": "server",
      "server": "srv01",
      "ref": "MyApp_Test",
      "user": "Admin",
      "password": "123",
      "aliases": ["test", "тест"]
    }
  ],
  "default": "dev"
}

Поля базы данных

Поле Тип Обязательное Описание
id string да Уникальный идентификатор
name string да Имя
type "file" / "server" да Тип подключения
path string для file Каталог файловой базы
server string для server Адрес сервера
ref string для server Имя базы на сервере
user string нет Пользователь 1С
password string нет Пароль
aliases string[] нет Альтернативные имена
branches string[] нет Git-ветки
configSrc string нет Каталог XML-выгрузки

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

Все навыки db-* используют единый алгоритм: id → alias → branch → name → default → спросить пользователя.

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

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

> Создай файловую базу 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, параметры, коды возврата)