Каркас DeepSeek

Обзор

DeepSeek Harness (dsh) — это разрабатываемая с открытым исходным кодом оболочка AI-агента, созданная DeepSeek AI. Она использует архитектуру «всё является плагином», позволяющую компоновать модели, инструменты, файловые системы, терминалы, сессии и рабочие процессы в расширяемую среду выполнения агента. С APIYI вы можете запускать DeepSeek Harness локально и использовать совместимый с OpenAI эндпоинт APIYI для настройки моделей, выполнения задач разработки и поддержки постоянных сессий.

🧩 Архитектура на основе плагинов

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

🌐 Веб-интерфейс

Запускайте локальный веб-интерфейс одной командой и настраивайте модели, рабочие пространства и сессии в браузере.

⌨️ CLI без графического интерфейса

Отправляйте разовые задачи из командной строки для скриптов автоматизации, пакетных заданий и рабочих процессов разработки.

💾 Постоянные сессии

Сохраняйте сессии, вызовы инструментов и состояние рабочего пространства, чтобы продолжать выполнение задач и устранять неполадки при выполнении.

Информация о проекте: DeepSeek Harness распространяется с открытым исходным кодом по лицензии MIT. Репозиторий проекта находится по адресу github.com/deepseek-ai/deepseek-harness. В настоящее время проект находится на этапе предварительной версии для разработчиков, поэтому будущие выпуски могут содержать несовместимые изменения.

Установка и запуск

Запуск веб-интерфейса с помощью npm

Установите Node.js, затем выполните:

npx @deepseek-ai/dsh web

После запуска сервера откройте http://127.0.0.1:3080. При первом запуске настройте APIYI в разделе настроек модели веб-интерфейса.

Запуск из исходного кода

Чтобы запустить исходный код репозитория или внести вклад в проект:

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

Использование безграфического CLI

После сборки из исходного кода отправьте разовую задачу с помощью:

pnpm dsh --profile headless "Inspect the repository and explain the failing tests."

Подключение APIYI

DeepSeek Harness поддерживает встроенный маршрут DeepSeek и маршруты нескольких провайдеров на основе llm-pi-ai. В текущей конфигурации используются провайдер apiyi, протокол openai-responses и эндпоинт https://api.apiyi.com/v1. Модель по умолчанию — deepseek-v4-pro-0813. Файл конфигурации — $DSH_HOME/settings.yaml. Если DSH_HOME не задан, расположением по умолчанию в Windows обычно является C:\Users\Administrator\.dsh\settings.yaml.

Вариант 1: настройка через веб-интерфейс (рекомендуется)

Подготовьте token APIYI

Создайте token в консоли APIYI. Никогда не сохраняйте настоящий token в файле проекта, истории командной строки или общедоступном журнале.

Откройте настройки моделей

Запустите веб-интерфейс, откройте Настройки → Модели и выберите Добавить пользовательского провайдера.

Введите сведения о провайдере

Используйте следующие значения в качестве отправной точки:

Поле	Рекомендуемое значение
ID провайдера	`apiyi`
Отображаемое имя	`apiyi`
Базовый URL	`https://api.apiyi.com/v1`
Протокол API	`openai-responses`
Ссылка на учетные данные	`APIYI_API_KEY`
Модель	`deepseek-v4-pro-0813`

В текущей конфигурации в качестве модели по умолчанию используется deepseek-v4-pro-0813. В файле конфигурации также сохранены другие модели APIYI; при переключении моделей используйте актуальный список моделей APIYI.

Сохраните настройки и выберите модель

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

При сохранении ключа через веб-интерфейс DeepSeek Harness сохраняет его в локальном хранилище учетных данных и возвращает странице только скрытое описание. Изменения конфигурации вступают в силу при следующем запросе и обычно не требуют перезапуска веб-интерфейса.

Вариант 2: настройка settings.yaml

Для настройки на основе файла объявите провайдера APIYI в $DSH_HOME/settings.yaml и укажите token через переменную окружения:

llm-pi-ai:
  providers:
    apiyi:
      displayName: apiyi
      apiKeyEnv: APIYI_API_KEY
      api: openai-responses
      baseURL: https://api.apiyi.com/v1
      models:
        - id: deepseek-v4-pro-0813

macOS или Linux:

export APIYI_API_KEY=YOUR_API_KEY

Windows PowerShell:

$env:APIYI_API_KEY = "YOUR_API_KEY"

apiKeyEnv — это только ссылка на учетные данные. Не помещайте настоящий token в settings.yaml. Чтобы добавить другую модель, добавьте ее ID в список models.

Распространённые сценарии использования

Локальный веб-агент

Используйте веб-интерфейс в браузере для анализа кода, организации файлов, отладки тестов и обслуживания проектов. Выберите рабочую область для сеанса, затем опишите цель и ограничения на естественном языке.

Автоматизированные задачи

Профиль без интерфейса выполняет одну задачу и выводит итоговый ответ, что делает его подходящим для локальных скриптов и рабочих процессов автоматизации:

pnpm dsh --profile headless "Review the changed files and summarize possible regressions."

Python SDK

DeepSeek Harness предоставляет deepseek-harness-sdk, который может запускать среду выполнения и вызывать агент из Python. Обратите внимание, что встроенная среда выполнения Python по умолчанию использует deepseek-official; она автоматически не наследует маршрут apiyi, используемый текущей конфигурацией веб-интерфейса/профиля без интерфейса.

python -m pip install deepseek-harness-sdk

from deepseek_harness import DeepSeekHarness

with DeepSeekHarness(
    provider="apiyi",
    model="deepseek-v4-pro-0813",
    cwd="/absolute/path/to/workspace",
    session_root="/absolute/path/to/sessions",
    cordis="/absolute/path/to/apiyi.cordis.yml",
) as harness:
    result = harness.run(
        "Inspect the repository and summarize the failing tests.",
        session_id="example-001",
    )

print(result.final_response)

Чтобы использовать указанный выше маршрут apiyi, пользовательская композиция Cordis должна подключить @deepseek-ai/dsh-llm-pi-ai и предоставить apiKeyEnv: APIYI_API_KEY, api: openai-responses и список моделей APIYI через settings.yaml или конфигурацию композиции. В руководстве по Python SDK для встроенной композиции постоянного терминала указаны Linux x64, Linux arm64 и macOS 14 или более поздней версии на arm64. Эта композиция не поддерживает агентов Windows. Пользователям Windows рекомендуется использовать веб-интерфейс или CLI.

Выбор модели

Модели APIYI постоянно обновляются. Перед выбором модели для рабочего использования ознакомьтесь с последним списком моделей, их возможностями и рекомендациями по использованию:

Просмотреть последние рекомендации по моделям

Ознакомьтесь с актуальными рекомендациями по моделям, сравнением возможностей и руководством по использованию. Используйте идентификаторы моделей, доступные в текущем списке моделей APIYI.

Лучшие практики

Используйте отдельный идентификатор сеанса для каждой независимой задачи. Повторно используйте существующий идентификатор только тогда, когда необходимо продолжить тот же разговор и сохранить состояние оболочки.
В примере Python SDK используется доступное для записи рабочее пространство и композиция danger-full-access. Запускайте его в одноразовой рабочей копии или контейнере.
Не размещайте ключи API в cordis.yml, settings.yaml, исходном коде или журналах коммитов. Предпочтительно использовать хранилище учетных данных веб-интерфейса или ссылку на переменную окружения.
DeepSeek Harness находится на этапе предварительной версии для разработчиков. Перед обновлением убедитесь, что конфигурация вашего плагина и маршруты моделей остаются совместимыми.

Часто задаваемые вопросы

Какой провайдер и модель используются в текущей конфигурации?

В текущей конфигурации используются провайдер apiyi, протокол openai-responses, базовый URL https://api.apiyi.com/v1 и deepseek-v4-pro-0813 в качестве модели по умолчанию.

Какой базовый URL и протокол следует использовать для APIYI?

Используйте https://api.apiyi.com/v1 в качестве базового URL и openai-responses в качестве протокола в соответствии с текущей конфигурацией. Не изменяйте протокол, не подтвердив совместимость эндпоинта.

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

Убедитесь, что идентификатор провайдера содержит непустое значение в нижнем регистре, идентификатор модели указан правильно, а сохранённая конфигурация относится к провайдеру llm-pi-ai. Текущая модель по умолчанию — deepseek-v4-pro-0813; пользовательскую модель необходимо добавить в список models, прежде чем её можно будет выбрать.

Как исправить ошибку MISSING_CREDENTIAL?

В веб-интерфейсе перейдите в Настройки → Модели и сохраните учетные данные для провайдера. При использовании settings.yaml убедитесь, что задано APIYI_API_KEY и что apiKeyEnv указывает на эту переменную окружения.

Что делать, если обнаружение моделей возвращает ошибку 401?

Сначала проверьте token APIYI и базовый URL. DeepSeek Harness использует GET /models для обнаружения моделей у пользовательских провайдеров, совместимых с OpenAI. Если эндпоинт не предоставляет этот маршрут, введите идентификатор модели вручную.

Можно ли запускать Python SDK в Windows?

Встроенная конфигурация persistent-terminal не поддерживает агентов Windows. Пользователи Windows могут использовать веб-интерфейс или CLI; для Python SDK соблюдайте требования к платформе, указанные в документации проекта.

Что делать, если обновление нарушило конфигурацию?

Проект находится на стадии предварительной версии для разработчиков, поэтому обновления могут содержать критические изменения. Повторно проверьте конфигурацию провайдера, идентификатор модели и состав плагинов по последней документации проекта.

Связанные ресурсы

Краткое руководство APIYI

Получите ключ API и узнайте о базовых URL и основном использовании API.

Репозиторий DeepSeek Harness

github.com/deepseek-ai/deepseek-harness

Настройка провайдера DeepSeek Harness

Ознакомьтесь с документацией проекта по настройке провайдера, учётных данных и модели.

Получить помощь

Поддержка в корпоративном WeChat

Отсканируйте код, чтобы добавить поддержку, или свяжитесь с поддержкой напрямуюКонфигурация APIYI, интеграция DeepSeek Harness и рекомендации по использованию

Поддержка по электронной почте

Поддержка: [email protected]Деловые запросы: [email protected]

При обращении в поддержку укажите провайдера, идентификатор модели, базовый URL, протокол API, сообщение об ошибке, версию Node.js, режим использования и соответствующие снимки экрана, чтобы проблему можно было быстрее диагностировать.

Обзор

Разговорный ИИ

Программирование

Вклад сообщества

AI-агент

Инженерия

Перевод

Обзор

🧩 Архитектура на основе плагинов

🌐 Веб-интерфейс

⌨️ CLI без графического интерфейса

💾 Постоянные сессии

Установка и запуск

Запуск веб-интерфейса с помощью npm

Запуск из исходного кода

Использование безграфического CLI

Подключение APIYI

Вариант 1: настройка через веб-интерфейс (рекомендуется)

Вариант 2: настройка settings.yaml

Распространённые сценарии использования

Локальный веб-агент

Автоматизированные задачи

Python SDK

Выбор модели

Просмотреть последние рекомендации по моделям

Лучшие практики

Часто задаваемые вопросы

Связанные ресурсы

Краткое руководство APIYI

Рекомендации по моделям APIYI

Репозиторий DeepSeek Harness

Настройка провайдера DeepSeek Harness

Получить помощь

Поддержка в корпоративном WeChat

Поддержка по электронной почте

​Обзор

🧩 Архитектура на основе плагинов

🌐 Веб-интерфейс

⌨️ CLI без графического интерфейса

💾 Постоянные сессии

​Установка и запуск

​Запуск веб-интерфейса с помощью npm

​Запуск из исходного кода

​Использование безграфического CLI

​Подключение APIYI

​Вариант 1: настройка через веб-интерфейс (рекомендуется)

​Вариант 2: настройка settings.yaml

​Распространённые сценарии использования

​Локальный веб-агент

​Автоматизированные задачи

​Python SDK

​Выбор модели

Просмотреть последние рекомендации по моделям

​Лучшие практики

​Часто задаваемые вопросы

​Связанные ресурсы

Краткое руководство APIYI

Рекомендации по моделям APIYI

Репозиторий DeepSeek Harness

Настройка провайдера DeepSeek Harness

​Получить помощь

Поддержка в корпоративном WeChat

Поддержка по электронной почте

Обзор

Установка и запуск

Запуск веб-интерфейса с помощью npm

Запуск из исходного кода

Использование безграфического CLI

Подключение APIYI

Вариант 1: настройка через веб-интерфейс (рекомендуется)

Вариант 2: настройка settings.yaml

Распространённые сценарии использования

Локальный веб-агент

Автоматизированные задачи

Python SDK

Выбор модели

Лучшие практики

Часто задаваемые вопросы

Связанные ресурсы

Получить помощь