ParkingRobot/docs/overview.md

项目概览

项目定位

MyParking 是停车机器人控制软件的当前正式开发版本，主体为 C# 插件工程。项目目标是让多舵轮停车机器人完成底盘运动、车辆状态获取、轨迹跟踪、原地自转和后续停车作业；当前研发重点仍是单车闭环和实车联调，多车协同尚未形成可运行实现。来源：README.md、MultiWheelC/PilotConfig.cs、Shared/Fleet/FleetKinematics.cs。

项目不是可直接 dotnet run 的独立应用：

• MultiWheelC.dll 由 Clumsy 宿主加载，提供 C 层动作、控制和 MovementTest 入口。
• MedullaAdapter.dll 由 Medulla 宿主加载，负责 M 层硬件通信和周期逻辑。
• CommonUsage.dll 提供通用底盘模型和四轮几何解算。

对应入口类型为 MultiWheelC/PilotDefinition.cs::PilotDefinition 和 MedullaAdapter/DiverCartDefinition.cs::DiverCartDefinition；仓库中没有 Program.Main。

车辆与业务场景

• 代码接口面向四个可转向轮组，并暴露8个驱动电机的位置/速度反馈和4个舵角反馈。M/C IO定义见 PilotDefinition、DiverCartDefinition。
• 车体支持正常前后行驶、倒车轨迹、任意固定运动方向β下的滚动运动、蟹行和停车后原地自转。主要入口见 MultiWheelC/Movements/ 和 MultiWheelC/Experiments/。
• 夹臂速度、位置、限位和报警IO已经接入，但轮胎识别、自动钻车、释放车辆和完整停车作业状态机尚未在当前新版流程中完成。来源：PilotConfig.cs、PilotDefinition.cs、README.md。
• 多车模型数据类型已经预留，但多车配置位于 PilotConfig.cs 的 #if false，FleetKinematics.cs 只有占位注释，不能把当前代码视为已支持多车编队。

整体运行流程

典型新版轨迹跟踪流程：

1. Clumsy 宿主通过 MovementTest 或动作计划启动 TrajectoryTrackingMovement。
2. 动作停车并通过 PrepareWheelsForward 将舵轮预对齐到本段运动方向β。
3. ParkingVehicleStateProviderFactory 组合 Detour 位姿和轮组反馈速度。
4. ParkingGeometricController 完成轨迹投影、横纵向控制、GCP分配和完成条件判断。
5. GcpCommandExecutor、MultiWheelChassisAdapter 将SI单位命令转换到当前运动坐标系，再调用 CommonUsage.Chassis.MultiWheelChassis。
6. M层周期逻辑将底盘和夹臂命令发送到MCU/CAN，并把反馈通过宿主IO返回C层。

详细调用链见 architecture.md，接口和坐标语义见 interfaces.md。

当前阶段

• 单车基本运动、新版轨迹跟踪、倒车直线、45°蟹行直线、原地自转和组合动作均有宿主测试入口。
• 新版控制默认采用 Stanley 横向控制和 PID 纵向控制；轨迹实验和控制周期诊断可输出CSV。
• 当前代码能力不等于完整实车验收，特别是高速、曲线倒车、蟹行曲线、长期稳定性和异常工况仍需单独验证。

待确认

• Clumsy/Medulla 宿主的正式版本、插件部署目录和启动顺序。
• PilotDefinition.Conf 在实车上的持久化文件位置、加载时机和发布流程。
• 真实车辆最终几何参数、舵轮零位/限位和不同车辆配置的权威来源。
• 完整停车业务的产品流程、安全状态机和验收指标。