DSH × Codex Bridge

Conecta el poder de decisión de Codex con el poder de ejecución de DSH.

中文 · English · Instalación · Uso · Arquitectura

dsh-codex-bridge es una infraestructura de agentes de código abierto para desarrolladores: Codex se encarga de desglosar los objetivos, seleccionar las estrategias de delegación y la evidencia de aceptación; DeepSeek Harness (DSH) se encarga de ejecutar código, pruebas y trabajo de subagentes internos en el perfil especificado; Bridge se encarga del protocolo, el workspace aislado, el ciclo de vida de las tareas y los artefactos revisables.

Estado del proyecto

Código fuente disponible ｜ 0.1.0-alpha.1 ｜ bucle cerrado con DSH 0.1.0-rc.8 verificado

La versión actual se puede compilar desde el código fuente, inicializar el proyecto, instalar el perfil local de DSH y el plugin de Codex, ejecutar comprobaciones de salud y, a través de MCP, impulsar a DSH para completar tareas en un worktree aislado. La evidencia del bucle cerrado con un proveedor real se guarda en real-dsh-rc8.json, real-dsh-rc8.patch y real-dsh-rc8-continue.patch.

La modalidad de publicación actual es la instalación desde el código fuente; la publicación pública en npm y en Marketplace aún no se ha realizado. La línea base de compatibilidad con DSH fijada para la primera versión es 0.1.0-rc.8. DSH está en Developer Preview, por lo que actualizar DSH debe pasar por pruebas de compatibilidad; no se puede inferir su disponibilidad únicamente a partir del número de versión.

Related MCP server: agent-rack

¿Qué problema resuelve?

Cuando una tarea no merece consumir el contexto completo del modelo principal, Codex puede entregársela a DSH:

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

Bridge no presenta a DSH como un modelo nativo de Codex ni como un subagente nativo. El Direct Mode predeterminado consiste en que el hilo principal de Codex llame directamente al MCP de Bridge; el opcional Native Shell Mode genera un agente personalizado de Codex con un ámbito de responsabilidades reducido como capa de orquestación, para obtener una experiencia más cercana al hilo nativo, pero consume un uso adicional de Codex.

Quickstart en 10 minutos (código fuente disponible)

Por ahora, use la ruta del código fuente; npm y Marketplace aún no se han publicado; no instale el paquete con el mismo nombre desde el registry público ni desde directorios.

Instalación desde el código fuente (ruta de desarrollo actual)

Requisitos previos: Node.js 22.19+ o 24+, pnpm, Git, una DSH 0.1.0-rc.8 ejecutable, Codex CLI o Desktop, y al menos un proveedor ya configurado en 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

Inicialización, instalación y comprobación de salud:

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"

Luego, en una sesión nueva de Codex, llame a list_profiles y use delegate_task para delegar una tarea de solo lectura o de implementación de alcance reducido. La tarea predeterminada usa un Git Worktree independiente; el workspace principal no debe modificarse directamente.

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

La skill delegate-to-dsh detectará los perfiles disponibles, elegirá single o multi según el flujo de trabajo independiente y el beneficio de revisión, y escribirá la justificación y los roles en la tarea. Decir explícitamente “agente único” o “multiagente” siempre anula el juicio automático. El modo multiagente solo se considera aprobado si se observan suficientes invocaciones de subagentes y eventos de finalización en la sesión de DSH.

Verificación del bucle cerrado con DSH real

Este comando iniciará un perfil real de DSH 0.1.0-rc.8 y llamará al proveedor configurado en la máquina actual; no es un LLM falso ni una simulación sin conexión:

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

Evidencia correspondiente: real-dsh-rc8.json, real-dsh-rc8.patch, real-dsh-rc8-continue.patch y model-matrix.json. Antes de ejecutarlo, debe completarse la configuración del proveedor de DSH; la prueba generará llamadas reales de red y de modelo, y verificará en un Git Fixture temporal el estado de las tareas, el enrutamiento de modelos, la decisión automática de agente único o multiagente, los eventos de subagentes, el hash de artefactos, la continuación en la misma sesión, la cancelación real y que el workspace principal permanezca sin cambios.

Instalación de futuros lanzamientos (npm / Marketplace)

El paquete npm y el paquete de Codex Plugin Marketplace aún no se han publicado. El nombre futuro del paquete, el estado de revisión, el runtime de Node y las restricciones de versión de DSH se rigen por las notas de lanzamiento oficiales; en la versión actual, no ejecute comandos de instalación global que no hayan sido confirmados por las notas de lanzamiento.

Dos modos de ejecución

Ambos modos comparten el protocolo, los perfiles, el estado de las tareas, el Worktree y los artefactos; cambiar de modo no debe cambiar el formato de los resultados de las tareas.

Navegación de documentos

• Manual de instalación completo: entorno, compilación desde el código fuente, Direct/Native Shell y límites de actualización y desinstalación.

• Manual de uso completo: activación por lenguaje natural, agente único/multiagente, perfil, revisión de resultados, continuación y cancelación.

• Inicio rápido en 10 minutos: desde la instalación desde el código fuente hasta la primera tarea revisable.

• Referencia de configuración: perfil, enrutamiento de modelos, workspace, concurrencia y políticas.

• Informe de viabilidad técnica: evidencia de API pública, límites y M0 PoC.

• Plan de arquitectura de software: Gateway, Task Engine, DSH Adapter y protocolo.

• Plan de construcción y lanzamiento: hitos, pruebas y Definition of Done.

• Modelo de seguridad: claves, rutas, red, Shell, recursividad y límites de artefactos.

• Solución de problemas: doctor, MCP, DSH, proveedor, Worktree y recuperación.

• Guía de contribución: desarrollo local, pruebas, cambios y normas para pull requests.

• Divulgación de vulnerabilidades de seguridad: no envíe detalles de vulnerabilidades sensibles en Issues públicos.

• Código de conducta: el estándar de colaboración que mantenemos en conjunto al participar en el proyecto.

• Canales de soporte: a dónde deben dirigirse los bugs, las sugerencias de funciones y los problemas de seguridad.

• Registro de cambios: funciones y limitaciones conocidas del Alpha actual.

Limitaciones actuales

• Solo se admite la instalación desde el código fuente; el paquete npm y el directorio público de plugins de Codex aún no se han publicado.

• El runtime de escritura actual solo admite worktrees aislados de Git.

• Bridge no confirma, fusiona, despliega ni publica automáticamente los resultados de DSH.

• Algunas políticas de red, rutas denegadas, número de archivos y disco en los perfiles siguen siendo declaraciones de protocolo; aún no se han mapeado por completo a ejecutores del lado de Bridge.

• Para una ejecución determinista entre modelos se deben usar varios perfiles con nombre; el enrutamiento forzado de submodelos a nivel de rol aún requiere el DSH Child Setup Contract.

Compromisos de diseño

• Protocol first: Codex, DSH y otros Hosts futuros solo intercambian JSON versionado, sin exponer tipos privados de Cordis.

• Profile over model: el usuario elige un perfil semántico; el proveedor, el modelo y el razonamiento son resultados de análisis verificables.

• Safety by default: worktree aislado por defecto, privilegios mínimos, límites de recursos, cancelable y enmascaramiento de secretos.

• Codex owns the decision: DSH devuelve la evidencia y Codex decide aceptar, continuar, cancelar o descartar.

• Release as one unit: el plugin de Codex, el plugin de DSH y el protocolo compartido se publican sincronizados con versiones fijas.

Licencia de código abierto

El código se publica bajo Apache-2.0. Las dependencias de terceros, los ejemplos y el propio DSH conservan sus respectivos derechos de autor y licencias; antes del lanzamiento oficial se generarán el listado de licencias de dependencias, el SBOM y la prueba de procedencia de la compilación.

Contribuciones y comentarios

El proyecto ya cuenta con un bucle cerrado reproducible desde el código fuente. Antes de abrir un Issue, lea la Guía de contribución y la Solución de problemas; si se trata de un problema de seguridad, siga SECURITY.md. No pegue claves, cookies, registros completos ni código privado en Issues públicos.