Перейти к содержимому

Подключение DeepSeek Harness ​

Сложность ⌨️ Средний уровень (запуск из терминала, настройка в Web UI) | Формат API OpenAI-совместимый | base_url https://1app.ru/v1

DeepSeek Harness (dsh) — открытый агентный фреймворк от DeepSeek AI. Он собран по принципу «всё есть плагин»: модели, инструменты и интерфейс подключаются модулями, а работать с ним можно из локального Web UI. По умолчанию dsh ходит на собственный эндпоинт DeepSeek, но в настройках есть Custom model API — и этого достаточно, чтобы направить его на 1APP. Один токен 1APP добавит в dsh модели DeepSeek, Claude, GPT, Gemini и другие — с оплатой по факту использования, без подписки.

Перед началом

Зайдите в Консоль → Токены и создайте токен в группе, которая покрывает нужные модели (Быстрый старт, Выбор группы). Для моделей DeepSeek это группа DeepSeek. Везде, где ниже встречается sk-xxxx, подставляйте свой ключ.

Developer preview

DeepSeek Harness находится в стадии developer preview: между версиями бывают ломающие изменения. Если пункт меню или поле называется иначе — сверяйтесь с официальной документацией.

Требования ​

  • Node.js 24.9 или новее (node --version).
  • Токен 1APP с доступом к нужным моделям.
  • Терминал и браузер на одной машине — либо SSH-туннель до порта Web UI.

Шаг 1: Запуск ​

Установка не нужна — пакет запускается через npx:

bash
npx @deepseek-ai/dsh web

Команда поднимает Web UI на http://127.0.0.1:3080 и открывает браузер. Если браузер открывать не нужно (например, при запуске по SSH), добавьте --no-open.

Данные dsh хранит в ~/.dsh; другой каталог задаётся переменной DSH_HOME.

Запуск из исходников — для разработки или если нужна конкретная версия (после клонирования можно переключиться на тег, например git checkout dsh-v0.2.2-rc.1):

bash
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

Шаг 2: Выбор рабочей папки ​

В открывшемся окне нажмите Choose workspace и укажите каталог проекта. Без выбранной папки поле ввода задачи неактивно. dsh работает с файлами этой папки, поэтому выбирайте тот репозиторий, который хотите поручить агенту.

Шаг 3: Добавление 1APP как поставщика моделей ​

  1. Откройте Settings → Models.
  2. Нажмите Add model provider и переключите карточку на Custom model API.
  3. Заполните поля:
ПолеЧто вписать
Provider ID1app — строчными буквами; менять потом нельзя
Display name1APP (произвольное)
Base URLhttps://1app.ru/v1
API protocolOpenAI Chat Completions
API keysk-xxxx — ваш токен 1APP
Modelsdeepseek-v4-pro, deepseek-v4.1-flash
  1. В блоке Model catalog нажмите Fetch available models — dsh запросит список моделей у 1APP по введённым адресу и ключу. Отметьте нужные и нажмите Update list.
  2. Сохраните поставщика.

Если список моделей не загрузился

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

Карточка DeepSeek в dsh — не для 1APP

Встроенный поставщик DeepSeek всегда берёт адрес и каталог моделей из своей поставки, даже если поменять base URL. Поэтому 1APP добавляется именно как Custom model API, а не через карточку DeepSeek.

Шаг 4: Проверка ​

  1. В поле модели выберите deepseek-v4-pro или deepseek-v4.1-flash.
  2. Отправьте задачу, например: «Кратко опиши структуру этого репозитория».
  3. Если приходит ответ — ключ, адрес и группа настроены верно.

Выбранная модель становится моделью по умолчанию для новых сессий; текущая сессия сохраняет модель, с которой начиналась.

Дополнительные настройки ​

Настройки Web UI пишутся в ~/.dsh/profiles/web/cordis.patch.yml (<profile> = web при стандартном запуске). Тот же файл можно открыть кнопкой Open configuration file в шапке настроек, если браузер работает на той же машине, что и сервер. Изменения применяются на следующем запросе, перезапуск не нужен.

Пример ручной настройки поставщика:

yaml
- id: llm-pi-ai
  config:
    providers:
      1app:
        api: openai-completions
        baseURL: https://1app.ru/v1
        apiKeyEnv: ONEX_API_KEY   # имя переменной окружения с вашим ключом
        models:
          - id: deepseek-v4-pro
          - id: deepseek-v4.1-flash

Проще не писать ключ в файл вручную, а один раз сохранить его в Web UI — тогда dsh держит секрет отдельно (в ~/.dsh/.credentials.yaml), а в настройках остаётся только ссылка на него.

Уровни рассуждений. Меню Effort появляется только у модели, для которой уровни объявлены. Модели, добавленные вручную, уровней не объявляют — их задают в cordis.patch.yml; пока уровней нет, действует значение по умолчанию эндпоинта.

Картинки. Модель принимает изображения, только если у неё объявлена модальность image. Модели 1APP по умолчанию считаются текстовыми; для работы с изображениями укажите input: [text, image] у модели и убедитесь, что выбранная модель действительно поддерживает изображения.

Застряли? ​

  • 401 / неверный токен → ключ введён с ошибкой или лишними пробелами; проверьте, что он вида sk-xxxx (подробнее).

  • 404 / неверный интерфейс → в Base URL должно быть https://1app.ru/v1, протокол — OpenAI Chat Completions.

  • Нет доступного канала → модель не входит в группу токена: создайте токен в подходящей группе (Выбор группы, подробнее).

  • Список моделей пуст → добавьте идентификаторы вручную: deepseek-v4-pro, deepseek-v4.1-flash.

  • Сервер отвергает role: developer или поле max_completion_tokens → включите совместимость в cordis.patch.yml у своего поставщика. Блок compat добавляется внутрь существующего блока 1app, остальные его поля (адрес, протокол, модели, ключ) не переписывайте:

    yaml
    - id: llm-pi-ai
      config:
        providers:
          1app:
            compat:
              supportsDeveloperRole: false
              maxTokensField: max_tokens
  • Недостаточно средств → исчерпана квота токена или баланс аккаунта (подробнее).

  • Модель не отвечает после смены в настройках → начните новую сессию: активная сессия держит модель, записанную в её журнале.

Остальные случаи — в разделе Частые ошибки.