BuildersGate

者之门 3.11https://img.shields.io/badge/python-3.11%-blue)](https://www/downloads/) [](docs/setup支持) [](LICENSE) 构建者之门与 Claude Code 构建 MCP 服务器。 它为一个游戏项目提供了 Claude 78：设计数据库、工作队列固定的艺术生成、God Blender 适配器以及捕获。状态存储在一个中。 您可以同时运行 Code 会话，每个一个角色：艺术、游戏玩法、叙事、、技术。它们读取和写入同一个数据库，因此它们不会，并且不能同时编辑同一个仪表板显示每个会话的操作，并且是您和批准输出的地方。 Claude 会话使用和同一个数据库。询问垂直切片之前还有什么未完成的工作，它会读取队列和范围层，而不是聊天。 `bgate init` 命令创建一个具有可运行 Godot 游戏的项目。`` 命令则将其指向您已有的游戏。 代码中强制执行了限制：当前范围层之外的工作被拒绝，生成在花费上限处停止，一个席位锁定的文件不能被另一个席位写入，并且任何代理都不能批准自己的艺术作品。 本地优先。无守护进程，无云，无前端构建步骤。 <p align="center <img src="docs/screenshots/overview.png="820" alt="构建者之门仪表板：实时代理、队列活动"> </p align="center"><em板，针对真实项目<a href="docs/s">更多截图 →</a></p> **：** 运行 Claude Code 并正在构建游戏的人员，希望有多个会话协同小型项目来说，它更像是机械> **与 Claude 一** 请指向中的 [`CLAUDE.mdUDE.md)。它是为代表您进行安装的助手编写的，包括两个最耗时的错误 **对此感到陌生？** 从 **[`docs/start-here.md`](docs/start-here.md)** 开始。它假设没有任何前提条件，并一次性定义了词汇。如果不熟悉术语，请查看 **[`docs/glossary.md`](docs/glossary.md)**。 ## 项目状态 诚实版，2026-07-首个公开版本。该 solo 项目，已经在一台机器上构建了真正的游戏方向都可以看到这一点。 经过测试套件使用验证。** MCP。席位、资产锁定和 PreToolUse 钩子。Godot 适配器：无和检查、导入并在引擎内检查、截图、。两个图像提供程序。仪表板。通过连接的简介捕获游戏测试。`bgate publish`。`bgate doctor`。 **有效通过手动验证。**适配器和 gl往返。它们通过驱动真实 Blender 的，但这些测试 `slow` 或在 Blender absent 时跳过，因此运行对它们没有任何 这里没有任何内容生成 几何图形，因此请将 3D 视为较少走过的路径。 **，已命名。** 音位的 workspace 是一个刻1 的声音库、播放表，UI 以横幅显示。仪表板的不均匀；失败的有时仍然表现为无发生ot 版本检测在上报告“未知”提案，而非产品。** [`bgate_engine/`](bgate_engine/) 是一个设计包含 JSON 模式无运行时代码**。中没有任何内容导入它。其核心主张，Python 中的第二个权威模拟，在记录在自己的 `DESIGN.md` §16.5 中的实验返回负面结果后被**撤销**，针对其他两个标题。 它随附是因为模式是打包数据，推理值得阅读，而不是因为它是一个方向。 **来源待查。** 大部分内容都是针对一台 Windows 机器上的少数游戏的。它经过了严格的自我审计，前 10 个阻塞点已经被状态标题指出了哪些。 ## 需求 - Python.11+ - MCP 客户端。[Claudehttps://claude.com/claude-code) 是针对的 - [God.x](https://godotengine.org)。如果 `bgate publish` Web 导出模板 - 可选：[Blender 4.2://blender.org 3D 部分、`ffmpeg` 和 `ff 用于游戏测试捕获、`faster-whisper` 和` 用于转录 可选：`_API_KEY` 或 `_API_KEY` 用于 **Windows 是支持的平台。** Linux 是尽力而为：产品的一部分调用了 Windows 工具，套件在那里没有保持绿色。macOS 未测试。 ，包括 API 密钥表：[`docs`](docs/setup.md)。 和快速入门 ```bash git clone https:///ThepizzapieGate cd BuildersGate install -e . 或：pip install -[dev,stt,record]" bgate doctor # python/key/ffmpeg/blender/godot/whisper bgate init emberfall --kind 2d # 一个项目和一个可运行的游戏 cd emberfall # 可选：使用您的图像密钥在此处放置一个 .env，参见 .env.example bgate serve # 仪表板在 http://0.0.1:7788 ``` ` doctor` 如果其列表中的任何内容不可用。对于 CI 步骤来说是正确的，对于人类令人担忧的： Python 和 Godot完成核心循环。请阅读各行，而不是退出代码。 `bgate init` 创建一个以项目命名的**新目录**，而不是您当前所在的目录。它写入 `.bgate/game.db`，解压 Godot 模板，并打印绝对路径。`bgate serve` 在没有项目的情况下显示首次运行屏幕，从浏览器执行相同的操作。 要让代理驱动 ```bash claude mcp add builders-gate user -- <abs-python> -m bgate_mcp.server bgate hook-install <game-project> # 通道/锁定牙齿 ``` 使用**绝对** Python 路径。claude CLI 的健康检查解决了 bare `python` 与您的 shell 不同，并报告与运行正常的服务器的“无法连接”。 其他入口点，参见/setup.md`](docs/setup.md)： | 它执行的操作---| | `bgate app` | 仪表板在原生窗口中选项卡 | | ` adopt` | 将其指向您已有的 God。仅添加，不会您编写的字节 `bgate projects` | 列出每个已知项目 | | `bgate use <name>` | 在不导出 `BGATE_ROOT` 的活动项目 | |ate publish` | 将机器上的每个游戏转换为静态街机网站 | | ` hook-status` |强制钩子实际上 | ### 桌面应用程序bgate serve`本地 Web 服务器，您中打开它。` app` 运行相同的将其放在原生窗口中 - 在 Windows 上，这是 Edge 运行时，它 11 一起不需要浏览器捆绑和额外安装： ``` install -e ".[desktop]" bgate``` 它绑定到操作系统选择的环回端口，因此不会已经打开的 ` serve` 冲突，并且窗口时关闭服务器 独立的 Windows 构建，以及它为何发出警告 在 [发布页面](https://github.com/Thepizzapie/BuildersGate/releases) 上有一个 `BuildersGate-windows.zip`，适用于完全 的人员。解压并运行 `BuildersGate.exe 双击打开窗口，或使用 `BuildersGate.exe 打开浏览器仪表板。 将抱怨，这里的原因。**文件没有代码签名两个独立的防御措施来对抗这一点： - **Defender** 将第一个构建标记为 `Trojan:Win32/Sabsik.TE.A!ml`。`!ml` 后缀意味着机器学习猜测，而不是签名匹配。该构建使用了 PyInstaller's `--onefile`，它将压缩存档解压到 `%TEMP%` 并从中执行代码 - 行为上是一个投递者，无论它实际执行什么作为一个普通文件夹提供，这消除了该触发器 **Smart App，Windows 11，拒绝直接启动未签名的二进制文件：*“我们无法确认谁发布了 BuildersGate.exe。”* 任何重新打包都无法修复这个问题。它需要一个 Authenticode 证书，[正在开发中](https://github.com/Thepizzapie/BuildersGate/issues)。 每个版本都在 `.sha256` 发布旁边，因此您可以检查下载的内容与 CI 构建的内容是否匹配。两者都由工作流中的 [`github/workflows/release-exe.ymlgithub/workflows/release.yml) 从标记的提交中生成，您可以日志。 **如果您，`pip install` 可以避免所有这些问题 `bgate app普通的 Python 进程签名的可执行为您提供相同的原生推荐的路线。 构建独立的可执行文件： ```bash pipe ".[desktopinstaller python packaginge.py ``` 写入 `dist//`，启动它它是否提供自己的资产，并且只有在那时才会压缩它。检查不是仪式通过从 `__` 向上遍历查找 `static/` 和 `templates/`，因此错误布局的捆绑包仍然启动，仍然渲染外 404 每个样式表。绿色 PyInstaller 运行并不意味着可用的二进制文件流程 步骤 是 `bgate。此后的所有 MCP 工具调用注册了服务器的 Claude 会话都可以驱动它。形状：您或器为每个席位分发一个代理，每个代理通过 `BGATE_SEAT` 采用其角色text 1 init <name>bgate/game.db + 一个可运行的游戏路径 2 godot_scaffold （或，进入现有项目：相同的可） 3 DIRECTOR 席位 bible支柱、核心范围层、 CUT4 NARRATIVE 席位 lore_add / lore_fact；每次写入叙事时的 canon_check 5 ART 席位 ref_pin 批准的引用首先，然后是 blender_sprites / image_sprites / image_generate；资产锁定前触摸任何二进制文件，资产释放后 6 GAMEPLAY 席位 在其通道中编写代码；每次更改后 godot_check_project + godot_run；godot_screenshot 查看游戏 7 QA 席位 通过 godot_run 进行无头测试脚本；资产验证以防止漂移 8 playtest_check/start 自己玩， 大声说话；反馈分类并加入到遥测数据；您推广什么成为工作 ``` 四条规则使多代理工作安全。 在编写**您明显的通道**之外的内容之前，请检查 `seat_can_write`。 在编辑前锁定二进制文件。 在您的工作更改另一个席位的世界时，留下一个 `seat_post_note`。 在构建任何新内容之前，请调用 `scope_check(rank)`。 `seat_brief(role)` 返回每个席位启动所需的所有内容：任务、通道、圣经、教义、固定的参考锚、推广的反馈以及谁锁。 每个工具都接受一个可选的 ``。它从项目，然后是 `BG`，然后从 cwd 向上遍历以ate/` 目录。只要可能有多个项目显式传递它。 ## 文档 [`docs/README.md`](docs/README 索引每一**从这里开始 页面 | 它是什么---|---| | [start-here.md](docs/start-here.md) |。 假设一无所知 | | [glossary.md](docs/gl) | 项目中使用的每个术语 | **参考** | 页面 | 它是什么 | |---|---| | [setup.md](docs/setup.md) | 需求 密钥、`adopt`、项目切换、 注册、平台支持reference.md](docs/reference.md) | 面的详细信息：仪表席位、锁ender 到 Godot、发布、游戏布局 | | [](docs/design) | 切割、仅限人类批准、教义选择 | | [gotchas.md](docs/gotchas.md) | GPU 冷启动、stdio 死锁isper 分段、遥测时钟 | **发现 页面 | 它是什么---|---| ##者之门 ```bash pip install -e ".[dev]" python -m pytest "not slow" ``` `-m "not slow"` 取消选择驱动真实 Blender、 和套件内轮子构建的测试。只有当您安装了两者并时，才可以省略它套件中有一个轮子烟雾测试，存在的故障是不可见的 `pip install -：发布的轮子没有 JavaScript 和 `，生成的仪表板是 404s，脚引发了 `FileNotFoundError`，而没有任何验证。 ## 贡献、安全、许可证 反馈在这里比补丁更有价值，尤其是“它在我的机器上无法运行”和“可以绕过这个门禁”。请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)，了解报告中应包含的内容，以及 [CHANGELOG.md](CHANGELOG.md) 中的发布状态。 该工具执行任意的 GD调用 shell 命令，并使用具有编辑权限的代理会话。 [SECURITY.md](SECURITY.md) 明确说明了 localhost 防保护的内容（浏览器您的仪表板，包括通过绑定）和不（恶意、网络部署、不受信任输入）。 GitHub 安全通告报告漏洞，而不是公开的问题。 MIT。参见 [LICENSE](LICENSE)。