教师说明 · 如何把这套系统用起来
一、交付包里有什么
| 文件 / 目录 | 作用 | 是否可改 |
|---|---|---|
| index.html | 课程门户：系统说明、使用步骤、交付边界 | 可改文字 |
| lesson.html | 初中 D01 完整仿真演示课（握手 / 对话 / 带路） | 不建议改结构 |
| lesson-hs.html | 高中 D02 定点头限位课（arm3d 仿真 / 临界角 / 接触侧） | 不建议改结构 |
| plan.html / worksheet.html | 初中 D01 教案 / 学案，浏览器直接打印 | 可按校情改 |
| plan-hs.html / worksheet-hs.html | 高中 D02 教案 / 学案，浏览器直接打印 | 可按校情改 |
| roadmap.html | 20 个项目、200 课时的课程地图 | 只读 |
| tutorial/ | 20 个项目教程副本（项目目标 + 10 课时大纲） | 只读 |
| tutorial.html | 从调试到课堂：教学法与工程方法总结 | 只读 |
| account.html | 学生/教师注册、积分排名、兑换奖励；教师可加分与导出数据 | 按校情使用 |
| assets/ | 样式、机械臂仿真、三关交互脚本、局域网限位数据库 | 不要改 |
| manifest.json | 文件清单、大小、SHA256、版本、构建时间 | 校验用 |
二、离线部署（学校电脑）
- 把 zip 拷到教室电脑，右键“全部解压”。
- 进入解压后的文件夹，双击 index.html。
- 推荐浏览器：Chrome / Edge / Firefox（近 3 年版本）。不要用 IE。
- 投影后按 F11 全屏；演示课页面支持 1280×720 及以上分辨率。
- 不需要安装 Python/ROS。初中三关可完全离线；高中限位课需要教师机与机器人控制台（8790/8788）在同一局域网。
机房批量部署：把整个文件夹放到机房共享盘或每台电脑的桌面；也可以把 zip 放进学校资源平台，让学生自行下载解压。不要只拷贝单个 HTML 文件——仿真脚本在
高中限位课：先在教师机打开机器人控制台的
assets/ 里。
高中限位课：先在教师机打开机器人控制台的
http://192.168.31.47:8790/headfix_limits.html，确认能加载；控制台 IP 变化时，在高中课页面顶部改“控制台地址”。
三、课堂组织建议
| 场景 | 建议 |
|---|---|
| 只有教师机 + 投影 | 教师演示初中三关或高中限位四步，学生分组讨论并填写学案；每步先让学生预测，再操作验证。 |
| 每组一台电脑 | 学生跟随操作；教师用“暂停/复位”控制节奏，避免各组进度差太大。 |
| 有实体机 | 仿真先行：先在仿真里跑通，再由教师用原控制台做一次空载慢速演示；学生只看不动。 |
| 实体机数量不足 | 四组轮换：真机观察 / 仿真 / 学案记录 / 小组讨论，每 10 分钟换位。 |
| 高中选修 | 把 D02 当作“数据约束”案例：画出限位点→临界角→安全规则的接口，再用 Python 复现姿态判据。 |
四、真机安全边界（必须遵守）
学生包不含真机控制。本系统不会连接、同步或驱动实体机器人。
实体机由教师使用原有 robot-viz 控制台操作；操作前确认：急停可达、立柱高度合适、桌面距离足够、夹爪下方无人。
真机演示只做空载慢速；禁止让学生把手伸入夹爪或工作区；禁止用真机做“握手”接触演示。
实体机由教师使用原有 robot-viz 控制台操作；操作前确认：急停可达、立柱高度合适、桌面距离足够、夹爪下方无人。
真机演示只做空载慢速；禁止让学生把手伸入夹爪或工作区；禁止用真机做“握手”接触演示。
五、常见问题
| 现象 | 处理 |
|---|---|
| 双击后页面空白 | 确认整个文件夹解压完整；用 Chrome/Edge/Firefox 打开；不要用 IE。 |
| 机械臂画面不显示 | 确认 assets/arm6.js 与 assets/demo.js 存在；刷新页面。 |
| 对话没有反应 | 点击快捷问题或按回车发送；检查浏览器是否禁用了 JavaScript。 |
| 带路按钮无反应 | 先点“暂停”再点目的地；确认没有连续快速点击。 |
| 投影后字太小 | 浏览器 Ctrl/Cmd + “+” 放大到 125%–150%；或 F11 全屏。 |
| 打印教案/学案 | Ctrl/Cmd + P；建议 A4 纵向、边距 16mm；颜色选“彩色”以便保留提示框。 |
六、版本与验收
交付包根目录的 manifest.json 记录了版本、构建时间、文件列表与 SHA256。学校验收时可核对文件数量与哈希；后续更新直接替换整个文件夹，不要只覆盖部分文件。
| 项目 | 说明 |
|---|---|
| 当前版本 | v1.5.0 · 2 节完整仿真 Demo（D01 初中 + D02 高中限位）+ 20 项目课程地图 |
| 后续扩展 | 按同一模板逐项目补：课件 10 + 教案 10 + 学案 10 + 代码 + 仿真 + 评价 + 教具清单 |
| 研发侧保留 | 完整课程库、原始调试资料、机器人控制台；不放入学生包 |
七、建议的下一步
- 先用 D01（初中）和 D02（高中）各做一次 45 分钟试讲，收集教师反馈。
- 根据反馈确定“先做初中还是先做高中”的扩展顺序。
- 每扩展一个项目，保持“课件 / 教案 / 学案 / 仿真 / 评价 / 教具”六件套齐全。
八、交付方：如何重新打包
以下命令在研发侧 `robot-edu/` 目录执行，不要求学校电脑安装：
./export-school.sh # 等价于： python3 generate.py python3 tools/build_school_package.py
产物在 dist/robot-edu-school-v1.5.0/ 与 dist/robot-edu-school-v1.5.0.zip。每次构建会更新 manifest.json 的版本、文件清单与 SHA256；发给学校时整包替换，不要只覆盖单个 HTML。