{ "schemaVersion": 1, "integrationApiVersion": 3, "audience": "game-backend-development-agent", "entrypoint": "ai-integration.md", "openapi": "openapi.json", "releases": "releases.json", "stateActions": "state-actions.json", "runtimeContract": "docs/接口契约.md", "runtimeGuide": "docs/完整接入与联调.md", "examples": [ "examples/submission.json", "examples/trial-positive.json", "examples/trial-negative.json", "examples/trial-invalid.json" ], "clients": { "runtime": "examples/game-client.go", "portal": "examples/portal-client/main.go" }, "configTemplate": "config.example.json", "requiredEnvironment": [], "environmentPolicy": "申请身份和接入地址由应用后端自动生成、保存和读取；不要求用户复制凭据或填写申请表。", "apiBaseTemplate": "/api/sdk/applications/{APPLICATION_CATEGORY}/{SDK_APPLICATION_ID}", "executionOrder": [ "read_agent_and_openapi", "read_own_backend_profile", "start_automatic_enrollment", "poll_enrollment_review", "read_private_identity_and_sdk_receipt", "submit_updated_application_and_task_proposals", "poll_review_and_fetch_manifest", "implement_real_backend_collectors", "submit_positive_negative_and_invalid_cases", "verify_actual_runtime_transport_separately", "poll_review_until_approved", "record_versions_and_results" ], "completion": { "phase": "approved", "requiredEvidence": [ "revision", "manifest.version", "task positive/negative checks", "actual runtime/transport verification results" ], "warning": "sandbox/ready不证明微信、真实道具、真实进度或钱包已经验证。" }, "constraints": [ "不需要用户复制指令或填写网页表单", "审核等待不是授权通过", "不公开或上传密钥", "不修改公共服务内部实现", "禁止绕过历史规则保护或伪造真实游戏数据" ], "sdkClientEnvironment": [ "SDK_PORTAL_URL", "SDK_PORTAL_TOKEN", "APPLICATION_CATEGORY", "SDK_APPLICATION_ID" ], "enrollment": { "url": "/api/sdk/enrollments/applications", "profileSource": "own_backend_existing_data", "identity": "automatically_generated_and_persisted", "firstAction": "submit_profile_then_poll_review", "credentialPolicy": "read_private_backend_identity_and_receipt_no_manual_copy" }, "runtimeOpenAPI": "runtime-openapi.json", "featuresConfigTemplate": "config.features.example.json", "runtimeFeatureMinimumVersion": "0.4.0", "runtimeModes": { "local": { "transport": "loopback", "program": "huohua-game-service", "storage": "sqlite", "requiresDownload": true }, "central": { "transport": "private_https", "program": "huohua-public-service", "storage": "postgresql_schema_per_game", "requiresDownload": false } }, "runtimeEnvironment": [ "HUOHUA_SERVICE_MODE", "HUOHUA_SERVICE_URL", "HUOHUA_GAME_ID", "HUOHUA_GAME_TOKEN" ], "modeGuide": "docs/双模式接入与内网部署.md", "centralConfigTemplate": "config.central.example.json", "runtimeFeatures": { "stamina": "optional authoritative balance", "ads": [ "splash", "rewarded" ], "leaderboards": "one configured field per permanent board, no periods" }, "resources": [ { "url": "agent.json", "label": "AI机器入口", "audience": "game_ai" }, { "url": "llms.txt", "label": "AI资源索引", "audience": "game_ai" }, { "url": "openapi.json", "label": "后端接入API定义", "audience": "game_ai" }, { "url": "runtime-openapi.json", "label": "双模式运行API定义", "audience": "game_ai" }, { "url": "state-actions.json", "label": "状态与动作映射", "audience": "game_ai" }, { "url": "releases.json", "label": "版本与下载校验清单", "audience": "both" }, { "url": "downloads.html", "label": "全部版本与下载说明", "audience": "both" }, { "url": "ai-integration.md", "label": "AI完整执行说明", "audience": "game_ai" }, { "url": "integration-api.md", "label": "后端交换与联调规则", "audience": "game_ai" }, { "url": "config.example.json", "label": "游戏公共服务配置模板", "audience": "game_ai" }, { "url": "config.features.example.json", "label": "启用体力/开屏激励/字段榜配置模板", "audience": "game_ai" }, { "url": "config.central.example.json", "label": "集中服务部署模板", "audience": "platform_ops" }, { "url": "relay.example.json", "label": "平台中转配置模板", "audience": "platform_ops" }, { "url": "examples/portal-client/main.go", "label": "后端接入API Go客户端", "audience": "game_ai" }, { "url": "examples/game-client.go", "label": "双模式公共服务Go调用示例", "audience": "game_ai" }, { "url": "examples/submission.json", "label": "游戏资料与任务建议样例", "audience": "game_ai" }, { "url": "examples/trial-positive.json", "label": "达标联调样例", "audience": "game_ai" }, { "url": "examples/trial-negative.json", "label": "未达标联调样例", "audience": "game_ai" }, { "url": "examples/trial-invalid.json", "label": "错误类型联调样例", "audience": "game_ai" }, { "url": "docs/统一应用自动入驻.md", "label": "统一应用自动入驻", "audience": "game_ai" }, { "url": "docs/接口契约.md", "label": "接口契约", "audience": "game_ai" }, { "url": "docs/完整接入与联调.md", "label": "完整接入与联调", "audience": "game_ai" }, { "url": "docs/部署升级.md", "label": "部署升级", "audience": "both" }, { "url": "docs/体力广告与排行榜.md", "label": "体力广告与排行榜", "audience": "game_ai" }, { "url": "docs/水果游戏0.4.0适配清单.md", "label": "水果游戏0.4.0适配清单", "audience": "game_ai" }, { "url": "docs/双模式接入与内网部署.md", "label": "双模式接入与内网部署", "audience": "game_ai" }, { "url": "deployment.md", "label": "接入站点与API部署说明", "audience": "platform_ops" }, { "url": "portal-nginx.example.conf", "label": "接入站点Nginx模板", "audience": "platform_ops" }, { "url": "deploy/huohua-game-service@.service", "label": "huohua-game-service@.service", "audience": "platform_ops" }, { "url": "deploy/huohua-public-service.service", "label": "huohua-public-service.service", "audience": "platform_ops" }, { "url": "deploy/huohua-relay.service", "label": "huohua-relay.service", "audience": "platform_ops" }, { "url": "deploy/public-nginx.example.conf", "label": "public-nginx.example.conf", "audience": "platform_ops" }, { "url": "deploy/relay-nginx.example.conf", "label": "relay-nginx.example.conf", "audience": "platform_ops" } ], "downloads": { "version": "0.7.6", "packages": [ { "os": "windows", "arch": "amd64", "url": "downloads/0.7.6/huohua-game-services-0.7.6-windows-amd64.zip", "sha256": "35b0cfc3f098a15cd87667f94ffa93f56728d6bf481d241705a12092a203a051", "size": 23611625 }, { "os": "linux", "arch": "amd64", "url": "downloads/0.7.6/huohua-game-services-0.7.6-linux-amd64.zip", "sha256": "fb45b4be834ee7d0f7885989131286a98d002388397814e70e92cffe0c228501", "size": 23469432 } ] } }