chore: use git-lfs for lancedb archive

Author: mars167

.git-ai/lancedb.tar.gz

@@ -0,0 +1 @@
+.git-ai/lancedb.tar.gz filter=lfs diff=lfs merge=lfs -text

.gitattributes

@@ -11,9 +11,18 @@ if [ ! -f ".git-ai/lancedb.tar.gz" ]; then
   exit 0
 fi
 
+LFS_REQUIRED="$(git check-attr filter -- .git-ai/lancedb.tar.gz 2>/dev/null | grep -q 'filter: lfs' && echo 1 || echo 0)"
+if [ "$LFS_REQUIRED" = "1" ]; then
+  if git lfs version >/dev/null 2>&1; then
+    git lfs post-checkout "$@"
+  else
+    echo "git-ai: repository requires git-lfs to fetch .git-ai/lancedb.tar.gz; please install git-lfs." 1>&2
+    exit 0
+  fi
+fi
+
 if ! command -v git-ai >/dev/null 2>&1; then
   exit 0
 fi
 
 git-ai ai unpack -p "$ROOT" >/dev/null
-

.githooks/post-checkout

@@ -11,9 +11,18 @@ if [ ! -f ".git-ai/lancedb.tar.gz" ]; then
   exit 0
 fi
 
+LFS_REQUIRED="$(git check-attr filter -- .git-ai/lancedb.tar.gz 2>/dev/null | grep -q 'filter: lfs' && echo 1 || echo 0)"
+if [ "$LFS_REQUIRED" = "1" ]; then
+  if git lfs version >/dev/null 2>&1; then
+    git lfs post-merge "$@"
+  else
+    echo "git-ai: repository requires git-lfs to fetch .git-ai/lancedb.tar.gz; please install git-lfs." 1>&2
+    exit 0
+  fi
+fi
+
 if ! command -v git-ai >/dev/null 2>&1; then
   exit 0
 fi
 
 git-ai ai unpack -p "$ROOT" >/dev/null
-

.githooks/post-merge

@@ -18,3 +18,12 @@ if [ -n "$CHANGED" ]; then
   echo "git-ai: .git-ai/lancedb.tar.gz changed during pre-push; please commit it before pushing." 1>&2
   exit 1
 fi
+
+LFS_REQUIRED="$(git check-attr filter -- .git-ai/lancedb.tar.gz 2>/dev/null | grep -q 'filter: lfs' && echo 1 || echo 0)"
+if [ "$LFS_REQUIRED" = "1" ]; then
+  if ! git lfs version >/dev/null 2>&1; then
+    echo "git-ai: repository requires git-lfs to push LFS objects; please install git-lfs." 1>&2
+    exit 2
+  fi
+  git lfs pre-push "$@"
+fi

.githooks/pre-push

@@ -102,4 +102,29 @@ git-ai ai hooks status
 - `pre-commit`：自动 `index --overwrite` + `pack`，并把 `.git-ai/meta.json` 与 `.git-ai/lancedb.tar.gz` 加入暂存区。
 - `pre-push`：再次 `pack`，若归档发生变化则阻止 push，提示先提交归档文件。
 - `post-checkout` / `post-merge`：若存在 `.git-ai/lancedb.tar.gz` 则自动 `unpack`。
-- 如需使用 git-lfs 管理归档文件，可手动执行：`git lfs track .git-ai/lancedb.tar.gz`（或运行 `git-ai ai pack --lfs`）。
+
+## Git LFS（推荐，用于 .git-ai/lancedb.tar.gz）
+
+为了避免把较大的索引归档直接存进 Git 历史，推荐对 `.git-ai/lancedb.tar.gz` 启用 Git LFS。
+
+### 开启（一次性）
+
+```bash
+git lfs install
+git lfs track ".git-ai/lancedb.tar.gz"
+git add .gitattributes
+git commit -m "chore: track lancedb archive via git-lfs"
+```
+
+也可以用 `git-ai` 触发（仅在已安装 git-lfs 的情况下生效）：
+
+```bash
+git-ai ai pack --lfs
+```
+
+### 克隆/切分支后（如果未自动拉取 LFS）
+如果你环境设置了 `GIT_LFS_SKIP_SMUDGE=1`，或发现 `.git-ai/lancedb.tar.gz` 不是有效的 gzip 文件：
+
+```bash
+git lfs pull
+```

README.md

@@ -11,9 +11,18 @@ if [ ! -f ".git-ai/lancedb.tar.gz" ]; then
   exit 0
 fi
 
+LFS_REQUIRED="$(git check-attr filter -- .git-ai/lancedb.tar.gz 2>/dev/null | grep -q 'filter: lfs' && echo 1 || echo 0)"
+if [ "$LFS_REQUIRED" = "1" ]; then
+  if git lfs version >/dev/null 2>&1; then
+    git lfs post-checkout "$@"
+  else
+    echo "git-ai: repository requires git-lfs to fetch .git-ai/lancedb.tar.gz; please install git-lfs." 1>&2
+    exit 0
+  fi
+fi
+
 if ! command -v git-ai >/dev/null 2>&1; then
   exit 0
 fi
 
 git-ai ai unpack -p "$ROOT" >/dev/null
-

assets/hooks/post-checkout

@@ -11,9 +11,18 @@ if [ ! -f ".git-ai/lancedb.tar.gz" ]; then
   exit 0
 fi
 
+LFS_REQUIRED="$(git check-attr filter -- .git-ai/lancedb.tar.gz 2>/dev/null | grep -q 'filter: lfs' && echo 1 || echo 0)"
+if [ "$LFS_REQUIRED" = "1" ]; then
+  if git lfs version >/dev/null 2>&1; then
+    git lfs post-merge "$@"
+  else
+    echo "git-ai: repository requires git-lfs to fetch .git-ai/lancedb.tar.gz; please install git-lfs." 1>&2
+    exit 0
+  fi
+fi
+
 if ! command -v git-ai >/dev/null 2>&1; then
   exit 0
 fi
 
 git-ai ai unpack -p "$ROOT" >/dev/null
-

assets/hooks/post-merge

@@ -18,3 +18,12 @@ if [ -n "$CHANGED" ]; then
   echo "git-ai: .git-ai/lancedb.tar.gz changed during pre-push; please commit it before pushing." 1>&2
   exit 1
 fi
+
+LFS_REQUIRED="$(git check-attr filter -- .git-ai/lancedb.tar.gz 2>/dev/null | grep -q 'filter: lfs' && echo 1 || echo 0)"
+if [ "$LFS_REQUIRED" = "1" ]; then
+  if ! git lfs version >/dev/null 2>&1; then
+    echo "git-ai: repository requires git-lfs to push LFS objects; please install git-lfs." 1>&2
+    exit 2
+  fi
+  git lfs pre-push "$@"
+fi

assets/hooks/pre-push

@@ -13,6 +13,7 @@ git-ai ai unpack
 如果仓库安装了 git-lfs，推荐对 `.git-ai/lancedb.tar.gz` 使用 LFS：
 
 ```bash
+git lfs install
 git lfs track ".git-ai/lancedb.tar.gz"
 git add .gitattributes
 git commit -m "track lancedb archive via lfs"