# 10. Project Stack Defaults ## 1. 原则 新项目需要明确的默认技术选型,Agent 不应自行猜测。已有项目则必须保留真实技术栈,不得为了符合默认值而迁移。 ## 2. 新项目默认全栈方案 | 层次 | 默认技术 | |---|---| | 前端框架 | React | | 前端语言 | TypeScript | | 构建工具 | Vite | | 包管理器 | npm | | UI 组件库 | Ant Design | | 样式 | Tailwind CSS v4 + CSS Variables | | 状态管理 | Zustand | | 路由 | React Router | | HTTP | Axios | | 后端语言 | Python | | 后端框架 | FastAPI | | 校验 | Pydantic | | ORM | SQLAlchemy | | 数据库迁移 | Alembic | | 开发数据库 | SQLite | | 生产数据库 | PostgreSQL | | API | REST + OpenAPI | | 本地静态资源 | `./data` | 具体依赖版本按初始化时的兼容稳定版本选择,并保持 lockfile。此处定义的是新项目起点,不是所有项目的强制技术栈。 ## 3. 项目类型与生命周期 - `project.type: fullstack`:前后端均适用; - `frontend-only`:仅初始化前端; - `backend-only`:仅初始化后端; - `project.lifecycle: auto`:空项目按 new,已有应用代码按 existing; - `new`:默认 stack 是初始化目标; - `existing`:以代码、依赖和锁文件为准。 ## 4. 覆盖 只修改与项目意图不同的字段。不要要求用户重复填写整套技术栈。若明确需求与默认值冲突,说明冲突并提出最小调整,不得静默替换技术。