Skip to content

gvt add — 为已有项目添加钩子检查

在已有项目中注册一个前端目录,自动检测其工具链并生成对应的钩子检查配置。

用法

bash
# 交互模式
cd your-project
gvt add

# 快捷模式
gvt add --dir frontend/my-app

交互流程

$ cd existing-project
$ gvt add

 → 输入前端目录路径: frontend/my-app
 → 正在检测工具链...
   ✓ 类型: vue | 包管理器: pnpm
   ✓ 工具: ESLint, Prettier, TypeScript, Vite
   ✓ 将注册检查项: line_count, lint, build, format, types
 → 确认添加? Yes
   ✓ 已更新 .gvt/hook/ 配置文件
   ✓ 已安装 .githooks/pre-commit 钩子

参数

参数简写说明
--dir-d前端目录路径(相对项目根目录)

自动检测的检查项

根据检测结果自动生成检查项:line_countlintbuildformattypesinline_styles。不强制使用 oxc 工具链。

配置文件位置

注册后写入 .gvt/hook/modules/<name>.toml。文件名由路径推导:

  • . → 项目名
  • 多层路径用 - 连接,如 frontend/my-appfrontend-my-app

激活钩子

bash
bash scripts/install-hooks.sh

激活后每次 git commit 会触发 .githooks/pre-commit 调用 gvt hook 检查。

适用场景

  • 旧项目接入 GVT 代码检查
  • 为第三方前端目录补充行数/lint/构建检查
  • 在 monorepo 中按目录注册多个独立检查模块

基于 MIT 协议开源