dsh-gate

dsh-gate позволяет Codex контролировать длительные сеансы DeepSeek Harness через MCP, сохраняя при этом независимость DSH Host и сеансов от процесса MCP.

Рабочее пространство содержит:

• @dsh-gate/mcp-server: девять инструментов MCP поверх публичного сетевого клиента DSH и контроллера переподключения;

• @dsh-gate/supervisor-tools: инструменты передачи управления, приёма артефактов и бюджета зарегистрированных сбоев на стороне DSH;

• два узких операторских навыка, пример конфигурации Codex/DSH и детерминированный рабочий процесс bootstrap/doctor/Host.

Развёртывание, проверка и запуск

pnpm bootstrap      # fetch the pinned DSH fork commit, build & link the exact
                    # network client, install the supervisor plugin into an
                    # isolated project-local DSH home (.dsh-state/) — never starts the Host
pnpm run doctor     # verify pin, link, built artifacts, and plugin/profile
pnpm host:start     # start the independent DSH Web Host on http://127.0.0.1:8080
pnpm run doctor --live  # additionally verify the running Host identity/protocol

Затем скопируйте config/codex-mcp.example.toml в соответствующую конфигурацию Codex и замените заполнитель <workspace-root> на абсолютный путь этого checkout'а — это единственное значение, зависящее от конкретной машины. Исполняемый файл сервера — packages/mcp-server/dist/cli.js — если более старая конфигурация по-прежнему указывает на dist/index.js, обновите её до dist/cli.js (точка входа библиотеки не запускает MCP-сервер). Конфигурация MCP Codex поддерживает stdio-серверы с полями для команды, аргументов, окружения, таймаута запуска и таймаута инструментов.

Полное руководство оператора — предварительные требования, контракт совместимости и политика обновлений, независимость Host, видимость в браузере, чистое восстановление после сбоев и ограничение, связанное с официальными upstream-PR — читайте в DEPLOYMENT.md.

Related MCP server: codex-worker-runtime

Зафиксированный коммит форка DSH

@dsh-gate/mcp-server импортирует @deepseek-ai/dsh-client-connection/network-client, общие экспорты сетевого клиента и контроллера переподключения. Эти экспорты не входят ни в один опубликованный релиз DSH; они потребляются из публичного форка ровно в одном коммите:

• форк: https://github.com/yidapan666-creator/deepseek-harness.git

• коммит: 7212c955438c70c9a2d168f67e85a8014b8d4488

SHA коммита является контрактом совместимости — bootstrap выполняет выборку по SHA (никогда по движущейся ветке), doctor отказывается от checkout, чей HEAD отличается или чей удалённый репозиторий не идентифицирует форк, а грязный checkout отклоняется без деструктивного восстановления. Сама ссылка создаётся существующим скриптом scripts/link-local-dsh.mjs, который повторно используется bootstrap; она действует только локально, и ни один путь к машине не фиксируется в метаданных пакета. dist/cli.js сначала проверяет стык и выводит понятный диагностический текст вместо необработанной ошибки разрешения модуля, если он отсутствует.

Чтобы обновить привязку: измените DSH_PINNED_COMMIT в scripts/dsh-gate-lib.mjs, удалите .dsh-state/dsh и снова запустите pnpm bootstrap. Политику и объяснение, почему коммит форка не заявляется как upstream-слияние, см. в DEPLOYMENT.md.

Периодичность контроля

dsh_wait выполняет пятиминутный агрегированный цикл прогресса: по умолчанию он возвращает примерно одно наблюдение каждые 300000 мс, и возвращается раньше только при существенной границе супервизора — например, терминальном состоянии, запросе/вопросе, контрольной точке, блокировке или эскалации. Обычный поток событий никогда не вызывает быстрых повторных вызовов wait. Каждое наблюдение цикла агрегирует прогресс с момента предыдущего asOfSeq — дельту шагов, счётчики инструментов, дельты токенов — плюс компактную ограниченную сводку projectActivity затронутых проектных файлов, изменённых успешными правками/записями, и целевых команд проверки (например, pnpm verify). Терминальные наблюдения несут итоговые значения по области задачи. Никакие сырые логи, диффы или выводы инструментов никогда не включаются.

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

Детали длительной передачи управления

supervisor_handoff.summary ограничен 2048 символами. Когда задаче требуется более длинный отчёт, запишите его в Markdown в каталог .dsh-handoff/<taskId>/ внутри рабочего каталога сеанса (каталог игнорируется git), передайте относительный путь в artifacts и укажите на него в краткой сводке. Инструмент передачи управления отклоняет сводки, превышающие лимит, с точной инструкцией и сам никогда не записывает данные передачи — в частности, никогда в ~/.codex или любой другой глобальный каталог. Приём артефактов обеспечивает изоляцию: только относительные пути, без обходов, симлинков, жёстких ссылок или нерегулярных файлов, хешированные по допустимому дескриптору внутри рабочего каталога сеанса.

Статус релиза

Исходный код распространяется под лицензией MIT и подготовлен для публичного размещения на yidapan666-creator/dsh-gate: зависимость DSH является публичным форком, рабочее дерево не содержит путей, специфичных для конкретной машины, или секретов, а pnpm bootstrap проходит с управляемой ссылкой. Публикация в npm остаётся отдельным, всё ещё заблокированным решением: обе пакета не могут быть собраны или запущены при чистой установке, пока не будет опубликован шов @deepseek-ai/dsh-client-connection/network-client (пин форка работает для воспроизводимых сборок из исходников, но не для установки пакетов из реестра).

Оставшееся ограничение upstream — публикация в npm: обе пакета не могут быть собраны или установлены без опубликованного @deepseek-ai/dsh-client-connection/network-client. Публичный пин форка на 7212c955438c70c9a2d168f67e85a8014b4488 делает сборки из исходников воспроизводимыми уже сегодня; при этом никакого слияния с upstream не заявляется.

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

Смотрите docs/protocol.md о семантике состояний, docs/benchmark.md — о пути приёмки, docs/source-provenance.md — о происхождении исходного кода и лицензиях, docs/source-backed-reuse-review.md — о ретроспективном обзоре дизайна. Для контрибьюторов: CONTRIBUTING.md. Для сообщений об уязвимостях: SECURITY.md.