Initial import of FaRui Campus ADS v3.2

docs/git-upload-prep.md

@@ -0,0 +1,94 @@
+# Git 上传准备记录
+
+本文记录当前工作空间上传 Git 前已经完成的准备，以及后续推送远端时需要注意的事项。
+
+## 已处理
+
+- 已新增根目录 `.gitignore`，排除 colcon 构建产物、Python 缓存、日志、IDE 数据库和本地助手状态目录。
+- 已新增根目录 `.gitattributes`，将 `.pcd`、`.db3`、`.bag`、`.mcap`、模型文件、静态库、动态库、压缩包和较大的 GIF 标记为 Git LFS 文件。
+- 已确认本机安装了 Git LFS：`git-lfs/3.0.2`。
+- 已确认当前未发现 `build/`、`install/`、`log/` 目录。
+- 已备份并删除无效/嵌套 `.git/` 元数据，备份目录为 `/tmp/farui_git_metadata_backup_20260605_132216`。
+- 已初始化根目录 Git 仓库，当前分支为 `main`。
+- 已创建本地初始提交，提交信息为 `Initial import of FaRui Autoware Dual-Orin Stack`。
+- 已规范 Git 中的 executable bit，仅保留带 shebang 的脚本为可执行。
+
+## 当前仓库状态
+
+- 根目录只有一个有效 `.git/`。
+- 工作区当前为 clean 状态。
+- 当前未配置远端仓库。
+- 当前有 26 个文件由 Git LFS 管理。
+
+## 大文件
+
+当前最大本地生成物是 `.vscode/browse.vc.db`，约 867 MB，已通过 `.gitignore` 排除。
+
+仍然建议使用 Git LFS 管理以下类型的大文件：
+
+- 点云和地图测试数据：`*.pcd`
+- ROS bag 数据：`*.db3`、`*.bag`、`*.mcap`
+- SDK 或第三方二进制库：`*.a`、`*.so`
+- 模型和推理制品：`*.onnx`、`*.engine`、`*.pt`、`*.pth`
+- 压缩包和大型演示图：`*.zip`、`*.tar*`、`*.gif`
+
+### 嵌套 Git 仓库
+
+工作空间内存在多个嵌套 `.git/` 目录。若直接在根目录提交，Git 会把这些目录识别为
+嵌入式仓库或 submodule 风格条目，容易导致克隆后源码不完整。
+
+建议二选一：
+
+- 作为 vendored source：记录来源和 commit 后，删除内部 `.git/` 目录，把源码完整纳入主仓库。当前初始提交采用此方式。
+- 作为 submodule：在根仓库中正式配置 `.gitmodules`，由 Git 管理第三方依赖版本。
+
+当前记录到的嵌套仓库如下：
+
+| 路径 | Commit | Remote |
+| --- | --- | --- |
+| `master/src/Api/tier4_ad_api_adaptor` | `3de19bc` | `https://github.com/tier4/tier4_ad_api_adaptor.git` |
+| `master/src/Driver/Camera/hikvision_ros2_driver` | `a2f8538` | `https://github.com/sjtu-cyberc3/hikvision_ros2_driver.git` |
+| `master/src/Driver/Vehicle/ros2_socketcan` | `85da8c3` | `https://github.com/autowarefoundation/ros2_socketcan` |
+| `master/src/Mapping/fast_lio2` | `18418bc` | `https://github.com/Ericsii/FAST_LIO_ROS2.git` |
+| `master/src/Mapping/liorf` | `da22fa0` | `https://github.com/YJZLuckyBoy/liorf.git` |
+| `master/src/Mapping/livox_ros_driver2` | `378d1c7` | `https://github.com/Ericsii/livox_ros_driver2.git` |
+| `master/src/Vehicle/sensor_component_description` | `0798200` | `https://github.com/tier4/sensor_component_description.git` |
+| `master/src/universe/common/glog` | `ea36766` | `https://github.com/tier4/glog.git` |
+| `master/src/universe/common/muSSP` | `c79e98f` | `https://github.com/tier4/muSSP.git` |
+| `master/src/universe/core/autoware_cmake` | `890e312` | `https://github.com/autowarefoundation/autoware_cmake.git` |
+| `master/src/universe/core/autoware_common` | `6752ca7` | `https://github.com/autowarefoundation/autoware_common.git` |
+| `master/src/universe/core/autoware_lanelet2_extension` | `6fc35a0` | `https://github.com/autowarefoundation/autoware_lanelet2_extension.git` |
+| `master/src/universe/core/autoware_msgs/autoware_adapi_msgs` | `2512a4f` | `https://github.com/autowarefoundation/autoware_adapi_msgs.git` |
+| `master/src/universe/core/autoware_msgs/autoware_internal_msgs` | `4f5feff` | `https://github.com/autowarefoundation/autoware_internal_msgs.git` |
+| `master/src/universe/core/autoware_msgs/autoware_msgs` | `4f9f1c0` | `https://github.com/autowarefoundation/autoware_msgs.git` |
+| `master/src/universe/core/autoware_utils` | `451419e` | `https://github.com/autowarefoundation/autoware_utils.git` |
+| `slave/src/Api/tier4_ad_api_adaptor` | `3de19bc` | `https://github.com/tier4/tier4_ad_api_adaptor.git` |
+| `slave/src/Driver/Vehicle/Pixkit_Chassis_Driver/pix_driver` | `a0c4902` | `https://github.com/pixmoving-moveit/pix_driver.git` |
+| `slave/src/Driver/Vehicle/ros2_socketcan` | `85da8c3` | `https://github.com/autowarefoundation/ros2_socketcan` |
+| `slave/src/Vehicle/sensor_component_description` | `0798200` | `https://github.com/tier4/sensor_component_description.git` |
+| `slave/src/universe/core/autoware_cmake` | `890e312` | `https://github.com/autowarefoundation/autoware_cmake.git` |
+| `slave/src/universe/core/autoware_common` | `6752ca7` | `https://github.com/autowarefoundation/autoware_common.git` |
+| `slave/src/universe/core/autoware_lanelet2_extension` | `6fc35a0` | `https://github.com/autowarefoundation/autoware_lanelet2_extension.git` |
+| `slave/src/universe/core/autoware_msgs/autoware_adapi_msgs` | `2512a4f` | `https://github.com/autowarefoundation/autoware_adapi_msgs.git` |
+| `slave/src/universe/core/autoware_msgs/autoware_internal_msgs` | `4f5feff` | `https://github.com/autowarefoundation/autoware_internal_msgs.git` |
+| `slave/src/universe/core/autoware_msgs/autoware_msgs` | `4f9f1c0` | `https://github.com/autowarefoundation/autoware_msgs.git` |
+| `slave/src/universe/core/autoware_utils` | `451419e` | `https://github.com/autowarefoundation/autoware_utils.git` |
+
+## 后续推送流程
+
+添加远端仓库后推送：
+
+```bash
+git remote add origin <远端仓库地址>
+git push -u origin main
+```
+
+如果远端平台需要 Git LFS，请确认远端仓库已启用 LFS，并在推送前执行：
+
+```bash
+git lfs install
+git lfs ls-files
+```
+
+如果以后决定改成 submodule 管理第三方依赖，需要从当前单体仓库方式重新设计
+`.gitmodules`，并替换对应目录的 vendored source。