/db-list - Управление реестром баз данных

SkillDatabases & data

Manages the registry of 1C databases (.v8-project.). Use when the user talks about databases, the database list, 'add a database', 'which databases exist'.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the /db-list - Управление реестром баз данных skill

What this skill tells your AI

The instructions your AI receives, as published by desko77/cursor-1c-skills in skills/1c-db-list/SKILL.md and read by ahel’s review.

Управляет файлом .v8-project.json - реестром информационных баз проекта. Файл хранит параметры подключения, алиасы, привязку к веткам Git.

Usage

/db-list - показать список баз
/db-list add - добавить базу (интерактивно)
/db-list remove <id> - удалить базу из реестра
/db-list show <id|alias> - подробности по базе

Формат .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", "feature/*"],
 "configSrc": "C:\\WS\\myapp\\cfsrc"
 },
 {
 "id": "test",
 "name": "Тестовая",
 "type": "server",
 "server": "srv01",
 "ref": "MyApp_Test",
 "user": "Admin",
 "password": "123",
 "aliases": ["test", "тест"]
 }
 ],
 "default": "dev"
}

Поля корневого объекта

ПолеТипОписание
v8pathstringКаталог bin платформы 1С. Необязательный - если не задан, автоопределение
databasesarrayМассив баз данных
defaultstringid базы по умолчанию

Поля объекта базы данных

ПолеТипОбязательноеОписание
idstringдаУникальный идентификатор (латиница, без пробелов)
namestringдаЧеловекочитаемое имя
type"file" / "server"даТип подключения
pathstringдля fileПуть к каталогу файловой базы
serverstringдля serverАдрес сервера 1С
refstringдля serverИмя базы на сервере
userstringнетИмя пользователя 1С
passwordstringнетПароль
aliasesstring[]нетАльтернативные имена для быстрого доступа
branchesstring[]нетGit-ветки или glob-паттерны (release/*, feature/*), привязанные к этой базе
configSrcstringнетКаталог XML-выгрузки конфигурации

Алгоритм разрешения базы данных

Этот алгоритм используется ВСЕМИ навыками (db-*, epf-build, epf-dump, erf-build, erf-dump) для определения целевой базы.

  1. Если пользователь указал параметры подключения (путь, сервер) - используй напрямую
  2. Если пользователь указал базу по имени - ищи совпадение в таком порядке:
  3. По id (точное совпадение)
  4. По aliases (совпадение в массиве с учетом морфологии: "тестовую" = "тестовая" = "тестовой")
  5. По name (нечеткое совпадение с учетом морфологии и регистра)
  6. Если пользователь не указал базу - сопоставь текущую ветку Git с databases[].branches:
  • Точное совпадение: ветка dev"branches": ["dev"]
  • Glob-паттерн: ветка release/2.1"branches": ["release/*"]
  1. Если ветка не совпала - используй default
  2. Если не найдено или неоднозначно - спроси пользователя
  3. Если файл .v8-project.json не найден - спроси параметры подключения и предложи создать файл

После выполнения: если использованная база не зарегистрирована - предложи добавить через /db-list add.

Автоопределение платформы

Если v8path не задан в конфиге:

$v8 = Get-ChildItem "C:\Program Files\1cv8\*\bin\1cv8.exe" | Sort-Object -Descending | Select-Object -First 1

Операции

Показать список баз

Прочитай .v8-project.json, выведи таблицу:

ID Имя Тип Путь/Сервер По умолч.
dev Разработка file C:\Bases\MyApp_Dev ✓
test Тестовая server srv01/MyApp_Test

Добавить базу

Спроси у пользователя интерактивно:

  • id, name, type (file/server)
  • path (для file) или server + ref (для server)
  • user, password (необязательно)
  • aliases, branches (необязательно)

Добавь в массив databases. Если это первая база - установи как default.

Удалить базу

Удали из массива databases по id. Если удаляемая была default - спросить новый default.

Подробности по базе

Выведи все поля конкретной базы.

Формирование строки подключения

Для использования в шаблонах команд других навыков:

Файловая база:

/F "<path>"

Серверная база:

/S "<server>/<ref>"

Аутентификация (добавляется если user задан):

/N"<user>" /P"<password>"

Важно: между /N и именем пробела нет. Между /P и паролем пробела нет. Если пароль пустой - опусти /P целиком.

Signals

GitHub stars
57
Forks
13
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
x-1c-db-list-desko77
Source
github.com/desko77/cursor-1c-skills