内容
# 克劳德GBS插件
GB Studio 4.x 的克劳德代码插件。给予模型：
- **MCP 工具**，用于结构化项目编辑（`patch_script`、`set_variable`、`create_scene`、`create_actor`、`create_trigger`、`create_variable`、`create_custom_event`、`set_start_scene`、`delete_*`、`build_rom`、`run_emulator`、`screenshot`、`generate_sprite`、`convert_image_to_sprite`等），由上游 `chrismaltby/gb-studio` 4.x 资源模式支持。MCP 服务器位于 [`@gbs-toolkit/mcp-server`](https://www.npmjs.com/package/@gbs-toolkit/mcp-server) npm 包中，通过 `npx` 按需启动。
- **安全规则** 技能，在对话涉及 GB Studio 资源时自动加载 - 编码硬件限制、4.x 每个资源磁盘布局、强制构建/模拟器/截图反馈循环，以及模型必须永远不能做的事情（例如，直接使用 `Write` 编辑 `.gbsres`）。
- **六个主题技能**，模型可以按需调用：`gbvm-scripting`、`dialogue-and-ui`、`sprite-generation`、`actor-patterns`、`scene-design`、`debugging-rom`。
## 安装
该插件通过私有市场分发。从任何克劳德代码会话：
```
/plugin marketplace add https://github.com/gbs-toolkit/claude-gbs-marketplace
/plugin install gbs@gbs-toolkit
```
（或在开发过程中使用本地路径进行 `/plugin marketplace add`。）
## 配置
插件的 `.mcp.json` 引用了几个环境变量；在启动克劳德代码之前设置您需要的变量：
| 变量 | 是否必需 | 用途 |
|---|---|---|
| `GBS_PROJECT_ROOT` | 是 | 包含 `<name>.gbsproj` 的目录 |
| `SPRITE_PROVIDER` | 可选 | `openai`（默认）/ `gemini` / `replicate` / `fal` |
| `OPENAI_API_KEY` / `GEMINI_API_KEY` / `REPLICATE_API_TOKEN` / `FAL_KEY` | 取决于条件 | 所选提供商所需 |
| `GBS_CLI_PATH` | 可选 | 重写 `gb-studio-cli.js` 的探测 |
| `GBS_MGBA_RUNNER` | 可选 | `run_emulator` 使用的链接到 libmgba 的二进制文件的路径 |
如果您的客户端在运行时不在插件的 `.mcp.json` 中扩展 `${VAR}`，请在项目级别的 `.mcp.json` 中重写值（项目级别配置优先于插件级别配置）。
## 开发
技能是 `skills/<name>/SKILL.md` 下的纯 Markdown 文件，并带有 YAML 前置元数据 - 编辑并重新加载。MCP 服务器源代码位于同级仓库 [`gbs-toolkit/mcp-server`](https://github.com/gbs-toolkit/mcp-server) 中，并作为 [`@gbs-toolkit/mcp-server`](https://www.npmjs.com/package/@gbs-toolkit/mcp-server) 发布到 npm。
要使用本地 MCP 服务器代码库而不是 npm 版本，请将 `.mcp.json` `args` 更改为指向本地路径：
```json
{
"mcpServers": {
"gbs": {
"command": "node",
"args": ["/abs/path/to/mcp-server/dist/index.js"],
"env": { "GBS_PROJECT_ROOT": "..." }
}
}
}
```
## 许可证
MIT
