Summer Engine

Summer Engine：MCP 服务、CLI 和技能

为 AI 打造的游戏引擎。

任何 Agent 都能构建、测试并发布一款完整的多人游戏。MCP 服务 · 游戏开发技能 · summer CLI，全部包含在一个 npm 包中：summer-engine。

官方网站 · 文档 · CLI 设置 · MCP 设置

安装

• 立即开始制作游戏（Node 22+）：npx -y summer-engine@latest dev。如果尚未安装 Summer Engine 应用（约 660 MB，免费），它会在安装前征求你的同意；随后在此处创建入门项目（如果此文件夹中已有其他文件，则创建在 ./my-game 中），并打开项目，供你的 Agent 使用。无需登录即可构建。
• 聊天应用（Claude、ChatGPT、Cursor...）：添加 https://mcp.summerengine.com/mcp。无需安装任何内容。
• Homebrew： brew install summerengine/tap/summer
• npm（Node 22+）：npm install -g summer-engine

仅 CLI（summer-engine 4.2.0 或更高版本），不含 MCP 服务：summer setup --cli。summer ops search "publish my game" 可查找任何操作，无论是否已登录。

连接

云端工作：https://mcp.summerengine.com/mcp。 无需安装。将 URL 添加到你的 Agent，并登录一次 Summer 账户。之后，你的 Agent 就可以制作资源（图像、3D 模型、动画、音效、音乐、人声、视频），搜索和下载 Summer 资源库中的内容，规划游戏，并管理项目、商店、发布、价格、分析、A/B 测试、团队和 Studio。它不提供引擎工具：如需使用这些工具，请使用下方的本地服务。

引擎工作：npx -y summer-engine@latest setup <agent> --yes（需要 Node 22+）。它会将本地服务（summer mcp）和技能写入 Agent 的配置。本地服务会在你的计算机上驱动 Summer Engine 应用：构建场景、编写脚本、运行游戏、截取屏幕截图、读取错误。运行 summer login 后，它也可以执行所有云端操作，因此你的 Agent 只需要一个服务。或者，在开始使用中粘贴提示词，让 Agent 完成所有步骤。

仅使用 CLI（summer-engine 4.2.0 或更高版本）：npx -y summer-engine@latest setup <agent> --cli --yes。 不使用 MCP 服务：Agent 会在其 shell 中将 Summer 作为命令运行。安装程序会为 Agent 安装技能和 summer-cli，以及命令指南，不会写入 MCP 配置。Agent 会使用 summer login 登录，通过 summer ops search "<what you want>" 查找操作，并使用 summer <area> <action> --<field> <value> 运行操作，同时支持 --dry-run、--wait 和 --json。引擎命令（summer engine …）会驱动你计算机上的 Summer Engine 应用。每项技能末尾都有一张表，列出该技能提及的每个工具对应的命令。添加 --assets-only 可仅安装资源相关技能。--no-mcp 与 --cli 作用相同。

ChatGPT 和 Claude 的连接器目录使用两个经过审核、工具列表固定的商店版本：https://mcp.summerengine.com/chatgpt（游戏、资源和生成；不含发布和账单链接）和 https://mcp.summerengine.com/directory（商店、发布和 Grow 读取操作；不含图像、3D、音频或视频生成）。它们保留 3.x 工具名称，且不提供 summer_search 或 summer_call。其他所有功能请使用 /mcp。

这是什么

Summer Engine 是专为 AI 打造的游戏引擎。此仓库将你的 AI 编码 Agent（Claude Code、Cursor、Codex、Copilot 等）连接到引擎：Agent 可以在引擎中构建完整游戏、进行测试、将游戏发布到 summer.games，并读取玩家的游戏方式。

此仓库本身不是引擎。CLI 会为你下载 Summer Engine 应用。

安装 Summer 后，你的 Agent 可以：

• 构建真正的游戏：通过实时 MCP 工具创建场景、脚本、物理效果和 UI。
• 构建多人游戏：使用 Summer 自有的联网功能，包括匹配、组队、排行榜、玩家数据和世界存档。
• 添加分析并读取数据：商店页面浏览量、启动次数、游戏会话、游戏时长和自定义事件。
• 发布游戏到 summer.games 商店：商店页面、美术资源、构建版本、私人预览链接和正式发布。Summer 的商店审核会在内容上线前进行。
• 使用经过验证的方案：技能、模板和参考资料，均可通过一个索引搜索。
• 检查自己的工作：运行游戏、截取屏幕截图、读取调试器信息、按下真实按键。
• 继续任何项目：.summer/ 项目记忆可让新的 Agent 从上一个 Agent 停下的地方继续工作。

由你决定 Agent 可以执行哪些操作

Studio > Settings > Agent permissions 中有六个开关。它们适用于你连接的所有应用，例如 Claude 或 ChatGPT。这些默认设置即刻生效，你很快就能更改。在此之前，Summer Games 仍会在 Agent 发布游戏前征求游戏所有者同意；价格、A/B 测试和成员变更也会先征求你的同意。

关闭某个开关后，Agent 会先征求你的同意。它会提供一个链接（https://www.summerengine.com/studio/approvals/<id>），打开的 Studio 标签页会显示请求，并提供 Approve 和 Decline 选项。获得批准前不会进行任何更改。Agent 在更改 Agent 权限或自动充值、参加游戏创作活动或更改分析事件上限前，始终会先征求同意。Studio > Settings > Agent activity 会按时间倒序列出 Agent 所做的更改或发出的请求，并为价格、促销活动、国家/地区价格、成员角色、团队名称和事件上限提供撤销功能。

生成内容和付费构建会消耗你的 Summer 积分。在 Studio Billing 中开启自动充值：当积分低于你设定的数值时，Summer 会按你选择的金额充值，但不会超过你设定的月度限额。Agent 绝不会自行更改自动充值设置。积分用尽时，你的 Agent 会收到 no_credits 错误和一个链接：https://www.summerengine.com/studio/credits。

未经你的明确确认，Summer 绝不会安装软件。库条目在结构上受到限制（通过 CI 中的 capability lint），无法指示 Agent访问网络、凭据或包管理器。

开始使用：一个提示词

打开你的 AI Agent（Claude Code、Cursor、Codex、Copilot、Devin Desktop 等），然后粘贴：

安装 Summer Engine，我们来制作一款游戏。阅读 github.com/summerengine/summer，检查我已安装的内容，安装缺少的部分，并打开一个入门项目，这样我们就可以开始制作了。

Agent 会阅读此 README，检查你的设备上已有的内容，并只在其命令行中执行缺少的步骤。

首次运行将会：

1. 通过 npx 获取 summer-engine npm 包（约 2 MB）。
2. 将 Summer 的游戏开发技能安装到 ~/.claude/skills/（或你的 Agent 用户技能目录），以便 Agent 在下次会话中加载这些技能。
3. 运行 npx -y summer-engine@latest dev：如果尚未安装 Summer Engine 应用，就下载它（约 660 MB），创建一个入门项目，并在引擎中打开。

制作游戏无需登录。只有当你首次使用 Summer 云端服务（生成素材、发布）时，Agent 才会提示你登录。

没有命令行的 Agent（Claude Desktop、带本地服务的聊天应用）会通过 MCP 执行相同步骤：在你同意安装引擎后，summer_projects_create_local 会创建入门项目，summer_projects_open_local 会打开该项目。

在大多数 Agent（Claude Code、Codex、Cursor、GitHub Copilot（VS Code、CLI、JetBrains）、Zed、Cline、Kilo Code、OpenCode、Devin Desktop、Antigravity、Kiro、Trae、Warp、Goose、Hermes、Crush、Amp、Factory、Junie、Qwen Code、Kimi Code、Grok Build 和 Mistral Vibe）中，设置还会连接 Summer Games（summer-games），让 Agent 可以查看你的好友、创建派对并代表你发送消息。你只需登录一次；设置过程会显示适用于你的 Agent 的操作步骤（Claude Code：/mcp，选择 summer-games；Codex：/mcp login summer-games；Cursor：在其 MCP 设置中点击 summer-games 旁的 Connect）。浏览器中会打开 summer.games 页面；登录并选择 Allow。

然后让 Agent 开始制作。

Claude Code：Summer 插件

在 Claude Code 中，输入：

/plugin install summer --marketplace summerengine/summer

然后输入 /summer:start。大约五分钟内，它就能让第一款游戏运行起来，只需你确认一次，无需登录：你可以选择一个已经可以运行的模板，也可以根据构想，让 Summer 在聊天中绘制概念图并据此规划，然后在 Summer Engine 桌面应用中构建游戏。该插件提供 Summer 的技能和两个 MCP 服务：summer-engine 用于操控桌面应用（需要 Node），summer-cloud 是 Summer 托管的服务（使用 /mcp 登录一次）。请使用插件或 summer setup claude-code，不要同时使用两者：它们会安装相同的技能。

只需要素材？

音效、音乐、语音、图像、3D 模型、动作和视频都在 Summer 的服务器上生成，因此无需安装 Summer Engine 应用。最快捷的方式是在连接中使用托管服务：无需 Node，也无需安装。若要获取素材技能，也可以改为粘贴：

将 Summer 连接到此 Agent，让我可以制作游戏素材。阅读 github.com/summerengine/summer，连接到 Summer 并帮我登录。跳过 Summer Engine 应用和入门项目，我只需要素材。

Agent 会安装素材技能和 MCP 配置（summer-engine 4.0.0 或更高版本），并帮你登录。它不会下载引擎。每个素材都会以普通文件的形式保存到你的 Summer 资源库中：3D 模型为 GLB，图像为 PNG、JPG 或 WebP，音频为 MP3 或 WAV，视频为 MP4。Agent 会将每个文件保存到你的项目中（引擎的素材文件夹，或你指定的文件夹），因此任何引擎或 Web 应用都可以使用这些文件。

致正在阅读本文的 Agent：安装指南

node --version

winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements
$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')
node --version

npx -y summer-engine@latest doctor --json

npx -y summer-engine@latest setup claude-code --yes --force

npx -y summer-engine@latest install

npx -y summer-engine@latest login

npx -y summer-engine@latest doctor --json

cd ~/Projects   # or wherever the user keeps code

npx -y summer-engine@latest dev --yes 3d-basic my-fps-game

# Poll doctor until local-api flips to ok (max ~30s):
for i in 1 2 3 4 5 6; do
  npx -y summer-engine@latest doctor --json | grep -A2 '"id": "local-api"' | grep -q '"status": "ok"' && break
  sleep 5
done

生命周期：创建 → 测试 → 发布 → 增长

这些操作在托管的 Summer 服务上运行；执行 summer login 后，本地服务也可以运行这些操作。

Agent 如何调用 Summer

每项功能都是一个名为 <area>.<action> 的操作：assets.generate_image、store.publish、pricing.set_base。

• 直接工具覆盖常见任务：在操作名称前加上 summer_，并用 _ 替换 .（games.list 对应 summer_games_list）。引擎工具保留其 3.x 名称（summer_add_node、summer_run_script、summer_play、summer_screenshot），制作工具保留 summer_tool_<slug> 的形式。
• 其他所有操作：summer_search 根据你用文字描述的任务查找对应操作，并返回其准确输入。summer_call 执行该操作：{op, input, dryRun?, idempotencyKey?}。
• 统一的响应格式：成功完成时返回带有 result 的 done；运行中时返回带有任务的 running（每次调用等待最多 50 秒的 summer_jobs_wait 可继续等待）；需要批准时返回带有链接的 needs_approval；试运行时返回带有预览的 dry_run；出错时返回带有 code、message 和唯一一个 next 步骤的错误。
• 可安全尝试：所有更改都支持 dryRun: true（不会更改任何内容，也不会花费任何费用；涉及支出时会显示你自己的额度估算）和 idempotencyKey，因此重试不会重复执行。
• 错误代码：invalid_input、not_signed_in、forbidden、not_found、conflict、idempotency_conflict、in_progress、rate_limited、no_credits、over_limit、engine_not_running、engine_lacks_op、unsupported、not_in_profile、moved、outcome_unknown、unavailable、internal。
• 所有 4.x 版本仍支持 3.x 名称：summer_call 在所有服务上都接受这些名称；summer mcp --toolsets legacy 会在本地服务上列出这些名称；只要你安装的技能版本低于 4.0，本地服务也会自行列出这些名称。升级后首次启动会刷新你安装的 Summer 技能，因此升级后，除非你主动要求，否则不会显示旧版列表。旧名称与操作之间的映射见 registry/operations/legacy-names.json。

同样的操作也可以通过 shell 运行：summer <area> <action> --<field> <value>（例如 summer assets generate-image --prompt "a cozy pixel-art tavern" --aspect-ratio 16:9），支持 --dry-run、--wait（持续等待任务或审批完成）和 --json（只输出响应；任何 ok 响应的退出代码均为 0，出错时为 1）。summer whoami 会显示当前登录用户。summer ops search <words> 和 summer ops describe <op> 用于查找操作及其输入。所有读取信息的命令都支持 --json。

此仓库包含什么

summer/
├── README.md          # you are here: overview + the install playbook
├── AGENTS.md          # the agent guide: trust, the library, navigation, engine rules
├── src/               # the Summer software (TypeScript)
│   ├── core/          #   shared implementations (capabilities used by both CLI and MCP)
│   ├── cli/           #   the `summer` command surface
│   ├── mcp/           #   the MCP server and tool adapters
│   ├── project-memory/#   .summer/ read/write
│   └── installer/     #   agent detection and config writing for every supported client
├── library/           # the Library: tools, skills, templates, references
├── registry/          # schemas + generated/ (the compiled index everything reads; never hand-edited)
├── evals/             # evidence the library works: routing, skills, examples, templates, tools, end-to-end
├── integrations/      # one folder per supported agent: what gets installed where
├── commands/          # the shipped slash commands (/summer, /gameskill, the plugin's /summer:start)
├── hooks/             # lifecycle hooks: session-start orientation, opt-in pre-commit doctor
├── assets/            # files the tools ship with: offline API docs, engine-side probe and audit scripts
├── scripts/           # generate-registry (the compiler), validate-library (schema + capability lint)
├── tests/             # v2 prose behaviour specs (the code tests sit next to the code in src/)
├── docs/              # development guide, migration notes, design contract
└── .claude-plugin/ …  # plugin manifests for Claude Code, Codex, Cursor and Factory (generated)

一条规则贯穿始终：每个条目只描述一次（在 library/ 中使用 resource.yaml），注册表编译器会生成其余所有内容——可搜索索引、每个 Agent 插件清单、技能安装器数据、计数和旧版别名。CI 会在发现任何不一致时失败。参见 docs/design/CONTRACT.md。

资源库

六种条目，均可通过同一个生成的索引搜索：

• 技能——如何把某件事做好（FPS 控制器、场景构图、调试规范、VFX 配方、音频设计……）。采用开放的 Agent Skills 格式，因此任何符合规范的工具都能使用。
• 示例——经过验证的可运行实例，并附有必需的证据（截图、验证回执）——无法证明其有效的示例不会发布。
• 模板——完整的项目基础（平台游戏、FPS、竞速、Roguelike、多人游戏起始项目……），每个模板都固定到确切的提交，并附有经过验证的树摘要。summer create <slug> 会准确获取该提交，重新计算摘要并在不匹配时拒绝，然后将固定信息记录到项目的 .summer/project.json 中——绝不会使用某个分支今天恰好包含的内容。两个小型模板（3d-basic、empty）内置其中，可离线生成。使用 summer list templates 浏览；固定规则和摘要公式见 library/templates/README.md。
• 合集——经过策划且兼容的创作素材：包含风格规则和预设的资源集。目前尚无合集发布。
• 参考资料——事实信息：引擎版本兼容性、GDScript 风格、工具参考。
• 工具——可执行的功能本身，与其他条目一样在同一注册表中描述，方便 Agent 发现可用功能。

Agent 不会浏览文件夹；它们会通过 summer_docs_search（或 summer tool search-library），按摘要、用例和分类检索编译后的索引（registry/generated/index.json），然后使用 summer_docs_read 加载匹配项。ID 永久不变，因此即使条目经过任何重新整理，反馈和证据也会始终跟随该条目。

生态系统

 Claude Code · Codex · Cursor · Gemini · Copilot · OpenCode · …
        │            (any AI coding agent)
        ▼
 ┌──────────────────────────────────────────────┐
 │  Summer (this repo, npm: summer-engine)      │
 │  library · registry · MCP tools · CLI        │
 │  project memory (.summer/) · evals           │
 └──────────────────────────────────────────────┘
        │ MCP / local API
        ▼
 Summer Engine (desktop app: editor + runtime)
        │
        ▼
 summer.games store · your players

Summer 可与任何 Agent 配合使用：integrations/ 会针对每种 Agent 调整同一套生成系统。各项内容的安装位置见 integrations/README.md。

项目记忆：.summer/

每个 Summer 项目都带有自己的记忆，以便于阅读的 Markdown 和 JSON 格式保存：

• GameSoul.md——游戏的核心承诺，在头脑风暴阶段编写，并由每个构建技能读取。
• memory/——不可偏移的固定事实：角色口吻、世界设定、提供方绑定。
• project.json——模板固定信息（id、version、repo + commit + tree_digest，或 builtin: true）、创建该项目的 toolkit_version，以及 created_at：用于明确记录创建此项目时使用的模板及其提交。

这样一来，任何新 Agent——无论哪个 Agent、哪个会话——都能在没有原始对话的情况下回答这是什么游戏、已完成什么、验证了什么、接下来要做什么。使用 summer memory 自行查看。

使用自带技能

有两种方式可以使用自己的素材扩展 Summer：

1. 将技能放入你的 Agent，使用常规方式（~/.claude/skills/、.cursor/rules/ 等）——Summer 的技能采用标准 Agent Skills 格式，可与你的技能共存。
2. 将技能交给 Summer（计划中）：外部 Summer 格式资源将支持安装到项目、用户或工作室范围，并记录在 .summer/project.json 中，让项目中的每个 Agent 都能看到。Schema 部分已就绪——外部条目采用命名空间（<publisher>/<kind>/<slug>），绝不会悄然覆盖官方 ID；安装器尚未构建。

官方条目通过 PR 纳入此仓库，并受 Schema 验证和功能 lint 检查约束。

知识库反馈

• Agent 可以报告某个条目的使用效果（使用 summer_call 和 docs.feedback）：有效 / 修复后有效 / 错误 / 已过时 / 不完整 / 不适用 / 路由错误。完整发送的内容包括：条目 ID、每个条目对应的一个结果词、可选的备注和偏差说明（最多 280 个字符，关于该条目）、引擎版本、Agent 自行报告的模型 ID、此 CLI 的版本、宿主应用名称/版本、每个进程随机生成的会话 ID，以及——仅在未登录时——随机生成的安装 UUID（登录时则改为发送账户令牌）。此架构无法携带你的代码、文件或聊天内容。 某台机器上的首次调用不会发送任何内容，只会返回一条通知；设置 SUMMER_NO_TELEMETRY=1 或 DO_NOT_TRACK=1 可完全关闭此功能。
• 目前，这些报告会发送到一个只能写入的邮箱，由维护人员查看。只有经过验证的结果才会计入；条目的排名绝不会依据受欢迎程度。

遥测

Summer 会发送少量使用情况记录，帮助我们了解哪些工具和命令有效，以及它们在哪些 Agent 应用中有效。它绝不会发送提示词、代码、文件内容、文件路径、项目名称、工具参数或结果，也不会发送你输入的任何内容。 设置 SUMMER_NO_TELEMETRY=1 或 DO_NOT_TRACK=1 可全部关闭。

电脑上首次运行 summer 命令时（任何命令，包括 summer mcp），都会向 stderr 打印一次此通知：

Summer collects usage data to improve its tools: which commands and tools run, whether they worked, and which agent app ran them.
No prompts, code, file names or project names. Opt out: SUMMER_NO_TELEMETRY=1
Details: https://github.com/summerengine/summer#telemetry

每条记录都会发送到 Summer 服务上的 /api/mcp/log-local-call。每个请求还会在请求头中注明此软件包的版本。

工具调用或命令在适用时会添加以下字段：

知识库反馈邮箱与上述遥测相互独立，相关说明见上文。向 Summer 服务发送请求（生成、资源、商店）时，也会在请求头中注明你的 Agent 应用、版本和所用工具；设置上述两个变量可移除这些信息。

下载的内容

我们会在对磁盘进行任何操作前告知你。

不会下载或收集的内容：

• 除 遥测 中所列内容外，不会收集遥测数据。诊断信息保留在本地。
• 不会静默更新引擎。summer install 会检查已安装的版本，并在替换前征求同意（或需要 --yes）；不会在你不知情的情况下更新引擎。
• 不会下载模型权重。AI 生成在 Summer Engine Studio（云端）运行，不会在你的机器上运行。

开源与非开源内容

发布到 summer.games、多人游戏托管、匹配和 Grow 已上线。

CLI 参考

贡献

本库通过 PR 持续扩展，CI 会严格把关：

1. 报告有问题的条目。 提交 issue，并引用提示词和响应；如果你是 Agent，也可以在确认失败后通过 summer_call 提交 docs.feedback。
2. 改进或添加条目。 添加 library/<kind>/<slug>/，其中包含 resource.yaml（技能还需包含 SKILL.md）。运行 npm run validate:library，使用 node scripts/generate-registry/cli.ts 重新生成，然后将两者一并提交。CI 会检查架构、能力 lint 和注册表一致性。

docs/DEVELOPMENT.md 是贡献者指南；docs/design/CONTRACT.md 是规则手册。 如何使用真实引擎和真实 Agent 对未发布的构建进行端到端测试： docs/TESTING.md。

文档

• Agent 指南（AGENTS.md） — Agent 如何使用 Summer，包括验证阶梯
• 开发指南 · v2 → v3 迁移
• 设计：契约 · 决策
• Agent 支持映射 · 模板固定 · 评测
• 各宿主说明：Claude Code · Codex · Cursor · OpenCode

许可证

本仓库中的所有内容均采用 MIT 许可证。Summer Engine 本身为专有软件。请参阅哪些内容开源，哪些不开源。

部分流程技能（头脑风暴、编写计划、编写技能、调查缺陷）改编自采用 MIT 许可证的 obra/superpowers。归属信息见 NOTICE。

链接

• 网站
• 下载 Summer Engine
• 文档
• Issues
• 支持 · 隐私政策 · 条款