Блог

Руководство по Web UI DeepSeek Harness: начало работы на localhost:3080

Короткий ответ

Web UI DeepSeek Harness — это локальная консоль по адресу http://127.0.0.1:3080. Это не «окно чата», а фронтенд среды выполнения агента: вы задаёте цель, агент в цикле вызывает инструменты, пока не закончит, а в интерфейсе вы наблюдаете за процессом и вмешиваетесь в него.

Запуск:

bash
npx @deepseek-ai/dsh web

Откройте http://127.0.0.1:3080. Чтобы консоль выполняла реальную работу, направьте бэкенд модели на TeamoRouter:

bash
export DEEPSEEK_API_KEY="sk-teamo-your-key"
export DEEPSEEK_BASE_URL="https://api.teamorouter.com/v1"
export DEEPSEEK_DEFAULT_MODEL="deepseek-v4-pro-free"

Ниже — каждая часть интерфейса и как ей пользоваться.

1. Управление сессиями: параллельные задачи

Список сессий (слева или сверху) позволяет:

  • Создавать сессии — каждая представляет собой независимый контекст агента.
  • Переключаться и переименовывать — называйте сессии по задачам («fix payment bug», «refactor reports»): так их проще найти, чем по дате.
  • Запускать несколько сессий параллельно — dsh поддерживает параллельные сессии: удобно, когда в фоне идёт долгий агентный цикл, а в другой сессии вы задаёте быстрые вопросы.

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

2. Выбор модели: один ключ, много моделей

Селектор модели переключает ID модели для каждой сессии. При подключённом TeamoRouter типичный выбор такой:

ID модели Позиционирование Бесплатная квота
deepseek-v4-pro-free Флагманская Pro, сложная работа 200/день
deepseek-v4-flash-free Дешёвая Flash, лёгкая работа 200/день
deepseek-v4-pro Платная Pro, без лимита на аккаунт
deepseek-v4-flash Платная Flash, без лимита на аккаунт

Лёгкая работа на Flash, сложная на Pro — стандартная связка для экономии (см. V4 Pro против Flash).

3. Панель инструментов: руки агента

В панели инструментов перечислено всё, что может вызывать текущий агент, — в этом принципиальное отличие harness от обычного чата. Типичные инструменты:

  • bash — выполнение shell-команд: так агент читает файлы, запускает тесты, ставит зависимости.
  • Чтение и запись файлов — чтение, запись и правка файлов в рабочем каталоге.
  • subagent — запуск субагентов, которые параллельно работают над подзадачами, с последующим сбором результатов.
  • web_search / web_fetch — поиск в интернете и загрузка страниц.
  • ask_user_question — пауза в ключевой момент и вопрос пользователю.

Поймёте эти инструменты — поймёте, почему dsh правит код, а не просто рассуждает о коде: каждый вызов инструмента — это реальное чтение, запись или выполнение команды.

4. Цели: разбиваем длинные задачи

dsh моделирует длинные задачи как цели (Goals) и поддерживает:

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

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

5. Полный пример от начала до конца

  1. Задайте переменные окружения (см. выше) и запустите dsh.
  2. Начните сессию, выберите deepseek-v4-pro-free.
  3. Дайте реальную задачу:
text
Find package.json in the current directory, bump the version to 2.0.0, and add a release note line to the README.
  1. Наблюдайте в панели инструментов, как по очереди вызываются bash и файловые инструменты, после чего агент отчитывается о результате.

Этих 30 секунд хватит, чтобы почувствовать: «harness превращает модель в работника».

FAQ

Почему на 3080 пусто или нет подключения?

Убедитесь, что процесс npx @deepseek-ai/dsh web всё ещё жив. SDK-сервер dsh завершается, когда закрывается stdin, поэтому при запуске через nohup ... & держите подключённым stdin, который никогда не закрывается.

Панель инструментов пуста или агент говорит, что у него нет инструментов?

Инструменты берутся из пресета агента. Пресет по умолчанию включает bash, чтение и запись файлов и glob/grep; если он урезан, проверьте, подгружает ли конфигурация запуска соответствующие пакеты инструментов.

Web UI доступен только локально?

По умолчанию он привязан к 127.0.0.1 — только локальная машина. Не выставляйте его в публичный интернет: стоящий за ним агент умеет выполнять shell-команды, так что открытый порт опасен.

Можно ли изменить порт?

По умолчанию — 3080. При необходимости измените его флагом запуска или в конфигурации и соответственно обновите URL доступа.

Как действия в интерфейсе связаны с агентом под капотом?

Интерфейс — это слой наблюдения и вмешательства. Состояние, которое вы видите (цели, вызовы инструментов, сессии), соответствует реальным событиям в среде выполнения агента; остановка интерфейса не останавливает запущенную сессию агента.

С подключённым бесплатным тарифом TeamoRouter эта консоль даёт вам 200 бесплатных запросов к V4 Pro в день. Зарегистрируйтесь в TeamoRouter, получите ключ и начинайте.

Готовы подключиться?Войдите в консоль, пополните баланс и создайте API-ключ.
Руководство по Web UI DeepSeek Harness: начало работы на localhost:3080 · TeamoRouter