Оглавление

Тринадцать разделов выстроены в порядке «установить → начать пользоваться → решить проблему». Если нужно решить конкретную задачу, переходите сразу к разделу 12.

• 1 · Что это такое — три уровня структуры; в повседневной работе вы касаетесь только верхнего.
• 2 · Установка — какой пакет брать для каждой из трёх платформ и как установить.
• 3 · Первый запуск — мастер из шести шагов и «закрыть окно ≠ выйти».
• 4 · Обзор главного окна — за что отвечают четыре области.
• 5 · Первый диалог — как поставить задачу так, чтобы её поняли.
• 6 · Меню в трее — все системные точки входа.
• 7 · Страница настроек — что можно изменить в каждой секции.
• 8 · Профили — как переключать несколько конфигураций и как откатиться при сбое.
• 9 · Предустановленные плагины — 35 плагинов семи категорий по отдельности, а также как ими управлять и как поставить заново.
• 10 · Безопасный режим и режим восстановления — как спасти приложение, если после установки плагина оно не запускается.
• 11 · Обновления — пять этапов и четыре повторяемых действия.
• 12 · Если что-то не работает — таблица типовых симптомов и экспорт диагностики.
• 13 · Данные и помощь — где лежат файлы и где искать дополнительные документы.

1. Что это такое

Если в двух словах: агентные возможности DeepSeek Harness упакованы в настольное приложение — двойной клик по иконке, и можно вести диалог, поручить ему чтение и запись файлов, выполнение команд, вызов инструментов.

Продукт состоит из трёх уровней; вы работаете только с третьим, первые два работают в фоне автоматически.

У версии Essentials есть ещё одно отличие от универсальной версии из репозитория: это не пустое приложение «с оболочкой, в которое вы сами ставите плагины», — в установщик уже включены 35 отобранных и совместимых друг с другом плагинов. После установки при первом открытии эти возможности уже ждут на странице плагинов, и искать каждую в npm не нужно.

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, универсальный пакет macOS и Linux x64. Сборка Linux arm64 готовится в тестовом канале и пока не попала в стабильные ссылки; если на ARM-устройстве возникли проблемы с нативными модулями, используйте версию x64 для своей платформы или сборку из тестового канала.

3. Первый запуск

При первом запуске автоматически готовится конфигурация по умолчанию (профиль с именем desktop) и поднимается локальный интерфейсный сервис. Сначала открывается мастер из шести шагов; в любой момент можно нажать «Пропустить настройку» и доделать всё на странице настроек:

На последней странице сначала показывается обзор по крупным категориям: память и контекст, интерфейс и рабочее пространство, агенты и навыки, документы и медиа, код и инженерия, роботы и симуляция, подключения и автоматизация — для каждой указано, «чем эта категория может помочь», и число плагинов. Только после нажатия «Готово и начать» мастер начинает устанавливать плагины по одному и при каждом показывает его название, версию, категорию, полное описание и фразу «Спасибо такому-то за этот плагин». Во время установки ничего делать не нужно — просто дождитесь завершения: 35 пакетов ставятся по одному, поэтому первый запуск займёт немного больше времени, чем обычно.

После мастера открывается главное окно. Закрыть окно — не значит выйти из приложения: по умолчанию окно лишь сворачивается в трей, фоновый сервис и запущенные задачи продолжают работать. Чтобы действительно выйти, используйте «Выйти» в меню трея.

4. Обзор главного окна

После установки предустановленных плагинов в боковой панели и у поля ввода появятся дополнительные входы: центр навыков, доска задач, панель расходов, история ввода, экспертные команды и другие. Всё это предоставляют плагины из раздела 9 — отключите соответствующий плагин, и вход исчезнет.

5. Первый диалог

1. Создайте сессию и выберите рабочий каталог.
2. Одной фразой опишите «что сделать + где + каким должен быть результат». Например: «Прочитай README в этом каталоге и собери в таблицу все устаревшие ссылки на скачивание».
3. Когда работа началась, следите за вызовами инструментов и изменёнными файлами; если нужно сменить направление — прервите и скажите новое требование.
4. Если результат не устраивает, скажите, что именно не так: агент исправит с учётом контекста, новую сессию открывать не нужно.

Три условия понятной задачи:

• Границы: какой каталог и какие файлы можно менять — не давайте свободы действий.
• Приёмка: что считается готовым результатом (запускается, тесты проходят, в таблице нет пустых значений).
• Ограничения: что трогать нельзя, какой формат сохранить, можно ли выходить в сеть.

6. Меню в трее

Когда окно закрыто, иконка в трее — главный вход в приложение. Правый клик по ней показывает:

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

7. Страница настроек

Вход в настройки — внизу боковой панели (Настройки → Настройки рабочего стола). Секции:

В безопасном режиме эта страница доступна только для чтения, а доступ из браузера, локальная сеть, удалённое управление и уведомления отключены — так задумано, это не поломка.

8. Профили: несколько конфигураций

Профиль — это независимый набор конфигурации: свои сессии, плагины и настройки, друг другу они не мешают. Типичный случай — отдельные профили «работа» и «личное» или «повседневный» и «пробую новые плагины».

Три практических правила:

• Если один профиль сломан, переключитесь на другой и продолжайте работать — спасать его не обязательно.
• В новом профиле есть только официальные базовые компоненты, 35 предустановленных плагинов ставятся только в тот профиль, где был завершён мастер. Если вы сменили профиль и хотите ими пользоваться, проверьте фактический список на странице плагинов и доустановите недостающие.
• Удаление профиля перемещает его в каталог резервных копий восстановления (а не стирает сразу); общие сессии и настройки сохраняются. Но для этого профиля он уже недоступен — проверьте перед действием.

9. Предустановленные плагины

Этот раздел — главный в руководстве. Установщик 2.2.9 содержит 35 плагинов, распределённых по семи крупным категориям; при завершении первого мастера они автоматически устанавливаются в текущий профиль. Сначала разберём, «что именно установлено и как это происходит», затем опишем каждый плагин по категориям, а в конце — как ими управлять и как ставить заново.

9.1 Что входит в комплект

Установщик распространяет архивы 35 плагинов вместе с приложением (каталог plugins/), и по завершении первого мастера они по одному устанавливаются в профиль. Это не «необязательная загрузка» — они уже стоят после установки: откройте страницу плагинов, и в «Установленные плагины» будут все 35, по умолчанию включённые.

9.2 Как происходит предустановка

Несколько деталей, которые стоит знать:

• Установка идёт по одному: при каждом плагине мастер показывает его название, версию, категорию, описание и автора. Не закрывайте окно, пока всё не установится.
• Критерий успеха — появление имени пакета в зависимостях package.json профиля, а не отсутствие ошибки в команде; после установки имя также добавляется в profile.bundles, иначе получится «установлен, но не включён».
• Сбой одного плагина не блокирует запуск: если после установки что-то не встало, появится сводное окно с перечнем названий и причин, а в настольный журнал запишется (bundled plugin not installed: <имя>: <причина>); мастер при этом завершится как обычно. Позже на странице плагинов можно проверить, что действительно попало в список.
• Ставится только в тот профиль, где мастер был завершён. Созданные позже профили чистые: при необходимости пройдите мастер заново или доустановите со страницы плагинов.

9.3 Подробный список по категориям

Ниже перечислены все 35 плагинов по семи крупным категориям. v после названия — версия из комплекта; строка «Подходит для» — рекомендация по выбору, а не ограничение возможностей.

9.4 Отключение, удаление и повторная установка

• Сначала отключить, потом удалить: отключение лишь запрещает загрузку при следующем запуске, файлы и настройки остаются, включить обратно можно в любой момент; удаление вызывает dsh plugin remove и стирает пакет, интерфейс спрашивает: «После удаления предоставляемые им возможности исчезнут».
• Удаление предустановленного плагина освобождает немного места: исходные .tgz из установщика остаются в каталоге программы в plugins/, удаляется только установленная копия в профиле. Чтобы действительно уменьшить размер, нужен установщик без этих пакетов, а не поштучное удаление.
• Поставить обратно: «Настройки» → «Инструменты рабочего стола» → «Мастер настройки» — пройдите до страницы 6 и нажмите «Готово и начать»: недостающие в профиле пакеты доустановятся. Можно и поставить вручную способами из 9.5.
• Защищённые компоненты трогать нельзя: компоненты, нужные самому менеджеру плагинов (Host, веб-сервис, доступ к файлам и т. п.), помечены «Нужно для управления плагинами, нельзя отключить или удалить»; встроенные базовые компоненты вроде dsh-base и dsh-web-app вообще не попадают в управляемый список, их состояние видно только в «Настройки → Встроенные плагины».

9.5 Поставить плагины самому: три способа

Страница плагинов (слева «Плагины», подзаголовок «Установка, включение и настройка плагинов») решает две задачи:

• Установка нового плагина: нажмите «Добавить плагин», выберите «Установить сторонний плагин» и укажите имя npm-пакета (например, dsh-xxx или @автор/плагин), адрес репозитория GitHub или локальный каталог. При установке можно выбрать источник: реестр по умолчанию, официальный реестр, зеркало материкового Китая или собственный внутренний npm-реестр.
• Управление установленным: в «Установленные плагины» можно включать, отключать, удалять и проверять обновления, а также видеть версию, источник и состояние каждого плагина.

Магазин плагинов — на выбор два: dsh-community-market (встроенный открытый магазин с поддержкой собственных источников данных, Beta) и dsh-market (популярный магазин сообщества на данных awesome-dsh-plugin, имя пакета в комплекте — dshmarket). Одновременно можно включить только один; магазин сам является плагином, поэтому включается и выключается прямо на странице плагинов.

Три команды в терминале (без --profile действуют на активный профиль):

9.6 После установки — перезапуск и проверка

Плагин загружается только после перезапуска приложения — по завершении установки интерфейс пишет «Установлен; перезапустите DSH, чтобы загрузить его». Как убедиться, что всё встало:

1. Откройте страницу плагинов и проверьте, есть ли он в «Установленные плагины» и включён ли.
2. Посмотрите, появился ли его пункт в боковой панели (магазин, доска, экспертные команды, расходы и т. п.).
3. Если сомневаетесь, откройте «Настройки → Журналы», поднимите уровень журналирования и перезапустите приложение: ошибка загрузки обычно видна явно.

9.7 Что делать, если плагин сломал приложение

Переустанавливать систему и удалять каталог данных не нужно. Идите в Ассистент восстановления из раздела 10: сначала отключите в «Управлении плагинами» тот, что поставили последним, и запустите приложение; если не помогает — используйте «Откат» к предыдущей контрольной точке, с которой приложение запускалось. Предустановленные плагины ведут себя точно так же — они ничем не отличаются от поставленных позже.

10. Безопасный режим и режим восстановления

Обе функции решают одну задачу: после чего-то установленного приложение перестало запускаться. Разница в том, что безопасный режим — это «зайти в чистом виде и работать», а режим восстановления — «остановиться у входа и починить».

10.1 Безопасный режим

Безопасный режим запускается с отдельным временным каталогом данных: он не читает прежние плагины, настройки, сессии и записи воркспейсов и потому не может быть ими сломан. Исходные данные не меняются ни на байт.

Как войти: трей → «Войти в безопасный режим…»; либо на главной странице Ассистента восстановления нажмите «Безопасный режим».

Что можно делать в безопасном режиме:

• Проверить, «в плагинах ли дело»: если здесь всё работает, причина почти наверняка в плагине или конфигурации.
• Работать через веб-интерфейс — вести диалог, читать и записывать файлы, чтобы успеть сделать срочное.
• Смотреть журналы и экспортировать диагностику (пакет экспортируется и из Ассистента восстановления).

Ограничения (так задумано):

• Страница настольных настроек доступна только для чтения, изменить ничего нельзя.
• Доступ из браузера, доступ по локальной сети, удалённое управление, настольные уведомления и другие пункты, зависящие от постоянной конфигурации, недоступны.
• Сверху постоянно висит полоса «Безопасный режим», напоминающая, что вы работаете во временной среде.

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

10.2 Ассистент восстановления (режим восстановления)

Как сюда попадают:

• Вы сами выбрали в трее «Ассистент восстановления…».
• Запуск несколько раз подряд закончился неудачей, и приложение само перешло в Ассистент восстановления.
• Если интерфейс вообще не поднимается, отдельно открывается диалог «Восстановить DSH Desktop» — можно повторить восстановление без перезапуска фонового сервиса.

Ассистент восстановления сообщает три вещи: почему вы здесь (при ручном входе пишется «Вы вошли в режим восстановления вручную»), какой профиль и какой каталог используются и на каком шаге остановился запуск (инициализация Electron → подготовка окружения Shell → подготовка настольного runtime → выбор профиля → сборка конфигурации плагинов → запуск сервисов плагинов → запуск настольного интерфейса → подтверждение результата). Шаг, на котором всё встало, и очерчивает круг проблемы.

Как работает откат: после каждого успешного запуска приложение сохраняет «контрольную точку» — конфигурацию, которая на тот момент работала. Откат возвращает профиль, settings.yaml и состояние включённости плагинов к этому моменту. Точка показывает одно из трёх состояний: «восстановима / не читается / точки ещё нет»; «не читается» означает, что сама точка повреждена — берите более раннюю.

Сброс к заводским настройкам: текущий каталог данных целиком перемещается в корзину, после перезапуска создаётся новый профиль по умолчанию. Файлы проектов вне каталога данных не удаляются — очищаются только собственные настройки и сессии. Перед выполнением убедитесь, что старые сессии вам действительно больше не нужны.

10.3 Выход

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

11. Обновления

Пять этапов: проверка → загрузка → установка → перезапуск → подтверждение версии. Четыре повторяемых действия:

• Ручная проверка: трей → «Проверить обновления…» либо настройки → «Версия и обновления» → «Проверить обновления».
• Перезапуск: настройки → «Версия и обновления» → «Перезапустить»; можно нажать и на уведомление в заголовке окна.
• Очистка остатков установки: обновление обычно срывается из-за файлов, занятых старым экземпляром. Выйдите через трей и запустите установщик снова — удалять каталоги вручную не нужно.
• Возврат: если нужно вернуть только предыдущее рабочее состояние, используйте «Откат» в Ассистенте восстановления. Чтобы перейти на стабильный канал, просто скачайте установщик нужной версии со страницы загрузки и установите поверх — профиль и плагины сохранятся.

12. Если что-то не работает

Экспорт диагностической информации

Трей → «Экспорт диагностической информации…» или тот же пункт внизу страницы настроек. В пакет попадают локальные пути, журналы, сведения о системе и фрагменты памяти при сбое. Перед публикацией просмотрите его сами: пути и фрагменты сессий могут содержать приватные данные.

13. Данные и помощь

Дополнительные документы

• README.md / README.zh.md: установка, сборка, среда разработки.
• docs/: описание архитектуры, процесс выпуска, руководство по разработке плагинов.
• В том же каталоге Nonead-DSH-Desktop-User-Manual.en.md и HTML-версии на восьми языках: содержание совпадает, удобно сверять.
• CHANGELOG.md: изменения каждой версии; в записи 2.2.9 есть согласованный с этим руководством «Список встроенных плагинов (35)».

Благодарности

Продукт построен на upstream DeepSeek Harness и открытом сообществе: Electron, Node.js, pnpm, Python, а также система плагинов Cordis и экосистема официальных bundle. Спасибо сопровождающим upstream и всем контрибьюторам.

35 плагинов, распространяемых с приложением, созданы следующими авторами и командами (в порядке названий; один автор может быть автором нескольких плагинов):

Конкретная версия, автор и полное описание каждого плагина записаны вместе с пакетом в plugins/manifest.json, их также можно посмотреть в подробностях на странице плагинов.

Руководство обновляется вместе с версиями. Если нашли расхождение с текущей версией, создайте issue в GitHub / GitCode.