# 网站与后端自动接入部署

2026-10-26目录更新：源码工程为runtime/game；从仓库根执行pnpm build:docs生成运行下载包及文档站，发行包位于.artifacts/releases/game，文档站位于.artifacts/sites/game。原deploy模板、运行配置及线上/本地持久数据保持原位置；按新代码目录构建，不移动数据库、上传或用户资产。这里描述操作，不自动执行。

## 构建站点

在仓库根目录执行：

```powershell
pnpm build:docs
```

产物为.artifacts/sites/game，包含静态文档、Markdown、llms.txt、版本清单、模板、Go示例和Windows/Linux下载包。站点没有网页联调工作台或手工JSON表单。固定下载版本不能覆盖为其他内容。

首页是AI执行协议；agent.json为机器入口，openapi.json为接入API定义，state-actions.json声明状态动作。部署须包含这些文件及examples目录，不能只上传HTML。代理或静态托管不要把JSON、Markdown或Go源码请求重写到HTML首页；AI必须能直接读取原文。版本索引和机器协议建议及时刷新缓存。

## 部署与路由

上传完整站点目录，配置实际域名的HTTPS。参考[Nginx模板](portal-nginx.example.conf)，root改为站点目录，`/api/sdk/`转发到已更新的火花API。管理后台也须部署本次更新。站点不包含数据库，不需要网页登录；接入API用每游戏独立凭证。

静态站点仅供读取资料和下载。双方后端发起资料提交、清单拉取与测试回执请求；浏览器不操作联调。平台运维程序预置游戏身份、唯一前缀、微信配置、中转路由和环境凭据，不把内部签名密钥交给公开网站。

管理后台不通过文档站公开代理；`/api/admin/`继续使用原有管理员身份与审计。游戏本机服务和中转内部接口留在可信网络。

## 后台只审核

1. 游戏后端自动提交资料、数据能力与任务建议。
2. 后台“自建游戏库”（/selfGame）的“待审核”展示后端申请、单次奖励与推广参与名额，在同一记录详情完成入驻、任务及联调审核。App申请在“自建App库”（/selfApp）处理；/sdk仅为接入设置。任务审核通过后自动生成禁用任务和版本化要求，独立后端自行读取，最终审核后启用。
3. 双方后端执行测试并交换回执，系统自动统计每任务达标/未达标覆盖，齐全后进入待审核。
4. 审核人员通过或驳回联调结果，原因经API返回。通过明确授权同步当前资料、上架及启用所审任务，由后端自动执行，不再另填字段、点发布或手工验收测试。

## 更新与历史保护

接入API由v1升级为v2：submission新增tasks，任务字段来自capabilities；旧的人工publish流程取消。旧提交需按新协议补充任务建议后重新审核，不会默认为已批准。已有正式参与或任务记录的旧任务不自动替换，保护历史奖励规则。

保留历史downloads目录，更新静态页面和索引，不使用旧产物增量残留console.html/console.js；部署完整新目录后确认这两个旧地址返回404。程序固定版本不会随站点更新而自动升级。真实微信和跨云网络仍需部署后通过双方后端验证。

## 双模式公共服务

参见[双模式接入与内网部署](docs/双模式接入与内网部署.md)。网站同时提供本地 SDK 下载和内网 API 协议。内网运行 API 不通过公网文档站代理；集中服务使用 config.central.example.json、PostgreSQL 和 huohua-public-service，游戏可按环境选择 local 或 central。