石器时代重构-6.11

开发进度报告 - 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/sendPetSkill
  • assets/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 — 已有骨架,需完善玩家技能列表/升级UI
  • assets/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 — 已有骨架,需完善骑乘UI
  • assets/game/PetSystem.ts — 确认属性加点数据结构
  • assets/net/LssProto.ts — 确认 KN(改名)/宠物合成 协议

功能清单:

  • 宠物改名(输入新名称 → KN协议)
  • 宠物属性加点(HP/攻击/防御/敏捷)
  • 宠物合成(选两只宠物 → 合成结果预览)
  • 骑乘/下马切换按钮

Session-C 待完成

Phase 5: 社交系统

目标文件:

  • assets/cocos/PartyView.ts — 已有骨架,需完善组队UI
  • assets/cocos/FriendView.ts — 已有骨架,需完善好友UI
  • assets/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 merge session-a 的最新提交,确保基础功能完整

评论

评论功能即将上线,敬请期待。