階段二:靈巧手與雙臂校準(Windows)
本階段對三個裝置進行標定：主動臂、從動臂、AmazingHand 手。標定是遙操作正確性的前提，必須完成本階段才能進入遙操作。
標定順序：主動臂 → 從動臂+手 → 手角度。每步都需終端交互（物理操作 + 按鍵）。
⚠️ 通用提醒：本頁命令中的串口參數為示例佔位，必須替換為你機器實際的 COM 號（見階段一記錄的串口）。
前置條件
已完成 階段一：環境搭建
conda 環境
lerobot已啟用
# 啟用環境
conda activate lerobot
# 進入到lerobot
cd ../lerobot三裝置串口已記錄
裝置已上電、獨立供電
步驟 1：標定主動臂
lerobot-calibrate --teleop.type=so101_leader --teleop.port=<主動臂COM> --teleop.id=amazing_hand_leader將
<主動臂COM>替換為你機器的實際 COM 號（示例COM54）。
交互步驟：
將主動臂所有關節移到中間位，按 Enter
將每個關節依次推到最大/最小範圍，完成後按 Enter
驗證：標定檔案自動儲存到 C:\Users\<使用者名稱>\.cache\huggingface\lerobot\calibration\teleoperators\so_leader\amazing_hand_leader.json
⚠️ 注意 1（夾爪必標）：6 號夾爪舵機範圍會作為
gripper.pos（0~100）的歸一化基準。夾爪務必從全開推到全閉，標定到位，否則後續手開合比例會失真。
⚠️ 注意 2（自由轉動）：標定時機械臂需能自由轉動，確保舵機空載。
⚠️ 注意 3（標定檔案位置）：Windows 下路徑為使用者目錄
%USERPROFILE%\.cache\huggingface\lerobot\calibration\。
步驟 2：標定從動臂（同時連接手）
lerobot-calibrate --robot.type=so101_amazing_hand --robot.port=<從動臂COM> --robot.hand_port=<手COM> --robot.id=amazing_hand_follower將
<從動臂COM>/<手COM>替換為實際 COM 號（示例COM58/COM11）。
交互步驟：
將從動臂 5 個關節（無 6 號）移到中間位，按 Enter
將各關節走全行程，按 Enter
驗證：標定檔案儲存到 C:\Users\<使用者名稱>\.cache\huggingface\lerobot\calibration\robots\so101_amazing_hand\amazing_hand_follower.json
⚠️ 注意 1（手扭矩自動啟用）：此命令連接時自動啟用 8 個手舵機扭矩（日誌顯示
enabling AmazingHand torque），標定結束手會張開，屬正常現象。
⚠️ 注意 2（不會彈手 GUI）：手角度不使用 lerobot 的
RangeFinderGUI，從動臂標定結束即完成。手角度用步驟 3 的專用工具。
⚠️ 注意 3（串口佔用）：此步驟佔用手串口。不要同時執行其他佔用該串口的進程。
步驟 3：標定手角度 + 夾爪方向（專用 GUI）
lerobot-calibrate-amazing-hand --hand_port <手COM> --leader_port <主動臂COM>將
<手COM>/<主動臂COM>替換為實際 COM 號（示例COM11/COM54）。--leader_port用於同步標定夾爪方向（見下）。
GUI 操作：
拖動 4 根手指滑塊（index/middle/ring/thumb），使手完全張開，點擊
Save Open拖動滑塊使手完全握拳，點擊
Save Close主動臂夾爪張開，點擊
Capture Open（GUI 實時顯示gripper.pos，張開時應接近 100）主動臂夾爪捏合，點擊
Capture Close（捏合時應接近 0）自動儲存：以上四個值都設定後，視窗頂部彈出綠色橫幅
AUTO-SAVED to ...\hand_angles.json，終端同步列印路徑關閉視窗（手自動解除扭矩）
驗證：角度與夾爪映射儲存到 C:\Users\<使用者名稱>\.cache\huggingface\lerobot\calibration\robots\so101_amazing_hand\hand_angles.json
⚠️ 注意 1（必須標定）：每台新電腦/每隻手都必須執行本步驟。config 裡的角度是 AmazingHand 官方通用預設，僅作後備；
hand_angles.json存在時優先載入你的實測值。不標定可能導致開合方向/範圍錯誤。
⚠️ 注意 2（自動載入）：機器人每次啟動讀取
hand_angles.json（含gripper_open_pos/gripper_close_pos）覆蓋 config 預設值，無需改代碼。夾爪方向會因主動臂而異，標定一次即可。
⚠️ 注意 3（滑塊語義）：滑塊向
+方向使該指 m1 向+angle、m2 向-angle（鏡像）。以手的實際姿態判斷張開/握拳，不必關注角度數值。
⚠️ 注意 4（精確標定）：標定"完全張開"時不要過度（手指歪斜/散開），"完全握拳"時不要過度擠壓（舵機持續受壓）。否則遙操作時開合會過頭。
⚠️ 注意 5（Capture 順序）：
Capture Open/Capture Close對應主動臂夾爪的開合，不是手手指。若手張開方向反了，多半是這裡標反或手角度標反，重標即可。
⚠️ 注意 6（GUI 打不開）：確認已安裝
pygame（amazinghandextra 內含）。若仍打不開，檢查是否有圖形桌面環境。
重標定
只需重標某一部分時：
只重標手 → 僅執行步驟 3
只重標從動臂 → 僅執行步驟 2（會順帶啟用手扭矩）
全部重標 → 步驟 1 → 2 → 3
⚠️ 注意：步驟 2 和步驟 3 不能同時執行（都佔用手串口）。
完成本階段後，進入 階段三：遙操作。
故障排查
| 現象 | 原因 | 解決 |
|---|---|---|
| 主動臂標定報 2307 型號錯誤 | 臂總線被污染/串口衝突 | 確認未同時連手串口；本項目手走 rustypot 已規避 |
| 標定手無 GUI 彈出 | 用了錯誤命令 | 必須用 lerobot-calibrate-amazing-hand（不是 lerobot-calibrate） |
手驅動報 Operation timed out | 串口忙碌/時序 | 確認手串口未被佔用，重試 |
| 標定檔案找不到 | 路徑不對 | 檢查 %USERPROFILE%\.cache\huggingface\lerobot\calibration\ |
| 串口打不開 | COM 號錯 | 用 lerobot-find-port 重新確認 |