diff --git a/README.md b/README.md
index 0a184fb..6f7a9cf 100644
--- a/README.md
+++ b/README.md
@@ -75,8 +75,22 @@ bash ~/ros2/scripts/run_visual_servo_rt.sh --arm 89 --control
 
 ## 上传 git 时
 
-- **要提交**：`src/` `scripts/` `docs/` `config/site.example.yaml` `models/README.md` `models/**/*.labels.yaml`
-- **不要提交**：`config/site.yaml`（含本机 IP/序列号）、`build/` `install/` `log/`、YOLO `.pt/.onnx/.engine`、`thirdparty/` `vendor/`
+- **要提交**：`src/` `scripts/` `docs/` `config/site.example.yaml` `models/README.md` `models/**/*.labels.yaml` `handeye/`
+- **不要提交**：`config/site.yaml`（含本机 IP/序列号）、`handeye/tmp/`（临时产物）、`build/` `install/` `log/`、YOLO `.pt/.onnx/.engine`、`thirdparty/` `vendor/`
 - 规则已写在 `.gitignore`
 
-别人克隆后必须自己 `cp site.example.yaml site.yaml` 并重新手眼标定（不要直接用仓库里某台现场的 `T_4x4` 当真值）。
+### `handeye/` 是个例外，说明一下
+
+`handeye/poses/`（示教点）与 `handeye/results/`（标定结果）**是入库的**，
+尽管它们属于某台现场的数据。理由是：手眼标定要用真机示教十几分钟，
+是费了真机时间换来的资产，入库才有一份可回滚的备份；一旦没入库，
+一次误删就得重新上真机采点。所以这两类文件按"资产"对待，而不是按"配置"。
+
+因此**别人克隆后必须重新标定，并把结果覆盖到 `handeye/results/<臂号>_<模式>.yaml`**。
+不要直接用仓库里现成的 `T_4x4` —— 那是属于另一台机器、另一个相机安装位的，
+用错的表现是跟踪始终差几厘米，且很难怀疑到标定值上。
+示教点同理：`handeye/poses/` 里的关节角只在对应的那台臂上有意义。
+
+（注：`config/site.yaml` 不入库、而 `handeye/` 入库，看似矛盾，其实是
+"配置属于站点、不入库；标定成果属于资产、入库"这条区分。早期这两类的
+边界没写清，导致 README 的说明和仓库实际状态不一致。）
diff --git a/handeye/poses/91_eye_in_hand.yaml b/handeye/poses/91_eye_in_hand.yaml
index d41bdd9..da2ac25 100644
--- a/handeye/poses/91_eye_in_hand.yaml
+++ b/handeye/poses/91_eye_in_hand.yaml
@@ -1,4 +1,4 @@
-# Right arm 91 (Rizon4-063991) taught joints for hand-eye.
+# Right arm 91 taught joints for hand-eye.
 # Fill with:
 #   bash ~/ros2/scripts/run_handeye.sh --arm 91 teach
 #   bash ~/ros2/scripts/run_handeye.sh --arm 91 merge
diff --git a/handeye/results/89_eye_in_hand.yaml b/handeye/results/89_eye_in_hand.yaml
index d3b3a46..9926f95 100644
--- a/handeye/results/89_eye_in_hand.yaml
+++ b/handeye/results/89_eye_in_hand.yaml
@@ -1,4 +1,4 @@
-# Left arm 89 (Rizon4-063989) eye-in-hand. Do not use for 91.
+# Left arm 89 eye-in-hand. Do not use for 91.
 # Hand-eye result
 # mode: eye_in_hand
 # camera_source: d405