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_count、lint、build、format、types、inline_styles。不强制使用 oxc 工具链。
配置文件位置
注册后写入 .gvt/hook/modules/<name>.toml。文件名由路径推导:
.→ 项目名- 多层路径用
-连接,如frontend/my-app→frontend-my-app
激活钩子
bash
bash scripts/install-hooks.sh激活后每次 git commit 会触发 .githooks/pre-commit 调用 gvt hook 检查。
适用场景
- 旧项目接入 GVT 代码检查
- 为第三方前端目录补充行数/lint/构建检查
- 在 monorepo 中按目录注册多个独立检查模块