### ページの名前と URL の案
ページの名前：π0.5 を mechArm 270 で追加学習し、実機で動かす ─ 環境・手順・結果の入口
URL：/pi05-mecharm-reproducible-guide

### 誰に
公開モデルの π0.5 を自分の小型アームで追加学習して動かしたい開発者・研究者。日本語で調べる人。ChatGPTなどのAIに聞いてたどり着く人も入る。

### この人がこのページで得るもの
π0.5 と mechArm 270 を使った追加学習と実機推論について、同じ環境から始めるために必要な手順、版と数字、足りない情報、そして現在の到達点がわかる見取り図。

### 最初の画面
π0.5 を mechArm 270 で追加学習し、実機で動かす ─ 環境・手順・結果の入口

Mac、Runpod の A40、小型アーム mechArm 270 を使い、お手本の収集から追加学習、実機推論まで進めた研究のログを、始める順にまとめました。
使った環境、ログで確認できる手順、実機で得た結果を対応させています。再現に必要でも、ログ一覧から確認できない情報は「ログにない（未記載）」と表示しています。
あなたの環境でこの研究を再現し、ここから先へ進むための土台として使ってください。

### 見せ場
再現の成否に関わる条件を、版番号と電源の数字のまま前に出していること。
例えば、アームの指令が遅い原因は pymycobot 4.0.4 であり、2.9.6 に戻すと送信が1.6秒から約0.02秒に改善した事実（Log#20）。ブロックを落とす原因は電源不足であり、12V・2Aから12V・5A（12×5で60W・計算）へ交換すると位置5で5回とも成功した事実（Log#30・#34）。同じ環境から始める人が踏む落とし穴を先に潰す。

### 構成
**1. そろえるものと、ログにない情報（環境表）**
AIが読み取れるよう文字の表で提示し、不足を明示する。
- 書くこと：再現に必要な環境と、ログにない情報の明示。
- 使う事実とログ：mechArm 270（Log#4ほか）、pymycobot 2.9.6・Piのdaemon（Log#20）、電源12V・5A（Log#30・#34）、Mac・RunpodのA40（Log#2・#27）、3,198円の互換ゲームパッド（Log#19）、2TBの外付けSSD（SO-101 Log#2）。Pythonやπ0.5の版、Piの型番は「ログにない（未記載）」。

**2. いまの到達点（実機で確認できた範囲）**
全位置で動くわけではない事実と、失敗からの直し方を置く。
- 書くこと：現在の成功率と、失敗をどう直したか。
- 使う事実とログ：お手本19本・3か所で15回中9回成功（Log#14）。お手本50本で一から学習し、位置1は3回成功、位置2は4回届かず、カメラの傾きではない（Log#28・#29）。12V・5Aに替えて位置5で5回成功（Log#34）。停止を詰めて学習し直す（Log#11）、肩の角度を直前の目標に変えて初めて箱に入った（Log#12）。

**3. まず GPU で推論を通す**
- 書くこと：遠隔推論の手順とGPUメモリの確認。
- 使う事実とログ：Macから画像と指示を送り予測を受信。平均97ms・往復391ms・0.34ドル（Log#2）。LIBEROで20回すべて成功・メモリを測った（Log#3）。
- 次に読む1本：遠隔推論の手順とコードは → Log#2

**4. お手本を集める**
- 書くこと：手とゲームパッドによる収集と、姿勢の限界。
- 使う事実とログ：肩約88°より深い姿勢はエラーなしに捨てられる（Log#9）。浅いつかみをゲームパッドで深く教え直し、5か所10本ずつ計50本に（Log#23・#26）。
- 次に読む1本：深くつかむお手本を教え直した記録は → Log#26

**5. 追加学習と実機で動かす**
- 書くこと：200ステップから50本・3,000ステップへの学習と、実機での直し。
- 使う事実とログ：200ステップでMacで予測受信（Log#4）。50本で一から学習し、A40で3,000ステップに6.2時間・約579円（Log#27）。GPU空き待ちで約4時間半（Log#10）。失敗をゲームパッドで直すと中央13秒、キーの41〜51秒より短く、関節を動かすのは2.6秒（Log#22・#32）。
- 次に読む1本：50本で一から学習し直した記録は → Log#27

**6. つまずき索引と、試した記録を送る**
- 書くこと：症状から引ける索引と、フォームへの案内。
- 使う事実とログ：指令が遅い → Log#20、ブロックを落とす → Log#30・#34、肩約88°より深い姿勢が動かない → Log#9、爪がブロックに乗る → Log#6・#25。
- フォーム案内（/message）：進んだ章、環境の違い、止まった所や未記載で困った所を送るよう促す。

### 束ねるログ
- SO-101 Log#2
- Log#2, #3, #4, #6, #9, #10, #11, #12, #14, #19, #20, #22, #23, #25, #26, #27, #28, #29, #30, #32, #34

### 今あるページとのつなぎ方
- トップ：今ある「シリーズ」欄の「フィジカルAI研究室を作る」の横に、「π0.5 を mechArm 270 で追加学習した環境・手順・結果」としてリンクを置く。
- シリーズ冒頭：「π0.5 と mechArm 270 を始める順に読む。使用環境・手順・実機結果・未記載情報をまとめた入口」としてリンクを置く。
- /gpu-buy-or-rent（GPUは買うか借りるか）：末尾に「借りた A40 で π0.5 を3,000ステップ学習すると、6.2時間・約579円でした。手順と環境はこちら」と置く。
- SNS：LinkedInに「Log#20（版を戻すと1.6秒が約0.02秒に）」など1つの罠を書き、このページへ送る。

### 公開後に見る数字
- 人の表示数（30件たまるまでは判断しない）
- ログへ進んだ人の割合と、選ばれた手順のリンク（環境・データ・学習・実機の各リンク移動を分けて記録）
- AI の利用者の依頼で読みに来た数（AI経由の取得と、AIリンクからの人の訪問は別集計にする）
- フォームからの「再現を試した・試そうとした記録」の連絡数

### ゴールにどう効くか
| 見るもの | ゴールに効く理由 | 効かないかもしれない理由 |
|---|---|---|
| このページの人の表示 | トップやLPから具体数字を添えて誘導するため。 | ニッチな題材で絶対数が少ない。→ AIや検索向けの文字起こしで手当てする。 |
| このページからログへ進んだ人 | 手順ごとに「次に読む1本」を置き、次の作業としてログを開く理由を作るため。 | このページだけで満足する。→ 要約は1行で止め、手順はログへ送る作りにした。 |
| AI の利用者の依頼で読みに来た数 | 表や到達点を文字にし、数字の横にログURLを置いてAIが引用しやすくするため。 | AIが要約だけで回答を完結させる。→ 手順の詳細は各ログに分散させている。 |
| AI のリンクから、このページに来た人 | AIが「未記載情報」や「つまずき索引」を含めた際、情報元として踏まれやすいため。 | AIのUI上でリンクが目立たない。→ AIの回答にURLが直接出るよう本文に配置する。 |
| 問い合わせ・相談 | 「試そうとして止まった記録」も歓迎し、書く内容を明示して敷居を下げるため。 | 再現のハードルが高く試す人が出ない。→ 読むだけでも索引が役立つ構成にした。 |