ForgeaX-Games/forgeax-dsh-game-plugin

插件Plugin ⭐ 6 MIT other

ForgeaX game development inside DeepSeek Harness. This is a DSH bundle: installing it into a profile adds one patch layer that wires the already-published @forgeax/game MCP server, its bundled ForgeaX Skills, and a workspace guard into your DSH session.

catalog 简介 / catalog descriptioncatalog description:DeepSeek Harness (DSH) bundle plugin for ForgeaX game dev — @forgeax/dsh-game

编辑导读Editor's Brief

## 核心特性
- 该插件新增了一个 DSH bundle 层,将已发布的 @forgeax/game MCP 服务器接入 DeepSeek Harness 配置。
- 它将 mcp__forgeax__forgeax_status_litemcp__forgeax__forgeax_run_current_game 暴露为 DSH 工具。
- 它会在启动时将 forgeax-game Skill 以及解析出的包中附带的所有 forgeax-engine-* Skill 注册到 ctx.skills
- 它强制执行工作区守卫,拒绝在 realpath 解析后 target_dir 不是当前会话 cwd 的 ForgeaX 工具调用。
- 它会校验解析出的 @forgeax/game 包身份,而不是包含游戏逻辑或 ForgeaX 副本。

## 使用场景
- 在 DSH 会话中运行 ForgeaX 游戏开发工作流,无需手动将 ForgeaX Skills 安装到仓库中。
- 通过 DSH 工具界面检查 ForgeaX 运行时状态。
- 从 DSH 会话运行当前 ForgeaX 游戏,同时让工具调用限制在当前活动工作区内。

## 技术细节
- 该 bundle 为启动规范、MCP 客户端、Skill 来源和工作区守卫插入四条带命名空间的条目。
- 解析器模块 @forgeax/dsh-game/forgeax-package 会定位通过 pnpm 安装的 @forgeax/game 包,并发布 forgeaxGameLaunch 服务。
- MCP 客户端使用 stdio 传输,并设置 serverName: forgeax,桥接的是工具而非资源。
- 工作区守卫会在 tools/pre-execute 阶段进行评估;当没有可用的会话 cwd 时,会在 tools/post-execute 阶段报告无法校验的调用。

## 注意事项
- pnpm 必须位于 PATH 中,因为 dsh plugin 只是一个轻量 pnpm 转发器;Node 必须为 22 或更高版本,并与 DSH 保持一致。
- 支持 macOS arm64、Linux x64 和 Windows x64;对于没有发布对应 @forgeax/game-runtime 变体的平台,虽然可以安装,但运行时启动会失败。
- 添加 bundle 后必须重启 DSH;一次性 ForgeaX 操作仍然保留为 CLI 子命令,而不是 MCP 工具。

## Core Features
- The plugin adds a DSH bundle layer that connects the published @forgeax/game MCP server into a DeepSeek Harness profile.
- It exposes mcp__forgeax__forgeax_status_lite and mcp__forgeax__forgeax_run_current_game as DSH tools.
- It registers the forgeax-game Skill and every forgeax-engine-* Skill shipped in the resolved package on ctx.skills at boot.
- It enforces a workspace guard that denies ForgeaX tool calls whose target_dir is not the current session cwd after realpath resolution.
- It verifies the resolved @forgeax/game package identity instead of containing game logic or a copy of ForgeaX.

## Use Cases
- Running ForgeaX game development workflows inside a DSH session without manually installing ForgeaX Skills into the repository.
- Checking ForgeaX runtime status through the DSH tool surface.
- Running the current ForgeaX game from a DSH session while keeping tool calls confined to the active workspace.

## Technical Details
- The bundle inserts four namespaced rows for launch specification, MCP client, Skill source, and workspace guard.
- The resolver module @forgeax/dsh-game/forgeax-package locates the pnpm-installed @forgeax/game package and publishes the forgeaxGameLaunch service.
- The MCP client uses a stdio transport with serverName: forgeax and bridges tools rather than resources.
- The workspace guard evaluates tools/pre-execute and reports unverifiable calls on tools/post-execute when no session cwd is available.

## Notes
- pnpm must be on PATH because dsh plugin is a thin pnpm forwarder, and Node must be version 22 or higher, matching DSH.
- macOS arm64, Linux x64, and Windows x64 are supported, while platforms without a published @forgeax/game-runtime variant install but fail when the runtime starts.
- DSH must be restarted after adding the bundle, and one-time ForgeaX operations remain CLI subcommands rather than MCP tools.

安装Install

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

ForgeaX-Games/forgeax-dsh-game-plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

上一个 Prev dsh-minimal-vision 下一个 Next sgme