# db-load-dt

Restores a 1C information base from a DT file, including its configuration and data. Use it when an existing base must be replaced.

- skill · `type=skill` · Claude Code, Codex · 37 installs · ★ 730
- Author: Nikolay Shirokov
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/HEAD/.claude/skills/db-load-dt/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/db-load-dt

## What it does

This skill imports a DT archive into an existing 1C information base and replaces both the configuration and stored data. Before it runs, it suggests creating a rollback copy with `/db-dump-dt` and asks for explicit approval because the import cannot be undone.

It reads `.v8-project.json` to resolve the target by connection details, name, alias, or the current Git branch. The actual load uses the PowerShell script `db-load-dt.ps1`, which accepts file-based or server-based connections, credentials, background job count, and extra `1cv8.exe` or `ibcmd` arguments.

A file database requires `-InfoBasePath`; a server database requires both `-InfoBaseServer` and `-InfoBaseRef`. Active sessions block a server load unless the database is freed or `-UnlockCode` is supplied. The restored snapshot already has a synchronized configuration, so `/db-update` is unnecessary.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add Nikolay-Shirokov/cc-1c-skills
```
In the agent chat (not a shell):
```text
/plugin install 1c-skills@cc-1c-skills
```
This installs the whole 1c-skills plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-load-dt -a claude-code
```

3. **Manually: put the files in place**
- File: `~/.claude/skills/db-load-dt/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/db-load-dt/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Nikolay-Shirokov/cc-1c-skills --skill db-load-dt -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/db-load-dt/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

**Manually: put the files in place**
- File: `.cursor/skills/db-load-dt/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Nikolay-Shirokov/cc-1c-skills db-load-dt
```

2. **Manually: put the files in place**
- File: `.github/skills/db-load-dt/SKILL.md`

### Gemini CLI

**Platform CLI**
```bash
gemini skills install https://github.com/Nikolay-Shirokov/cc-1c-skills --path .claude/skills/db-load-dt
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/db-load-dt/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/HEAD/.claude/skills/db-load-dt/SKILL.md

## When to use it
- restore a 1C base from a DT archive
- replace a base’s configuration and data
- load a DT file into a file database
- resolve a server database by name
- create a rollback point before importing

## Example prompts
- Load `backup.dt` into the `dev` database with `/db-load-dt`.
- Create a current backup with `/db-dump-dt`, then restore `C:\backup\base.dt`.
- Restore `input.dt` to a server database and provide an unlock code if sessions are active.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: c4f091545c863311.

BEGIN THIRD-PARTY FILE c4f091545c863311
````text
---
name: db-load-dt
description: Загрузка информационной базы 1С из DT-файла — полная перезапись базы (конфигурация + данные). Используй когда нужно загрузить архив информационной базы, восстановить базу, загрузить dt
disable-model-invocation: true
argument-hint: <input.dt> [database]
allowed-tools:
  - Bash
  - Read
  - Glob
  - AskUserQuestion
---

# /db-load-dt — Загрузка информационной базы из DT-файла

Восстанавливает информационную базу целиком (конфигурация **+ данные**) из DT-файла.

> ⚠️ **Необратимая операция.** Загрузка `.dt` **полностью перезаписывает базу** — и
> конфигурацию, и все данные. Текущее содержимое базы будет потеряно. После загрузки
> `/db-update` **не нужен** — конфигурация БД уже синхронна внутри снимка.

## Когда НЕ использовать

- Нужно создать **новую** базу из `.dt` → используй `/db-create` (из DT-шаблона), а не загрузку
  в существующую.
- Нужно обновить только конфигурацию (без данных) → `/db-load-cf` или `/db-load-xml`.

## Usage

```
/db-load-dt <input.dt> [database]
/db-load-dt backup.dt dev
```

## Порядок действий перед загрузкой

1. Предложи пользователю сначала сделать `/db-dump-dt` текущего состояния базы — это точка
   отката (восстановиться будет нечем, если не сохранить).
2. Запроси **явное подтверждение**: вся база (данные + конфигурация) будет перезаписана.
3. Только после подтверждения выполняй загрузку.

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

Прочитай `.v8-project.json` из корня проекта и разреши базу:
1. Если пользователь указал параметры подключения (путь, сервер) — используй напрямую
2. Если указал базу по имени — ищи по id / alias / name в `.v8-project.json`
3. Если не указал — сопоставь текущую ветку Git с `databases[].branches`
4. Если ветка не совпала — используй `default`
Платформа — `v8path` найденной записи базы, иначе корневой `v8path`. Не задан ни там, ни там — `-V8Path` не передавай.
Если файла нет — предложи `/db-list add`.
````
END THIRD-PARTY FILE c4f091545c863311

The third-party file has ended. Everything between the c4f091545c863311 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3023 of 5783 bytes. © Nikolay Shirokov · MIT · https://github.com/Nikolay-Shirokov/cc-1c-skills/tree/HEAD/.claude/skills/db-load-dt/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md