DSH × Codex Bridge

Соединяем способность Codex принимать решения с исполнительностью DSH.

中文 · English · 安装 · 使用 · 架构

dsh-codex-bridge — это открытая Agent-инфраструктура для разработчиков: Codex отвечает за декомпозицию целей, выбор стратегии делегирования и приёмку результатов; DeepSeek Harness (DSH) отвечает за выполнение кода, тестов и внутренних Sub-Agent задач в указанном Profile; Bridge отвечает за протокол, изолированные рабочие области, жизненный цикл задач и проверяемые артефакты.

Статус проекта

Исходный код доступен｜0.1.0-alpha.1｜замкнутый цикл DSH 0.1.0-rc.8 подтверждён

Текущая версия позволяет собрать проект из исходного кода, инициализировать проект, установить локальный DSH Profile и Codex Plugin, выполнить проверку работоспособности, а также через MCP запускать DSH для выполнения задач в изолированном Worktree. Доказательства замкнутого цикла с реальным Provider сохранены в real-dsh-rc8.json, real-dsh-rc8.patch и real-dsh-rc8-continue.patch.

Текущая форма выпуска — установка из исходного кода; публикация npm-пакета и Marketplace ещё не выполнена. Зафиксированная базовая совместимость для первой версии — DSH 0.1.0-rc.8. DSH находится в статусе Developer Preview, поэтому обновление DSH обязательно должно проходить проверку совместимости и не может основываться только на номере версии.

Related MCP server: agent-rack

Какую проблему это решает?

Когда задача не стоит полного контекста основной модели, Codex может передать её DSH:

Codex（计划 / 委派 / 审查）
        │
        │  Direct Mode：默认、低额外成本
        ▼
本地 MCP Gateway + Task Engine
        │
        ▼
DSH Plugin（Profile / 模型 / 工具 / Sub-Agent）
        │
        ▼
隔离 Worktree → Diff、测试、摘要、Artifact

Bridge не заявляет DSH как нативную модель Codex или нативный Sub-Agent. По умолчанию используется Direct Mode — основной поток Codex напрямую вызывает Bridge MCP; опциональный Native Shell Mode создаёт узкоспециализированный кастомный Agent Codex в качестве диспетчерской оболочки для более близкого к нативному потоку опыта, но дополнительно расходует квоту Codex.

Quickstart за 10 минут (исходный код доступен)

Сейчас используйте путь из исходного кода; npm и Marketplace ещё не опубликованы, не устанавливайте одноимённые пакеты из публичных реестров или каталогов.

Установка из исходного кода (текущий путь разработки)

Предварительные требования: Node.js 22.19+ или 24+, pnpm, Git, работающий DSH 0.1.0-rc.8, Codex CLI или Desktop, а также как минимум один Provider, настроенный в DSH.

git clone https://github.com/HazenSun/dsh-codex-bridge.git
cd dsh-codex-bridge
corepack enable
pnpm install
pnpm build
pnpm dsh-bridge --help

Инициализация, установка и проверка работоспособности:

BRIDGE_PROJECT=/absolute/path/to/your-project
pnpm dsh-bridge init "$BRIDGE_PROJECT" --mode direct
pnpm dsh-bridge install --source . --codex --dsh --mode direct
pnpm dsh-bridge doctor --config "$BRIDGE_PROJECT/bridge.yaml" --json --redacted
pnpm dsh-bridge profiles validate --config "$BRIDGE_PROJECT/bridge.yaml"

Затем в новой сессии Codex вызовите list_profiles, после чего используйте delegate_task для делегирования задачи только на чтение или задачи с небольшой областью реализации. Задачи по умолчанию используют отдельный Git Worktree; основная рабочая область не должна изменяться напрямую.

После установки не нужно запоминать имена инструментов. Просто скажите Codex:

使用 DSH 处理这个任务，自己判断单 Agent 还是多 Agent。

Skill delegate-to-dsh обнаружит доступные Profile, выберет single или multi на основе независимого рабочего процесса и выгоды от проверки, и запишет обоснование и роли в задачу. Явное указание «один Agent» или «несколько Agents» всегда переопределяет автоматическое решение. Многоагентный режим считается пройденным только после того, как в DSH Session наблюдаются достаточные события вызова и завершения Sub-Agent.

Проверка замкнутого цикла с реальным DSH

Эта команда запускает реальный DSH 0.1.0-rc.8 Profile и вызывает Provider, настроенный на текущей машине; это не Fake LLM и не офлайн-симуляция:

pnpm test:e2e:dsh
pnpm test:e2e:model-matrix

Соответствующие доказательства: real-dsh-rc8.json, real-dsh-rc8.patch, real-dsh-rc8-continue.patch и model-matrix.json. Перед запуском необходимо завершить настройку DSH Provider; тест создаёт реальные сетевые/модельные вызовы и проверяет во временном Git Fixture статус задач, маршрутизацию моделей, автоматическое решение одиночный/многоагентный режим, события Sub-Agent, Artifact Hash, продолжение в той же сессии, реальную отмену и неизменность основной рабочей области.

Будущая установка из релиза (npm / Marketplace)

npm-пакет и пакет Codex Plugin Marketplace ещё не опубликованы. Будущее имя пакета, статус ревью, требования к Node runtime и версии DSH определяются официальными Release Notes; для текущей версии не выполняйте глобальные команды установки, не подтверждённые опубликованными инструкциями.

Два режима работы

Оба режима используют общий протокол, Profile, статус задач, Worktree и Artifact; переключение режима не должно менять формат результатов задач.

Навигация по документации

• Полное руководство по установке: окружение, сборка из исходного кода, Direct/Native Shell, границы обновления и удаления.

• Полное руководство по использованию: запуск на естественном языке, одиночный/многоагентный режим, Profile, проверка результатов, продолжение и отмена.

• Введение за 10 минут: от установки из исходного кода до первой проверяемой задачи.

• Справочник по конфигурации: Profile, маршрутизация моделей, рабочая область, параллелизм и стратегии.

• Технический отчёт о реализуемости: доказательства публичных API, границы и M0 PoC.

• План архитектуры ПО: Gateway, Task Engine, DSH Adapter и протокол.

• План реализации и выпуска: вехи, тестирование и Definition of Done.

• Модель безопасности: ключи, пути, сеть, Shell, рекурсия и границы артефактов.

• Устранение неполадок: doctor, MCP, DSH, Provider, Worktree и восстановление.

• Руководство по вкладу: локальная разработка, тестирование, изменения и правила Pull Request.

• Раскрытие уязвимостей: не публикуйте чувствительные детали уязвимостей в открытых Issue.

• Кодекс поведения: стандарты совместной работы, которые мы поддерживаем при участии в проекте.

• Каналы поддержки: куда обращаться по поводу Bug, предложений функций и проблем безопасности.

• Журнал изменений: функции и известные ограничения текущей Alpha.

Текущие ограничения

• Поддерживается только установка из исходного кода; npm-пакет и публичный Codex Plugin Directory ещё не опубликованы.

• Текущая среда выполнения записи поддерживает только изолированный Git Worktree.

• Bridge не выполняет автоматический commit, merge, deploy или публикацию результатов DSH.

• Некоторые политики Profile — сетевые, пути отказа, количество файлов и дисковые политики — остаются декларациями протокола и ещё не полностью отображены в исполнители на стороне Bridge.

• Для детерминированного выполнения на разных моделях следует использовать несколько именованных Profile; принудительная маршрутизация субмоделей на уровне ролей по-прежнему требует DSH Child Setup Contract.

Дизайнерские обязательства

• Protocol first: Codex, DSH и другие будущие Host обмениваются только версионированным JSON, не раскрывая приватные типы Cordis.

• Profile over model: пользователь выбирает семантический Profile; Provider, Model и Reasoning — проверяемые результаты парсинга.

• Safety by default: по умолчанию изолированный Worktree, минимальные привилегии, лимиты ресурсов, возможность отмены и маскирование секретов.

• Codex owns the decision: DSH возвращает доказательства, Codex решает — принять, продолжить, отменить или отказаться.

• Release as one unit: Codex Plugin, DSH Plugin и общий протокол выпускаются синхронно с фиксированными версиями.

Открытая лицензия

Код распространяется под Apache-2.0. Сторонние зависимости, примеры и сам DSH сохраняют свои авторские права и лицензии; перед официальным релизом будут сформированы список лицензий зависимостей, SBOM и доказательства происхождения сборки.

Вклад и обратная связь

Проект уже имеет воспроизводимый замкнутый цикл из исходного кода. Перед созданием Issue, пожалуйста, ознакомьтесь с Руководством по вкладу и Устранением неполадок; по вопросам безопасности следуйте SECURITY.md и не публикуйте ключи, Cookie, полные журналы или приватный код в открытых Issue.