docs: 精简CLAUDE.md,只保留关键信息

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
sladro 2025-09-14 14:55:53 +08:00
parent 5f263e503d
commit 161edce061

View File

@ -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"开始回放
**主要修复**2025-09-14
- 修复回放时路径不显示问题
- 新增 `get_planned_path()` 方法
- 改进回放时路径和标记显示