diff --git a/CLAUDE.md b/CLAUDE.md index 5cc9551..d5e78db 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -375,69 +375,14 @@ self.arm_controller.set_joint_positions(saved_joint_positions) - `src/simulation/environment.py`(create_task_markers, create_transport_object方法) - `src/gui/main_window.py`(execute_three_stages方法添加吸附逻辑) -## 仿真录制回放功能(2025-09-14)✅ 已完成 +## 录制回放功能 ✅ -### 新增功能 -为机械臂仿真系统添加了完整的录制和回放功能,用户可以保存仿真数据并重复观看执行过程。 +**核心功能**: +- 执行时录制关节位置、路径数据 +- 回放时显示路径和精确重现动作 +- 自动保存为时间戳命名的JSON文件 -### 核心模块 -1. **SimulationRecorder** (`src/simulation/recording.py`) - - 实时录制机械臂关节位置、末端执行器位置、运输物体位置 - - 支持30fps录制,自动保存为JSON格式 - - 记录关键事件(抓取、释放等)和配置信息 - -2. **SimulationPlayer** (`src/simulation/playback.py`) - - 加载并验证录制文件格式 - - 支持播放/暂停/速度控制 - - 按时间轴精确重现仿真动作 - -### GUI界面集成 -在主窗口左侧控制面板添加"Recording & Playback"区域: -- **Start Recording** - 开始/停止录制 -- **Load Recording** - 加载录制文件 -- **Play/Pause** - 控制回放播放 - -### 技术特性 -- **自动录制**:执行三阶段任务时自动记录每帧数据和规划路径 -- **智能保存**:文件自动以时间戳命名(`simulation_recording_YYYYMMDD_HHMMSS.json`) -- **完整回放**:回放时显示原始规划路径(暗绿色)和任务点标记 -- **精确重现**:机械臂按录制的关节位置精确回放 -- **数据完整性**:记录完整的机械臂状态、物体位置、规划路径和系统配置 - -### 数据格式 -```json -{ - "metadata": { - "timestamp": "2025-09-14T14:30:52", - "config": {...}, - "task_points": {...} - }, - "frames": [ - { - "time": 0.0, - "joint_positions": [...], - "end_effector_position": [...], - "object_position": [...] - } - ], - "path_data": { - "planned_path": [[...], [...], ...], - "executed_path": [] - }, - "events": [...] -} -``` - -### 配置管理规范 -遵循项目配置管理原则,所有模块专用参数定义为文件内部常量: -- `recording.py`: MAX_FRAMES_PER_SECOND, DEFAULT_FRAME_INTERVAL -- `playback.py`: DEFAULT_PLAYBACK_SPEED, MIN_PLAYBACK_SPEED, MAX_PLAYBACK_SPEED - -### 新增文件 -- `src/simulation/recording.py` - 录制器模块 -- `src/simulation/playback.py` - 回放器模块 -- 修改 `src/gui/main_window.py` - GUI集成(约150行新增代码) - -### 使用方法 -1. **录制**:点击"Start Recording" → 执行仿真任务 → 自动保存 -2. **回放**:点击"Load Recording"选择文件 → 点击"Play"开始回放 \ No newline at end of file +**主要修复**(2025-09-14): +- 修复回放时路径不显示问题 +- 新增 `get_planned_path()` 方法 +- 改进回放时路径和标记显示 \ No newline at end of file