VUP 是什么
VUP 的核心价值是：让团队用统一方式快速搭应用、可控地使用 AI、并按需扩展能力。
你能得到什么
1）Apps 层（vup app add）
通过模板快速启动不同类型应用：
- 前端：Vue、Nuxt、VitePress
- 后端：Nest
- 多端：UniApp、Capacitor、Electron
- 平台/工具：Qiankun、WXT、CLI、MCP、Component、Package
2）AI 治理层（.agents）
这里的 AI 不是黑盒，而是可治理的交付系统。
.agents/_core/rules/*：约束流程、文件、模块和质量的硬规则.agents/_core/tasks/*：按工程动作加载的任务卡片，例如添加应用、页面、接口、鉴权和发布.agents/_core/stacks/*：只在 task 需要时读取的平台差异说明- 外部 skill：由各自安装器管理，不写入
.agents
为什么 AI 生成代码更标准：
- 标准化输入：规则、skills、目录约定明确。
- 标准化过程：分阶段推进、关键 Gate 确认、决策可留痕。
- 标准化输出：结构、命名、可评审性保持一致。
传统 AI 生成 vs VUP 治理：
| 维度 | 通用 AI 生成 | VUP 治理 |
|---|---|---|
| 输入 | 主要依赖提示词，容易漂移 | rules + skills + 仓库约定 |
| 过程 | 中间步骤不透明 | Phase/Gate 机制，可审计 |
| 输出 | 每次风格波动大 | 结构和规范一致性更高 |
| 团队协作 | 难复用、难对齐 | 共享约定，可持续复用 |
Core 指令按职责拆分：
- Rules 保证每次 AI 执行都不越过共同边界。
- Tasks 告诉 AI 如何完成常见工程动作。
- Stacks 说明各平台的差异落点。
- 外部 skill 补充团队领域知识，不污染 vup 内置核心。
3）Packages 层（vup package add）
项目启动后按需“后补能力”，避免一开始过度设计：
@vup/ui/@vup/ui-mobile：桌面端/移动端 UI 封装@vup/http：统一请求层与拦截器能力@vup/mock：基于 MSW 的 mock 联调能力@vup/pwa：PWA 预设与运行时辅助能力@vup/iconfont：图标资源整合@vup/richeditor：富文本能力@vup/nest-upload：Nest 上传模块
Packages 是真正进入运行时代码的能力；tasks 负责告诉 AI 何时添加、接到哪里、遵循哪个 README 或 API。比如请求层应优先使用基座的 @vup/http，而不是在业务里重新手写一套并行实现。
4）Examples 参考层（examples/）
基座仓库还提供“单能力示例工程”：
examples/mockexamples/pwaexamples/qiankunexamples/ui
这些示例用于接入参考和能力验证，不作为 vup app add 的正式应用模板。需要时可通过 vup example add 添加到当前项目。
为什么这套结构有效
- 启动更快：先建应用，再逐步增强。
- AI 更稳：rules 兜底行为，skills 复用成熟路径。
- 架构更轻：功能按需添加，不提前堆复杂度。
- 协作更顺：统一约定降低 onboarding 和评审成本。