Конфигурация модели 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
Azureapi-version
CodexOAuth

Добавить пользовательский провайдер

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

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

FieldsОписаниеОбязательно?
ID провайдераПостоянный идентификатор в нижнем регистреОбязательный
Отображаемое имяИмя, отображаемое в пользовательском интерфейсеOptional
Базовый URLbaseURL конечной точкиОбязательный
Протокол 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 из списка, который предоставляет ей возможности работы с изображениями, и запустите новый сеанс.
Другие расширения