{
  "schemaVersion": 1,
  "audience": "app-backend-development-agent",
  "serviceVersion": "0.6.6",
  "entrypoint": "docs/AI接入协议.md",
  "deploymentGuide": "docs/部署升级与数据迁移.md",
  "controlOpenAPI": "control-openapi.json",
  "runtimeOpenAPI": "runtime-openapi.json",
  "stateActions": "state-actions.json",
  "releases": "releases.json",
  "downloads": {
    "version": "0.6.6",
    "programs": [
      "huohua-app-agent",
      "huohua-app-service",
      "huohua-app-transfer"
    ],
    "packages": [
      {
        "os": "windows",
        "arch": "amd64",
        "url": "downloads/0.6.6/huohua-app-services-0.6.6-windows-amd64.zip",
        "size": 17875751,
        "sha256": "dd10ea162ab18b0a2476144e8ff2cb957d454304c1ccb1b0587386e0cc2b2863"
      },
      {
        "os": "linux",
        "arch": "amd64",
        "url": "downloads/0.6.6/huohua-app-services-0.6.6-linux-amd64.zip",
        "size": 17757276,
        "sha256": "13a7054fe2c7796cd2892f0f8f03b03bd403499b025b7cc131c05f4a3c61aa65"
      }
    ]
  },
  "runtimeModes": {
    "local": {
      "requiresDownload": true,
      "program": "huohua-app-agent",
      "transport": "loopback",
      "storage": "sqlite"
    },
    "central": {
      "requiresDownload": false,
      "program": "huohua-app-service",
      "transport": "private_https",
      "storage": "postgresql_schema_per_app"
    }
  },
  "requiredEnvironment": [],
  "controlBaseTemplate": "/api/sdk/applications/{APPLICATION_CATEGORY}/{APP_APPLICATION_ID}",
  "runtimeBaseTemplate": "/v1/apps/{HUOHUA_APP_ID}",
  "featureGuide": "docs/广告先发奖异步验真与火花核查.md",
  "conditionalEnvironment": {
    "managementAndAdCallback": [
      "HUOHUA_APP_MANAGEMENT_TOKEN"
    ],
    "csjRewarded": [
      "HUOHUA_APP_CSJ_UNLOCK_KEY"
    ],
    "gdtRewarded": [
      "HUOHUA_APP_GDT_REWARD_KEY"
    ]
  },
  "userIdFormula": {
    "format": "prefix + year_last_digit + MMDD + six_random_digits",
    "timezone": "Asia/Shanghai",
    "prefixPattern": "^[a-z]{2,3}$",
    "allocation": "platform-global-app-and-game-registry"
  },
  "prefixAllocation": "/api/sdk/applications/{APPLICATION_CATEGORY}/{APP_APPLICATION_ID}/user-id-prefix",
  "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"
  ],
  "constraints": [
    "App前端不持有公共服务密钥",
    "默认公共服务验证登录名和密码，外部身份适配需显式启用",
    "不得把沙箱通过当作真实业务或奖励到账",
    "同App同环境一个权威数据源，禁止自动双写或故障切换",
    "广告仅开屏与激励；穿山甲与腾讯优量汇直连均已适配，按独立渠道协议验真",
    "cloudSync/payment/membership当前未实现",
    "不使用游戏SDK或游戏运行API"
  ],
  "resources": [
    {
      "url": "agent.json",
      "label": "AI机器入口"
    },
    {
      "url": "control-openapi.json",
      "label": "App资料、任务和审核状态API"
    },
    {
      "url": "runtime-openapi.json",
      "label": "App公共运行API"
    },
    {
      "url": "state-actions.json",
      "label": "审核状态与动作"
    },
    {
      "url": "releases.json",
      "label": "固定版本与下载校验"
    },
    {
      "url": "llms.txt",
      "label": "AI资源索引"
    },
    {
      "url": "config.local.example.json",
      "label": "config.local.example.json"
    },
    {
      "url": "config.central.example.json",
      "label": "config.central.example.json"
    },
    {
      "url": "config.platform.example.json",
      "label": "config.platform.example.json"
    },
    {
      "url": "docs/AI接入协议.md",
      "label": "AI接入协议"
    },
    {
      "url": "docs/Flutter前端附属包.md",
      "label": "Flutter前端附属包"
    },
    {
      "url": "docs/在线登录与进度门禁.md",
      "label": "在线登录与进度门禁"
    },
    {
      "url": "docs/平台与登录方式.md",
      "label": "平台与登录方式"
    },
    {
      "url": "docs/广告先发奖异步验真与火花核查.md",
      "label": "广告先发奖异步验真与火花核查"
    },
    {
      "url": "docs/应用类型与登录规则.md",
      "label": "应用类型与登录规则"
    },
    {
      "url": "docs/登录名密码与统一用户ID.md",
      "label": "登录名密码与统一用户ID"
    },
    {
      "url": "docs/统一应用自动入驻.md",
      "label": "统一应用自动入驻"
    },
    {
      "url": "docs/腾讯优量汇广告配套接入.md",
      "label": "腾讯优量汇广告配套接入"
    },
    {
      "url": "docs/账号状态与公共权益广告.md",
      "label": "账号状态与公共权益广告"
    },
    {
      "url": "docs/部署升级与数据迁移.md",
      "label": "部署升级与数据迁移"
    },
    {
      "url": "examples/client/main.go",
      "label": "examples/client/main.go"
    },
    {
      "url": "examples/portal-client/main.go",
      "label": "examples/portal-client/main.go"
    },
    {
      "url": "examples/submission.json",
      "label": "submission.json"
    },
    {
      "url": "examples/trial-positive.json",
      "label": "trial-positive.json"
    },
    {
      "url": "examples/trial-negative.json",
      "label": "trial-negative.json"
    },
    {
      "url": "examples/trial-invalid.json",
      "label": "trial-invalid.json"
    },
    {
      "url": "deploy/app-agent@.service",
      "label": "app-agent@.service"
    },
    {
      "url": "deploy/app-docs-nginx.conf",
      "label": "app-docs-nginx.conf"
    },
    {
      "url": "deploy/app-private-nginx.conf",
      "label": "app-private-nginx.conf"
    },
    {
      "url": "deploy/app-service.service",
      "label": "app-service.service"
    }
  ],
  "integrationApiVersion": 3,
  "apiBaseTemplate": "/api/sdk/applications/{APPLICATION_CATEGORY}/{APP_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"
  },
  "sdkClientEnvironment": [
    "APP_PORTAL_URL",
    "APP_PORTAL_TOKEN",
    "APPLICATION_CATEGORY",
    "APP_APPLICATION_ID",
    "APPLICATION_CATEGORY"
  ],
  "environmentPolicy": "申请身份和接入地址由应用后端自动生成、保存和读取；不要求用户复制凭据或填写申请表。"
}