Приложение Д. FAQ

Приложение Д. Часто задаваемые вопросы (FAQ)

В этом приложении собраны самые частые вопросы, с которыми сталкиваются пользователи DeepSeek Harness — особенно те, кто переходит с Cursor. Вопросы сгруппированы по темам. Если ваш вопрос не нашёлся — в конце приложения есть ссылки, куда обращаться за помощью.

1. Общие вопросы

Вопрос: DeepSeek Harness — это бесплатно?

Да, сам фреймворк распространяется бесплатно по лицензии MIT. Вы платите только за токены API — за каждый вызов модели. Это как с Cursor: вы платите за подписку или за использование API, а не за сам редактор.

Вопрос: Чем DSH отличается от Cursor для меня как маркетолога?

Cursor — это AI-помощник, который пишет код вместо вас. Вы получаете код и сами решаете, что с ним делать: загружать на сервер, настраивать, проверять.

DeepSeek Harness — это AI-агент, который выполняет задачи вместо вас. Он не только пишет код, но и сам деплоит на сервер, создаёт базу данных, проверяет работу и сообщает вам результат.

Если коротко: Cursor даёт вам код, DSH даёт вам готовый результат.

Вопрос: Можно ли использовать DSH вместе с Cursor?

Да, это лучшая стратегия для маркетолога:
- Cursor — для быстрого написания кода, когда вы хотите сами контролировать процесс.
- DSH — для автоматизации: деплой, расписание, сложные многошаговые задачи.

Никто не заставляет вас выбирать что-то одно.

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

Вопрос: Какие требования к компьютеру для DSH?

Вам нужен только Node.js. Конкретно (engines пакета @deepseek-ai/dsh):

• ^22.19.0 (на ветке 22 — не ниже 22.19) или >=24.0.0
• Ветка 23.x не поддерживается
• Node.js 18 и 20 не подойдут — ошибки часто без явного «обновите Node»

Проверьте свою версию:

node --version

Если версия не подходит — обновите Node.js с официального сайта (LTS 22.19+ или 24+).

Вопрос: Как установить DSH?

Самый простой способ — одной командой:

npx @deepseek-ai/dsh web

Или глобально (если планируете использовать часто):

npm install -g @deepseek-ai/dsh
dsh web

Вопрос: Команда dsh не найдена (command not found) после установки

Перезапустите терминал — переменные PATH обновляются только при новом запуске. Если не помогает — перезагрузите компьютер.

Вопрос: Установка через npx скачивается очень медленно или падает

Проблема в сети. Попробуйте:
1. Сменить npm-зеркало (mirror).
2. Или установить из исходников:
bash git clone https://github.com/deepseek-ai/deepseek-harness.git cd deepseek-harness pnpm install && pnpm run build && pnpm dsh web

Вопрос: Порт 3080 уже занят

Замените порт:

dsh web --port 8090

Или любой другой свободный порт.

Вопрос: Я на Windows, и у меня ошибки с bash

DSH на Windows использует PowerShell (pwsh), а не bash. Если вы видите ошибки, связанные с bash — скорее всего, вы пытаетесь выполнить Linux-команды в Windows-окружении. Используйте PowerShell или WSL.

3. Настройка и конфигурация

Вопрос: Web UI открылся, но поле ввода серое (недоступно)

Вы не выбрали рабочую область (workspace). Это сделано специально для безопасности — агент может работать только с теми файлами, к которым вы дали доступ.

Решение: нажмите кнопку «Выбрать рабочую область» («Choose workspace») и выберите папку вашего проекта. После этого поле ввода станет активным.

Вопрос: Я сохранил API-ключ, но он больше не отображается в интерфейсе

Это сделано намеренно. Ключи отображаются только один раз — при вводе. После сохранения интерфейс показывает только обезличенный идентификатор.

Сами ключи хранятся в файле ~/.dsh/.credentials.yaml (на Windows — %USERPROFILE%\.dsh\.credentials.yaml). Если нужно проверить или исправить ключ — откройте этот файл.

Вопрос: Ошибка MISSING_CREDENTIAL

Ключ не настроен или настроен неправильно.

Проверьте:
1. Зайдите в Settings → Models и сохраните API-ключ заново.
2. Убедитесь, что при вставке не попали лишние пробелы в начале или конце.
3. Проверьте баланс на platform.deepseek.com — если баланс нулевой, ключ не сработает.

Вопрос: Я изменил настройки в cordis.patch.yml, но они не работают

Три самые частые причины:

1. Вы правите не тот файл — проверьте, что вы находитесь в папке своего профиля (~/.dsh/profiles/<имя_профиля>/).
2. Синтаксическая ошибка в YAML — проверьте отступы (пробелы, не табуляция).
3. Patch заменяет всю строку, а не объединяет — если вы хотите изменить одно поле, но в строке есть другие поля — их нужно переписать все, иначе они вернутся к значениям по умолчанию.

Диагностика: выполните команду:

dsh --profile web --dump-config

Она покажет, какие настройки реально загружены. Если ваших настроек там нет — значит, они не попали в сборку.

4. Использование и поведение агента

Вопрос: Агент остановился на середине задачи и ничего не делает

Скорее всего, агент ждёт вашего подтверждения. Некоторые действия (удаление файлов, выполнение опасных команд, доступ за пределы рабочей папки) требуют вашего разрешения.

Что делать: посмотрите на экран — должно появиться окно с запросом подтверждения. Нажмите «Разрешить» или «Запретить».

Если окна нет — откройте Trajectory (траекторию) и посмотрите, на каком шаге агент остановился.

Вопрос: Я закрыл вкладку браузера — задача потеряется?

Нет. DSH сохраняет все сессии в папке ~/.dsh/sessions. Вы можете:
- Открыть ту же сессию заново в веб-интерфейсе.
- Продолжить с того места, где остановились.

Вопрос: Агент изменил файлы, которые не должен был трогать

Это серьёзная проблема. Вот как защититься в будущем:

1. Всегда начинайте с тестовой папки — создайте отдельную директорию для экспериментов.
2. Напишите правила в AGENTS.md — файл в корне проекта, который агент читает при старте. Пропишите там: «Никогда не изменяй файлы в папке config/».
3. Используйте режим workspace-write (Глава 10) — агент сможет изменять только файлы в рабочей папке.
4. Включите режим подтверждения ask — перед каждым изменением агент будет спрашивать вашего разрешения.

Вопрос: Агент слишком много тратит токенов, счёт растёт

Что можно сделать:

1. Установите лимиты в профиле: max_steps: 10, max_tokens: 30000 (Глава 10).
2. Используйте более дешёвую модель (DeepSeek-V4-Flash вместо Pro).
3. Для длинных многошаговых задач попробуйте PTC (он же Code Mode в части официальных текстов) — на хорошо структурированных задачах он может снизить число раундов с моделью; при кривом коде бюджет всё равно сгорит (Глава 8).
4. Сократите промпт — уберите лишние слова.
5. Установите плагин для мониторинга бюджета (например, dsh-budget) — он покажет расход в реальном времени.

Вопрос: Агент не использует какой-то инструмент или плагин

Проверьте:
1. Установлен ли плагин? dsh plugin --profile web list
2. Перезапустили ли DSH после установки?
3. Посмотрите --dump-config — виден ли плагин в конфигурации?
4. В описании инструмента (description) может быть неясно, когда его вызывать.

5. Плагины

Вопрос: Как установить плагин?

Три способа:

Способ 1 — npm-пакет (рекомендуется, самый простой):

dsh plugin --profile web add <имя_пакета>

Плагин уже собран, ничего дополнительно делать не нужно.

Способ 2 — GitHub-репозиторий:

dsh plugin --profile web add github:владелец/репозиторий

Важно: при первой установке может быть ошибка — это защита pnpm. DSH покажет, что нужно сделать: добавить название плагина в файл pnpm-workspace.yaml вашего профиля в секцию allowBuilds.

Способ 3 — локальный файл:

dsh plugin --profile web add ./путь/к/плагину.tgz

Вопрос: Я установил GitHub-плагин, но он не работает — ошибка при установке

Это нормальная ситуация для первого раза. pnpm (менеджер пакетов) по умолчанию запрещает выполнение скриптов из GitHub-репозиториев.

Что делать:
1. Прочитайте сообщение об ошибке — там будет точный текст, что нужно добавить в файл pnpm-workspace.yaml.
2. Откройте файл ~/.dsh/profiles/<имя_профиля>/pnpm-workspace.yaml.
3. Добавьте строку:
yaml allowBuilds: - <имя_пакета>
4. Сохраните и повторите команду установки.

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

Вопрос: Где искать плагины?

• Встроенный маркетплейс — установите dshmarket и ищите в интерфейсе.
• GitHub по теме dsh-plugin — github.com/topics/dsh-plugin
• Awesome-списки — например, hackerFish/awesome-dsh-plugin

6. Ошибки и их решения

Вопрос: Ошибка UNKNOWN_MODEL

Вы выбрали модель, которая не настроена или не существует.

Решение: зайдите в Settings → Models и выберите другую модель из списка уже настроенных. Или добавьте новую модель вручную.

Вопрос: Ошибка 401 Unauthorized (при получении списка моделей)

API-ключ неверный или истёк.

Решение: проверьте ключ на platform.deepseek.com и введите заново в настройках DSH.

Вопрос: Агент говорит «файл не найден», хотя файл есть

Причины:
- Не выбрана рабочая область (workspace).
- Файл находится за пределами рабочей папки, а у агента нет прав на доступ.
- Путь указан относительно, а агент «думает» в другой директории.

Решение:
1. Проверьте, что выбрана правильная рабочая область.
2. Используйте абсолютные пути в промпте.
3. Если файл за пределами рабочей папки — либо переместите его, либо расширьте права агента (не рекомендуется для продакшена).

Вопрос: Инструмент вызван, но говорит «unknown tool» или «tool is disabled»

Причина: потоковый ответ модели может содержать пустой идентификатор инструмента. Чаще всего это происходит при использовании OpenAI-совместимых шлюзов.

Решение: это баг в обработке стриминга. Проверьте, что у вас установлена последняя версия DSH. Если проблема сохраняется — обратитесь в Issues на GitHub.

Вопрос: DSH вообще не запускается, сразу падает

Возможные причины:
- Ошибка в конфигурации профиля (cordis.patch.yml).
- Не хватает зависимостей плагина.
- Повреждённая сессия.

Что делать:
1. Проверьте конфигурацию: dsh --profile web --dump-config
2. Если конфигурация выглядит нормально — попробуйте создать новый профиль.
3. Если не помогает — установите dsh-doctor — плагин для автоматической диагностики:
bash npx dsh-doctor recover --profile web
4. Крайний случай — полный сброс: удалите папку ~/.dsh (предварительно сделав бэкап). Это удалит все сессии, профили и настройки — начнёте с чистого листа.

Вопрос: Сессия повреждена — ошибка «corrupt session log»

Это известная проблема. Есть плагин для восстановления****:

dsh plugin --profile web add github:po-et/dsh-session-rescue

Он диагностирует и чинит повреждённые сессии.

7. Безопасность

Вопрос: Можно ли открыть DSH в интернете (--host 0.0.0.0)?

Категорически нет. В DSH нет встроенной аутентификации — любой, кто найдёт ваш IP и порт, сможет управлять вашим агентом. Разработчики прямо предупреждают, что не рекомендуется обходить это ограничение.

DSH должен работать только на 127.0.0.1 (локальный доступ).

Вопрос: Как защитить сервер от агента?

1. Создайте отдельного пользователя на сервере для агента (не root).
2. Ограничьте права — дайте доступ только к одной папке.
3. Используйте режим workspace-write в настройках DSH.
4. Включите подтверждение опасных действий (approval_policy: ask).
5. Регулярно проверяйте логи — смотрите Trajectory, чтобы видеть, что делал агент.

8. Сравнение с Cursor

Вопрос: Что лучше — Cursor или DeepSeek Harness?

Это разные инструменты для разных задач:

Главный вывод: Cursor даёт вам код, DSH даёт вам выполненную задачу. Они не заменяют друг друга, а дополняют.

Вопрос: Стоит ли переходить с Cursor на DSH?

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

9. Где искать помощь

Если ваш вопрос не нашёлся в этом FAQ:

1. Официальный репозиторий DSH — github.com/deepseek-ai/deepseek-harness — Issues и Discussions; обязательно SAFETY.md.
2. Лендинг продукта — deepseek.com/harness.
3. Сообщество — Discord и чаты (ссылки в README репозитория).
4. Awesome-списки — подборки плагинов и примеров (проверяйте дату и звёзды).
5. Команда --dump-config — что реально загружено в профиле.
6. Плагин dsh-doctor — диагностика:
   bash npx dsh-doctor recover --profile web