[позже] Первый запуск на своём ПК

Глава 3:

Глава 3. Ваш первый запуск: не делайте это на реальном проекте

В этой главе вы впервые запустите агента и дадите ему задачу. Самое важное правило: всё, что мы делаем в этой главе, происходит в тестовом репозитории, который не жалко сломать. DeepSeek Harness — это инструмент в стадии разработчика (Developer Preview), и агент может сделать неожиданные вещи. Поэтому сначала учимся на безопасных примерах.

3.1. Подготовка: создаём тестовый репозиторий

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

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

Создайте новую пустую папку на компьютере. Назовите её, например, dsh-test.
Откройте терминал и перейдите в эту папку:
bash cd /путь/к/dsh-test
(Опционально) Если вы хотите, чтобы агент работал с Git-репозиторием, инициализируйте его:
bash git init
Или создайте тестовый репозиторий на GitHub, склонируйте его в эту папку и работайте внутри склонированной директории.

Почему это важно: DSH использует текущую рабочую директорию как «рабочее пространство» (workspace) агента. Агент сможет читать и редактировать файлы только в пределах этой папки (если вы не дадите ему дополнительные разрешения). Для первого запуска используйте маленький тестовый репозиторий.

3.2. Запуск Web UI

Теперь запустите веб-интерфейс DSH. Всё делается одной командой:

npx @deepseek-ai/dsh web

Что происходит:
- Команда скачивает и запускает DeepSeek Harness.
- Веб-интерфейс становится доступен по адресу http://127.0.0.1:3080.
- Браузер откроется автоматически (если не открылся, перейдите по ссылке вручную).

Важно: не закрывайте терминал, пока работаете с веб-интерфейсом — это сервер, и его остановка прервёт работу.

Если у вас Windows и команда не работает: перезапустите терминал или PowerShell — часто проблема в том, что переменные окружения ещё не обновились.

3.3. Настройка модели (ещё раз проверить)

Хотя вы уже настраивали API-ключ в Главе 2, перед первым запуском стоит проверить:

В веб-интерфейсе откройте Settings → Models.
Убедитесь, что API-ключ вставлен и сохранён.
Совет по безопасности: используйте ключ с ограничением по расходу (spending limit) и никогда не вставляйте его в диалог с агентом.

3.4. Выбор рабочей области (Workspace)

Это важный шаг. Без выбранной рабочей области интерфейс для ввода задач будет недоступен.

В веб-интерфейсе найдите кнопку «Choose workspace» (Выбрать рабочую область).
Нажмите на неё и добавьте папку, в которой вы запускали DSH (ту самую dsh-test).
Выберите её из списка.

Почему это важно: агент получит доступ к файлам только в этой папке. Вы можете контролировать, что именно он видит.

3.5. Первая задача: безопасный промпт

Теперь самое интересное — первая задача. Не давайте агенту задачу «сделай сайт» сразу. Сначала проверьте, что он вообще видит ваши файлы и может с ними работать.

Рекомендованный промпт для первого запуска:

«Inspect this repository without changing files. Summarize its purpose, list its main packages, and cite the files that support each conclusion.»

На русском:

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

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

Альтернативный простой промпт для совсем пустой папки:

«Создай файл hello.txt с текстом "Привет, мир!" и больше ничего не делай.»

Этот промпт безопасен, потому что вы сами видите результат — появился файл или нет.

3.6. Что вы увидите во время работы агента

Когда вы отправите промпт, начнётся процесс, который может занять от нескольких секунд до пары минут.

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

Пример того, что вы можете увидеть в ответе (если в папке есть файлы):

Этот репозиторий содержит простой HTML-сайт.
Основные файлы:
- index.html — главная страница (подтверждается содержимым файла)
- style.css — файл стилей (подтверждается импортом в index.html)
Назначение: сайт-визитка.

3.7. Четыре сигнала успешного запуска

Как понять, что всё работает правильно? Должны быть все четыре признака:

Признак	Что это значит
Браузер получил ответ	Вы видите текст ответа, а не ошибку
Ответ ссылается на реальные файлы	Агент действительно прочитал вашу папку, а не просто «угадал»
Сессия осталась видимой	После завершения ответа вы можете вернуться к истории диалога
Не было скрытых запросов на запись	Агент не выполнял команды или запись файлов без вашего ведома

Если все четыре признака есть — поздравляю! DeepSeek Harness работает, и вы можете переходить к более сложным задачам.

3.8. Что делать, если что-то пошло не так

Даже при правильной настройке могут возникнуть проблемы. Вот таблица для быстрой диагностики:

Проблема	Что проверять в первую очередь
Браузер не подключается	Запущен ли терминал? Правильный ли адрес (`http://127.0.0.1:3080`)?
Поле ввода недоступно	Выбрана ли рабочая область (workspace)?
Ошибка аутентификации	Правильно ли вставлен API-ключ? Есть ли деньги на балансе?
Инструменты недоступны	Проверьте настройки прав и политики безопасности
Агент видит не те файлы	Проверьте, в какой папке вы запускали DSH и какая рабочая область выбрана

Универсальный способ диагностики:

Выполните команду в терминале:

npx @deepseek-ai/dsh --profile web --dump-config

Она покажет, какие плагины, сервисы, инструменты и политики реально загружены на вашем компьютере. Это самый быстрый способ понять, что именно не так с конфигурацией.

3.9. Запуск без веб-интерфейса (Headless-режим)

Как маркетолог, вы, скорее всего, будете пользоваться веб-интерфейсом. Но полезно знать, что DSH умеет работать без браузера — это пригодится, если вы захотите автоматизировать задачи на сервере или по расписанию.

Команда для однозадачного запуска:

npx @deepseek-ai/dsh --profile headless "Проверь этот репозиторий. Не изменяй файлы. Выполни только проверки и сообщи о проблемах."

Что происходит:
- DSH запускается, выполняет задачу, печатает ответ в терминал и завершается.
- Не открывается браузер, не запускается веб-сервер.
- Подходит для скриптов и CI/CD.

Для первого раза лучше использовать веб-интерфейс — там всё нагляднее.

3.10. Итоговый чек-лист: вы готовы к реальным задачам

Если вы успешно выполнили все шаги из этой главы, у вас есть:

[x] Установленный и работающий DeepSeek Harness.
[x] Настроенный API-ключ с балансом.
[x] Выбранная рабочая область (workspace).
[x] Успешно выполненная первая задача (агент ответил, ссылаясь на реальные файлы).
[x] Понимание, как читать траекторию (Trajectory) — лог действий агента.
[x] Знание, куда смотреть при ошибках.

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