Руководство по агентам Flaq AI

Практическое руководство по использованию DeepSeek Harness с OpenAI-совместимым API Flaq AI

Запустите веб-интерфейс открытого проекта DeepSeek Harness с OpenAI-совместимой конечной точкой Flaq AI, а затем подключите поддерживаемую модель DeepSeek v4 для анализа репозиториев и задач программирования. DeepSeek Harness следует архитектуре «всё является плагином»: адаптеры моделей, инструменты, агентный цикл, хранилище сеансов, разрешения, песочницы, телеметрия и веб-интерфейс можно компоновать или заменять с помощью плагинов и конфигурации.

Руководства по агентам

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1DeepSeek Harness/api/v1ZCode/api/v1

Установка

Запуск DeepSeek Harness

Для DeepSeek Harness требуется Node.js 22.19+ или версия 24+. Запустите его из каталога проекта, который хотите использовать как расположение файловой системы по умолчанию; официальная команда npm по умолчанию запускает веб-интерфейс по адресу http://127.0.0.1:3080.

1

Запуск веб-интерфейса DeepSeek Harness

Используйте официальный пакет npm для запуска веб-интерфейса. Не закрывайте этот терминал во время работы с DeepSeek Harness.

При первом запуске загружается текущий пакет @deepseek-ai/dsh и инициализируется профиль веб-интерфейса.

Официальная команда npm

npx @deepseek-ai/dsh web

Репозиторий: ознакомьтесь с последними инструкциями по установке, выпусками, примечаниями о совместимости и исходным кодом в официальном репозитории DeepSeek Harness на GitHub.

Настройка

Подключение DeepSeek Harness к Flaq AI

Откройте Settings → Models в DeepSeek Harness, добавьте Flaq AI как пользовательского провайдера и введите свой ключ API Flaq. После сохранения Provider ID изменить нельзя, поэтому используйте flaq, если вам намеренно не нужно другое имя маршрута. После сохранения провайдера выберите рабочее пространство, прежде чем начинать сеанс.

Рекомендуемая модель DeepSeek v4 Pro для анализа репозиториев, задач программирования и рабочих процессов, которым полезны более мощные возможности рассуждения.

В Settings → Models выберите Add provider → Add a custom provider. Введите указанные ниже значения и добавьте выбранный ID модели вручную вместо использования Fetch available models. Сохраните провайдера, а затем выберите эту модель для нового сеанса. Модели, введённые вручную, DeepSeek Harness считает исключительно текстовыми, если не объявлены дополнительные модальности.

  • Используйте точный базовый URL Flaq и протокол openai-completions.
  • Замените заполнитель своим ключом API Flaq и оставьте ID модели точно в указанном виде.

Пользовательский провайдер Flaq AI

Provider ID: flaqDisplay name: Flaq AIBase URL: https://api.flaq.ai/api/v1API protocol: openai-completionsCredential / API key: Your_Flaq_Api_KeyModel ID: deepseek-v4-pro-text-to-text

Проверка

Проверка Flaq в DeepSeek Harness

Откройте веб-интерфейс, выберите каталог проекта, в котором вы запустили DeepSeek Harness, выберите настроенную модель Flaq и создайте новый сеанс. Поле ввода остаётся недоступным, пока не выбрано рабочее пространство.

  • DeepSeek Harness выводит активный URL в терминале.
  • Ниже указан локальный адрес по умолчанию.

Открытие веб-интерфейса

http://127.0.0.1:3080
  • Сначала отправьте задачу только для чтения.
  • Обычный ответ, отражающий содержимое выбранного рабочего пространства, подтверждает, что DeepSeek Harness может обращаться к конечной точке Flaq и использовать настроенную модель.

Проверка доступа к репозиторию

Summarize this repository and identify its main packages. Do not modify any files.

Пример плагина

Установка плагина DeepSeek Harness

Используйте DSH OpenPencil как конкретный пример архитектуры DeepSeek Harness «всё является плагином». Завершите описанные выше настройку и проверку провайдера Flaq, остановите работающий веб-интерфейс, затем добавьте плагин в профиль web и перезапустите ту же версию DeepSeek Harness. DSH OpenPencil добавляет инструменты для создания, предварительного просмотра, изучения и редактирования документов дизайна .op непосредственно в диалоге.

1

Установка DSH OpenPencil

Добавьте общедоступный пакет OpenPencil в профиль web, используя версию DeepSeek Harness, с которой плагин сейчас протестирован. Выполните эту команду из того же каталога проекта, который используете для DeepSeek Harness.

Установка DSH OpenPencil

npx --yes -p @deepseek-ai/[email protected] dsh plugin --profile web add @zseven-w/dsh-openpencil@latest

Репозиторий: ознакомьтесь с исходным кодом, требованиями к настройке, выпусками и примечаниями о совместимости в репозитории DSH OpenPencil на GitHub.

2

Перезапуск веб-интерфейса

Снова запустите протестированную версию DeepSeek Harness, чтобы профиль web загрузил DSH OpenPencil. Не закрывайте этот терминал, пока снова открываете веб-интерфейс.

Перезапуск веб-интерфейса

npx --yes -p @deepseek-ai/[email protected] dsh web
3

Проверка DSH OpenPencil с Flaq AI

Выберите настроенную модель Flaq и рабочее пространство, начните новый сеанс и отправьте приведённый ниже запрос. Если двоичный файл OpenPencil доступен, плагин должен создать документ .op и представить в диалоге предварительный просмотр с возможностью редактирования.

Проверка DSH OpenPencil с Flaq AI

Create a simple editable OpenPencil document with a title, a subtitle, and two feature cards. Save it as openpencil-demo.op, then render an editable preview.

Открытый исходный код

Знакомство с официальным репозиторием DeepSeek Harness

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

DeepSeek Harness на GitHub

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

Руководство по открытому исходному коду

Знакомство с открытым руководством Flaq AI по DeepSeek Harness

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

Руководство по DeepSeek Harness на GitHub

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

Устранение неполадок

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

Использование этой настройки из руководства может значительно увеличить расход токенов.

Обсуждения DeepSeek Harness в X (Twitter)

Изучите обсуждения разработчиков и первых участников о DeepSeek Harness (DSH) — агентной платформе с открытым исходным кодом, включая её архитектуру «всё является плагином», компонуемую среду выполнения, экосистему плагинов и практический опыт использования.