开发进度报告 - 2026-06-11
全局状态
分支与 Worktree 设置
三个 session 现在各自拥有独立的 worktree 目录:
| Session | Worktree 目录 | 分支 | 当前进度 |
|---|---|---|---|
| session-a | ~/Projects/sa-session-a/ |
claude-session-a/battle-skill-item-pet-system |
Phase 1 ✅ + Phase 3 ✅ |
| session-b | ~/Projects/sa-session-b/ |
claude-session-b/skill-pet-system |
Phase 2 + Phase 4 |
| session-c | ~/Projects/sa-session-c/ |
claude-session-c/social-world-interact |
Phase 5 + Phase 6 |
⚠️ 注意: 三个分支目前指向同一个 commit (b5459ae)。后续各自提交的代码会逐步分离。
如何同步代码
当 session-a 提交了新代码后,session-b/c 可以通过以下方式同步:
# 在 session-b 或 session-c 的 worktree 目录下
git fetch origin
git merge origin/claude-session-a/battle-skill-item-pet-system
合并时如果有冲突,用 --ours / --theirs 解决即可。
Session-A 已完成
Phase 1: 核心战斗系统 ✅
新增文件:
assets/cocos/BattleView.ts— 完整战斗UI(攻击/防御/道具/宠物/技能/逃跑)assets/cocos/BattleCharaRenderer.ts— 战斗角色渲染(HP条/状态标记)
修改文件:
assets/net/LssProto.ts— 新增 BU_RECV(15) 协议、sendUseItem/sendPetTurn/sendPetSkillassets/net/ProtocolParser.ts— 完善 BC/BP/BU 协议解析assets/game/Battle.ts— 完善战斗状态机、解析服务端战斗数据assets/cocos/GameApp.ts— 集成 BattleView、B键切换战斗面板
Phase 3: 物品交互系统 ✅
新增文件:
assets/cocos/GroundItemRenderer.ts— 地面物品渲染(CA协议解析后的ItemObjData/GoldObjData可视化)assets/cocos/GroundItemPickupView.ts— 地面物品拾取/丢弃确认弹窗assets/cocos/BankView.ts— 银行/仓库窗口(个人+家族仓库,金币存取)
修改文件:
assets/cocos/InventoryView.ts— 添加物品详情面板、使用/装备/丢弃/拆分按钮assets/cocos/InputController.ts— 添加 getGroundItemHit 回调,点击地面物品检测assets/cocos/GameApp.ts— 集成地面物品点击/拾取/丢弃逻辑、N键打开银行assets/net/LssProto.ts— 新增 DG_RECV(20) 协议、sendDropGold
Session-B 待完成
Phase 2: 技能系统
目标文件:
assets/cocos/SkillView.ts— 已有骨架,需完善玩家技能列表/升级UIassets/cocos/PetSkillView.ts— 新建,宠物技能查看/学习assets/cocos/PetView.ts— 添加"技能"标签页入口assets/game/SkillSystem.ts— 已有数据层,确认技能定义完整性assets/net/LssProto.ts— 确认 SK(技能升级) 协议实现
功能清单:
- 技能列表窗口(已学技能 + 可学习技能)
- 技能升级按钮 + 确认
- 宠物技能列表(40+种技能类型)
- 技能描述面板
- 战斗中技能快捷选择
Phase 4: 宠物系统完善
目标文件:
assets/cocos/PetView.ts— 添加改名/属性加点/合成功能assets/cocos/RideView.ts— 已有骨架,需完善骑乘UIassets/game/PetSystem.ts— 确认属性加点数据结构assets/net/LssProto.ts— 确认 KN(改名)/宠物合成 协议
功能清单:
- 宠物改名(输入新名称 → KN协议)
- 宠物属性加点(HP/攻击/防御/敏捷)
- 宠物合成(选两只宠物 → 合成结果预览)
- 骑乘/下马切换按钮
Session-C 待完成
Phase 5: 社交系统
目标文件:
assets/cocos/PartyView.ts— 已有骨架,需完善组队UIassets/cocos/FriendView.ts— 已有骨架,需完善好友UIassets/cocos/PlayerPopupMenu.ts— 已有骨架,玩家右键菜单assets/cocos/TradingView.ts— 完善双边交易流程assets/game/PartySystem.ts/assets/game/FriendSystem.ts/assets/game/Trading.ts— 确认数据层
功能清单:
- 组队邀请/确认/退出
- 队员列表/HP状态/队长标记
- 好友添加/删除/在线状态
- 私聊窗口(双击好友打开)
- 交易物品选择 + 金币设置
- 双方确认流程(锁定→确认→执行)
Phase 6: 地图与世界交互
目标文件:
assets/cocos/DialogView.ts— 完善NPC对话assets/cocos/NpcWindow.ts— 已有,解析WN协议动态窗口assets/cocos/InputController.ts— 添加点击其他玩家检测assets/cocos/CharacterView.ts— 玩家信息展示assets/cocos/BottomToolbar.ts— 已有骨架,底部快捷栏
功能清单:
- WN协议窗口解析(按钮/列表/输入框/多页)
- 靠近NPC按交互键触发对话
- 地图切换/传送点处理
- 点击其他玩家弹出信息面板(名称/等级/称号/家族)
- 玩家交互菜单(组队/交易/私聊)
Phase 7: 界面与系统功能(未分配)
- MainMenu.ts — 主菜单(人物/道具/宠物/任务/家族/技能/帮助/设置)
- TitleView.ts — 称号查看/切换
- RankingView.ts — 排行榜
- DragHelper.ts — 窗口位置持久化(localStorage)
- SettingsView.ts — 系统设置(音效/画质/屏蔽)
文件归属参考
各 session 负责的文件范围,避免冲突:
| Session | 负责文件 |
|---|---|
| session-a | BattleView, BattleCharaRenderer, GroundItemRenderer, GroundItemPickupView, BankView, InventoryView(详情部分), InputController(地面物品部分), LssProto(物品相关) |
| session-b | SkillView, PetSkillView, PetView(改名/加点/合成), RideView, SkillSystem, LssProto(技能相关) |
| session-c | PartyView, FriendView, PlayerPopupMenu, TradingView(交易流程), DialogView, NpcWindow, CharacterView(玩家交互), BottomToolbar, LssProto(社交相关) |
备注
- 所有新文件已提交到
claude-session-a/battle-skill-item-pet-system分支 - session-b 和 session-c 的 worktree 目录下已有各自的代码骨架(SkillView/BankView/PartyView 等),但那些文件是在主工作目录创建的,需要通过
git checkout或手动复制到对应 worktree - 建议各 session 在开始工作前,先
git mergesession-a 的最新提交,确保基础功能完整
评论
评论功能即将上线,敬请期待。