DeepSeek Harness работает с Novita AI: запустите локально веб-интерфейс Harness и добавьте Novita AI как кастомного провайдера, совместимого с OpenAI. Установите Node.js, выполните npx @deepseek-ai/dsh web, откройте http://127.0.0.1:3080, затем укажите https://api.novita.ai/openai как базовый URL провайдера, API-ключ Novita AI в качестве учётных данных и ID модели из вашей библиотеки моделей Novita AI. Настройка занимает несколько минут; основная работа — выбрать подходящую модель для задач кодинга, анализа репозиториев, исследований или работы с большими объёмами.
Что такое DeepSeek Harness
DeepSeek Harness — это опенсорсный инструментарий агентов от DeepSeek AI, построенный на архитектуре «всё — плагин». Официальная документация описывает проект как находящийся на стадии предварительного просмотра для разработчиков и предупреждает о возможных изменениях, нарушающих совместимость, поэтому лучший подход для продакшена — зафиксировать рабочую версию, проверять изменения перед обновлением и тестировать интеграцию после каждого апгрейда.
Различие между моделью и инструментарием становится очевидным, когда вы их запускаете. LLM читает промт и решает, что делать дальше. Инструментарий даёт этому решению путь выполнения: рабочее пространство, инструменты, оболочку, браузер, сессии, хранилище и способ наблюдать за результатами перед выбором следующего действия. DeepSeek Harness упаковывает этот цикл в веб-интерфейс, работающий на вашей машине, в то время как модель рассуждения может оставаться API-сервисом.
Такая архитектура подходит для нескольких типов задач:
- Изменения в кодовой базе. Позвольте агенту просматривать файлы, предлагать патчи, запускать тесты и исправлять ошибки.
- Триаж репозитория. Исследуйте незнакомые зависимости, отслеживайте пути вызовов, оценивайте риски и создавайте задачи для отслеживания.
- Исследования и отчёты. Комбинируйте просмотр веб-страниц, вывод в файлы и структурированные сводки, когда ответ разбросан по множеству страниц.
- Эксперименты с операциями. Напишите скрипты, запустите их локально с подтверждением и запишите изменения перед масштабированием.
Она менее подходит, когда вам нужен небольшой, проверяемый API-вызов без доступа к файлам или локального выполнения. Инструментарий агента — это среда разработки, а не просто инференс-эндпоинт. Если вам нужны только чат-завершения, используйте прямой LLM API Novita AI — это проще.
Что нужно для настройки
Вам понадобятся четыре вещи:
- Машина с установленным Node.js.
- Аккаунт Novita AI.
- API-ключ Novita AI.
- Рабочий каталог, который агент может читать и, где необходимо, редактировать.
Чтобы убедиться, что Node.js установлен, выполните:
node --version
Официальный репозиторий DeepSeek Harness в настоящее время заявляет поддержку Node.js версий ^22.19.0 || >=24.0.0. Если команда выводит старую версию или завершается ошибкой, установите Node.js с nodejs.org и повторите проверку. По возможности избегайте запуска команд от имени администратора; если npx не работает из-за невозможности записи в глобальный кэш, исправьте права Node.js/npm вместо открытия оболочки от root.
Перед завершением настройки создайте отдельную папку для проекта и поместите её под контроль версий, если содержимое имеет значение. Инструментарий с доступом к инструментам может быть чрезвычайно полезен, но «посмотреть на этот код» сильно отличается по уровню риска от «отправить в продакшен». Проверяйте предложенные агентом действия и не подключайте к нему учётные данные, которые ему не нужны.
Как подключить модели Novita AI
Шаг 1: Получите API-ключ Novita AI
Войдите в Novita AI, откройте Key Management, создайте новый ключ и сразу скопируйте его. Если консоль показывает ключ только один раз, поместите его в менеджер паролей или локальное хранилище секретов, которое уже использует ваша команда. Не вставляйте его в документацию, скриншоты, репозиторий исходного кода или общий чат.
Для этого руководства экспортируйте его в оболочке, где будет запускаться Harness:
export NOVITA_API_KEY="your-key"
Переменная только упрощает настройку; конфигурация провайдера в следующем разделе — это то, что Harness использует для вызовов модели.
Шаг 2: Запустите веб-интерфейс DeepSeek Harness
Официальный README предлагает следующий путь запуска через npm:
npx @deepseek-ai/dsh web
Первый запуск загружает пакет и его зависимости, поэтому может занять больше времени, чем последующие. Затем DeepSeek Harness открывает веб-интерфейс по адресу http://127.0.0.1:3080 по умолчанию и запускает его в вашем браузере по умолчанию. Если вы работаете через SSH или не хотите открывать браузер, в официальном README описан флаг --no-open:
npx @deepseek-ai/dsh web --no-open
DeepSeek Harness также можно запустить из исходного кода с помощью pnpm install, pnpm run build и pnpm dsh web, но путь через npm — самый быстрый способ получить рабочий интерфейс, и именно его мы используем в этом руководстве.
Шаг 3: Добавьте Novita AI как кастомного провайдера
Точные названия могут меняться по мере развития DeepSeek Harness, но цель в текущем веб-интерфейсе одна: откройте настройки модели/провайдера и добавьте кастомного провайдера, совместимого с OpenAI.
| Поле | Значение |
|---|---|
| Отображаемое имя | Novita AI |
| ID провайдера | novita или другой стабильный локальный идентификатор |
| Базовый URL | https://api.novita.ai/openai |
| API-ключ | Ваш API-ключ Novita AI |
| Каталог моделей | Обновите или добавьте конкретные ID моделей Novita AI, которые вам нужны |
Используйте https://api.novita.ai/openai, а не путь к конкретной модели. Держите ID провайдера стабильным; если вы переименуете его позже, существующие настройки сессий могут указывать на несуществующий провайдер. После сохранения провайдера обновите каталог моделей и сделайте модель видимой в выборе сессии.
Выберите протокол API openai-completions. DeepSeek Harness документирует этот протокол для OpenAI Chat Completions и предлагает также openai-responses и anthropic-messages для шлюзов, использующих эти форматы запросов.
Шаг 4: Выберите модель и рабочее пространство
Откройте рабочее пространство в веб-интерфейсе DeepSeek Harness и выберите одну из добавленных моделей Novita AI. Если в интерфейсе есть действие «получить модели», используйте его, а не вводите ID модели по памяти. ID модели — это контракт интеграции: неверный ID может выглядеть как проблема с сетью, правами доступа или пустой каталог.
Затем выполните небольшую задачу перед работой с важной кодовой базой:
Перечислите файлы в этом рабочем пространстве, определите основную точку входа и предложите одно малозатратное улучшение документации.
Убедитесь, что агент может читать рабочее пространство, вызывать модель и остановиться перед действием, которое вы не одобрили. Как только цикл заработает, переходите к реальной задаче.
Если автоматическое обнаружение моделей не заполняет список, добавьте ID модели вручную. DeepSeek Harness описывает обнаружение как удобную функцию, потому что не каждый шлюз возвращает одинаковый формат списка.
Что можно запустить после настройки
DeepSeek Harness даёт вам место для определения и запуска сессий агентов, а не только для последующих вопросов. Несколько практических отправных точек:
Объясните и отрефакторите существующий участок кода
Укажите рабочее пространство на сервис или пакет и попросите агента проследить одну функцию от начала до конца. Полезный результат — не только текст; он может включать план изменений, файлы, которые будут затронуты, добавляемые тесты и сигналы, подтверждающие успешность рефакторинга.
Проследите, как входящий запрос достигает уровня базы данных. Создайте нумерованную последовательность, перечислите вероятные точки отказа и предложите тесты для двух самых рискованных путей.
Проверяйте план перед тем, как разрешить редактирование. Модель может выбрать внешне логичный путь через кодовую базу, зависящий от неявного инициализатора, устаревшего пути конфигурации или старого API, у которого всё ещё есть вызовы в продакшене.
Подготовьте миграцию или очистку
Harness полезен для задач «подготовить работу». Попросите инвентаризацию зависимостей, список использования API, чек-лист совместимости или поэтапный план миграции. Эти артефакты легче проверять, чем один большой патч, и они сохраняют ваше суждение, если миграция затрагивает другие команды.
Выполните рабочий процесс «исследование → файл»
Для обзоров рынка или технических сравнений попросите агента собрать источники, сверить даты, отметить разногласия и написать черновик отчёта в локальный файл. Держите результат узким: «создать таблицу кандидатов с URL и датами» легче проверить, чем «расскажите мне, что происходит на этом рынке».
Создайте повторяемый локальный рабочий процесс
Когда промт сработал, сохраните его как промт проекта или плагин, если ваша версия Harness это поддерживает. Повторно используемый промт должен указывать рабочее пространство, необходимые входные данные, формат вывода и границы безопасности. Последнее важно, когда рабочий процесс запускает команды или редактирует файлы.
Как выбрать модель для задачи
Novita AI поддерживает DeepSeek и другие семейства моделей, так что вопрос не в том, «у какого провайдера есть одна модель?», а «какую модель использовать на этом этапе рабочего процесса?» Начните с актуальных списков в библиотеке моделей Novita AI и подтвердите точный ID модели на странице модели перед сохранением в Harness. ID моделей и лимиты меняются по мере обновления каталогов.
Используйте эти схемы маршрутизации как отправную точку:
- DeepSeek V4.1 Flash полезна, когда вам нужно сильное общее рассуждение для анализа кода, математических задач или многошаговых объяснений без затрат флагманской модели.
- GLM 5.3 — флагманская модель GLM на момент написания, а GLM 5.3 Flash — эффективный нативный мультимодальный вариант. Проверьте лимиты контекстного окна и вывода, прежде чем отправлять весь репозиторий в один запрос.
- Qwen3.8 Flash и Qwen3.8 Max** охватывают эффективный и флагманский концы текущей линейки Qwen3.8. Запустите одну и ту же задачу с патчем на вашем стандартном наборе, чтобы увидеть, какой результат легче проверять.
- Kimi K3 — текущий флагман Moonshot в каталоге Novita и подходит для рабочих процессов с длинным контекстом, исследованиями и интенсивным использованием инструментов. Перед использованием в продакшене подтвердите точное поведение API для вызовов инструментов.
- MiniMax M3 — самая новая модель MiniMax, кандидат для эффективных интерактивных задач и работы с мультимодальными входами. Измеряйте задержку и качество на своих собственных промтах, а не полагайтесь на результаты одного бенчмарка.
Для продакшен-работы с агентами три параметра важнее любого рейтинга:
- Успешность задачи. Проходит ли патч тесты? Содержит ли отчёт запрошенные разделы? Выполняет ли вызов инструмента нужное действие?
- Стоимость за принятый результат. Учитывайте повторы, бесполезный вывод и время человека на проверку неудачных планов.
- Характер ошибок. Отказывается ли модель вежливо, галлюцинирует вызов инструмента или уверенно выполняет неверное действие? Для последнего нужны более строгие настройки подтверждения.
Если вы хотите сравнить две модели без редактирования провайдера каждый раз, добавьте обе в одного провайдера Novita AI, сохраните их точные ID и запустите один и тот же репрезентативный набор промтов. Затем проверьте конечные артефакты, а не только вывод чата.
Устранение распространённых проблем настройки
Список моделей пуст
Проверьте, что базовый URL точно https://api.novita.ai/openai, API-ключ актуален и ваш аккаунт имеет доступ к модели. Если в интерфейсе есть кнопка обновления, обновите каталог после сохранения провайдера. Затем проверьте ключ вне Harness прямым API-запросом.
Если при получении моделей возвращается ошибка аутентификации, сначала проверьте ключ. Harness при обнаружении вызывает эндпоинт списка моделей, совместимый с OpenAI, и может выдать там ошибку, в то время как обычные запросы завершаются неудачей по другой причине.
Провайдер сохраняется, но запросы не проходят
Убедитесь, что ID модели совпадает со страницей модели Novita AI. Также проверьте, поддерживает ли выбранная модель тип запроса, который делает Harness: текстовая модель может не поддерживать запрос с изображением, а модель без поддержки инструментов может выдавать ошибку на шаге агента, ожидающем вызова инструментов.
npx зависает или завершается ошибкой при первом запуске
Первый запуск загружает зависимости и может занять некоторое время. Если он не удаётся, проверьте сеть, кэш npm и версию Node.js. Повторный чистый запуск допустим; если ошибка связана с правами, предпочтите пользовательскую установку Node.js или кэш менеджера пакетов, а не запуск команды с повышенными привилегиями.
Браузер не открывается
Сервер может всё ещё работать. Откройте http://127.0.0.1:3080 вручную или перезапустите с npx @deepseek-ai/dsh web --no-open и откройте URL из браузера на той же машине. При работе через SSH перенаправленный хост может быть не 127.0.0.1, поэтому используйте адрес, выведенный командой.
Агент сделал неожиданное изменение
Остановите выполнение, проверьте различия в системе контроля версий и отмените то, что вам не нужно. Затем уменьшите область действия инструментов или запустите задачу в одноразовом рабочем пространстве. Если ваша команда использует защищённые ветки и учётные данные для развёртывания, держите их вне доступа агента, пока не будете уверены в рабочем процессе.
Часто задаваемые вопросы
Поддерживает ли DeepSeek Harness модели Novita AI?
DeepSeek Harness поддерживает кастомных провайдеров, совместимых с OpenAI, а Novita AI предоставляет совместимый API. В этом руководстве используется путь кастомного провайдера: https://api.novita.ai/openai как базовый URL, API-ключ Novita AI и точный ID модели со страницы модели Novita AI.
Нужно ли разворачивать собственный сервер модели?
Нет. Novita AI размещает API модели; DeepSeek Harness работает локально и вызывает этот API. Вам не нужно управлять GPU для этой настройки. Однако вам понадобятся достаточные локальные ресурсы для процесса Node.js и любых инструментов, которые запускает агент.
Готов ли DeepSeek Harness к продакшену?
Официальный репозиторий описывает DeepSeek Harness как предварительный просмотр для разработчиков и предупреждает о возможных изменениях, нарушающих совместимость. Он может быть полезен уже сегодня, но фиксируйте версии, проверяйте заметки о выпусках, храните важную работу под контролем версий и тестируйте обновления в некритичном рабочем пространстве перед изменением продакшен-процесса.
Можно ли использовать несколько моделей в одном проекте?
Да, если интерфейс поддерживает переключение моделей в сессии. Полезный паттерн: одна модель для черновиков или первого прохода кода, другая для проверки или более глубокого анализа, и более дешёвая модель для суммаризации, классификации или повторяющихся извлечений.
Где хранить API-ключ Novita AI?
Помещайте его в конфигурацию провайдера только когда это необходимо, а в остальное время держите в локальном менеджере секретов или зашифрованном хранилище переменных окружения. Никогда не коммитьте его, не делитесь им в скриншотах и не давайте ему более широких прав, чем нужно для задачи.
Что сделать перед подключением реальной кодовой базы?
Поместите рабочее пространство под контроль версий, подтвердите настройки подтверждения агента и удалите ненужные учётные данные. Начните с задачи только на чтение или низкого риска, затем расширяйте набор инструментов после того, как поймёте, как агент ведёт себя с вашим проектом.
Рекомендуемые статьи
- What Are Coding Agents? How They Work and How to Build One
- GLM 5.2 on Novita AI: Long-Context Launch, Pricing, and Developer Fit
- DeepSeek V4 Pro vs Flash on Novita AI: Pricing, Model ID, and API Choice
Источники
- Официальный репозиторий DeepSeek Harness, проверено 10 сентября 2026 г.: статус предварительного просмотра для разработчиков, команда запуска npm, порт веб-интерфейса, флаг
--no-openи путь запуска из исходников. - Руководство по конфигурации моделей DeepSeek Harness, проверено 10 сентября 2026 г.: поля кастомного провайдера, протокол
openai-completions, постоянные ID провайдеров, обнаружение моделей и устранение неполадок. - package.json DeepSeek Harness, проверено 10 сентября 2026 г.: диапазон версий Node.js.
- Библиотека моделей Novita AI, проверено 10 сентября 2026 г.: каталог размещённых моделей и страницы моделей.
- Key Management Novita AI, проверено 10 сентября 2026 г.: создание API-ключа и путь управления.
- LLM API Novita AI, проверено 10 сентября 2026 г.: базовый URL, совместимый с OpenAI, и позиционирование API.
