Files
FunGameServer-Test/.workbuddy/memory/2026-08-22.md
T
2026-08-28 19:44:46 +08:00

12 KiB
Raw Blame History

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 无效(// 转义问题),需用 PowerShell Stop-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 属性(只有 LINQ Count() 扩展)→ 用 Entities.Count;模组项目需 using Microsoft.Extensions.Logging 才能用 ILogger(DI 扩展需单独 using)。