first commit

This commit is contained in:
2026-08-28 19:44:46 +08:00
commit d99ccbbb0c
114 changed files with 16246 additions and 0 deletions
+95
View File
@@ -0,0 +1,95 @@
# 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)。