gvt hook — 运行代码检查

在已生成的项目（包含 .gvt/hook/ 配置目录）中运行 pre-commit 代码检查。

用法

# 检查所有已变更的文件（默认：暂存区 + 工作区 + 未跟踪文件）
gvt hook

# 仅检查暂存区（已 git add）的文件（pre-commit 钩子使用）
gvt hook -t

# 全项目扫描
gvt hook --all

参数

参数	简写	说明
--staged	-t	仅检查暂存区文件
--all		全项目扫描（忽略暂存状态）

所有命令均不支持位置参数，请使用标志参数。

检查范围

• 默认：暂存区 + 工作区 + 未跟踪文件
• -t：仅 git add 的文件（pre-commit 钩子默认调用）
• --all：扫描整个项目，用于 CI 或一次性全量检查

模块级配置

每个模块在 .gvt/hook/ 下维护独立 .toml，支持 enabled 单独开关。默认只检查暂存文件，使用 --all 进行全量扫描。

检查失败处理

任一检查项失败会在终端以彩色输出标记文件与行号，退出码非 0，中断 commit 或 CI。修复后重新运行 gvt hook 即可。

注意事项

• 检查项由 .toml 的 checks 字段定义，可在 gvt add 后手动增减。
• line_count 使用双阈值（警告/错误），默认 warn_lines=250、max_lines=300。