Оформление
Подключение 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 как поставщика моделей
- Откройте Settings → Models.
- Нажмите Add model provider и переключите карточку на Custom model API.
- Заполните поля:
| Поле | Что вписать |
|---|---|
| Provider ID | 1app — строчными буквами; менять потом нельзя |
| Display name | 1APP (произвольное) |
| Base URL | https://1app.ru/v1 |
| API protocol | OpenAI Chat Completions |
| API key | sk-xxxx — ваш токен 1APP |
| Models | deepseek-v4-pro, deepseek-v4.1-flash |
- В блоке Model catalog нажмите Fetch available models —
dshзапросит список моделей у 1APP по введённым адресу и ключу. Отметьте нужные и нажмите Update list. - Сохраните поставщика.
Если список моделей не загрузился
Автоподбор — удобство, а не гарантия: часть шлюзов отвечает в неожиданном формате. Добавьте идентификаторы моделей вручную — они работают так же. Актуальный список — в Консоли и в каталоге моделей.
Карточка DeepSeek в dsh — не для 1APP
Встроенный поставщик DeepSeek всегда берёт адрес и каталог моделей из своей поставки, даже если поменять base URL. Поэтому 1APP добавляется именно как Custom model API, а не через карточку DeepSeek.
Шаг 4: Проверка
- В поле модели выберите
deepseek-v4-proилиdeepseek-v4.1-flash. - Отправьте задачу, например: «Кратко опиши структуру этого репозитория».
- Если приходит ответ — ключ, адрес и группа настроены верно.
Выбранная модель становится моделью по умолчанию для новых сессий; текущая сессия сохраняет модель, с которой начиналась.
Дополнительные настройки
Настройки 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Недостаточно средств → исчерпана квота токена или баланс аккаунта (подробнее).
Модель не отвечает после смены в настройках → начните новую сессию: активная сессия держит модель, записанную в её журнале.
Остальные случаи — в разделе Частые ошибки.