12 KiB
12 KiB
2026-08-22
项目进度盘点(FunGame.Server-v3)
- 梳理三项目现状:FunGame.Core(net10.0 战斗引擎,v3 迭代中,最新 dev-0820,git 到 #170)、FunGame.Testing-v3(模拟器已并入单 WebAPI 项目,含 Tests/OshimaGameModules,已出 linux-x64/win-x64 发布)、FunGame.Server-v3(本工作区,4 项目 + webui)。
- Server-v3 里程碑对照 docs/04-架构设计.md:M0~M6 全部 ✅(骨架/数据层/认证/插件热重载/WebSocket/业务/WebUI),M7 加固发布 ⏳ 进行中。
- 修复阻断 bug:
FunGame.Server-v3.slnx中误把webui/配置为 .NET Framework Website 项目(Type="Website"),导致dotnet build报 MSB4249 失败。已移除该条目,webui 由 npm 独立构建。 - M7 剩余候选:玩家局内决策接入(gaming.action 驱动 GamingQueue,当前 AI 自动循环)、Elo 扩圈匹配、单元/集成测试项目(参考 Testing-v3 Tests)、Linux 自包含发布、WebUI 权限/角色与系统配置页、MySQL Provider 部署验证。
FunGame.Testing-v3 新增 webui-client(Server 测试客户端)
- 新建项目
C:\milimoe\FunGame.Testing-v3\webui-client,技术栈与 Testing-v3 现有 webui 回放台一致:React 19 + Vite 6 + Tailwind CSS v4(@tailwindcss/vite 插件),TypeScript 严格模式。 - 设计参照
C:\milimoe\FunGame.Testing-v3\docs_internal\01-WebUI.txt+02-MobileUI.txt(深蓝紫底 / 金色装饰 / 蓝红阵营 / 二次元幻想风),针对 FunGame.Core 战斗系统适配(5v5 → 5 人混战)。 - 端口 5174;vite proxy 配置
/api与/ws代理到 FunGame.Server-v3(5000),解决 CORS。 - 三个主面板:测试中心(预设 30+ 用例 + 手动请求构造器,含 auth/用户中心/对局回放/经济/系统/管理/WebSocket/房间匹配组,结果卡片展示状态/耗时/错误/JSON)、战斗对局(顶部双队伍+金色回合计数器、中央角色战场 HP/MP/状态/阵营、底部开始行动/自动/×2 加速、对局事件流、结算横幅)、回放(对局记录列表 → meta → 回合时间轴 → RoundRecord JSON → statistics)。
- REST 客户端封装:ApiResponse 解包 + 耗时测量 + 错误归一化。WS 客户端:MessageEnvelope 信封、心跳 (system.ping)、响应关联(按 i 字段)、超时控制。
- React Context 全局状态(ServerProvider):连接配置 / 认证 (JWT) / WS 实例 / 测试记录 / 对局事件 / 战斗状态。
- 支持深链:
#tab=test|battle|replay直接进入对应面板(顺手增强)。 npm run build成功(240KB JS / 35KB CSS gzip 后 73KB/6.5KB),共 2026 行 TS/TSX,0 错误 0 警告。- 验收截图(Chrome headless):桌面测试中心、移动端 390x844、战斗对局、回放加载中,4 张存于
webui-client/shots/。 - Chrome headless
--virtual-time-budget会干扰 fetch 调度导致 "Failed to fetch"(已记录);agent-browser daemon 在本环境启动 Chrome 一直 exit 3(已记录),改用 Chrome headless 直接 --screenshot 验收。 - 项目已写 README.md(启动步骤 + 代理说明 + 测试流程指引 + 协议速查)。
CORS 修复(5174 直连放行)
- 现象:客户端(5174)顶部直连
http://localhost:5000时 Server 日志报CORS policy execution failed,浏览器拦截 401 响应。 - 修复:
FunGame.Server-v3/src/FunGame.Server.Host/appsettings.json的AllowOrigins增加http://localhost:5174与http://127.0.0.1:5174。 - 验证:curl 带
Origin: http://localhost:5174返回 401 +Access-Control-Allow-Origin: http://localhost:5174;未放行 Origin 无 CORS 头。 - 注意:Git Bash 下
taskkill //F //PID无效(// 转义问题),需用 PowerShellStop-Process或cmd //c;遗留 dotnet 进程会占用 5000 导致重启失败(AddressInUse)。
对局暂停/恢复 + Oshima 模组移植
1. Server 对局控制(暂停/恢复/强制结束)
GameHostService新增PauseGame(Guid)/ResumeGame(Guid);HostedGame增加volatile bool Paused;RunGameLoopAsync循环内暂停检测(暂停时等待 100ms 直到恢复/结束)。AdminControllers新增POST /api/admin/server/games/{id}/pause|resume(GamesManage 权限);强制结束.../end原本已有。- webui-client
BattleView操作区新增「⏸ 暂停/▶ 继续」「⏹ 强制结束」(confirm 确认),走 REST 管理端;BattleState增加paused字段(gaming.over 时复位)。
2. Oshima 模组(FunGameSimulation 内容移植给 Server)
- 新建
modules/FunGame.Server.Modules.Oshima/:复制 Testing-v3 OshimaGameModules 源码(Characters/Effects/Items/Skills/Units 281 cs)+Others/OshimaGameModuleConstant.cs+ configs;命名空间保持Milimoe.FunGameTesting.OshimaGameModules.*。 - 唯一外部依赖
FunGameService.GenerateRandomChineseName(雇佣兵团.cs 用到)→ 新建Others/RandomNames.cs自包含工具类并改写引用。 - 新建
OshimaServerModules.cs:OshimaCharacterModule(18 角色,工厂 id 1-18)/OshimaSkillModule(基础+爆发+被动+通用+魔法全量)/OshimaItemModule(武器/防具/鞋子/饰品/消耗品),实现 Server 的ICharacterModule/ISkillModule/IItemModule,OnLoad 注册 Factory。 - csproj 仿 ExampleModules(含 CopyModulesToHost 复制到 Host/modules/*/_staging 热替换);已加入 slnx。
- 模组一次编译通过(0 错 0 警);Server 启动后 /api/admin/plugins 显示 oshima.characters/skills/items 三个 Loaded。
- 端到端验证(临时脚本
webui-client/e2e-battle-check.mjs,Node 原生 WS):match.start → 回合含 Oshima 角色(大島シヤ)→ pause 后 1s 0 新回合 → resume 后 32 新回合 → gaming.over → 强制结束 OK。
3.5 参考 FunGameSimulation 生成对局(角色技能装配)
- 新建
src/FunGame.Server.Host/Services/CharacterBuildService.cs:参考 FunGameSimulation + FunGameService.AddCharacterSkills 装配对局角色。BuildSimulationCharacters(count, level=10, skillLevel=2):随机角色 +BuildCharacter逐角色装配。BuildCharacter(template):Copy → Level=10 / NormalAttack.Level=2 → 专属被动+大招(id 1-18 映射表,如 1→META马/熵灭极诣、18→概念之骰/神之因果)→ 随机 3 基础战技(排除疾走)→ 3 通用被动(等级1)→ 3 通用大招 → 清理模板被动特效。- 与模组解耦:技能通过
catalog.GetSkills()按 Name 匹配。
- 接入:Program.cs 注册;RoomMessageHandlers 的 match.start 用
BuildSimulationCharacters、room.start 玩家/AI 角色用BuildCharacter。 - 关键踩坑(模组工厂注册):OshimaSkillModule/ItemModule OnLoad 工厂委托原用
skill.Copy(),但Skill.Copy()内部调Factory.GetInstance→ 委托又 Copy → 无限递归。修复:工厂委托必须返回新实例(Activator.CreateInstance(type)),不能 Copy。 - 坑 2:部分技能(如 闪现)只有
(Character? character = null)构造,Activator.CreateInstance(Type)不应用可选参数 → MissingMethodException。修复:ModuleEntityFactory.Create<T>先试无参构造,失败退化CreateInstance(type, [null])。 - 验证:装配日志 K神(Id=18)11 技能(概念之骰/神之因果/3战技/3通用被动/3通用大招)、男甘雨(Id=4)专属灵能反射/三相灵枢;被动不出现于行动记录、大招需条件触发,以装配日志为准。
- 日志级别:Server:Debug=False 时 LogDebug 不可见,装配日志用 LogInformation。
房间自选模组(Server 提供列表 → 客户端渲染选择)
Server 端
- 新增
src/FunGame.Server.Host/Controllers/GameModulesController.cs:GET /api/game-modules([AllowAnonymous],公开),返回{ modes, modules }:modes:从PluginManager.Items过滤Kind=ServerPlugin && Status=Loaded(可作为房间 GameModule 的游戏模式,如 example)modules:过滤Kind=CharacterModule/SkillModule/ItemModule && Status=Loaded(内容模组,影响角色/技能/物品池)- 数据实时反映热重载。
客户端(webui-client)
types.ts加ModuleInfoDto/GameModulesDto;api.ts加fetchGameModules(baseUrl)。- 新增
src/components/RoomPanel.tsx:- 挂载时
GET /api/game-modules拉取列表,渲染游戏模式选项卡(含版本/作者/描述)。 - 房间参数:模组(必选)、最大人数(2-10)、是否排位、密码(可选)。
- 「创建房间」→ WS
room.create({module, map, maxUsers, isRank, password})→ 返回roomId。 - 创建后显示「▶ 开始对局(房主)」→ WS
room.start({roomId})→ 收到gaming.start后提示用户切到「战斗对局」面板,battle.gameId 也被 patchBattle 同步。 - 错误/提示:WS 未连接、token 缺失、result.error 全部 inline 展示。
- 挂载时
App.tsx新增 Tab「🚪 房间」(#room深链)。- 端到端:room-e2e.mjs 验证模组列表正确、自选 example 创建房间 UXJWPBF、开始对局成功。
- 截图:headless
--virtual-time-budget=8000 --screenshot触发 React 完整渲染(普通--screenshot截不到 fetch 完成态;此参数对 fetch 有干扰但 8s 足够完成初次加载),存webui-client/shots/05-room.png。 - 已知行为:room.start 按内容模组池全量随机抽角色,未按"内容模组"过滤——若需"只选 Oshima 角色"可后续扩展 GameHostService 的角色源支持 contentModule 参数。
创建游戏只从所选模组取内容(角色/技能/物品)
- PluginManager:新增
GetModuleEntities<T>(string modulePrefix)—— 按{prefix}.前缀过滤已加载实体模组。 - EntityCatalog:新增
GetCharacters/GetSkills/GetItems(string modulePrefix)。 - CharacterBuildService:
BuildSimulationCharacters/BuildCharacter增加modulePrefix参数——角色模板池与技能池均只从该模组族取;技能装配改为按 SkillType 分类自适应(战技 Skill / 被动 Passive / 爆发 SuperSkill 各随机 3,排除专属技能名避免重复与跨角色专属;候选不足回退)。SkillType枚举在FunGame.Core.Library.Constant。 - RoomEntity:新增
ContentModule字段(EF 迁移20260822050723_AddContentModule,README 命令不带 --startup-project,因 Host 缺 EF Design 包)。CreateRoomAsync加参数;room.create接收contentModule;room.start用它过滤角色池;match.start也支持可选contentModule;room.list响应带出contentModule。 - 客户端 RoomPanel:新增"内容模组"单选(全量 / 模组名前缀去重:example、oshima),room.create 传
contentModule。 - 验证(cm-e2e.mjs):oshima → 大島シヤ 10 技能(META马+战技+通用被动/爆发,无重复);example → 示例战士 1 技能(示例打击,example.skills 唯一技能);全量 → 混合角色 + 专属。
- 教训:硬编码技能名池只对 oshima 有效,example 模组会装配 0 技能 → 必须按类型从所选模组实际技能中选取。
3. Oshima JSON 配置物品部署
- 需求:把
Testing-v3/WebAPI/OshimaGameModules/configs/oshima-studios/oshima.fungame.items.json(108KB,147 件武器/防具/收藏品配置)部署到 Server Host。 - 加载机制确认:
Factory.GetGameModuleInstances<Item>(module_name, file_name)→EntityModuleConfig<T>从AppDomain.CurrentDomain.BaseDirectory/modules/{ModuleName}/{FileName}.json读取(默认 ModuleDirectory="modules"),JSON 物品经 OpenItemAdapter 适配。 - 部署:JSON 复制到
src/FunGame.Server.Host/modules/oshima-studios/oshima.fungame.items.json;Host.csproj 加<None Include="modules/oshima-studios/**" CopyToOutputDirectory="PreserveNewest"/>随构建复制到 bin(运行时 BaseDirectory 可读)。 OshimaItemModule.BuildEntities先Factory.GetGameModuleInstances<Item>("oshima-studios","oshima.fungame.items")合并 JSON 物品(key 前缀oshima_json_,JsonItemCount 静态计数),再合并代码物品;OnLoad 统一注册 Factory。- 验证:启动日志
Oshima 物品模组加载:代码物品 51 件 + JSON 配置物品 147 件(共 198 件)。 - 踩坑:
IReadOnlyDictionary.Values是IEnumerable,没有.Count属性(只有 LINQCount()扩展)→ 用Entities.Count;模组项目需using Microsoft.Extensions.Logging才能用 ILogger(DI 扩展需单独 using)。