@forgeax/dsh-game

Desarrollo de juegos ForgeaX dentro de DeepSeek Harness. Esto es un DSH bundle: instalarlo en un perfil añade una capa de parche que integra en tu sesión DSH el servidor MCP @forgeax/game ya publicado, sus ForgeaX Skills incluidas y un guard de espacio de trabajo.

No contiene lógica de juego ni ninguna copia de ForgeaX. Resuelve el paquete @forgeax/game que pnpm instaló junto a él, verifica su identidad y lo conecta.

Qué se obtiene

No ejecutes forgeax-game devkit install. Este bundle registra las Skills directamente; además, ejecutar el instalador solo deja copias duplicadas en tu repositorio que DSH nunca leerá.

Related MCP server: dsh-harness-mcp-server

Requisitos

• macOS arm64, Linux x64 o Windows x64. Este bundle es JS puro y no declara os/cpu; hereda su alcance de plataforma de @forgeax/game, cuyo @forgeax/game-runtime incluye un binario nativo como una entrada de optionalDependencies por plataforma. Tu máquina solo instala la que le corresponde. Las plataformas sin variante publicada (Mac Intel, ARM Linux, ARM Windows) se instalan sin errores, pero fallan al iniciar el runtime, exactamente como hace @forgeax/game por su cuenta.

• pnpm en PATH. dsh plugin es un simple trasvase de pnpm; sin pnpm, sale con 127.

• Node ≥ 22, igual que DSH.

Instalación

dsh plugin se instala en un perfil concreto y se autoactiva: como este paquete está libre dsh.bundle, añadirlo como dependencia también lo adjunta a la pila de capas dsh.profile.bundles de ese perfil.

dsh plugin --profile web add @forgeax/dsh-game

--profile es obligatorio (y no opcular): DSH no tiene un perfil predeterminado implícito, y la pila de capas es por perfil. Repite el comando para cada perfil que deba tener ForgeaX.

A continuación, reinicia dsh. Los capas de bundle se leen solo en el arranque; solo se supervisa el propio archivo de parche de usuario del perfil. Un bundle recién añadido permanece inerte hasta el siguiente arranque.

Comprueba al reiniciar:

dsh --profile web
# then, in the session:
#   ask for the ForgeaX status — the model should call mcp__forgeax__forgeax_status_lite

Configuración

Las latas que inserta este bundle, todas en su propio espacio de nombres para que nunca choquen con otro bundle:

El propio resolvedor vive en un quinto módulo, @forgeax/dsh-game/forgeax-package, que no importa ningún framework. Las herramientas de procedencia pueden cargarlo desde un perfil instalado, donde los paquetes DSH son dependencias de peers de que el perfil nunca instala una segunda copia.

Para cambiar algo, añade una fila con el mismo id al archivo de parche de usuario de tu perfil. Un parche reemplaza todo el config de la fila correspondiente — no hay una fusión en profundidad —, así que debes volver a especificar cada campo que quieras conservar. Por ejemplo, para acortar el tiempo de espera de la llamada a herramienta:

# $DSH_HOME/profiles/web/cordis.patch.yml
- insert:
    - id: forgeax-game.mcp-client
      name: '@deepseek-ai/dsh-mcp-client'
      inject:
        - forgeaxGameLaunch
      config:
        serverName: forgeax
        transport: stdio
        command: !!js ctx.forgeaxGameLaunch.spec.command
        args: !!js ctx.forgeaxGameLaunch.spec.args
        cwd: !!js ctx.forgeaxGameLaunch.spec.cwd
        env: !!js ctx.forgeaxGameLaunch.spec.env
        failOnStartupError: true
        toolCallTimeoutMs: 120000
        reconnect:
          enabled: true

Límites que conviene saber

• Solo herramientas. El servidor MCP de DSH conecta herramienta, no recursos. forgeax://status no es accesible en una sesión de DSH; mcp__forgeax__forge_status_lite devuelve el mismo estado. La Skill registrada lo indica para que el modelo no intente acceder al recurso.

• No hay bundles transitivos. Solo los paquetes listados directamente en dsh.profile.bundles contribuyen con una capa de parche. Un bundle que depende de este no hereda sus filas.

• Las operaciones puntuales de ForgeaX siguen en la CLI. Crear un juego, cambiar el juego activo o actualizar el plugin son subcomandos de forgeax-game <init|use|doctor|devkit|upgrade>, no Tools de MCP.

Modos de fallo

failOnStartupError está en true a propósito: una sesión de ForgeaX cuyo servidor MCP nunca ha arrancado está rota, no degradada, y un error de arranque es más barato de leer que un misterio en la primera llamada de herramienta.

Seguridad

• El proceso hijo se inicia con env: {}. DSH limpia el entorno del padre y fusiona config.env después de la limpieza, de modo que cualquier cosa indicada ahí reintroduciría un secreto que el framework acaba de anular.

• El guard de espacio de trabajo compara target_dir con la cwd de la sesión después de resolver realpath — nunca mediante un prefijo de la cadena, algo que los enlaces simbólicos y .. pueden aludir.

• Este bundle no lee, almacena ni registra ninguna clave de API, token o valor secreto.

Changelog

Todos los cambios perceptibles por el usuario se registran en CHANGELOG.md. Para contribuir, consulta CONTRIBUTING.md; para informar de una vulnerabilidad, consulta SECURITY.md.

Licencia

MIT