KuroMap

鸣潮大地图项目，地图绘制由AI编写测试，引用Haiyu的API请求库。

Git 子模块（Haiyu）

当前已将 https://github.com/HaiyuGame/Haiyu 作为子模块接入到：

• src/Haiyu

并在 WutheringMap.Sample 中引用：

• src/Haiyu/src/Waves.Core/Waves.Core.csproj
• src/Haiyu/src/Waves.Api/Waves.Api.csproj

本地电脑如何操作

1) 首次拉取（已有仓库）

git pull
git submodule sync --recursive
git submodule update --init --recursive

2) 在 KuroMap 中修改子模块代码，并提交到 Haiyu

进入子模块目录提交（这是提交到 Haiyu 仓库）：

cd src/Haiyu
git checkout <haiyu-branch>
# 修改代码后
git add .
git commit -m "feat: update Waves.Core/Waves.Api"
git push origin <haiyu-branch>

回到 KuroMap 根目录，提交子模块指针更新（这是提交到 KuroMap 仓库）：

cd /path/to/KuroMap
git add src/Haiyu
git commit -m "chore: bump Haiyu submodule"
git push

新电脑如何操作

方式 A：克隆时直接拉子模块（推荐）

git clone --recurse-submodules https://github.com/HaiyuGame/KuroMap.git

方式 B：普通克隆后再初始化子模块

git clone https://github.com/HaiyuGame/KuroMap.git
cd KuroMap
git submodule sync --recursive
git submodule update --init --recursive

更新到最新子模块提交

如果 KuroMap 里记录的子模块提交已更新，执行：

git pull
git submodule update --init --recursive

一键更新脚本（PowerShell）

仓库根目录提供了脚本：

• update-haiyu-submodule.ps1

在 PowerShell 中执行（默认更新到 main）：

./update-haiyu-submodule.ps1

指定分支：

./update-haiyu-submodule.ps1 -HaiyuBranch dev

只更新子模块不提交主仓库：

./update-haiyu-submodule.ps1 -SkipCommit