@forgeax/dsh-game

Разработка игр ForgeaX внутри DeepSeek Harness. Это DSH-бандл: установка его в профиль добавляет один слой патчей, который подключает уже опубликованный MCP-сервер @forgeax/game, входящие в его состав навыки ForgeaX и защиту рабочей области к вашему сеансу DSH.

Он не содержит игровой логики и копии ForgeaX. Он находит пакет @forgeax/game, установленный pnpm рядом с ним, проверяет его подлинность и подключает его.

Что вы получаете

Вам не нужно запускать forgeax-game devkit install. Этот бандл регистрирует навыки напрямую; повторный запуск установщика лишь оставит дубликаты в вашем репозитории, которые DSH никогда не читает.

Related MCP server: dsh-harness-mcp-server

Требования

• macOS arm64, Linux x64 или Windows x64. Этот бандл — чистый JS и не объявляет os/cpu; он наследует охват платформ от @forgeax/game, чей @forgeax/game-runtime поставляет нативный бинарник как одну запись optionalDependencies на платформу. Ваша машина устанавливает только подходящий вариант. Платформы без опубликованного варианта (Intel Mac, ARM Linux, ARM Windows) устанавливаются чисто, но выходят из строя при запуске рантайма, точно так же, как и сам @forgeax/game.

• pnpm в PATH. dsh plugin — тонкий форвардер pnpm; без pnpm он завершается с кодом 127.

• Node ≥ 22, как и DSH.

Установка

dsh plugin устанавливает в один именованный профиль и сам активируется: поскольку этот пакет объявляет dsh.bundle, добавление его как зависимости также добавляет его в стек слоёв dsh.profile.bundles этого профиля.

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

--profile обязателен — у DSH нет неявного профиля по умолчанию, а стек слоёв привязан к профилю. Повторите команду для каждого профиля, в котором должен быть ForgeaX.

Затем перезапустите dsh. Слои бандлов читаются один раз при загрузке; только собственный файл патчей профиля отслеживается. Свежедобавленный бандл неактивен до следующего запуска.

Проверьте после перезапуска:

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

Конфигурация

Четыре строки, которые вставляет этот бандл, все в пространстве имён, чтобы они никогда не могли конфликтовать с другим бандлом:

Сам резолвер живёт в пятом модуле, @forgeax/dsh-game/forgeax-package, который не импортирует фреймворк. Инструменты проверки происхождения могут загрузить его из установленного профиля, где пакеты DSH — соседи, которые профиль никогда не устанавливает второй копией.

Чтобы что-то изменить, добавьте строку с тем же идентификатором в файл пользовательских патчей вашего профиля. Патч заменяет весь config целевой строки — глубокого слияния нет — поэтому вам нужно заново указать каждое поле, которое вы хотите сохранить. Например, чтобы сократить таймаут вызова инструмента:

# $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

Ограничения, о которых стоит знать

• Только инструменты. MCP-клиент DSH мостит инструменты, а не ресурсы. forgeax://status недоступен в сеансе DSH; mcp__forgeax__forgeax_status_lite возвращает то же состояние. Зарегистрированный навык сообщает об этом, чтобы модель не пыталась использовать ресурс.

• Нет транзитивных бандлов. Только пакеты, перечисленные напрямую в dsh.profile.bundles, добавляют слой патчей. Бандл, зависящий от этого, не наследует его строки.

• Разовые операции ForgeaX остаются в CLI. Создание игры, переключение активной игры и обновление плагина — это подкоманды forgeax-game <init|use|doctor|devkit|upgrade>, а не MCP-инструменты.

Сбои и их причины

failOnStartupError установлен в true намеренно: сеанс ForgeaX, чей MCP-сервер так и не запустился, сломан, а не деградировал, и ошибка при загрузке читается дешевле, чем загадка при первом вызове инструмента.

Безопасность

• Дочерний процесс запускается с env: {}. DSH очищает родительское окружение и объединяет config.env после очистки, так что всё, что там указано, заново внедрит секрет, который харнесс только что удалил.

• Защита рабочей области сравнивает target_dir с рабочей директорией сеанса после разрешения realpath — никогда по строковому префиксу, который обходят симлинки и ...

• Никакой API-ключ, токен или секретное значение не читается, не хранится и не логируется этим бандлом.

Журнал изменений

Каждое видимое пользователю изменение записано в CHANGELOG.md. Чтобы внести вклад, см. CONTRIBUTING.md; чтобы сообщить об уязвимости, см. SECURITY.md.

Лицензия

MIT