Запрос конфигурация плагинов DeepSeek Harness представляет собой задачу по проверке, а не повод копировать фрагменты YAML. DeepSeek Harness — стороннее программное обеспечение с открытым исходным кодом. В официальном описании проекта он назван предварительной версией для разработчиков и содержится предупреждение об ожидаемых изменениях, нарушающих совместимость. Актуальная запись в официальном каталоге конфигурации надёжнее старого примера развёртывания.
В этой статье рассматриваются группы конфигурации, зависимости, значения по умолчанию, проверка и ограничения на работу с секретами. Она не описывает интеграцию OdiRouter или поддерживаемую функцию. OdiRouter — независимая платформа, упомянутая для русскоязычной аудитории.
Начните с каталога и пакета-владельца
Официальный каталог охватывает каждый блок config:, который запись cordis.yml может задавать для загружаемого пакета фреймворка. Он генерируется из исходного кода. Во введении указано, что генератор проверяет, можно ли найти в объявленном типе конфигурации ключи, валидируемые схемой во время выполнения, включая вложенные ключи.
Это задаёт для проверки две границы. Документированное объявление — отправная точка для изменения YAML. Поле, исключённое из схемы времени выполнения, предназначено только для времени выполнения, а не является настройкой, которую следует принудительно добавлять в cordis.yml. Строка Requires: является операционным свидетельством: дерево конфигурации должно загрузить именованные службы до того, как зависимый плагин сможет работать.
Для получения актуального списка полей используйте заголовок пакета и ссылку на его исходный код. Краткое руководство не может заменить каталог, пока проект меняется в статусе предварительной версии для разработчиков.
Проверяйте группы по их операционному назначению
Маршрут модели и политика запросов
@deepseek-ai/dsh-agent-default-model объявляет обязательные поля provider и model. В каталоге первый обозначен как зарегистрированный маршрут, а второй — как идентификатор модели, принадлежащий этому маршруту. Проверьте их с помощью выбранного адаптера, вместо того чтобы предполагать, что знакомая модель работает на каждом маршруте.
Запись @deepseek-ai/dsh-llm-deepseek документирует apiKeyEnv, baseURL, thinking, reasoningEffort, maxTokens, defaultContextWindow, models, streamIdleTimeoutMs и retryPolicy. Если reasoningEffort отсутствует, в каталоге high указано как значение по умолчанию; off, low, high и max являются документированными значениями. Эти настройки описывают плагин. Они не гарантируют доступность модели через другой продукт или конечную точку.
Инструкции для агента, указания по работе в рабочей области и системное приглашение.
@deepseek-ai/dsh-agent-loop имеет список maxParallelToolCalls и список agents. В его записи в каталоге указано, что 1 является последовательным и что при отсутствии используется объявленное значение по умолчанию. Рассматривайте параллелизм как решение по безопасности и пропускной способности для каждого инструмента, а не как универсальный регулятор скорости.
@deepseek-ai/dsh-agent-instructions отвечает за загрузчик инструкций рабочего пространства. Его текущие поля включают dshHome, projectRootMarkers, maxBytes, maxSourceBytes, instructionFileCandidates и localInstructionFileCandidates. Ограничения на количество байтов изменяют материал, доступный модели, поэтому фиксируйте любое изменение и его причину. Отдельная запись @deepseek-ai/dsh-system-prompt охватывает includeHarnessIdentity, includeRuntimeContext, persona и toolOrder.
Навыки, инструменты и локальное выполнение
Каталог распределяет ответственность между навыками и инструментами. @deepseek-ai/dsh-skill-filesystem охватывает локальное обнаружение и поведение при отслеживании изменений. @deepseek-ai/dsh-tools определяет, как зарегистрированные инструменты представляются модели, и включает maxParallelSubCalls. @deepseek-ai/dsh-bash-local предоставляет cwd, timeoutMs, maxTimeoutMs, maxOutputBytes, maxSpillBytes и graceMs для ограничений ресурсов и жизненного цикла.
Перед включением изменения проверьте корни файловой системы, поведение при перезагрузке, ограничения вывода и поведение при тайм-ауте в целевой среде. Протестируйте успешный вызов и ограниченный сценарий сбоя.
Проверьте значения по умолчанию и зависимости перед редактированием.
Каталог содержит сведения о заявленной конфигурации, расположениях исходного кода и требованиях к сервисам. Он не является гарантией совместимости. Для каждого изменённого ключа укажите имя пакета, имя поля, тип, необязательность, задокументированное значение по умолчанию, ссылку на исходный код и сервисы, перечисленные в Requires:.
Эта схема предназначена для проверки, а не является развёртываемым файлом или шаблоном секретов:
provider: <registered-provider-route>
model: <provider-owned-model-id>
reasoningEffort: high
maxParallelToolCalls: 1
apiKeyEnv: DEEPSEEK_API_KEYОткройте запись пакета, прежде чем использовать значение. Загрузчик, установленные пакеты, регистрации сервисов и политика среды определяют, будет ли декларация работать в конкретном развёртывании.
Не храните учётные данные в файлах конфигурации.
В @deepseek-ai/dsh-credentials-local описаны локальный документ с учётными данными и его поведение при перезагрузке. В @deepseek-ai/dsh-llm-deepseek, apiKeyEnv представляет собой ссылку на переменную окружения с документированным значением по умолчанию DEEPSEEK_API_KEY. Плагин поиска DeepSeek также рекомендует использовать apiKeyEnv вместо указания прямого ключа в конфигурации.
Используйте менеджер секретов или уровень доверенной среды. В примечаниях к обзору, примерах, сравнениях и запросах в службу поддержки указывайте только имя переменной или её скрытое значение. Не помещайте секрет непосредственно в cordis.yml. Поле конфигурации может указывать, где разрешаются учётные данные, но не служит доказательством того, что учётные данные должны находиться в файле конфигурации.
Небольшая проверка перед развёртыванием
Зафиксируйте пакет, URL каталога, ревизию репозитория и контекст релиза. Перепроверенный HEAD репозитория —
99f6f02fecdb7dff40c3fbc9470f5907c29f74ca; перепроверенная предварительная версия —dsh-v0.1.0-rc.7, опубликованная в 2026-08-17.Сравните каждый изменённый ключ, включая вложенные ключи, со сгенерированным каталогом: имя, тип, необязательность, значение по умолчанию и расположение исходного кода.
Прочитайте
Requires:перед составлением записи. Корректный объект всё равно не сможет работать без необходимого ему сервиса.Храните значения для развёртывания отдельно от учётных данных, предоставляемых средой. Проверяйте ссылку на переменную, а не значение учётных данных.
Внесите минимально необходимое изменение в контролируемой среде. Проверьте валидацию во время загрузки, разрешение зависимостей и один репрезентативный запрос или путь инструмента. Сохраните запись о результате и плане отката.
Перед последующим развёртыванием повторно проверьте каталог и примечания к выпуску. Предварительная версия может изменить имя поля, тип или значение по умолчанию.
Область действия и источники
Официальный каталог служит подтверждением заявленной конфигурации и связанных расположений исходного кода. официальное описание репозитория служит подтверждением статуса предварительной версии для разработчиков. страница предварительного релиза служит подтверждением проверенной предварительной версии. Ни один из этих источников не гарантирует стабильность, производительность, цены, совместимость, поддержку или доступность модели.
Ни один проверенный источник OdiRouter не устанавливает наличие партнёрства, встроенной интеграции или обязательств по поддержке с DeepSeek Harness. Считайте проекты независимыми. Посетите OdiRouter для ознакомления с его собственной платформой и вернитесь к официальному каталогу и репозиторию за авторитетными сведениями о конфигурации DeepSeek Harness.