Star Arm 102 交付版 v0.8.4 - 快速启动指南

🚀 30 秒快速启动

步骤 1：进入目录

cd /workspace/Star-Arm-102-3D-Web-v0.8.4-DELIVERY/Browser_SDK

步骤 2：启动服务

./run_local.sh

步骤 3：打开浏览器

访问：http://localhost:8080

✅ 启动成功标志

看到以下输出表示启动成功：

Serving HTTP on 0.0.0.0 port 8080 (http://0.0.0.0:8080/) ...

🎯 首次使用检查清单

1. 页面加载检查

[ ] 页面标题显示"Star Arm 102 数字孪生工作台（交付版）"
[ ] 右上角显示版本号 "v0.8.4"
[ ] 顶部标签页只有：实时控制、数据采集（禁用）、重设零点、恢复出厂参数、舵机配置
[ ] 没有"轨迹记录"标签 ← 已禁用

2. 串口连接检查

[ ] 点击"连接 Leader"按钮
[ ] 浏览器弹出串口选择对话框
[ ] 选择对应的 USB 串口设备
[ ] 看到"Leader 已连接"状态

3. 模型加载检查

[ ] 三维场景中显示 Star Arm 102 模型
[ ] 模型可以鼠标拖动旋转
[ ] 关节滑块显示实时角度值

🔧 常见问题

Q1: 页面打不开

解决: 确认启动了 run_local.sh，不能直接双击 html 文件

Q2: 串口无法连接

解决: - 检查 USB 线是否插好 - 确认没有其他程序占用串口 - 在 Linux 下可能需要 sudo usermod -a -G dialout $USER 然后重新登录

Q3: Firefox/Safari 无法使用

解决: 这两个浏览器不支持 Web Serial API，请使用 Chrome 或 Edge

Q4: 模型加载失败

解决: 检查 assets/models/ 目录是否完整复制

📋 功能演示流程

演示 1：实时遥操作（5 分钟）

选择 Leader 类型：Star Arm 102-HD
选择 Follower 类型：虚拟 FL（仅三维模型）
连接 Leader 串口
启动遥操作
移动 Leader 机械臂，展示 FL 三维模型实时跟随

演示 2：reBot B601 兼容（3 分钟）

选择 Follower 类型：虚拟 FL
选择虚拟型号：reBot Arm B601
连接 Leader 串口
启动遥操作
展示 B601 三维模型跟随 Leader 运动

演示 3：关节滑块控制（3 分钟）

连接 HD Leader 或 FL Follower
点击"进入滑块控制"
拖动 J1-J7 滑块
观察青色预览模型
点击"确认执行关节目标"

演示 4：世界坐标控制（5 分钟）

连接 FL Follower
切换到"世界坐标"标签
拖动末端 TCP 手柄（红/绿/蓝箭头）
或直接输入 X/Y/Z 毫米坐标
点击"计算并预览"
确认执行

📦 交付包内容

Star-Arm-102-3D-Web-v0.8.4-DELIVERY/
├── README.md                      # 产品说明文档
├── DELIVERY_CHECKLIST.md          # 交付清单
├── QUICKSTART.md                  # 本文件
└── Browser_SDK/
    ├── index.html                 # 主页面（无轨迹记录）
    ├── run_local.sh               # 启动脚本
    ├── assets/                    # 三维模型、纹理、库
    └── src/                       # JavaScript 源码

🎓 版本亮点（v0.8.4）

修复的 Bug

✅ J1 方向反转问题
✅ J2 方向反转问题
✅ J3 跟随问题
✅ J6 方向问题（渲染层解决）

支持的型号

Star Arm 102-LD（无动力 Leader）
Star Arm 102-HD（有动力 Leader）
Star Arm 102-FL（Follower）
reBot Arm B601（虚拟支持）

安全特性

预览→确认→执行安全链
紧急停止按钮
力控保护（HD 型号）
限位保护

📞 需要帮助？

如遇到任何问题： 1. 查看 README.md 详细说明 2. 查看 DELIVERY_CHECKLIST.md 功能清单 3. 联系 SmaugBrain 技术团队

SmaugBrain - 星智机器人产品部
2026-07-24