# CatanBuilding 独立备份清单

## 来源

- 来源仓库：`C:\Users\13999\Documents\ft_3`
- 来源分支：`dev_catanbuilding`
- 来源 commit：`b5774d8430b75d0072ac2e46921795fe8f5fd8f6`
- 对比主线：`develop`
- merge-base：
  - `fe1e2787277ef4053b40b78826579f15b1006e30`
  - `d937c163e1313229bfe229def66f678307f0971a`
- 审计目录：`C:\tmp\catanbuilding-backup-audit`

## 备份方式

从 `ft_3\Client` 复制为新的 Unity 工程根目录，并在 `C:\Users\13999\Documents\CatanBuildingBackup` 内执行独立 `git init`。该目录不是 worktree，不共享源仓库 `.git` 历史和对象库。

本次采用瘦身备份策略，不再复制完整 `Assets/`。先前全量复制会达到约 38GB，主要来自 `AssetsPackage`，不适合作为远端备份库。

## 保留目录

- `ProjectSettings/`：Unity 工程配置。
- `Packages/`：UPM manifest 和少量 embedded packages。
- `LocalPackages/`：manifest 中 `file:../LocalPackages/...` 引用的本地包，当前约 281MB。
- `Assets/Scripts/`：完整脚本目录，体积小，保留 ft_3 运行框架和 HexGrid 宿主依赖。
- `Assets/AddressableAssetsData/`：Addressables 配置，已保留 `HexBuilding` group。
- `Assets/Settings/`：包含 `AddressableHelperSetting.asset`。
- `Assets/ABPackage/pkgDownloads/HexBuilding/`：HexBuilding Addressables 资源本体。
- `Assets/ABPackage/pkgFirstPackage/Fonts/`：HexMapPanel 文本直接依赖字体。
- `Assets/AssetsPackage/art/terrainbuilding/test01/`：`hex_build_01.prefab` 直接引用的 terrainbuilding 美术资源。
- `Assets/AssetsPackage/UI/common/btn_close.png`、`mask.png`：HexMapPanel 直接引用 UI 图。
- `Assets/AssetsPackage/Animation/ui/FishingMapPanel/FishingMapPanel.controller`：HexMapPanel 直接引用 Animator Controller。
- `Assets/CoreLib/`、`Assets/Plugins/Demigiant/`、`Assets/Plugins/SignalR/`、`Assets/Plugins/LubanLib/`、`Assets/Plugins/CodeStage/`：脚本编译所需的最小 DLL/运行库依赖。
- `Assets/AppsFlyer/`、`Assets/MaxSdk/`、`Assets/Plugins/IngameDebugConsole/`、`Assets/Plugins/WaterCausticsModules/`：完整 `Assets/Scripts/` 编译链路继续需要的插件脚本/运行库。

## HexBuilding 核心内容

- `Assets/Scripts/HexGrid/**`
- `Assets/ABPackage/pkgDownloads/HexBuilding/**`
- `Assets/AddressableAssetsData/AssetGroups/HexBuilding.asset`
- `Assets/AddressableAssetsData/AssetGroups/Schemas/HexBuilding_*`
- `Assets/Settings/AddressableHelperSetting.asset` 中已保留 `HexBuilding` 配置。

## 已清理内容

- 未复制完整 `AssetsPackage/`、`Plugins/`、`Scenes/`、`Shader/`、`UnconfirmedAssets/` 等大目录。
- 未保留 `Assets/.vs/`、`Library/`、`Temp/`、`Logs/`、`UserSettings/`。
- 删除 `EventPartnerGather` Addressables group 及 schemas。

## 包配置调整

- 从 `Packages/manifest.json` 和 `Packages/packages-lock.json` 移除了非核心编辑器包：
  - `com.boxqkrtm.ide.cursor`
  - `com.github.skistua.unity-vimeditor`
- 从 `Packages/manifest.json` 移除了不存在依赖包 `com.asap.core` 的 `testables` 标记。

## 当前体积

执行瘦身后目录约 556MB：

- `LocalPackages/`：约 281MB。
- `Assets/`：约 204MB。
- `Packages/`：约 67MB。
- `ProjectSettings/`：约 0.1MB。

## 验证记录

- 已确认 `HexBuilding.asset` 包含地址：`BuildModel`、`HexMapPanel`、`hex_build_01_info`、`hex_build_01`、`HexMapAct`。
- 已确认 `AddressableHelperSetting.asset` 包含 `HexBuilding`。
- Unity batchmode 已通过工程打开和脚本编译检查，验证记录见 `DEPENDENCY_REPORT.md`。

## 远端

目标远端：`ssh://git@git.zz.com:2222/shandong/back_cantanBuilding.git`。