外观
生成项目结构
脚手架输出一个与 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 源仓库中的文件。后续升级组件时修改依赖版本;升级应用模板时应评估变更并迁移,不要重新运行脚手架覆盖已有项目。