Files
cc-1c-skills/.claude/skills/db-update/SKILL.md
T
Nick Shirokov 2a86df1c98 refactor(skills): унифицировать стиль триггеров в description
Заменено «пользователь просит» → «нужно» в 12 навыках для согласования
с доминирующим стилем репозитория (cf-*, cfe-*, form-*, skd-*, mxl-*,
role-*, interface-*, subsystem-edit/info/validate уже используют «нужно»).

Дополнительно у db-list переформулирован триггер: вместо «"добавь базу"»
(что коллидирует с db-create) — «зарегистрировать базу в реестре»,
точнее отражает суть скилла (управление .v8-project.json).

Затронуто: db-create, db-dump-cf, db-dump-xml, db-list, db-load-cf,
db-load-git, db-load-xml, db-run, db-update, meta-compile, meta-remove,
subsystem-compile.
2026-04-25 13:35:44 +03:00

4.9 KiB

name, description, argument-hint, allowed-tools
name description argument-hint allowed-tools
db-update Обновление конфигурации базы данных 1С. Используй когда нужно обновить БД, применить конфигурацию, UpdateDBCfg [database]
Bash
Read
Glob
AskUserQuestion

/db-update — Обновление конфигурации БД

Применяет изменения основной конфигурации к конфигурации базы данных (/UpdateDBCfg). Обязательный шаг после /db-load-cf, /db-load-xml, /db-load-git.

Usage

/db-update [database]
/db-update dev
/db-update dev -Dynamic+

Параметры подключения

Прочитай .v8-project.json из корня проекта. Возьми v8path (путь к платформе) и разреши базу:

  1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
  2. Если указал базу по имени — ищи по id / alias / name в .v8-project.json
  3. Если не указал — сопоставь текущую ветку Git с databases[].branches
  4. Если ветка не совпала — используй default Если v8path не задан — автоопределение: Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1 Если файла нет — предложи /db-list add. Если использованная база не зарегистрирована — после выполнения предложи добавить через /db-list add.

Команда

powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 <параметры>

Параметры скрипта

Параметр Обязательный Описание
-V8Path <путь> нет Каталог bin платформы (или полный путь к 1cv8.exe)
-InfoBasePath <путь> * Файловая база
-InfoBaseServer <сервер> * Сервер 1С (для серверной базы)
-InfoBaseRef <имя> * Имя базы на сервере
-UserName <имя> нет Имя пользователя
-Password <пароль> нет Пароль
-Extension <имя> нет Обновить расширение
-AllExtensions нет Обновить все расширения
-Dynamic <+/-> нет + — динамическое обновление, - — отключить
-Server нет Обновление на стороне сервера
-WarningsAsErrors нет Предупреждения считать ошибками

* — нужен либо -InfoBasePath, либо пара -InfoBaseServer + -InfoBaseRef

Фоновое обновление (серверная база)

Параметр Описание
-BackgroundStart Начать фоновое обновление
-BackgroundFinish Дождаться окончания
-BackgroundCancel Отменить
-BackgroundSuspend Приостановить
-BackgroundResume Возобновить

Коды возврата

Код Описание
0 Успешно
1 Ошибка (см. лог)

Предупреждения

  • Если обновление не динамическое — потребуется монопольный доступ к базе (все пользователи должны выйти)
  • Для серверных баз рекомендуется -Dynamic+ для обновления без остановки
  • Если структура данных существенно изменилась (удаление реквизитов, изменение типов) — динамическое обновление может быть невозможно

Примеры

# Обычное обновление (файловая база)
powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin"

# Динамическое обновление (серверная база)
powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic "+"

# Обновление расширения
powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение"