vben-cli-tools.mdc 1.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667
  1. ---
  2. description:
  3. globs:
  4. alwaysApply: false
  5. ---
  6. # Vben 项目 CLI 工具
  7. 项目在 `scripts/` 目录下提供了一些命令行工具,用于简化常用操作。
  8. ## vsh (`pnpm vsh`)
  9. `vsh` 是一个用于项目级别操作的工具,例如代码检查、依赖管理等。
  10. 代码位于 [scripts/vsh/](mdc:scripts/vsh)
  11. ### 用法
  12. ```bash
  13. pnpm vsh [command] [options]
  14. ```
  15. ### `vsh check-circular`
  16. 检查整个项目的循环引用。如果存在循环引用,会在控制台输出相关模块。
  17. - 用法: `pnpm vsh check-circular`
  18. - 选项:
  19. - `--staged`: 只检查 Git 暂存区内的文件 (默认 `false`)
  20. ### `vsh check-dep`
  21. 检查项目依赖情况,并在控制台输出"未使用的依赖"、"未安装的依赖"信息。
  22. - 用法: `pnpm vsh check-dep`
  23. - 选项:
  24. - `-r, --recursive`: 递归删除整个项目 (默认 `true`)
  25. - `--del-lock`: 是否删除 `pnpm-lock.yaml` 文件 (默认 `true`)
  26. ### `vsh lint`
  27. 对项目进行 lint 检查,确保代码符合规范。
  28. - 用法: `pnpm vsh lint`
  29. - 选项:
  30. - `--format`: 检查并尝试修复错误 (默认 `false`)
  31. ### `vsh publint`
  32. 对 Monorepo 项目进行包规范检查。
  33. - 用法: `pnpm vsh publint`
  34. - 选项:
  35. - `--check`: 仅执行检查 (默认 `false`)
  36. ### `vsh code-workspace`
  37. 生成 `vben-admin.code-workspace` 文件。通常在代码提交时自动执行。
  38. - 用法: `pnpm vsh code-workspace`
  39. - 选项:
  40. - `--auto-commit`: Git commit 时自动提交 (默认 `false`)
  41. - `--spaces`: 缩进格式 (默认 2个缩进)
  42. ## turbo-run (`pnpm turbo-run`)
  43. 用于快速执行 Monorepo 大仓中的脚本,并提供选项式交互选择。
  44. 代码位于 [scripts/turbo-run/](mdc:scripts/turbo-run)
  45. ### 用法
  46. ```bash
  47. pnpm turbo-run [command]
  48. ```
  49. ### `turbo-run dev`
  50. 快速执行 `dev` 命令,并提供选项式交互选择子项目进行开发。
  51. ## 脚本目录
  52. 所有 CLI 相关脚本都位于 [scripts/](mdc:scripts) 目录下。