Конфигурация модели DeepSeek Harness
DeepSeek Harness может использовать официальную конфигурацию DeepSeek или сторонние модели.
| Тип провайдера | Что это | Требования к учётным данным | Применимые сценарии |
|---|---|---|---|
| DeepSeek | Официальный эндпоинт DeepSeek | Ключ API DeepSeek (только для записи) | По умолчанию — самый быстрый способ начать работу |
| Провайдер из каталога | Провайдеры в установленном каталоге, например Anthropic, OpenAI | Ключи API для каждого провайдера; нативная аутентификация требует соответствующих учётных данных. | Подключение к уже включённым популярным вендорам |
| Пользовательский провайдер | Самостоятельно размещённые эндпоинты, например корпоративные шлюзы или собственные серверы. | ID провайдера, baseURL, протокол, учётные данные, модель | Эндпоинты отсутствуют в каталоге |
Откройте http://127.0.0.1:3080/. Весь интерфейс выглядит так. Сначала можно нажать Настройки, чтобы настроить API-ключ:

Если у вас ещё нет API-ключа, вы можете перейти наhttps://platform.deepseek.com/api_keysподать заявку.
Затем откройте Настройки → Модели. На карточке DeepSeek есть поле ввода API-ключа. Введите его и сохраните.

Добавить провайдера из каталога
Провайдеры из каталога получают эндпоинты, протоколы и списки моделей из установленного каталога dsh.
Выберите «Добавить провайдера», выберите провайдера, например Anthropic или OpenAI, введите его API-ключ и сохраните.
Установленный каталог автоматически предоставляет эндпоинты, протоколы и списки моделей; ручной ввод не требуется.

Например, мы настроили пакет coding plan от Zhipu:

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

Провайдеры, использующие нативную аутентификацию, требуют собственных нативных учётных данных; заполнение только поля API-ключа не завершит настройку.
| Provider | Обязательные нативные учетные данные |
|---|---|
| Bedrock | Учетные данные AWS и регион |
| Вершина | Проект ADC |
| Azure | api-version |
| Codex | OAuth |
Добавить пользовательский провайдер
Для конечных точек, которых нет в каталоге, таких как корпоративные шлюзы или самостоятельно размещенные серверы, используйте пользовательский провайдер.

Выберите «Добавить пользовательский провайдер» и заполните следующие поля.

| Fields | Описание | Обязательно? |
|---|---|---|
| ID провайдера | Постоянный идентификатор в нижнем регистре | Обязательный |
| Отображаемое имя | Имя, отображаемое в пользовательском интерфейсе | Optional |
| Базовый URL | baseURL конечной точки | Обязательный |
| Протокол API | например, openai-completions | Обязательный |
| Учётные данные | Ссылка на ключ API или переменную окружения | Обязательный |
| Модель | Как минимум одна модель | Обязательный |
Provider ID является постоянным, поскольку запросы, сохранённые сеансы, модели по умолчанию и ссылки на учётные данные используют его.
Если нужно переименовать провайдера, добавьте нового провайдера и удалите старого.
Отображаемое имя, базовый URL, протокол, учётные данные и модели остаются редактируемыми.
Выберите "fetch available models" в каталоге моделей, чтобы запросить базовый URL и учётные данные, отображаемые в данный момент в форме.
Выбор кандидата обновляет только черновик; провайдер не сохраняется до сохранения.
Провайдеры каталога используют установленный каталог и не выполняют сетевые запросы.
Ввод изображений: объявите модальность для визуальных моделей
Модели, введённые вручную, по умолчанию считаются текстовыми; чтобы поддерживать изображения, необходимо явно объявить это.
Поскольку ни одна часть процесса не может запросить у эндпоинта, какие модальности он принимает, dsh использует стратегию «сначала объявить, затем использовать».
Прикрепление изображений к таким моделям будет отклонено до отправки, и модель будет названа.
Визуальные модели у пользовательского провайдера требуют дополнительной строки; в форме нет соответствующего поля.
Пожалуйста, добавьте input для этой модели в $DSH_HOME/settings.yaml.
# 文件路径:$DSH_HOME/settings.yaml
# 顶层键 llm-pi-ai 是模型路由插件的 id,providers 下按提供方 id 组织
llm-pi-ai:
providers:
my-gateway:
apiKeyEnv: GATEWAY_API_KEY # 凭据引用:从 GATEWAY_API_KEY 环境变量读取
api: openai-completions # API 协议:OpenAI 兼容的补全协议
baseURL: https://gateway.example.example/v1 # 你的网关端点
models:
- id: legacy-chat # 纯文本模型,不写 input 即按纯文本对待
- id: vision-preview # 视觉模型
input: [text, image] # 声明同时接受文本与图片
input принимает text и image и применяется только к этой модели, поэтому один маршрут может обслуживать оба типа моделей.
Его пропуск или указание пустого списка равнозначны.
В этом случае сохраните модальность, записанную в установленном каталоге для этой модели; модели, не описанные в каталоге, используют defaultInput маршрута.
Если все ваши введённые вручную модели принимают изображения, вы можете один раз задать резервное значение на маршруте.
# 文件路径:$DSH_HOME/settings.yaml
# defaultInput 是回退值而不是覆盖值,默认为 [text]
llm-pi-ai:
providers:
vision-gateway:
apiKeyEnv: GATEWAY_API_KEY
api: openai-completions
baseURL: https://vision.example.example/v1
defaultInput: [text, image] # 对本路由下目录未描述的模型生效
models:
- id: first-model
- id: second-model
Чтобы сузить модальность модели у провайдера каталога, укажите её в modelOverrides с ключом по id модели.
# 文件路径:$DSH_HOME/settings.yaml
# 目录提供方没有可填写的 models 列表,覆盖走 modelOverrides
llm-pi-ai:
providers:
anthropic:
modelOverrides:
claude-sonnet-4-5:
input: [text] # 把该模型的图片能力去掉
input и defaultInput — это утверждения о вашем эндпоинте, а не проверки его.
Модель, которая объявляет возможности работы с изображениями, фактически не предоставляемые эндпоинтом, не будет заблокирована здесь; вместо этого провайдер отклонит запрос.
Таблица устранения неполадок
Когда конфигурация модели оказывается неверной, dsh выдает понятные сообщения об ошибках. Используйте таблицу ниже для устранения неполадок.
| Ошибка | Значение | Властвуй |
|---|---|---|
| MISSING_CREDENTIAL | Отсутствует ключ провайдера | Сохраните ключ провайдера через страницу Models или предоставьте указанную переменную окружения. |
| UNKNOWN_MODEL | Запрошенная модель не настроена | Выберите настроенную модель или добавьте отсутствующую модель в пользовательский провайдер. |
| Получение доступных моделей возвращает 401 | Ключ недействителен, или эндпоинт не поддерживает обнаружение моделей. | Проверьте ключ; обнаружение моделей вызывает OpenAI-совместимый GET /models. Для сервисов, которые не предоставляют этот эндпоинт, введите модель вручную. |
| Изображение отклонено перед отправкой | Модель не объявляет модальность изображения | Добавьте input: [text, image] к моделям пользовательского провайдера; собственные маршруты DeepSeek работают только с текстом и не могут быть изменены через конфигурацию. |
| Провайдер отклонил запрос с изображениями | Модель объявляет возможности работы с изображениями, которые эндпоинт фактически не предоставляет. | Удалите image из списка, который предоставляет ей возможности работы с изображениями, и запустите новый сеанс. |