db-list

📁 arman-kudaibergenov/1c-ai-development-kit 📅 Today
4
总安装量
1
周安装量
#51119
全站排名
安装命令
npx skills add https://github.com/arman-kudaibergenov/1c-ai-development-kit --skill db-list

Agent 安装分布

kilo 1
amp 1
opencode 1
cursor 1
kimi-cli 1
codex 1

Skill 文档

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

Управляет файлом .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"
}

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

Поле Тип Описание
v8path string Каталог bin платформы 1С. Необязательный — если не задан, автоопределение
databases array Массив баз данных
default string id базы по умолчанию

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

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

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

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

  1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
  2. Если пользователь указал базу по имени — ищи совпадение в таком порядке:
    1. По id (точное совпадение)
    2. По aliases (совпадение в массиве с учётом морфологии: «тестовую» = «тестовая» = «тестовой»)
    3. По name (нечёткое совпадение с учётом морфологии и регистра)
  3. Если пользователь не указал базу — сопоставь текущую ветку Git с databases[].branches:
    • Точное совпадение: ветка dev → "branches": ["dev"]
    • Glob-паттерн: ветка release/2.1 → "branches": ["release/*"]
  4. Если ветка не совпала — используй default
  5. Если не найдено или неоднозначно — спроси пользователя
  6. Если файл .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

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

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

  • 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 целиком.