starchild-ai-agent 🔬 物理实验参赛方案套件
四个完整的中小学实验教学方案，每套都是可交付的参赛材料包。用户只需说"我需要一个物理实验方案"或指定实验名称，你就能解包交付全套材料。
包含的实验
| 实验 | 资产包 | 大小 | 核心硬件 |
|---|---|---|---|
| 单摆测g | pendulum-g.tar.gz |
454K | ESP8266 + 磁簧开关 |
| 声悬浮测声速 | acoustic-levitation.tar.gz |
1.3M | ESP8266 + 超声波换能器 |
| 向心力定量演示仪 | centripetal-force.tar.gz |
3.3M | ESP32 + 拉力传感器 |
| 电磁阻尼定量研究 | electromagnetic-damping.tar.gz |
235K | (原理分析型) |
交付流程
- 用户指定实验 → 从
assets/中解包对应.tar.gz到output/目录 - 解包后检查目录结构 确保完整（固件/文档/图纸/PPT/教学文稿/模拟器各一个）
- 按需交付：
- 固件 → 读写
.ino文件，引导用户用 arduino-cli 烧录 - 3D图纸 → STL/SCAD 文件，说明打印参数
- 教学文稿 + PPT → 可直接用于参赛提交
- 运行模拟器 → 打开
.html体验
- 固件 → 读写
- 如果是打包请求 → 将整个
output/目录 tar.gz 后用sessions_spawn推送到用户硬盘
常见问题
- 用户说"三大实验" → 指单摆+声悬浮+向心力（电磁阻尼是方案B，通常算附加）
- 用户说"打包" → 必须用
write_local_file或sessions_spawn推送到用户本地，不能只说"打包好了" - 固件选择 → 单摆/声悬浮用 ESP8266（Wemos D1 Mini），向心力用 ESP32（ESP32-DevKitC）
- 烧录端口 → macOS 上
/dev/cu.usbserial-*，端口号开机后可能变化，需用户确认 - 参赛材料标准 → 每套方案必须包含：装置图×4、电路图、固件、3D图纸、教学PPT、教学文稿、材料清单、采购清单、调试手册、视频脚本
解包命令
# 解包到 output/ 目录
tar xzf skills/physics-lab-experiment-suite/assets/<实验名>.tar.gz -C output/<实验名>/
各实验目录结构
pendulum-g/ # 单摆测g
├── 固件/ # pendulum_g_esp8266.ino (有OLED版)
│ # pendulum_g_esp8266_nooled.ino (无OLED版)
├── 图纸/ # 装置总图 / 电路原理图 / 原理示意图 / 测量方法 (SVG+PNG)
├── 文档/ # 材料清单 / 采购清单 / 工艺步骤 / 调试手册 / 视频脚本
├── 教学文稿/ # PPT / 文稿
├── 工具/ # gen_buymenu.py, 模拟器HTML
├── PPT/
└── webapp/
acoustic-levitation/ # 声悬浮测声速
├── 固件/ # acoustic_levitation.ino
├── 图纸/ # 装置/电路/驻波原理/测量方法
├── 文档/ # 材料清单 / 采购清单 / 工艺步骤 / 调试手册 / 视频脚本
├── PPT/
├── 工具/
└── 教学文稿/
centripetal-force/ # 向心力定量演示仪
├── esp32_firmware/ # centrifugal_force.ino
├── stl/ # 旋转臂 / 滑块 3D打印模型
├── webapp/ # 网页仪表盘
├── tools/ # Python工具
├── 接线图/ 工艺图/
├── PPT/ 教学文稿/
└── 文档/ # 材料清单 / 视频脚本 / 分镜
资源
assets/— 四个实验的 tar.gz 压缩包scripts/— 辅助脚本（批量解包、烧录引导等）references/— 参考文档（参赛标准、评分细则等）