From de2313c765b94bfa24c166fe9bfead08ce11d818 Mon Sep 17 00:00:00 2001 From: chenshijue <24121145@bjtu.edu.cn> Date: Wed, 19 Aug 2026 11:25:33 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=20Git=20LFS=20?= =?UTF-8?q?=E5=85=8B=E9=9A=86=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Readme.md | 24 ++++++++++++++++++++++++ Readme_ZH.md | 24 ++++++++++++++++++++++++ 2 files changed, 48 insertions(+) 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 产品介绍