提交规范

<type>(<scope>): <subject>

[可选 body：说明 why]

[可选 footer：Breaking Changes / Closes #issue]

# 一次性启用（克隆后执行一次）
git config core.hooksPath githooks

#!/bin/bash
# 拦截误提交的日志/构建产物/系统文件
set -e
FORBIDDEN_PATTERNS='hs_err_pid.*\.log|replay_pid.*\.log|spy\.log|\.DS_Store|log\.bin|^target/|\.iml$'

errors=0
while IFS= read -r file; do
  if [[ "$file" =~ $FORBIDDEN_PATTERNS ]]; then
    echo "[✗] 禁止提交: $file (匹配忽略规则)"
    errors=1
  fi
done < <(git diff --cached --name-only --diff-filter=ACM)

# 校验当前分支名是否符合 <前缀>/<版本号>/<语义> 或 main / release/<版本> / line/<产品>/<版本>
branch=$(git rev-parse --abbrev-ref HEAD)
if [[ ! "$branch" =~ ^(main|release/|line/|feature/|hotfix/|custom/|dev/) ]]; then
  echo "[✗] 分支名 [$branch] 不符合规范，应为 release/line/feature/hotfix/custom/dev 前缀之一"
  echo "   格式: 主产品 <前缀>/<版本号>/<语义>（如 feature/2.1.1/bacnet-cov）或产品线 <前缀>/<产品>/<版本>/<语义>（如 feature/eos/2.1.0/择机算法）"
  errors=1
fi

# 三段式校验：feature/hotfix/custom 必须有 <版本>/<语义> 两段（语义段中文/英文均可）
# （子产品四段式 feature/<产品>/<版本>/<语义> 天然满足"至少两段"，此处不误报）
if [[ "$branch" =~ ^(feature|hotfix|custom)/([^/]+)$ ]]; then
  echo "[✗] 分支名 [$branch] 缺少语义段，应为 <前缀>/<版本号>/<语义>，如 hotfix/2.1.1/cov-fix 或 hotfix/2.1.1/knx隧道假死优化"
  errors=1
fi
# 语义段禁止空格（中文短语或英文小写连字符均可）
if [[ "$branch" =~ ^(feature|hotfix|custom)/[^/]*/.*[[:space:]] ]]; then
  echo "[✗] 分支名 [$branch] 语义段含空格，请用连字符或去掉空格"
  errors=1
fi

exit $errors

#!/bin/bash
# 强制 Conventional Commits: <type>(<scope>): <subject>
set -e
msg_file="$1"
first_line=$(head -1 "$msg_file")

# 合法 type；merge/revert 开头放行
PATTERN='^(feat|fix|docs|refactor|chore|perf|test|style|ci|build|revert)(\(.+\))?: .+'

if [[ "$first_line" =~ ^Merge ]] || [[ "$first_line" =~ ^Revert ]]; then
  exit 0
fi

if [[ ! "$first_line" =~ $PATTERN ]]; then
  echo "[✗] 提交信息格式错误: $first_line"
  echo "   应为: <type>(<scope>): <subject>"
  echo "   例:   feat(bacnet): 支持 SubscribeCOVProperty 降级订阅"
  echo "   type: feat|fix|docs|refactor|chore|perf|test|style|ci|build|revert"
  exit 1
fi

#!/bin/bash
# 仅在交互式编辑器提交且为新建提交时填模板
case "$2" in
  message|template|merge|squash|commit) exit 0 ;;
esac
cat >> "$1" <<'EOF'

# ---- 提交信息模板（删除本行及以上注释后填写）----
# <type>(<scope>): <subject>
#
# type: feat|fix|docs|refactor|chore|perf|test|style|ci
# scope(可选): system|iot|energy|eoms|driver|bacnet|modbus|auth|zw|fe|db|sql
# subject: 祈使句，中文，结尾不加句号
#
# [body: 说明 why，非 what]
# [footer: Breaking Changes / Closes #issue]
EOF