配置发布说明

文档版本：v1.0 最后更新：2026-04-02 08:28:05

本文档说明当前项目如何把 event/*.json 样例配置同步到服务器。

注意：

这里描述的是样例配置发布链，用于本地开发、模拟器测试、样例玩法联调。
正式前后端联调时，小程序应以 backend launch 返回的 manifestUrl 为准，而不是直接把根目录 event/*.json 当作正式配置入口。

1. 当前发布链路

当前样例配置会发布到 OSS，供样例玩法和调试链路使用：

classic-sequential
- 远端对象：gotomars/event/classic-sequential.json
- 访问地址：https://oss-mbh5.colormaprun.com/gotomars/event/classic-sequential.json
score-o
- 远端对象：gotomars/event/score-o.json
- 访问地址：https://oss-mbh5.colormaprun.com/gotomars/event/score-o.json

对应样例加载入口见：

map.ts

2. 仓库内已有上传能力

项目根目录已有 OSS 上传脚本：

oss-html.ps1

该脚本封装了 tools/ossutil.exe，默认 bucket 为：

oss://color-map-html

依赖前提：

本机存在 ossutil.exe
本机存在 ~/.ossutilconfig

3. 推荐发布命令

项目根目录新增了专门的配置发布脚本：

publish-event-config.ps1

它会在上传前执行这些检查：

本地配置文件是否存在
JSON 是否可解析
是否包含 schemaVersion
是否包含 game
是否包含 game.mode

发布全部玩法配置

.\publish-event-config.ps1 all

只发布顺序打点配置

.\publish-event-config.ps1 classic-sequential

只发布积分赛配置

.\publish-event-config.ps1 score-o

仅检查，不上传

.\publish-event-config.ps1 all -DryRun

4. npm 快捷命令

也可以使用：

npm run publish:config
npm run publish:config:classic
npm run publish:config:score-o
npm run publish:config:dry-run

5. 当前默认映射关系

本地文件	远端对象	说明
`event/classic-sequential.json`	`gotomars/event/classic-sequential.json`	顺序打点默认配置
`event/score-o.json`	`gotomars/event/score-o.json`	积分赛默认配置

6. 维护约定

后续如果新增新玩法配置发布，建议同步修改以下位置：

7. 后续演进方向

当前方案属于“本地校验 + 手动发布到 OSS”。

后续接入正式后台后，推荐演进为：

后台装配并校验配置
后台生成发布版本
后台上传 OSS/CDN
客户端仍只读取静态 JSON

配置发布说明.md 3.0 KB Постоянная ссылка История Исходник