Учебник по DeepSeek Harness

Кому следует читать это руководство?

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

• Разработчики / инженерыДля тех, кто хочет локального AI-ассистента для программирования, границы возможностей которого полностью контролируемы, а каждый компонент можно заменить или перекомбинировать, — а не чёрный ящик, зафиксированный вендором на фиксированной функциональности.

• Специалисты по AI/MLДля тех, кто интересуется архитектурой Agent: в её основе лежит плагинная система Cordis, событийно-ориентированный дизайн подкреплён академическими статьями, а паттерн PTC позволяет моделям составлять многошаговые вызовы инструментов с помощью программ на TypeScript.

• Энтузиасты инструментов для эффективности: Для тех, кто хочет встроить Agent в свой рабочий процесс с помощью графического интерфейса Web UI, headless-командной строки или Python SDK.

• Исследователи: Нужны наблюдаемые агенты — каждый запуск записывается в журналы сессий, доступные только для добавления, при этом системные промпты, цепочки рассуждений, вызовы инструментов и планирование субагентов можно просматривать в представлении Trajectory.

• Пользователи, ценящие open source и контролируемостьОткрытая лицензия MIT, свободная композиция на уровне конфигурации, без телеметрии, без облачной привязки, полностью под собственным контролем.

Предварительные навыки перед чтением

Этот учебникНе требуетопыта в исследованиях AI или глубоких знаний в машинном обучении. Вам нужно иметь:

Требования к операционной системе: Linux, macOS или Windows (можно запускать после установки Node.js).

Основные возможности

Возможности DeepSeek Harness:

• 🧩 Всё — это плагин— Ядро Cordis занимается только загрузкой, выгрузкой плагинов и управлением зависимостями; все возможности, такие как модели, инструменты, навыки, сессии, песочница, хранилище, циклы, планирование и UI, предоставляются плагинами, которые взаимодействуют через сервисы и события, со свободной композицией на уровне конфигурации

• 📜 Отслеживаемое выполнение— Всё, что видит модель (системные подсказки, цепочки рассуждений, вызовы инструментов и результаты, планирование субагентов, инъекция контекста), записывается в журналы сессий, доступные только для добавления; представление Trajectory отображает по источнику, а возобновление, форк, извлечение и воспроизведение совместно используют один и тот же поток событий

• 🛠️ Четыре режима работы— Стандартный режим (полнофункциональный агент для программирования), режим PTC (модель объединяет несколько раундов вызовов инструментов с помощью программы на TypeScript), минимальный режим (два инструмента, для бенчмаркинга моделей), творческий режим (проверки во время выполнения + эксперименты с плагинами + создание пользовательских пресетов)

• 🌐 Использование в нескольких формах— Веб-интерфейс (по умолчанию http://127.0.0.1:3080), headless (запуск один раз, вывод окончательного ответа и выход), CLI, Python SDK, TypeScript SDK

• 🔌 Богатые инструменты и расширения— Редактирование файлов, Shell, поиск по файлам и в вебе, навыки, планирование, цели, субагенты, рабочие процессы; управляемые событиями точки расширения (события трёх уровней: сессия/Агент/возможность), любую возможность можно заменить патчами

• 🔒 Открытый и управляемый— Открытый исходный код MIT; многоуровневая конфигурация Profile + composition package,dsh --profile web --dump-configПросмотр полного дерева конфигурации фактического запуска; непривилегированное ядро, все регистрации обратимы

• 🤖 Не зависит от модели— Укажите ключ API DeepSeek — и можно пользоваться; поддерживаются другие провайдеры и пользовательские эндпоинты, совместимые с OpenAI; маршрутизация моделей без перезапуска

• 🔬 Готов к исследованиям— Полностью наблюдаемый поток событий и дерево конфигурации, открытый дизайн для исследований архитектуры агентов (в основе Cordis лежат академические статьи)

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

Официальные ресурсы