|
|
@@ -1,13 +1,33 @@
|
|
|
#!/usr/bin/env bash
|
|
|
-# 知识库提交前校验:暂存区含 docs/参考资料/知识库 变更时自动运行校验脚本。
|
|
|
+# 提交前校验:
|
|
|
+# 1) 知识库校验:暂存区含 docs/参考资料/知识库 变更时运行 docs/scripts/validate_kb.py
|
|
|
+# 2) 循环依赖校验:暂存区含 cfc-backend/ 或 tools/check_circular_deps.py 变更时运行
|
|
|
+# tools/check_circular_deps.py;eager 循环依赖非空则阻断提交。
|
|
|
# 阻断不合规提交(返回非 0 时 git commit 会失败),可用 git commit --no-verify 跳过。
|
|
|
+#
|
|
|
+# 启用方式:bash docs/scripts/install_git_hooks.sh(core.hooksPath -> .githooks,幂等)
|
|
|
set -euo pipefail
|
|
|
|
|
|
ROOT="$(git rev-parse --show-toplevel)"
|
|
|
KB_DIR="docs/参考资料/知识库"
|
|
|
-VALIDATOR="$ROOT/docs/scripts/validate_kb.py"
|
|
|
+KB_VALIDATOR="$ROOT/docs/scripts/validate_kb.py"
|
|
|
+CIRCULAR_CHECKER="$ROOT/tools/check_circular_deps.py"
|
|
|
|
|
|
+PY_BIN="$(command -v python3 || command -v python || true)"
|
|
|
+
|
|
|
+# 1) 知识库校验
|
|
|
if git diff --cached --name-only -- "$KB_DIR" | grep -q .; then
|
|
|
- echo "[pre-commit] 检测到知识库变更,运行校验: $VALIDATOR"
|
|
|
- python3 "$VALIDATOR" "$ROOT/$KB_DIR"
|
|
|
-fi
|
|
|
+ echo "[pre-commit] 检测到知识库变更,运行校验: $KB_VALIDATOR"
|
|
|
+ "$PY_BIN" "$KB_VALIDATOR" "$ROOT/$KB_DIR"
|
|
|
+fi
|
|
|
+
|
|
|
+# 2) 循环依赖强约束(eager 环非空 → 阻断提交)
|
|
|
+STAGED_FILES="$(git diff --cached --name-only)"
|
|
|
+if grep -qE '^(cfc-backend/|tools/check_circular_deps\.py$)' <<< "$STAGED_FILES"; then
|
|
|
+ if [ -z "$PY_BIN" ]; then
|
|
|
+ echo "[pre-commit] 未找到 python3/python,无法执行循环依赖检查(请先安装 Python)" >&2
|
|
|
+ exit 1
|
|
|
+ fi
|
|
|
+ echo "[pre-commit] 检测到后端代码变更,运行循环依赖检查: $CIRCULAR_CHECKER"
|
|
|
+ "$PY_BIN" "$CIRCULAR_CHECKER"
|
|
|
+fi
|