> 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/assistent.md).

# Ассистент DSH

Ассистент следит за чатами проектов, разбирает завершённые сессии, читает тикеты Jira и принимает голосовые поручения. Пока вы его не включите, он молчит. Модель вызывается, только когда есть что разобрать: новый тикет в автоматическом режиме моделью не читается, разбор сессии и голосовое поручение — один короткий вызов.

Настройки: **Настройки → Ассистент и доступ → Ассистент DSH**. Там же «Входящие»: предложения, журнал и счётчики вызовов за сутки. Главный переключатель — вверху страницы. Вместе с ассистентом включается персонаж.

## Персонаж

В разделе «Персонаж» есть переключатель «Показывать персонажа» и выбор модели: **Miara** (по умолчанию), **Hiyori**, **Вера**, **Агата**, **Мэйлин** и **Рокси**. Miara и Hiyori — официальные образцы Live2D, они входят в архив. **Капля** — простой кружок без Live2D: модель не загружается, поэтому вариант подходит для слабых машин. У персонажа есть имя по умолчанию, в поле «Имя» можно задать своё, оно сохраняется после перезапуска.

Вера, Агата, Мэйлин и Рокси — модели Moon Rabbit автора 月並 のこ. Автор не разрешает их перераздавать, поэтому в архив поставки они не входят и в списке помечены «Не загружена». Чтобы подключить:

1. Включите «Показывать персонажа».
2. По ссылке «Страница автора» скачайте бесплатный архив моделей.
3. Нажмите «Выбрать скачанный архив…» и укажите файл.

DSH сверяет размер и SHA-256 архива с известным, извлекает только нужные файлы в дом DSH и сразу выбирает модель. Другой архив отклоняется до распаковки. Загруженные модели сохраняются при обновлении бандла. Свои модели сюда не загружаются.

Тот же выбор есть в **Настройки → Персонаж Live2D**. На странице «Плагины» пакет может быть включён, а компонент персонажа — выключен: переключатель на странице ассистента включает именно компонент. Размер, положение, движения и голос озвучки — в меню персонажа.

Персонаж пишет в текущий чат. Фигурка не пропадает и не мерцает, когда фокус переходит в поле ввода чата.

### Капля поверх других окон

Переключатель «Капля поверх других окон» в разделе «Персонаж» показывает Каплю поверх других приложений. Она появляется, не забирая фокус у окна, в котором вы работаете. Щелчок по Капле открывает чат, где агент ждёт ответа. Есть в Desktop для Windows и macOS. В Linux Web переключателя нет: персонаж остаётся в окне браузера.

### Картинка в чат персонажа

В чате персонажа есть кнопки «Изображение» и «Снимок окна». Картинку можно также вставить из буфера (Ctrl+V) или перетащить файл на персонажа. Подходят PNG, JPEG, GIF и WebP. «Снимок окна» берёт один кадр выбранного окна. Если захват экрана недоступен, DSH предложит вставить снимок через Ctrl+V. Перед отправкой видны миниатюры, картинка уходит по кнопке «Отправить».

### Озвучка ответа

Кнопка «Озвучить ответ» читает выбранный ответ вслух по-русски, повторное нажатие — «Остановить озвучку». Ключ не нужен: по умолчанию работает локальный синтез. Если у браузерного движка нет русских голосов, используется системный: в Windows — встроенный голос Windows, в macOS — системный, в Linux — установленный espeak-ng или espeak. Онлайн-голос браузера, например голоса Edge, отправляет текст своему сервису; он используется, только если вы выбрали его явно.

### Уведомления

В разделе «Центр внимания» включаются «Уведомления ассистента», сообщение о вопросе агента и тихие часы. Уведомление о вопросе показывает сам вопрос и название чата. Если ответ модели упёрся в лимит токенов ответа, приходит уведомление «Ответ обрезан» с этой причиной. В Desktop это системные уведомления, в Linux Web — уведомления браузера.

## Диалог ассистента

«Открыть диалог ассистента» открывает один постоянный чат. В боковой панели он виден как рабочая область «Ассистент DSH» и в списки проектов 1С не попадает.

Пресет этого чата скрыт из выбора проектов. В нём есть просмотр устройства DSH и установка плагинов. Установка всегда спрашивает подтверждение. Перед поручением в чужой или новый чат DSH тоже спрашивает подтверждение. Идущий ход чужого чата не прерывается: поручение встаёт в очередь.

В диалоге ассистент отвечает по встроенной документации DSH, сеть для этого не нужна. Настройку из разрешённого списка он меняет только после вашего подтверждения, секреты ему недоступны.

Модель диалога — как в текущем чате. В настройках можно выбрать отдельную.

## Разбор сессий

Сессия разбирается, когда она простаивает заданное время, работала дольше порога и вызывала инструменты. Сама проверка порога модель не вызывает. Ассистент предлагает до трёх вещей:

* запомнить факт в навыке памяти проекта;
* создать новый навык в `.dsh/skills` проекта — уже существующий файл не перезаписывается;
* открыть идею плагина в Creator. Без вашего подтверждения плагин не устанавливается.

Режимы: «выключено», «предлагать» (карточка «Принять / Отклонить / Позже») и «автоматически». В автоматическом режиме память и навыки записываются сразу, с пометкой «добавлено ассистентом» и кнопкой «Отменить». Отмена не удаляет файл, который вы уже изменили.

Разбираются сессии, завершённые при работающем DSH. История до запуска не читается.

## Тикеты Jira

Источник один на все проекты. На странице ассистента задаётся JQL, например `project in (ZUP, BUH) AND statusCategory != Done`, или ссылка на фильтр Jira. Нужен подключённый Atlassian: **Настройки → Atlassian**.

Проект для тикета ассистент выбирает сам: по уже сохранённой связи OpenSpec, по ключу проекта в источнике тикетов, по названию папки в заголовке. Если признаков нет, он делает один короткий вызов модели. При неуверенном ответе тикет приходит во «Входящие», и проект выбираете вы.

Исполнитель — новый чат в выбранном проекте, с пресетом этого проекта. На странице задаётся, начинает ли он с плана OpenSpec или сразу с реализации. Статусы в Jira ассистент не меняет. Отдельный запуск команды агентов, Claude Code или Codex из тикета не делается.

Первый опрос только запоминает текущие тикеты, чтобы не разослать все открытые сразу. Новым считается тикет, созданный после этого опроса. После смены запроса запоминание начинается снова. За один проход приходит одно уведомление, подробности — во «Входящих». Ручная «Передать агенту» суточный лимит автопередач не расходует.

## Telegram

Переключатель «Сообщения из Telegram — ассистенту» связывает чат с ботом с постоянным диалогом. Поручение с телефона ассистент ставит в нужный проект и отвечает, куда оно попало. Если адресат неясен, он задаёт один вопрос. Бот настраивается в **Настройки → Telegram** и доступен в DSH Desktop для Windows. Выбор другого чата командой `/menu` отвязывает ассистента.

Ответ исполнителя в Telegram сам не пересылается: результат виден в чате проекта. С телефона тот же чат открывается через [доступ с телефона](https://docs.onerpa.ru/pages/ngmmddXs599PbBNgkPjw#%D0%B4%D0%BE%D1%81%D1%82%D1%83%D0%BF-%D1%81-%D1%82%D0%B5%D0%BB%D0%B5%D1%84%D0%BE%D0%BD%D0%B0).

## Голосовое поручение

1. Включите режим голоса и сохраните ключ OpenAI. Он используется только для распознавания речи. Звук уходит в OpenAI и оплачивается отдельно от подписки на чат.
2. Нажмите **Alt+Win** вместе и отпустите, скажите поручение и нажмите сочетание ещё раз. Esc отменяет запись. Длительность — до 2 минут.
3. Ассистент распознаёт речь и выбирает чат или проект. В режиме «предлагать адресата» можно поправить текст и адресат. В режиме «отправлять сразу» уверенный выбор уходит без вопроса, неуверенный всё равно показывается.

Модель распознавания по умолчанию — **gpt-transcribe**. На выбор также gpt-4o-transcribe, gpt-4o-mini-transcribe и whisper-1. Если аккаунт ещё не знает gpt-transcribe, запрос один раз повторяется на gpt-4o-transcribe.

Сочетание записывается кнопкой на странице: нажмите её и затем нужные клавиши. Подходят Ctrl, Alt или Win с буквой, цифрой, F1–F24 или Пробелом, а также два модификатора без обычной клавиши, например Alt+Win. Такое сочетание срабатывает при отпускании и не открывает меню «Пуск». Клавиша определяется по положению, раскладка не важна.

В Windows Desktop сочетание работает и когда окно DSH не активно: DSH выходит на передний план и включает запись. Если сочетание занято другой программой, оно действует только в активном окне DSH. Когда приложение закрыто в трей, запись не начинается: откройте DSH и повторите. В macOS и Linux Web сочетание работает в активном окне.

Ctrl+Пробел тоже можно назначить. Он занят автодополнением в Конфигураторе 1С, EDT и редакторах кода — страница об этом предупредит.

Для OpenAI-совместимого прокси задайте переменную окружения `ONEC_ASSISTANT_STT_BASE_URL`, например `https://proxy.example/v1`.
