> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/pi-dsh-1c/dsh/ustanovka-i-zapusk.md).

# Установка и запуск

Здесь описан Windows x64. Для Linux (Web) и macOS — страница [Linux и macOS](https://docs.onerpa.ru/pi-dsh-1c/platformy.md). Какой архив скачать — [Получение и обновление](https://docs.onerpa.ru/pi-dsh-1c/poluchenie-i-obnovlenie.md).

1. Распакуйте весь ZIP в отдельную папку с правом записи. Не поверх другой версии и не запуская EXE из архива.
2. Запустите `DSH-Desktop-1C.exe`.
3. Выберите папку проекта 1С или передайте её аргументом.

```powershell
.\DSH-Desktop-1C.exe "D:\Projects\MyConfig"
.\DSH-Desktop-1C.exe --select
.\DSH-Desktop-1C.exe --doctor
.\DSH-Desktop-1C.exe --init
```

Node.js, Electron и права администратора не нужны. `install.ps1` только готовит профиль `desktop` и окно не открывает. Глобальная команда `dsh` и протокол `dsh://` не регистрируются.

Сообщение «Нет локального хоста dsh» значит, что ZIP распакован не целиком или повреждён. Распакуйте архив заново в новую папку. Второй экземпляр не открывается. Подробности ошибки — `DSH-Desktop-1C.exe --console`.

## Что лежит рядом с EXE

| Каталог           | Что в нём                                       |
| ----------------- | ----------------------------------------------- |
| `.dsh-1c/home`    | Профили, настройки, история и ключи этой сборки |
| `.desktop-local`  | Данные Electron, кэш и журналы                  |
| `dsh-1c-bundle`   | Программы и зависимости бандла                  |
| `runtime/desktop` | Electron и проверенный `app.asar`               |
| `runtime/node`    | Node для подготовки и консоли                   |

Автообновление оригинального Desktop выключено, чтобы не затереть сборку 1С. Проверка поставки 1С при запуске — не чаще раза в сутки и затем раз в сутки во время работы. Новая поставка скачивается сама, текущую работу это не останавливает. Меню **«Обновление бандла…»** открывает карточку с кнопками «Проверить обновление» и, когда архив уже проверен, «Обновить и перезапустить».

Перед перезапуском окно просит завершить DSH и открыть его снова. Сохраните правки: выполняемые задачи будут прерваны. Настройки, вход, история и проекты сохраняются. Пока идёт установка, не запускайте приложение вручную: оно откроется само. Если файл занят другой программой, окно «Обновление бандла 1С» показывает путь к нему, текущие файлы остаются, а скачанная поставка сохраняется. Закройте эту программу и повторите обновление. Если замена оборвалась, возвращаются прежние файлы. Отказ оставляет текущую работу. В архивах Linux и macOS от 21.11.2026 автоматический вопрос по тому же выпуску повторяется не чаще раза в сутки.

В архиве Windows от 22.11.2026 окно **«Обновление DSH Desktop 1С»** показывает дату установленной поставки и дату новой по московскому времени. Рядом с «Обновить и перезапустить» есть «Позже» и «Пропустить это обновление». «Позже» напомнит при следующем запуске. «Пропустить это обновление» эту поставку больше не предлагает и не скачивает; следующую предлагает, когда она выйдет. Пропущенную снова предлагает «Обновление бандла…». Карточка с теми же датами и кнопкой пропуска лежит в «Настройки → Общие → Обновление бандла».

Удаление: выйдите из трея и удалите папку поставки. Исходники проектов и их `.dev.env` лежат отдельно и не трогаются. Если нужны профили, сохраните `.dsh-1c/home` и `.desktop-local`.

## Консоль и запасные режимы

```powershell
.\dsh-1c.ps1 -Desktop -PrepareOnly
.\dsh-1c.ps1 -Doctor
.\dsh-1c.ps1 -Models
.\dsh-1c.ps1 -Acp
.\dsh-1c.ps1 "найди, где формируется счёт"
```

Одна задача из папки проекта печатает пять строк готовности: проект, `.dev.env`, модель, MCP, OpenSpec. Вывод появляется после завершения. Без выбранной модели задача до хоста дойдёт, ответа не будет: в консоли будет подсказка «Модель не выбрана».

`-Web` и `--safe` — дополнительный браузерный режим для диагностики, не отдельный продукт. `-Acp` поднимает stdio-сервер для внешнего клиента: независимые сессии, задания, подтверждения инструментов, отмена и продолжение.

## Консольный клиент

В архиве Windows от 22.11.2026 раздел **«Настройки → Консольный клиент»** прописывает команду `dsh1c`. Кнопка **«Прописать глобально»** после успеха пишет: «Готово. Откройте новое окно терминала и введите dsh1c в папке проекта.» Команда открывает терминальный клиент этой поставки: тот же бандл 1С, MCP, правила, навыки и инструменты. Провайдеры, модели и пресеты он берёт из настроек этого окна при каждом запуске. Интерфейс терминала на английском. Окна Desktop — настройки проекта, мастер, дерево метаданных, редактор — в терминале недоступны, их настройки терминал подхватывает. Команду `/update` в терминале не используйте: клиент обновляется вместе с DSH. Если команда уже указывает на эту поставку, кнопка называется **«Прописать заново»**. **«Убрать»** снимает `dsh1c`. **«Обновить статус»** перечитывает, прописана ли команда. В архивах Linux и macOS от 21.11.2026 этого раздела нет.

`--doctor` и `dsh-1c.ps1 -Doctor` при офлайн MCP заканчиваются предупреждением и кодом 0. Код 1 — поломка профиля поставки.

Вопрос «как подключить модель» или «где логи» можно задать агенту: на него отвечает навык `dsh-bundle-help`.
