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

96 lines
12 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)。