Ship the WeChat hot-update catalogs and the camp, TideWhale T2, UI atlas, and animation-lab work.

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
udx
2026-10-24 18:04:41 +08:00
co-authored by Cursor
parent 6ebc9401ce
commit 45e62132c8
1432 changed files with 2971856 additions and 2798 deletions
+13 -12
View File
@@ -4,7 +4,7 @@
> 客户端工程:`AIClient/`
> 资源生产:`ResourceCreate.md`
> 热更资源 CDN:`https://www.xworld.ren`
> 游戏服:`game.xworld.ren`(WebSocket:`wss://game.xworld.ren/ws?pid=...`)
> 游戏服:`BuddyDefense.xworld.ren:15888`(WebSocket:`wss://BuddyDefense.xworld.ren:15888/ws?pid=...`)
当前玩法依据:[AIGame 基础游戏设计](GameDesign.md)。功能方向为伙伴收集养成、弹珠、布阵塔防和营地;旧科幻肉鸽方案已归档。UI 当前仅保留 Candy。
@@ -22,7 +22,7 @@
| 资源生产 | 统一走 `ResourceCreate.md` 流水线,完成后登记 `Doc/ResDesc_*.md` |
| 网络 | WebSocket 连接/通知;HTTP 登录、幂等玩法 API 与 CDN 清单 |
| CDN | `https://www.xworld.ren` |
| 游戏服域名 | `game.xworld.ren`(Caddy `reverse_proxy`,自动处理 WS Upgrade) |
| 游戏服域名 | `BuddyDefense.xworld.ren:15888`(Caddy `reverse_proxy`,自动处理 WS Upgrade) |
非目标(首期不做):横屏、原生 App 包、复杂战斗回放、跨服匹配。
@@ -45,7 +45,7 @@
└─────────┼─────────────────────────────┼─────────────────────┘
│ HTTPS │ WSS
▼ ▼
https://www.xworld.ren wss://game.xworld.ren/ws?pid=...
https://www.xworld.ren wss://BuddyDefense.xworld.ren:15888/ws?pid=...
(CDN: 版本清单 + AB + DLL) (Caddy → 游戏服进程)
```
@@ -201,7 +201,7 @@ https://www.xworld.ren/wechat/version.json
→ Download(DLL + 必需资源)+ 进度 UI
→ HybridCLR LoadAssembly(HotUpdate.dll [+ AOT 补充元数据])
→ HotUpdate.GameEntry.Start()
→ 连接 wss://game.xworld.ren/ws?pid=...
→ 连接 wss://BuddyDefense.xworld.ren:15888/ws?pid=...
→ 进入登录 / 主界面
```
@@ -262,7 +262,7 @@ https://www.xworld.ren/wechat/version.json
| 用途 | URL |
| --- | --- |
| CDN / 静态资源 | `https://www.xworld.ren/...` |
| 游戏 WebSocket | `wss://game.xworld.ren/ws?pid={playerOrSessionId}` |
| 游戏 WebSocket | `wss://BuddyDefense.xworld.ren:15888/ws?pid={playerOrSessionId}` |
说明:
@@ -273,8 +273,9 @@ https://www.xworld.ren/wechat/version.json
Caddy 示意(运维侧):
```caddyfile
game.xworld.ren {
reverse_proxy 127.0.0.1:8080
https://BuddyDefense.xworld.ren:15888 {
bind SERVER_NIC_IPV4
reverse_proxy 127.0.0.1:15888
}
www.xworld.ren {
@@ -292,7 +293,7 @@ CDN 目录对 Bundle 可用长缓存;`version.json` 建议短缓存或 `no-cac
### 7.2 客户端连接约定
```text
wss://game.xworld.ren/ws?pid=...
wss://BuddyDefense.xworld.ren:15888/ws?pid=...
```
建议行为:
@@ -339,7 +340,7 @@ BootContext(壳 → 热更)至少传递:
1. 构建目标:微信小游戏适配工程(Unity WebGL + 微信转换工具 / 官方导出流程,以当前工程选用的适配插件为准)。
2. 主包最小化:Boot 场景 + AOT + 首屏更新 UI 图。
3. 远程资源域名白名单:配置 `https://www.xworld.ren`、`wss://game.xworld.ren`。
3. 远程资源域名白名单:配置 `https://www.xworld.ren`、`wss://BuddyDefense.xworld.ren:15888`。
4. 竖屏、安全区、性能档在真机与开发者工具双验。
5. 提审包升 `appVersion` 时,同步提高 CDN `appVersionMin/Max`,并保留旧 CDN 路径一段回滚窗口。
@@ -361,7 +362,7 @@ BootContext(壳 → 热更)至少传递:
| --- | --- |
| M0 | 壳工程:URP 竖屏 Boot、YooAsset Host 拉 CDN、HybridCLR 加载空热更 DLL |
| M1 | `version.json` + 上传脚本;微信开发者工具跑通更新条 |
| M2 | WS 连通 `wss://game.xworld.ren/ws?pid=...`;登录握手 |
| M2 | WS 连通 `wss://BuddyDefense.xworld.ren:15888/ws?pid=...`;登录握手 |
| M3 | 资源流水线打通(图/模 → Bundles → CDN);示例角色进场景 |
| M4 | UI / 玩法骨架;断线重连;维护公告 | ✅ HUD+ConfirmDialog;Ws 指数退避重连;`version.notice` + `maintenance.json` |
| M5 | 包体与性能优化;提审用壳版本策略固化 |
@@ -376,7 +377,7 @@ BootContext(壳 → 热更)至少传递:
| [`ResourceCreate.md`](ResourceCreate.md) | 图、3D、减面烘焙生成方式 |
| [`Doc/ResDesc.md`](Doc/ResDesc.md) | 资源登记索引 |
| [`UNITY-GUIDE.md`](UNITY-GUIDE.md) | Agent 操作 Unity 规范 |
| [`Doc/Design/Combat/SkillSystem.md`](Doc/Design/Combat/SkillSystem.md) | 关卡技能系统设计:逻辑行为、动作/特效/音效组合、固定tick事件、服务端结算与TangoFlux制作流程;当前为设计及配置契约,尚未切换运行时 |
| [`Doc/Design/Combat/SkillSystem.md`](Doc/Design/Combat/SkillSystem.md) | 技能设计及落地记录;25技能权威运行时、20主线关与5属性挑战已接通,十伙伴专属表现及9/9声音已入库;混音试听见 `Doc/Design/Sound/MixReview/Production.md`,真机与主观听审仍待验收 |
| [`Agents.md`](Agents.md) | 项目可读摘要 |
---
@@ -386,5 +387,5 @@ BootContext(壳 → 热更)至少传递:
- **微信竖屏小游戏** + **URP** + **YooAsset** + **HybridCLR**。
- 资源生产统一走 **ResourceCreate**,发布前必须 **ResDesc 登记**。
- 热更权威源:CDN `https://www.xworld.ren` 的 `version.json` + Package Manifest。
- 玩法服:`wss://game.xworld.ren/ws?pid=...`,Caddy 反代即可,不另配 WS。
- 玩法服:`wss://BuddyDefense.xworld.ren:15888/ws?pid=...`,Caddy 反代即可,不另配 WS。
- 壳只做启动与加载;业务全在热更程序集,保证日常迭代不提审。