执行者：游戏后端开发 AI · 接入协议 v2 · 运行程序 0.7.6

AI 后端接入执行协议

如果你是接到此网址的游戏开发 AI，按下面顺序读取资源并执行。所有正文与协议无需执行浏览器 JavaScript 即可获取。用户无需复制指令或操作网页。

01 · 读取机器入口

资源	用途
`agent.json`	机器入口：环境、资源、执行顺序和完成标准
`openapi.json`	OpenAPI 3.1：认证、请求/响应、错误码
`ai-integration.md`	完整执行指令与边界
`state-actions.json`	接入状态到下一步动作
`releases.json`	固定版本、平台架构、下载和SHA256

02 · 选择 SDK 或内网 API

读取 HUOHUA_SERVICE_MODE、HUOHUA_SERVICE_URL、HUOHUA_GAME_ID、HUOHUA_GAME_TOKEN。local 下载本地 SDK；central 直接调用平台提供的内网 HTTPS API，不下载或启动 SDK。两种模式共用接口，每游戏每环境只能选一个数据源。先读双模式接入说明。

当前固定版本：0.7.6。按实际系统和架构下载，校验SHA256后解压。新版本包包含本地 SDK、集中服务、中转和迁移工具；按模式使用，不要把四个程序全部部署到每个游戏。

平台	下载直链	大小
windows / amd64	`huohua-game-services-0.7.6-windows-amd64.zip`	23611625 bytes
SHA256	`35b0cfc3f098a15cd87667f94ffa93f56728d6bf481d241705a12092a203a051`
linux / amd64	`huohua-game-services-0.7.6-linux-amd64.zip`	23469432 bytes
SHA256	`fb45b4be834ee7d0f7885989131286a98d002388397814e70e92cffe0c228501`

固定版本与校验值同样位于agent.json的downloads和releases.json。保留版本记录，不自动替换为latest。

03 · 检查游戏环境

从当前游戏开发环境读取以上变量。缺失则报告所缺参数；不要猜测或复用其他游戏凭据。SDK_PORTAL_TOKEN仅调用接入API；运行调用凭据与接入审核凭据分开；central 的微信和广告密钥由公共服务平台配置，本地模式按配置模板部署。中转凭据分别配置，见运行程序配置模板。

04 · 依次执行

选择模式并固定版本 → local下载校验 / central检查内网服务兼容版本 → 提交真实资料与任务建议 → 读取审核后的manifest → 按数据要求开发真实后端采集与上报 → 交换正反案例及回执 → 验证实际运行链路 → 等待审核并记录结果。

API路径模板：/api/sdk/applications/{APPLICATION_CATEGORY}/{SDK_APPLICATION_ID}。具体方法与正文以openapi.json为准。请求使用游戏环境中的Bearer凭据，不在公开资源中查找密钥。

05 · 按状态推进

phase	动作
`awaiting_submission`	读取真实游戏资料与能力，生成任务建议，PUT submission
`awaiting_tasks_review`	等待审核；不要自行批准或反复更改相同资料
`integrating`	读取manifest，按fields开发真实采集与上报；提交每任务有效正反案例
`awaiting_review`	后端覆盖完成，等待审核，不把ready当成上架
`changes_requested`	taskReview被驳回则修改资料再提交；联调被驳回则修正游戏代码后提交新事件
`approved`	记录revision、manifest.version和结果；本版本测试记录固定，不再新增测试

等待审核每60秒查询；409先读取状态及反馈；401停止检查凭据；5xx退避重试。同业务重试保持事件ID和正文一致。

06 · 完整接入资源

资源地址	内容	使用方
`agent.json`	AI机器入口	游戏开发 AI
`llms.txt`	AI资源索引	游戏开发 AI
`openapi.json`	后端接入API定义	游戏开发 AI
`runtime-openapi.json`	双模式运行API定义	游戏开发 AI
`state-actions.json`	状态与动作映射	游戏开发 AI
`releases.json`	版本与下载校验清单	游戏开发 AI / 平台部署
`downloads.html`	全部版本与下载说明	游戏开发 AI / 平台部署
`ai-integration.md`	AI完整执行说明	游戏开发 AI
`integration-api.md`	后端交换与联调规则	游戏开发 AI
`config.example.json`	游戏公共服务配置模板	游戏开发 AI
`config.features.example.json`	启用体力/开屏激励/字段榜配置模板	游戏开发 AI
`config.central.example.json`	集中服务部署模板	平台部署
`relay.example.json`	平台中转配置模板	平台部署
`examples/portal-client/main.go`	后端接入API Go客户端	游戏开发 AI
`examples/game-client.go`	双模式公共服务Go调用示例	游戏开发 AI
`examples/submission.json`	游戏资料与任务建议样例	游戏开发 AI
`examples/trial-positive.json`	达标联调样例	游戏开发 AI
`examples/trial-negative.json`	未达标联调样例	游戏开发 AI
`examples/trial-invalid.json`	错误类型联调样例	游戏开发 AI
`docs/统一应用自动入驻.md`	统一应用自动入驻	游戏开发 AI
`docs/接口契约.md`	接口契约	游戏开发 AI
`docs/完整接入与联调.md`	完整接入与联调	游戏开发 AI
`docs/部署升级.md`	部署升级	游戏开发 AI / 平台部署
`docs/体力广告与排行榜.md`	体力广告与排行榜	游戏开发 AI
`docs/水果游戏0.4.0适配清单.md`	水果游戏0.4.0适配清单	游戏开发 AI
`docs/双模式接入与内网部署.md`	双模式接入与内网部署	游戏开发 AI
`deployment.md`	接入站点与API部署说明	平台部署
`portal-nginx.example.conf`	接入站点Nginx模板	平台部署
`deploy/huohua-game-service@.service`	huohua-game-service@.service	平台部署
`deploy/huohua-public-service.service`	huohua-public-service.service	平台部署
`deploy/huohua-relay.service`	huohua-relay.service	平台部署
`deploy/public-nginx.example.conf`	public-nginx.example.conf	平台部署
`deploy/relay-nginx.example.conf`	relay-nginx.example.conf	平台部署

样例仅说明结构。提交前替换为真实游戏资料；联调使用返回的manifest.version、字段和目标值，不固定使用样例版本1或等级10。错误类型样例应返回valid=false，不能计入有效覆盖。游戏AI读取游戏侧资源；平台中转和站点部署模板由平台维护。

07 · 判断是否完成

必须记录revision、manifest.version、每个任务的正反案例回执、实际运行链路验证结果及最终phase。ready或sandbox成功不等于微信、真实道具、真实进度或奖励支付已经通过；等待审核不等于允许上线。