依据《游戏调研-paid-v3.md》的变现与持久化标准（M1–M8 / P1–P12），为 youxi/1–15 全系列规划一套统一的游戏系统：一个服务端管所有游戏的用户资料、云存档、分享记录、支付与排行榜；一个合集小游戏作为总入口；一个管理后台做运营。本套文档是实施前的完整设计蓝图。
双平台规划、微信先落地。所有设计以"平台适配层"抽象微信/抖音差异，第一阶段只实装微信端，抖音端为第二阶段买量放大器。
中国区 VPS（主链路）+ Cloudflare（辅助面）+ 国内 CDN。小游戏 request 域名必须 HTTPS + ICP 备案，主 API 必须落在国内 VPS；Cloudflare 承担管理后台托管、冷备与定时任务。详见 01 架构。
合集小游戏为主 + 爆款拆独立。15 款以分包形式装进一个「游戏合集」小游戏（合集本身即游戏库+用户中心+签到任务）；测款数据达标的单款拆出独立发布、与合集互跳导流。详见 06 合集入口。
微信小游戏（合集 + 独立爆款） 抖音小游戏（阶段 5）
wx.login · 激励视频 · midas 支付 tt.login · 激励视频 · tt 支付
│ │
└──────────────────┬─────────────────────┘
│ HTTPS · 备案域名 api.example.cn
▼
┌─────────────────────────────────────────┐ ┌───────────────────────────────┐
│ 中国区 VPS（主链路 · 必须备案） │ │ Cloudflare（辅助面） │
│ Nginx/Caddy（TLS 终结） │ 冷备 │ Pages + Access → 管理后台 SPA │
│ Hono API（Node 20，一套代码双运行时） │────▶ │ R2 → 数据库备份 / 资产源站 │
│ Postgres（业务库） · Redis（榜/限频/会话） │ │ Workers → 定时任务 / 海外预留 │
└──────────────────┬──────────────────────┘ └──────────────▲────────────────┘
│ 静态资源回源 │ HTTPS（管理域名）
国内 CDN（cdn.example.cn） 运营 / 管理人员
request / downloadFile / uploadFile 合法域名必须「HTTPS + ICP 备案 + 大陆稳定可达」。Cloudflare Workers/Pages 的默认域名无法备案且大陆访问不稳定，不能作为小游戏直连的主链路——这是本架构把主 API 放在国内 VPS、把 Cloudflare 定位为"后台托管 + 冷备 + 辅助任务"的根本原因。统一账号（users/identities）、云存档 saves、双货币钱包与流水、支付订单、分享与回流记录、排行榜、签到 streak、任务、广告事件、游戏库配置——16 张表的字段、索引与关系。
阅读 →统一响应格式与错误码、code2session 登录时序、按模块的端点清单（auth/save/lb/share/pay/task/config/admin）、支付回调验单发货流程、防作弊要点。
阅读 →game-sdk.js 设计：wx/tt 平台适配层、云存档双写+离线队列、showUnlockChoice 双/三通道组件；15 款存量 demo 的接入改造指南与 SAVE_KEY 迁移映射表。
| 角色 | 阅读顺序 | 关注点 |
|---|---|---|
| 决策者 / 立项 | 本页 → 01 → 08 | 架构与成本、阶段划分、版号/备案两个前置风险 |
| 服务端开发 | 01 → 02 → 03 | 部署拓扑、表结构、API 契约与支付回调 |
| 客户端 / 游戏开发 | 04 → 05 → 06 | SDK 接口、存量 demo 改造步骤、分包迁移矩阵 |
| 运营 | 07 → 05 → 08 | 看板指标、活动配置、分享限额策略 |
| v2 硬门槛 | 要求 | 本套规划中的落点 | 状态 |
|---|---|---|---|
| M1 持久化 | 进度跨会话、跨设备保存（≥L1 云存档），"每次从头来"= NO-GO | 02 saves 表 · 03 存档 API · 04 SDK 双写与迁移 | 已覆盖 |
| M2 经济系统 | 软/硬双货币 + 体力，sink/source 成文 | 02 wallets/currency_txns · 07 货币配置模块 | 已覆盖 |
| M3 付费点 ≥3 类 | 便利型 ≥2 + 能力/表达型 ≥1 | 03 pay 模块 · 06 商店 · 08 阶段 4 | 阶段 4 实装 |
| M4 双通道 | 每个摩擦点"广告 or 付费（or 分享求助）" | 05 专项 · 04 showUnlockChoice 组件 | 已覆盖 |
| M5 首付费触点 | 首充 ¥1–6 在首个卡点弹出 | 06 商店设计 · 07 活动/弹窗配置开关 | 阶段 4 实装 |
| M6 卡点日程表 | D1→D7+ 至少 4 个"免费可过但慢"卡点 | 07 活动配置 · 04 SDK 埋点上报支撑校准 | 已覆盖 |
| M7 长线深度 ≥30 天 | 等级/图鉴/赛季表排到 30 天+ | 06 签到任务中心 · 02 tasks/signins/leaderboard 赛季 | 已覆盖 |
| M8 支付合规 | 服务端验单发货、概率公示、防沉迷、分享不强制 | 03 回调验签流程 · 05 合规红线 · 08 版号前置 | 已覆盖 |
变现机制 P1–P12 中依赖服务端的五条（P5 首充触发、P11 云存档、P12 服务端验单、P2 体力闸门服务端校验、分享回流计数）全部由本套系统承接；其余为游戏内数值设计，落在各游戏接入 SDK 时实现。
api.example.cn / cdn.example.cn / admin.example.com 需替换为实际备案域名。