diff --git a/Readme.md b/Readme.md index f14db3d..0b0bff1 100644 --- a/Readme.md +++ b/Readme.md @@ -1,3 +1,27 @@ +# 0. Repository Clone Instructions (Git LFS) + +The robotic hand STL model files (`.STL`) in this repository are hosted via Git LFS (Large File Storage). A plain `git clone` will only fetch pointer placeholder files, and the MuJoCo simulation will fail because it cannot find the STL models. + +**Install Git LFS before cloning:** +```bash +sudo apt install git-lfs +git lfs install +``` + +**Then clone the repository:** +```bash +git clone https://gitea.robotquan.com/chenshijue/delay-measurement.git +``` + +After cloning, the STL files will be automatically downloaded as full content via LFS. + +**Verify LFS files were fetched (optional):** +```bash +git lfs ls-files # should list all *.STL files +``` + +--- + # 1. LinkerFFG Glove ## 1.1 Product Introduction diff --git a/Readme_ZH.md b/Readme_ZH.md index cfa1461..5751fd2 100644 --- a/Readme_ZH.md +++ b/Readme_ZH.md @@ -1,3 +1,27 @@ +# 0. 仓库克隆说明(Git LFS) + +本仓库中的机械手 STL 模型文件(`.STL`)使用 Git LFS(Large File Storage)托管。直接 `git clone` 只会拉取到指针占位文件,MuJoCo 仿真会因找不到 STL 而报错。 + +**克隆前请先安装 Git LFS:** +```bash +sudo apt install git-lfs +git lfs install +``` + +**然后克隆仓库:** +```bash +git clone https://gitea.robotquan.com/chenshijue/delay-measurement.git +``` + +克隆完成后,STL 文件会自动通过 LFS 下载为完整内容。 + +**验证 LFS 是否拉取成功(可选):** +```bash +git lfs ls-files # 应列出所有 *.STL 文件 +``` + +--- + # 1. LinkerFFG手套 ## 1.1 产品介绍