@forgeax/dsh-game

DeepSeek Harness 내에서의 ForgeaX 게임 개발. 이것은 DSH 번들입니다: 프로필에 설치하면 이미 게시된 @forgeax/game MCP 서버, 번들된 ForgeaX Skills, 그리고 워크스페이스 가드를 DSH 세션에 연결하는 하나의 패치 레이어가 추가됩니다.

게임 로직이나 ForgeaX 사본은 포함하지 않습니다. pnpm이 옆에 설치한 @forgeax/game 패키지를 해석하고, 정체성을 검증한 후 연결합니다.

제공되는 것

forgeax-game devkit install을 실행하지 마세요. 이 번들은 Skills를 직접 등록합니다. 설치 프로그램도 실행하면 저장소에 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 단독과 정확히 동일합니다.

• PATH에 pnpm. 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에 있으며, 프레임워크를 import하지 않습니다. 출처 도구는 설치된 프로필에서 로드할 수 있습니다. 여기서 DSH 패키지는 peer이며, 프로필은 그 사본을 다시 설치하지 않습니다.

무언가를 변경하려면 프로필의 사용자 패치 파일에 같은 id의 행을 추가하세요. 패치는 대상 행의 전체 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

알아야 할 제한 사항

• 도구만. DSH의 MCP 클라이언트는 도구를 브리지하며 리소스는 브리지하지 않습니다. forgeax://status는 DSH 세션에서 접근할 수 없습니다. mcp__forgeax__forgeax_status_lite가 동일한 상태를 반환합니다. 등록된 Skill이 그렇게 명시하므로, 모델은 리소스를 시도하지 않습니다.

• 전이 번들 없음. dsh.profile.bundles에 직접 나열된 패키지만 패치 레이어를 제공합니다. 이 번들에 의존하는 번들은 그 행을 상속하지 않습니다.

• 일회성 ForgeaX 작업은 CLI에 유지됩니다. 게임 생성, 활성 게임 전환, 플러그인 업그레이드는 forgeax-game <init|use|doctor|devkit|upgrade> 하위 명령이며 MCP 도구가 아닙니다.

실패 모드

failOnStartupError는 의도적으로 true입니다: MCP 서버가 시작되지 않은 ForgeaX 세션은 저하된 것이 아니라 손상된 것이며, 부팅 시 오류는 첫 도구 호출 시의 미스터리보다 읽기 쉽습니다.

보안

• 하위 프로세스는 env: {}로 시작됩니다. DSH는 부모 환경을 정리하고 정리 후에 config.env를 병합합니다. 따라서 여기에 나열된 것은 하네스가 방금 제거한 비밀을 다시 주입하게 됩니다.

• 워크스페이스 가드는 realpath 해석 후 target_dir을 세션 cwd와 비교합니다 — 문자열 접두사로 비교하지 않으며, 심볼릭 링크와 ..이 무력화합니다.

• 이 번들은 API 키, 토큰 또는 비밀 값을 읽거나, 저장하거나, 기록하지 않습니다.

변경 로그

모든 사용자에게 보이는 변경 사항은 CHANGELOG.md에 기록됩니다. 기여하려면 CONTRIBUTING.md를 참조하세요. 취약점을 보고하려면 SECURITY.md를 참조하세요.

라이선스

MIT