DeepSeek Harness: всё — это плагин

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

Средний

Алексей Кузнецов

Системный администратор1 ноября 2026 г.2 мин чтения

git clone https://github.com/deepseek-ai/deepseek-harness.git
 cd deepseek-harness

python3 -m venv venv
 source venv/bin/activate
 pip install --upgrade pip
 pip install -r requirements.txt

ls -la plugins/
 cat plugins/__init__.py
 cat plugins/plugin_base.py

cat > plugins/plugin_example.py << 'EOF'
 from plugins.plugin_base import PluginBase

 @register_plugin
 class ExamplePlugin(PluginBase):
     name = "example"
     description = "Пример простого плагина для DeepSeek Harness"

     def execute(self, input_data: dict) -> dict:
         # Обработка входных данных
         result = {"status": "success", "processed": input_data.get("value", 0) * 2}
         return result
 EOF

cat >> config/plugins.yaml << 'EOF'
 - plugin: plugins.plugin_example.ExamplePlugin
   enabled: true
 EOF

python harness.py --list-plugins
 python harness.py --start

python - << 'EOF'
 from plugins.plugin_example import ExamplePlugin
 plugin = ExamplePlugin()
 output = plugin.execute({"value": 21})
 print(output)
 EOF

git add plugins/plugin_example.py config/plugins.yaml
 git commit -m "Добавить пример плагина"
 git push origin main

DeepSeek Harness: всё — это плагин

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

Предварительные требования

• Git
• Python 3.8+
• pip
• virtualenv

Шаг 1: Клонирование репозитория DeepSeek Harness

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

git clone https://github.com/deepseek-ai/deepseek-harness.git
 cd deepseek-harness

Шаг 2: Настройка виртуального окружения

Создайте виртуальное окружение Python, активируйте его и установите зависимости из файла requirements.txt.

python3 -m venv venv
 source venv/bin/activate
 pip install --upgrade pip
 pip install -r requirements.txt

Шаг 3: Изучение структуры плагинов

В корне проекта находится директория plugins/. В ней определены базовый класс плагина (PluginBase) и декоратор @register_plugin. Изучите эти файлы, чтобы понять интерфейс.

ls -la plugins/
 cat plugins/__init__.py
 cat plugins/plugin_base.py

Шаг 4: Создание простого плагина

Создайте новый файл plugin_example.py в директории plugins/. Плагин должен реализовывать метод execute(), который будет вызываться хостом.

cat > plugins/plugin_example.py << 'EOF'
 from plugins.plugin_base import PluginBase

 @register_plugin
 class ExamplePlugin(PluginBase):
     name = "example"
     description = "Пример простого плагина для DeepSeek Harness"

     def execute(self, input_data: dict) -> dict:
         # Обработка входных данных
         result = {"status": "success", "processed": input_data.get("value", 0) * 2}
         return result
 EOF

Шаг 5: Регистрация плагина в конфигурации

Откройте файл config/plugins.yaml (или аналогичный) и добавьте запись для ExamplePlugin, чтобы хост загружал его при старте.

cat >> config/plugins.yaml << 'EOF'
 - plugin: plugins.plugin_example.ExamplePlugin
   enabled: true
 EOF

Шаг 6: Запуск хоста Harness с новым плагином

Запустите основное приложение (обычно harness.py или main.py). Убедитесь, что плагин загружен и готов к работе.

python harness.py --list-plugins
 python harness.py --start

Шаг 7: Тестирование плагина

Используйте предоставленный CLI или write a small script, чтобы вызвать метод execute плагина и проверить результат.

python - << 'EOF'
 from plugins.plugin_example import ExamplePlugin
 plugin = ExamplePlugin()
 output = plugin.execute({"value": 21})
 print(output)
 EOF

Шаг 8: Деплой плагина в продакшн

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

git add plugins/plugin_example.py config/plugins.yaml
 git commit -m "Добавить пример плагина"
 git push origin main