Как читать это руководство
Руководство пользователя Nonead DSH Desktop
Это руководство для обычного пользователя. Оно не требует умения писать код и не предполагает, что у вас заранее установлены Node.js, pnpm или любые инструменты разработки: всё нужное уже есть в установщике — установили и работаете.
Оглавление
Тринадцать разделов выстроены в порядке «установить → начать пользоваться → решить проблему». Если нужно решить конкретную задачу, переходите сразу к разделу 12.
- 1 · Что это такое — три уровня структуры; в повседневной работе вы касаетесь только верхнего.
- 2 · Установка — какой пакет брать для каждой из трёх платформ и как установить.
- 3 · Первый запуск — мастер из семи шагов и «закрыть окно ≠ выйти».
- 4 · Обзор главного окна — за что отвечают четыре области.
- 5 · Первый диалог — как поставить задачу так, чтобы её поняли.
- 6 · Меню в трее — все системные точки входа.
- 7 · Страница настроек — что можно изменить в каждой секции.
- 8 · Профили — как переключать несколько конфигураций и как откатиться при сбое.
- 9 · Плагины — что входит в комплект, три способа установки, как удалить.
- 10 · Безопасный режим и режим восстановления — как спасти приложение, если после установки плагина оно не запускается.
- 11 · Обновления — пять этапов и четыре повторяемых действия.
- 12 · Если что-то не работает — таблица типовых симптомов и экспорт диагностики.
- 13 · Данные и помощь — где лежат файлы и где искать дополнительные документы.
1. Что это такое
Если в двух словах: агентные возможности DeepSeek Harness упакованы в настольное приложение — двойной клик по иконке, и можно вести диалог, поручить ему чтение и запись файлов, выполнение команд, вызов инструментов.
Продукт состоит из трёх уровней; вы работаете только с третьим, первые два работают в фоне автоматически.
2. Установка
Возьмите на странице загрузки пакет для своей платформы и запустите его. В установщик уже встроены Electron, Node.js, pnpm и фиксированная версия DSH runtime, доустанавливать окружение не нужно. В этой версии: Electron 44.0.0, Node.js 24.21.0, pnpm 11.8.0, Python 3.12.14 и DSH runtime 0.2.2-rc.1.
| Платформа | Что скачать | Как установить |
|---|---|---|
| Windows x64 | установщик .exe | запустить двойным кликом и пройти шаги мастера |
| macOS (Intel / Apple Silicon) | образ .dmg | открыть и перетащить иконку в «Программы» |
| Linux x64 | .AppImage | сначала chmod +x, затем двойной клик или запуск из командной строки |
При обновлении закрывать старую версию вручную не нужно. Установщик сам попросит работающий экземпляр завершиться, при необходимости завершит его принудительно и только затем перезапишет файлы; если закрыть не удалось, установка явно сообщит об ошибке и остановится, а не оставит нерабочую копию. Перед обновлением всё равно сохраните текущую работу.
Примечание: сборка для Windows ARM64 пока экспериментальная. Основная программа нативная для ARM64, но часть вложенных компонентов (встроенные среды Python / Node / Office, отдельные нативные модули) остаётся x64 и на ARM-устройствах полностью не проверена; обычным пользователям рекомендуется версия x64.
3. Первый запуск
При первом запуске автоматически готовится конфигурация по умолчанию (профиль с именем desktop) и поднимается локальный интерфейсный сервис. Сначала открывается мастер из семи шагов; в любой момент можно нажать «Пропустить настройку» и доделать всё на странице настроек.
| Шаг | О чём спрашивают | Совет |
|---|---|---|
| 1 Приветствие | что именно будет настроено | нажмите «Начать настройку» |
| 2 Режим окна | совместимость / расширенный / усиленный — определяет раскладку окна и способ работы с рабочим столом | если сомневаетесь, берите «совместимость»: она самая совместимая; расширенный и усиленный не поддерживаются в Linux |
| 3 Материал окна | сплошной фон или стекло | на старых видеокартах и в удалённом рабочем столе сплошной надёжнее |
| 4 Магазин плагинов | выключен / dsh-market / dsh-community-market; одновременно только один | можно выключить — приложение работает; включите, когда понадобится |
| 5 Подключение телефона | открывать ли этот компьютер с телефона или из браузера через Agents-Anywhere (Beta) | если не уверены — выключите; после включения сопряжение выполняется в боковой панели «Подключение телефона» |
| 6 Настольные уведомления | присылать ли системные уведомления о завершении и сбое текущей, фоновой и автоматической задачи | лучше включить все — длинные задачи не придётся караулить |
| 7 Доступ из браузера | разрешить открывать текущий профиль в браузере и только с этого компьютера или из всей локальной сети | для личного использования выбирайте «только этот компьютер»; для локальной сети нужен HTTPS-сертификат |
После мастера открывается главное окно. Закрыть окно — не значит выйти из приложения: по умолчанию окно лишь сворачивается в трей, фоновый сервис и запущенные задачи продолжают работать. Чтобы действительно выйти, используйте «Выйти» в меню трея.
4. Обзор главного окна
| Область | Где | За что отвечает |
|---|---|---|
| Боковая панель | слева | список сессий, новая сессия, входы в плагины и навыки, подключение телефона, настройки; сворачивается |
| Область диалога | в центре | переписка, ход вызова инструментов, изменения файлов и вывод команд |
| Поле ввода | внизу | ввод задачи; можно приложить файл, сменить модель, выбрать рабочий каталог; после отправки задачу можно прервать |
| Панель управления окном | сверху окна | от оболочки Desktop: назад/вперёд, обновление, управление окном; в разных режимах выглядит по-разному |
5. Первый диалог
- Создайте сессию и выберите рабочий каталог.
- Одной фразой опишите «что сделать + где + каким должен быть результат». Например: «Прочитай README в этом каталоге и собери в таблицу все устаревшие ссылки на скачивание».
- Когда работа началась, следите за вызовами инструментов и изменёнными файлами; если нужно сменить направление — прервите и скажите новое требование.
- Если результат не устраивает, скажите, что именно не так: агент исправит с учётом контекста, новую сессию открывать не нужно.
Три условия понятной задачи:
- Границы: какой каталог и какие файлы можно менять — не давайте свободы действий.
- Приёмка: что считается готовым результатом (запускается, тесты проходят, в таблице нет пустых значений).
- Ограничения: что трогать нельзя, какой формат сохранить, можно ли выходить в сеть.
6. Меню в трее
Когда окно закрыто, иконка в трее — главный вход в приложение. Правый клик по ней показывает:
| Пункт меню | Действие |
|---|---|
| Открыть DSH Desktop | снова показать окно |
| Новый профиль… | создать независимую конфигурацию |
| Профиль: <имя> | текущий профиль; здесь же можно переключиться |
| Режим: усиленный / совместимость / расширенный | быстро сменить режим окна (нужен перезапуск) |
| Проверить обновления… | вручную проверить наличие новой версии |
| Установить стабильную версию… | вернуться с тестового канала на стабильный |
| Войти в безопасный режим… | запуск во временной среде для поиска проблем с плагинами (см. раздел 10) |
| Выйти из безопасного режима и перезапустить… | только для безопасного режима: вернуться к обычному запуску |
| Открыть терминал DSH | встроенный терминал, где доступна команда dsh |
| Экспорт диагностической информации… | упаковать журналы и сведения о системе для отчёта о проблеме |
| Перезагрузить интерфейс | аналог обновления страницы, фоновый сервис не перезапускается |
| Перезапустить в режиме восстановления | сначала открыть Ассистент восстановления, не загружая текущий профиль и плагины |
| Выйти | действительно закрыть приложение вместе с фоновым сервисом |
7. Страница настроек
Вход в настройки — внизу боковой панели (Настройки → Настройки рабочего стола). Секции:
| Секция | Что можно изменить | Когда применяется |
|---|---|---|
| Профиль | выбор профиля для запуска, создание, удаление (удаляются и его конфигурация, и файлы плагинов) | после перезапуска |
| Режим окна | совместимость / расширенный / усиленный, а также материал окна (сплошной / стекло) | автоматический перезапуск после сохранения |
| Магазин плагинов | выключен / dsh-market / dsh-community-market; одновременно только один | перезапуск; после обновления с прежней версии выключен — нужно выбрать явно |
| Браузер и локальная сеть | разрешение открывать в браузере (только в режиме совместимости), только этот компьютер или локальная сеть, отпечаток и скачивание локального CA-сертификата | сразу или после перезапуска |
| Agents-Anywhere (Beta) | переключатель подключения телефона; после включения сопряжение в боковой панели «Подключение телефона» | сразу |
| Настольные уведомления | завершение и сбой текущей задачи, фоновых задач, автоматических задач | сразу |
| Журналы | журнал разработчика, уровень журналирования; журналы попадают в диагностический пакет | сразу |
| Версия и обновления | текущая версия, проверка обновлений, перезапуск, перезапуск в режиме восстановления | сразу |
| Для разработчиков | перезагрузка интерфейса, инструменты разработчика | сразу |
| Действия внизу | экспорт диагностики, открытие терминала DSH | — |
8. Профили: несколько конфигураций
Профиль — это независимый набор конфигурации: свои сессии, плагины и настройки, друг другу они не мешают. Типичный случай — отдельные профили «работа» и «личное» или «повседневный» и «пробую новые плагины».
Три практических правила:
- Если один профиль сломан, работайте в другом — сначала не нужно его спасать.
- Новый профиль пуст (только официальные базовые компоненты), плагины придётся ставить заново — именно поэтому он чистый.
- Удаление профиля удаляет и локальную конфигурацию, и файлы плагинов, отменить это нельзя.
9. Плагины: что поставляется и как установить
9.1 Что входит в комплект
Установщик не содержит сторонних плагинов. Профиль по умолчанию, создаваемый при первом запуске, загружает только два официальных базовых компонента:
@deepseek-ai/dsh-base— ядро Host: сессии, инструменты, доступ к файлам, подключение моделей.@deepseek-ai/dsh-web-app— веб-интерфейс, который вы видите.
То есть сразу после установки вы получаете чистое настольное приложение: диалог, чтение и запись файлов, выполнение команд. Магазин плагинов, экспертные команды, голосовой ввод, доска задач, граф кода и всё остальное нужно установить самому. Это сделано намеренно: состав определяете вы, а при проблеме легко найти «тот, что поставили последним».
9.2 Три способа установки
| Способ | Что удобно ставить | Как пользоваться |
|---|---|---|
| Страница плагинов | официальные и сторонние плагины | слева «Плагины» → «Добавить плагин» → «Установите сторонний плагин», укажите имя npm-пакета, адрес Git-репозитория или локальный каталог |
| Магазин плагинов | сторонние плагины сообщества | сначала в настройках → «Магазин плагинов» выберите магазин и перезапустите приложение, затем ищите и ставьте в магазине |
| Терминал DSH | сторонние плагины с известным именем пакета, пакетные операции | трей → «Открыть терминал DSH», выполните dsh plugin add <пакет> |
Страница плагинов (слева «Плагины», подзаголовок «Установите, включите и настройте плагины») решает две задачи:
- Установка: нажмите «Добавить плагин», выберите «Установите сторонний плагин» и укажите имя npm-пакета (например
dsh-xxxили@автор/плагин), адрес репозитория GitHub или локальный каталог. При установке выбирается источник: реестр по умолчанию, официальный реестр, зеркало материкового Китая или собственный внутренний npm-реестр. - Управление установленным: в «Установленные плагины» можно включать, отключать, удалять и обновлять плагины, видеть версию, источник и состояние каждого.
Часть плагинов поставляется вместе с DSH: для них показывается «Этот плагин поставляется с DSH. Включите его, не загружая другую копию.» — достаточно включить; если версия старше текущей версии DSH, появляется «Обновить». Сюда относятся экспертные команды, голосовой ввод, магазин плагинов, автоматическая проверка, терминал, поиск по сессиям, заголовки сессий, навыки-бейджи, Ralph, перевод цепочки рассуждений, Inspector, LiveShare, Forge, инструменты worktree, персональные рекомендации и другие. Тяжёлые по размеру или зависимостям и потому не устанавливаемые по умолчанию (подагенты Claude Code, подагенты Codex, управление рабочим столом Computer Use) также включаются на странице плагинов по мере необходимости.
Встроенные базовые компоненты (dsh-base, dsh-web-app и подобные) в управляемом списке страницы плагинов не появляются; их состояние видно в разделе «Настройки» → «Встроенные плагины».
Магазин плагинов сейчас предлагает два варианта: dsh-community-market (встроенный открытый магазин с поддержкой собственных источников данных) и dsh-market (популярный магазин сообщества на данных awesome-dsh-plugin). Одновременно можно включить только один.
Три команды в терминале (без --profile действуют на активный профиль):
| Команда | Действие |
|---|---|
dsh plugin add <пакет> | установка |
dsh plugin remove <пакет> | удаление |
dsh plugin update | обновление установленных плагинов |
9.3 После установки нужен перезапуск и проверка
Плагин загружается только после перезапуска приложения — по завершении установки интерфейс пишет «Установлен; перезапустите DSH, чтобы загрузить его.». Как убедиться, что всё встало:
- Откройте страницу плагинов и проверьте, есть ли он в «Установленные плагины» и включён ли.
- Посмотрите, появился ли его пункт в боковой панели (магазин, доска, экспертные команды и т. п.).
- Если сомневаетесь, откройте «Настройки → Журналы», поднимите уровень журналирования и перезапустите приложение: ошибка загрузки обычно видна явно.
9.4 Отключение и удаление
- Сначала отключить, потом удалить: отключение лишь запрещает загрузку при следующем запуске, файлы и настройки остаются, включить обратно можно в любой момент; удаление вызывает
dsh plugin removeи стирает пакет, интерфейс спрашивает: «То, что он предоставляет, исчезает после его удаления.». В Ассистенте восстановления та же операция называется иначе — суть одна. - Компоненты, нужные самому менеджеру плагинов (Host, веб-сервис, доступ к файлам и т. п.), помечены «Управление плагинами нуждается в этом; его нельзя отключить или удалить.» — чтобы приложение нельзя было разобрать до нерабочего состояния. Встроенные базовые компоненты вроде
dsh-baseиdsh-web-appв управляемый список не входят вовсе, их состояние смотрите в «Настройки → Встроенные плагины». - В профилях, обновлённых с прежней версии, магазин плагинов остаётся выключенным, пока вы явно не выберете его в настройках. Это не сбой.
9.5 Если плагин сломал приложение
Переустанавливать систему и удалять каталог данных не нужно. Идите в Ассистент восстановления из раздела 10: сначала отключите в «Управлении плагинами» тот, что поставили последним, и запустите приложение; если не помогает — используйте «Откат» к предыдущей точке, с которой приложение запускалось.
10. Безопасный режим и режим восстановления
Обе функции решают одну задачу: после чего-то установленного приложение перестало запускаться. Разница в том, что безопасный режим — это «зайти в чистом виде и работать», а режим восстановления — «остановиться у входа и починить».
10.1 Безопасный режим
Безопасный режим запускается с отдельным временным каталогом данных: он не читает прежние плагины, настройки, сессии и записи воркспейсов и потому не может быть ими сломан. Исходные данные не меняются ни на байт.
Как войти: трей → «Войти в безопасный режим…»; либо на главной странице Ассистента восстановления нажмите «Безопасный режим».
Что можно делать в безопасном режиме:
- Проверить, «в плагинах ли дело»: если здесь всё работает, причина почти наверняка в плагине или конфигурации.
- Работать через веб-интерфейс — вести диалог, читать и записывать файлы, чтобы успеть сделать срочное.
- Смотреть журналы и экспортировать диагностику (пакет экспортируется и из Ассистента восстановления).
Ограничения (так задумано):
- Страница настольных настроек доступна только для чтения.
- Доступ из браузера, доступ по локальной сети, Agents-Anywhere, настольные уведомления и другие пункты, зависящие от постоянной конфигурации, недоступны.
- Сверху постоянно висит полоса «Безопасный режим», напоминающая, что вы работаете во временной среде.
Выход: трей → «Выйти из безопасного режима и перезапустить…». После выхода временная среда удаляется при следующем обычном запуске и не занимает место на диске.
10.2 Ассистент восстановления (режим восстановления)
Как сюда попадают:
- Вы сами выбрали в трее «Перезапустить в режиме восстановления» или в настройках → «Версия и обновления» → «Перезапустить в режиме восстановления».
- Запуск несколько раз подряд закончился неудачей, и приложение само перешло в Ассистент восстановления.
- Если интерфейс вообще не поднимается, отдельно открывается диалог «Восстановить DSH Desktop» — можно повторить восстановление без перезапуска фонового сервиса.
Ассистент восстановления сообщает три вещи: почему вы здесь (при ручном входе пишется «Вы вошли в режим восстановления вручную»), какой профиль и какой каталог используются и на каком шаге остановился запуск (инициализация Electron → подготовка окружения Shell → подготовка настольного runtime → выбор профиля → сборка конфигурации плагинов → запуск сервисов плагинов → запуск настольного интерфейса → подтверждение результата). Шаг, на котором всё встало, и очерчивает круг проблемы.
| Вкладка | Назначение | Когда нужна |
|---|---|---|
| Быстрое восстановление | общая точка входа: безопасный режим, управление плагинами, контрольные точки, смена профиля, управление данными, диагностика | не знаете, что нажать, — начинайте отсюда |
| Управление плагинами | список напрямую установленных плагинов: «Отключить» (остаётся установленным, не загружается) или «Удалить»; встроенные и защищённые — только чтение | подозреваете недавно установленный плагин |
| Откат | возврат к контрольной точке запуска: восстанавливает профиль, общий settings.yaml и патчи каталога данных (включая состояние плагинов) | помните, что «вчера всё работало» |
| Смена профиля | список доступных профилей: переключить или создать; текущий сохраняется | один профиль сломан — работайте в другом |
| Сброс и данные | просмотр и смена каталога данных, возврат к каталогу по умолчанию, сброс к заводским настройкам | когда спасти уже не получается |
| Диагностика | просмотр и правка settings.yaml, патчей профиля, списка плагинов; открыть каталог профиля, экспортировать диагностический пакет | нужно найти причину или отправить отчёт |
Как работает откат: после каждого успешного запуска приложение сохраняет «контрольную точку» — конфигурацию, которая на тот момент работала. Откат возвращает профиль, settings.yaml и состояние включённости плагинов к этому моменту. Точка показывает одно из трёх состояний: «восстановима / не читается / точки ещё нет»; «не читается» означает, что сама точка повреждена — берите более раннюю.
Сброс к заводским настройкам: текущий каталог данных целиком перемещается в корзину, после перезапуска создаётся новый профиль по умолчанию. Файлы проектов вне каталога данных не удаляются — очищаются только собственные настройки и сессии. Перед выполнением убедитесь, что старые сессии вам действительно больше не нужны.
10.3 Выход
После починки ничего не нужно чистить вручную: выйдите из Ассистента восстановления и запустите приложение обычным образом. Если нажать «Перезапустить» из режима восстановления, приложение заново пройдёт обычный запуск; при повторной неудаче снова вернётся в Ассистент восстановления — бесконечного цикла не будет.
11. Обновления
Пять этапов: проверка → загрузка → установка → перезапуск → подтверждение версии. Четыре повторяемых действия:
- Ручная проверка: трей → «Проверить обновления…» либо настройки → «Версия и обновления» → «Проверить обновления».
- Перезапуск: настройки → «Версия и обновления» → «Перезапустить»; можно нажать и на уведомление в заголовке окна.
- Очистка остатков установки: обновление обычно срывается из-за файлов, занятых старым экземпляром. Выйдите через трей и запустите установщик снова — удалять каталоги вручную не нужно.
- Возврат версии: с тестового канала на стабильный — трей → «Установить стабильную версию…»; чтобы вернуть только предыдущее рабочее состояние, используйте «Откат» в Ассистенте восстановления.
12. Если что-то не работает
| Симптом | Что сделать сначала | Если не помогло |
|---|---|---|
| Двойной клик по иконке ничего не даёт / белый экран | выйдите через трей и откройте заново; проверьте, не запущен ли уже экземпляр | перезапустите в режиме восстановления и посмотрите, на каком шаге встал запуск |
| Запуск зависает или приложение перезапускается по кругу | Ассистент восстановления → «Смена профиля»: перейдите на рабочий | Ассистент восстановления → «Управление плагинами» → отключите последний установленный |
| После установки плагина интерфейс ругается, панели отдают 4xx | отключите этот плагин на странице плагинов и перезапустите | удалите его и подберите замену |
| Плагин установлен, но ни на что не влияет | на странице плагинов убедитесь, что он включён, затем полностью выйдите и откройте приложение | посмотрите ошибку загрузки в «Настройки → Журналы» |
| Окно закрыто, приложение не найти | посмотрите в трее: по умолчанию приложение не завершается | трей → «Открыть DSH Desktop» |
| Задача выполняется и замирает на середине | проверьте, не остановлена ли она и не ждёт ли подтверждения; проверьте уровень журналирования | экспортируйте диагностику и укажите время |
| Браузер не открывается | убедитесь, что режим окна — «совместимость» | заново включите в настройках «Разрешить открытие в браузере» |
| Устройства в локальной сети не подключаются | проверьте, что доступ по локальной сети включён и сертификат доверен устройству | проверьте межсетевой экран и не изменился ли IP |
| Обновление не ставится | выйдите через трей и запустите установщик снова | экспортируйте диагностику со скриншотом ошибки установщика |
| Страница настроек серая, ничего не изменить | скорее всего, вы в безопасном режиме — посмотрите полосу сверху | выйдите из безопасного режима и перезапустите |
Экспорт диагностической информации
Трей → «Экспорт диагностической информации…» или тот же пункт внизу страницы настроек. В пакет попадают локальные пути, журналы, сведения о системе и фрагменты памяти при сбое. Перед публикацией просмотрите его сами: пути и фрагменты сессий могут содержать приватные данные.
13. Данные и помощь
| Что | Где |
|---|---|
| Данные приложения (профили, настройки, сессии, плагины) | Windows: %APPDATA%\Nonead DSH Desktop; macOS: ~/Library/Application Support/Nonead DSH Desktop; Linux: ~/.config/Nonead DSH Desktop |
| Сама программа | в Windows по умолчанию D:\Software\Nonead DSH Desktop (каталог можно изменить при установке); в macOS — «Программы»; в Linux — место, где лежит AppImage |
| Настольные журналы | включаются в настройках → «Журналы»; попадают в диагностический пакет |
| Файлы сессий | хранилище сессий в каталоге данных; в «Диагностике» Ассистента восстановления можно открыть каталог профиля |
| Файлы ваших проектов | рабочий каталог, выбранный для каждой сессии; он не входит в данные приложения и не удаляется при деинсталляции |
Дополнительные документы
README.md/README.zh.md: установка, сборка, среда разработки.docs/: описание архитектуры, процесс выпуска, руководство по разработке плагинов.- В том же каталоге
Nonead-DSH-Desktop-User-Manual.en.mdи HTML-версии на восьми языках: содержание совпадает, удобно сверять.
Благодарности
Продукт построен на upstream DeepSeek Harness и открытом сообществе: Electron, Node.js, pnpm, Python, а также система плагинов Cordis и экосистема официальных bundle. Спасибо сопровождающим upstream и всем контрибьюторам.
Сведения об авторах сторонних плагинов поставляются вместе с самими плагинами и доступны на странице плагинов или в карточке магазина; руководство больше не перечисляет версии и авторов поимённо, потому что это ваш выбор при установке, а не комплектация продукта.
Руководство обновляется вместе с версиями. Если нашли расхождение с текущей версией, создайте issue в GitHub / GitCode.