关于 db-dump-xml
用于将 1C 信息库配置导出为 XML 源文件的技能,面向配置开发和版本管理工作流。支持全量、增量、部分导出以及仅更新 ConfigDumpInfo。
主要功能
- 01全量和增量导出
- 02按指定对象部分导出
- 03更新 ConfigDumpInfo
- 04导出扩展配置
- 05支持分层或扁平格式
适用场景
- 01将完整配置导出为 XML
- 02仅导出选定的配置对象
- 03导出扩展或更新导出信息
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ nikolay-shirokov/ cc-1c-skills --skill db-dump-xml安装后在 Claude Code 中输入/db-dump-xml确认已加载。
附带文件scripts/db-dump-xml.ps1scripts/db-dump-xml.py
README 原文English
来自项目 READMEREADME 暂无中文译文,以下为英文原文;中文介绍见上方。
/db-dump-xml — Выгрузка конфигурации в XML
Выгружает конфигурацию информационной базы в XML-файлы (исходники). Поддерживает полную, инкрементальную, частичную выгрузку и обновление ConfigDumpInfo.
Usage
/db-dump-xml [database] [outputDir]
/db-dump-xml dev src/config
/db-dump-xml dev src/config -Mode Full
/db-dump-xml dev src/config -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
Параметры подключения
Прочитай .v8-project.json из корня проекта и разреши базу:
- Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
- Если указал базу по имени — ищи по id / alias / name в
.v8-project.json - Если не указал — сопоставь текущую ветку Git с
databases[].branches - Если ветка не совпала — используй
defaultПлатформа —v8pathнайденной записи базы, иначе корневойv8path. Не задан ни там, ни там —-V8Pathне передавай. Если файла нет — предложи/db-list add. Если использованная база не зарегистрирована — после выполнения предложи добавить через/db-list add. Если в записи базы указанconfigSrc— используй как каталог выгрузки по умолчанию. Для-Extensionкаталог берётся изextensions[].srcзаписи базы, если он там указан.
Команда
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" <параметры>
Параметры скрипта
| Параметр | Обязательный | Описание |
|---|---|---|
-V8Path <путь> | нет | Каталог bin платформы, или полный путь к 1cv8.exe / ibcmd.exe |
-InfoBasePath <путь> | * | Файловая база |
-InfoBaseServer <сервер> | * | Сервер 1С (для серверной базы) |
-InfoBaseRef <имя> | * | Имя базы на сервере |
-UserName <имя> | нет | Имя пользователя |
-Password <пароль> | нет | Пароль |
-ConfigDir <путь> | да | Каталог для выгрузки |
-Mode <режим> | нет | Full / Changes (по умолч.) / Partial / UpdateInfo |
-Objects <список> | для Partial | Имена объектов через запятую |
-Extension <имя> | нет | Выгрузить расширение |
-AllExtensions | нет | Выгрузить все расширения |
-Format <формат> | нет | Hierarchical (по умолч.) / Plain |
-AdditionalV8Arguments <список> | нет | Доп. аргументы запуска 1cv8.exe через запятую, напр. /UseHwLicenses+ |
-AdditionalIbcmdArguments <список> | нет | Доп. аргументы ibcmd через запятую, в форме --ключ=значение |
*— нужен либо-InfoBasePath, либо пара-InfoBaseServer+-InfoBaseRef
Режимы выгрузки
| Режим | Описание |
|---|---|
Full | Полная выгрузка — все объекты конфигурации. Пишет поверх каталога: файлы, которых нет в конфигурации, остаются |
Changes | Инкрементальная — только изменённые с последней выгрузки (по ConfigDumpInfo.xml). Если выгрузки в каталоге ещё нет (пусто или только .git, README), выгружает полностью |
Partial | Частичная — выбранные объекты из параметра -Objects |
UpdateInfo | Обновить только ConfigDumpInfo.xml без выгрузки файлов |
Если пользователь просит выгрузить конкретные объекты — используй
-Mode Partialс-Objects.
Changes отказывает, если в каталоге есть выгрузка без ConfigDumpInfo.xml или каталог выгружен
в другой версии формата (другой платформой). -Mode Full в таком случае перевыгрузит всё дерево,
и изменятся все файлы, поэтому решение о полной выгрузке оставь пользователю.
Примеры
# Полная выгрузка (файловая база)
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -V8Path "C:\Program Files\1cv8\8.3.25.1257\bin" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Full
# Инкрементальная выгрузка
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Changes
# Частичная выгрузка
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\cfsrc" -Mode Partial -Objects "Справочник.Номенклатура,Документ.Заказ"
# Серверная база
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBaseServer "srv01" -InfoBaseRef "MyApp_Dev" -UserName "Admin" -Password "secret" -ConfigDir "C:\WS\cfsrc" -Mode Full
# Выгрузка расширения
powershell.exe -NoProfile -File "${CLAUDE_SKILL_DIR}/scripts/db-dump-xml.ps1" -InfoBasePath "C:\Bases\MyDB" -UserName "Admin" -ConfigDir "C:\WS\ext_src" -Mode Full -Extension "МоёРасширение"