$npx -y skills add Arman-Kudaibergenov/1c-ai-development-kit --skill db-updateЭтот скилл MUST быть вызван когда пользователь просит обновить БД, применить конфигурацию, выполнить UpdateDBCfg. SHOULD также вызывать после db-load-xml или db-load-cf для применения изменений к базе данных. Do NOT использовать для загрузки конфигурации — используй db-load-xml и
| 1 | # /db-update — Обновление конфигурации БД |
| 2 | |
| 3 | Применяет изменения основной конфигурации к конфигурации базы данных (`/UpdateDBCfg`). Обязательный шаг после `/db-load-cf`, `/db-load-xml`, `/db-load-git`. |
| 4 | |
| 5 | ## Usage |
| 6 | |
| 7 | ``` |
| 8 | /db-update [database] |
| 9 | /db-update dev |
| 10 | /db-update dev -Dynamic+ |
| 11 | ``` |
| 12 | |
| 13 | ## Параметры подключения |
| 14 | |
| 15 | Прочитай `.v8-project.json` из корня проекта. Возьми `v8path` (путь к платформе) и разреши базу: |
| 16 | 1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую |
| 17 | 2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json` |
| 18 | 3. Если не указал — сопоставь текущую ветку Git с `databases[].branches` |
| 19 | 4. Если ветка не совпала — используй `default` |
| 20 | Если `v8path` не задан — автоопределение: `Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort -Desc | Select -First 1` |
| 21 | Если файла нет — предложи `/db-list add`. |
| 22 | Если использованная база не зарегистрирована — после выполнения предложи добавить через `/db-list add`. |
| 23 | |
| 24 | ## Команда |
| 25 | |
| 26 | ```powershell |
| 27 | powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 <параметры> |
| 28 | ``` |
| 29 | |
| 30 | ### Параметры скрипта |
| 31 | |
| 32 | | Параметр | Обязательный | Описание | |
| 33 | |----------|:------------:|----------| |
| 34 | | `-V8Path <путь>` | нет | Каталог bin платформы (или полный путь к 1cv8.exe) | |
| 35 | | `-InfoBasePath <путь>` | * | Файловая база | |
| 36 | | `-InfoBaseServer <сервер>` | * | Сервер 1С (для серверной базы) | |
| 37 | | `-InfoBaseRef <имя>` | * | Имя базы на сервере | |
| 38 | | `-UserName <имя>` | нет | Имя пользователя | |
| 39 | | `-Password <пароль>` | нет | Пароль | |
| 40 | | `-Extension <имя>` | нет | Обновить расширение | |
| 41 | | `-AllExtensions` | нет | Обновить все расширения | |
| 42 | | `-Dynamic <+/->` | нет | `+` — динамическое обновление, `-` — отключить | |
| 43 | | `-Server` | нет | Обновление на стороне сервера | |
| 44 | | `-WarningsAsErrors` | нет | Предупреждения считать ошибками | |
| 45 | |
| 46 | > `*` — нужен либо `-InfoBasePath`, либо пара `-InfoBaseServer` + `-InfoBaseRef` |
| 47 | |
| 48 | ### Фоновое обновление (серверная база) |
| 49 | |
| 50 | | Параметр | Описание | |
| 51 | |----------|----------| |
| 52 | | `-BackgroundStart` | Начать фоновое обновление | |
| 53 | | `-BackgroundFinish` | Дождаться окончания | |
| 54 | | `-BackgroundCancel` | Отменить | |
| 55 | | `-BackgroundSuspend` | Приостановить | |
| 56 | | `-BackgroundResume` | Возобновить | |
| 57 | |
| 58 | ## Коды возврата |
| 59 | |
| 60 | | Код | Описание | |
| 61 | |-----|----------| |
| 62 | | 0 | Успешно | |
| 63 | | 1 | Ошибка (см. лог) | |
| 64 | |
| 65 | ## Предупреждения |
| 66 | |
| 67 | - Если обновление **не динамическое** — потребуется **монопольный доступ** к базе (все пользователи должны выйти) |
| 68 | - Для серверных баз рекомендуется `-Dynamic+` для обновления без остановки |
| 69 | - Если структура данных существенно изменилась (удаление реквизитов, изменение типов) — динамическое обновление может быть невозможно |
| 70 | |
| 71 | ## Примеры |
| 72 | |
| 73 | ```powershell |
| 74 | # Обычное обновление (файловая база) |
| 75 | powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" |
| 76 | |
| 77 | # Динамическое обновление (серверная база) |
| 78 | powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBaseServer "srv01" -InfoBaseRef "MyDB" -UserName "Admin" -Password "secret" -Dynamic "+" |
| 79 | |
| 80 | # Обновление расширения |
| 81 | powershell.exe -NoProfile -File .claude/skills/db-update/scripts/db-update.ps1 -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -Extension "МоёРасширение" |
| 82 | ``` |