Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,8 @@

* Dockerfile 构建层优化:restore 前先分层 COPY 全部工程与属性文件(仅项目结构/版本清单变化才重新 restore,源码变更实测 restore 层命中 CACHED);删除 final 阶段重复的 publish COPY;热更 DLL 同步移除 `|| true` 吞错(glob 未匹配或复制失败改为构建期 fail fast);scripts/acceptance.sh 仓库根改为按脚本自身位置推导并修正解决方案为 Server.slnx(原硬编码个人绝对路径且引用已不存在的 Server.sln)

* 包结构收敛:Standard 12 包定格 + 五处倒挂修剪 + 分层规则分析器固化(C463,GFX-1199):①管理契约 13 型(`IAdminActionContributor`/`AdminActionRegistry`/`AdminApiRequest` 等)自 Hosting.AdminApi 上移 Hosting.Abstractions(命名空间保留),`Online.Abstractions` 拆除对 AdminApi 的反向依赖;②`Online.Social` 拆除对 Apps/DataBase 的引用(旧好友数据一次性迁移代码存档 `scripts/legacy/`,`MigrateLegacyFriendData` 配置键废止——能力配置绑定器对未知字段严格 fail-fast,老 JSON 须删除该键);③`Online.Match` 拆除对 Core.Session/Proto 的依赖——撮合成立推送改经出站契约 `IOnlineMatchAssignmentNotifier`(包内缺省空实现,Launcher 以 `OnlineMatchAssignmentSessionNotifier` 注入等价 best-effort 推送);④RPS 样例游戏三文件自 Online.Match 移入新验收夹具工程 `GameFrameX.Apps.Sample`(test-fixture),玩法经 `OnlineMatchOptions.AddGame` 由宿主注入(`IOnlineMatchGame` 增 `BuildBridgeView` 契约面,零玩法形态不发布对局桥);⑤排行榜自 Competition 拆独立包 `Online.Leaderboard`(新模块 online-leaderboard,`OnlineCompetitionOptions` 与 `query_leaderboard` 随迁,配置段改 `Online.Settings.online-leaderboard`),Competition 保留冻结的赛季/锦标赛(必选依赖 online-leaderboard);⑥LiveOps 运营面五文件拆离存档 `scripts/detached-liveops/`(移交 Admin 仓),Operations 分析面(游戏事件/总览/时间线)原地冻结标注;⑦新增分层分析器 GFX0023(层级单调+同层禁互引)/GFX0024(契约包零运行时引用)/GFX0025(能力包四禁引 Apps/Hotfix/Proto/Core),L0–L5+层内序注册表固化全部工程引用图;⑧slnx 分组 `/Capability/Standard|Frozen|Experimental` 与 `/Fixture/`,gfx-online 模板新增 Leaderboard 开关并显式引用 Hosting.AdminApi。admin 注册表业务 action 37→30;存量 `Online.Settings.online-competition.*` 配置段须迁移或删除(装配期严格 fail-fast)。

### Fixed
* HTTP 请求管线正确性与响应一致性(C458,GFX-1180,GitHub #926):ProtoBuf 成功响应写出前更正 Content-Type 为 `application/x-protobuf`(原恒为 JSON,按媒体类型分派的客户端/网关解析二进制体失败);参数字典改 OrdinalIgnoreCase 并同步把 Query 提取改 TryAdd——大小写差异同名键(Query↔Body、Query↔Query)一律显式 `ParamErr` 拒绝,消除「被校验/被签名的 Query 值被 Body 静默覆盖」窗口;非 JSON 对象 Body(null 字面量/数组/标量/空体)以参数错误拒绝(新键 `Network.Http.RequestBodyNotJsonObject`),不再落入顶层 catch 记服务器错误日志;非 GET 缺 Content-Type 改统一 JSON envelope;DataAnnotations 校验失败业务码由字面量 400 统一为 `GameHttpStatusCode.ParamErr`;Swagger 路由匹配改末段精确比较(互为后缀命令不再错配文档,驼峰路由可匹配)且 GET 参数必填性跟随 `RequiredAttribute`;AOP 拒绝且未自行写响应时管线回写校验失败 envelope(契约写入 `IHttpAopHandler.Run`);`CheckSign` 缺 sign/timestamp 改本地化消息。对外破坏性:依赖 `code == 400` 判定校验失败的客户端改判 `code == 13`;`HttpStatusMessage.Success`/`NotFoundCommand`/`CheckFailedCommand` 及孤儿键 `Network.Http.NotFoundCommand`/`CheckFailedCommand` 删除(公共 API,下游如有引用需迁移)。
* Utility 安全修复:配置凭据脱敏、解压炸弹上限、冲突异常 Secret 脱敏与压缩失败显式抛出(C433,GFX-1173,GitHub #919):①`AppSetting.ToString/ToFormatString` 经浅拷贝掩码后序列化——`DataBasePassword`/`HttpSignSecret`/`InterNodeAuthSecret`/`HttpsCertPassword` 非空值输出 `***`(null/空串原样保留区分「未配置」),四个凭据不再随启动/停止日志明文外发;②`CompressionHelper.Decompress` 新增 `maxOutputLength` 上限重载(旧签名转发 const 默认 64MB),膨胀过程内超限即抛 `InvalidDataException`——Network `DefaultMessageDecompressHandler` 增构造参数上限、RemoteMessaging `IMessageCompressionAlgorithm.Decompress` 接口加参(const 默认值,源码兼容;`DefaultMessageCodec` 显式传 `_maxDecompressedSize`),事后长度检查降级为兜底防线,1MB 高压缩比帧不再可膨胀至 GB 级托管内存;③`SettingFieldConflict` 敏感字段判定扩展 Secret/Token 子串——多 Role 配置冲突异常不再明文携带 `HttpSignSecret`/`InterNodeAuthSecret`;④`RandomHelper` 类文档声明双随机源分级(基础接口 `Random.Shared` 非加密 PRNG 禁用于令牌/验证码/防作弊场景,安全场景用权重系列 CSPRNG 或 `RandomNumberGenerator`);⑤落地已归档 C349 既定方案:`Compress` 异常原样抛出、`Decompress` 对非法/损坏/截断数据统一抛 `InvalidDataException`(含 SharpZipLib 截断流死循环主动判定),删除「失败静默返回原始字节」回退与 `CompressFailed` 本地化键;⑥`FP.Sqrt/Acos` 越界异常构造器实参换序(本地化消息进 `Message`、`"x"` 进 `ParamName`,修复前 `ParamName == null`)。公共 API 行为变更经本条披露;解压炸弹/脱敏/截断/参数名均有回归用例锁定。
Expand Down
File renamed without changes.
File renamed without changes.
File renamed without changes.
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,7 @@

<ItemGroup>
<InternalsVisibleTo Include="GameFrameX.Capability.Hosting.Core, PublicKey=0024000004800000140100000602000000240000525341310008000001000100dbdd8ce8567465b0c7a56029b2f252989170cd00f15cd79b53c1cb8ecea09065a7fec9bfd5e241999707748cd59c25b4d8a721a1fe741495720642bae68ee134ba578cb153bd380d440e1908191e5a27ae79534f7dbd8c70c6fc18f26c1afaafe76d0b95d366b1bc81bffcf317673f37c839533a14f8939274c75fc8588134edad6d08f783a29916954fa5df678ed4dc9395c9618000d05be87d9caf15005987b48b224bdfcb07ea467ecc8be679620662a75b6a5b6748154664c8aa831c65428af7e5a955aa4eef974c0351a7865b9868d1c81a599eeda487bc5b46d0cbfd67729ae7d8e4c81b651bbbcc33e493f8d978b45350c7191e92989585ab7bf693bf"/>
<InternalsVisibleTo Include="GameFrameX.Capability.Hosting.AdminApi, PublicKey=0024000004800000140100000602000000240000525341310008000001000100dbdd8ce8567465b0c7a56029b2f252989170cd00f15cd79b53c1cb8ecea09065a7fec9bfd5e241999707748cd59c25b4d8a721a1fe741495720642bae68ee134ba578cb153bd380d440e1908191e5a27ae79534f7dbd8c70c6fc18f26c1afaafe76d0b95d366b1bc81bffcf317673f37c839533a14f8939274c75fc8588134edad6d08f783a29916954fa5df678ed4dc9395c9618000d05be87d9caf15005987b48b224bdfcb07ea467ecc8be679620662a75b6a5b6748154664c8aa831c65428af7e5a955aa4eef974c0351a7865b9868d1c81a599eeda487bc5b46d0cbfd67729ae7d8e4c81b651bbbcc33e493f8d978b45350c7191e92989585ab7bf693bf"/>
</ItemGroup>

</Project>
Original file line number Diff line number Diff line change
Expand Up @@ -12,11 +12,8 @@
</ItemGroup>

<ItemGroup>
<ProjectReference Include="../GameFrameX.Capability.Hosting.Abstractions/GameFrameX.Capability.Hosting.Abstractions.csproj"/>
<ProjectReference Include="../../GameFrameX.Localization/GameFrameX.Localization.csproj"/>
</ItemGroup>

<ItemGroup>
<ProjectReference Include="../GameFrameX.Capability.Hosting.AdminApi/GameFrameX.Capability.Hosting.AdminApi.csproj"/>
</ItemGroup>

</Project>
Original file line number Diff line number Diff line change
Expand Up @@ -2,18 +2,16 @@
<Import Project="../../Version.props" Label="版本号定义"/>

<PropertyGroup>
<Description>GameFrameX.Capability.Online.Competition,GFX Online 竞技能力包:排行榜/赛季/锦标赛/LiveOps 承载(InMemory 默认存储,懒默认描述符,族/宿主覆盖恒胜出)+ 自装配模块(OnlineCompetitionCapabilityModule,Options=OnlineCompetitionOptions)+ admin handlers(LiveOps 七 action). Competition capability package for the GFX Online family: leaderboards, seasons, tournaments and the LiveOps registry with in-memory default stores, the self-assembling capability module and admin handlers. Documentation: https://gameframex.doc.alianblank.com</Description>
<PackageTags>GameFrameX,Capability,Online,Competition,Leaderboard,Season,Tournament,LiveOps,GameServer</PackageTags>
<!-- 引用的传递面(Match→Core→Network.HTTP)带入 AspNetCore.OpenApi 源生成器(要求 C#11 file 类型),
与 LangVersion 10 钉死冲突;本包语言版本随 Directory.Build.props(latest),
语法风格仍按仓内 C#10 惯例书写(无 switch 表达式 / record / 顶层语句)。 -->
<Description>GameFrameX.Capability.Online.Competition,GFX Online 竞技能力包(冻结面:不删除、不演进):赛季/锦标赛承载(InMemory 默认存储,懒默认描述符,族/宿主覆盖恒胜出)+ 自装配模块(OnlineCompetitionCapabilityModule,必选依赖 online-leaderboard);榜单能力已拆至 GameFrameX.Capability.Online.Leaderboard 独立包,LiveOps 运营面移交 Admin 仓. Frozen competition capability package for the GFX Online family: seasons and tournaments with in-memory default stores and the self-assembling module requiring online-leaderboard; leaderboards moved to the dedicated leaderboard package and LiveOps handed over to the admin console. Documentation: https://gameframex.doc.alianblank.com</Description>
<PackageTags>GameFrameX,Capability,Online,Competition,Season,Tournament,Frozen,GameServer</PackageTags>
<!-- 本包语言版本随 Directory.Build.props(latest),语法风格仍按仓内 C#10 惯例书写
(无 switch 表达式 / record / 顶层语句)。 -->
</PropertyGroup>

<ItemGroup>
<ProjectReference Include="../GameFrameX.Capability.Online.Abstractions/GameFrameX.Capability.Online.Abstractions.csproj"/>
<ProjectReference Include="../GameFrameX.Capability.Online.Assets/GameFrameX.Capability.Online.Assets.csproj"/>
<ProjectReference Include="../GameFrameX.Capability.Online.Match/GameFrameX.Capability.Online.Match.csproj"/>
<ProjectReference Include="../GameFrameX.Capability.Hosting.Core/GameFrameX.Capability.Hosting.Core.csproj"/>
<ProjectReference Include="../GameFrameX.Capability.Online.Leaderboard/GameFrameX.Capability.Online.Leaderboard.csproj"/>
</ItemGroup>

</Project>
Loading
Loading