Skip to content

生成项目结构 ​

脚手架输出一个与 Kevairy 源仓库解耦的标准 Vue 单包项目:

text
my-admin/
├── src/                       # 后台应用源码
├── public/                    # 静态资源
├── tests/                     # 单元测试与 E2E
├── package.json               # 依赖、开发和质量命令
├── vite.config.ts             # Vite 构建配置
└── README.md                  # 新项目说明

应用根目录 ​

后台应用包含布局、认证适配器、路由、主题、请求封装、示例页面和自动化测试。应用从 npm registry 安装模板发布时验证过的 @kevairy/components 精确版本。

从以下文档开始接入业务:

@kevairy/components ​

组件包不再复制到生成项目中。应用通过 @kevairy/components 或 @kevairy/components/core 使用公开能力,并通过正常的依赖升级流程获取修复和新功能。

不要把只服务于单一业务页面的逻辑直接加入公共包。确认存在跨页面复用价值后,再按组件边界设计公开 API。

根目录命令 ​

以 pnpm 项目为例:

bash
pnpm dev
pnpm lint
pnpm typecheck
pnpm test
pnpm build

脚本会直接构建和测试当前应用,不经过 workspace 转发。使用 npm 或 yarn 时,脚手架会生成等价的命令串联方式。

与源仓库的关系 ​

生成完成后,新项目不会读取 Kevairy 源仓库中的文件。后续升级组件时修改依赖版本;升级应用模板时应评估变更并迁移,不要重新运行脚手架覆盖已有项目。