2026-06-17

更新概览

• React 模板完成一次面向 AI 协作的企业级重构：从旧的 demo 模板整理为 app / features / shared 分层结构。
• Vue3 模板同步完成企业级架构模板改造：目录、UI、样式、图标、文档页、AGENTS 规则和 Vite 插件开关均与新基线对齐。
• 两个模板的默认首页 demo 均调整为 docs 文档模块，用于说明项目结构、核心库职责和开发约定。
• UI 栈统一转向 shadcn 系列 + Tailwind CSS + Heroicons：React 使用 shadcn/ui，Vue3 使用 shadcn-vue。
• 构建默认复杂度降低：start / build 不再要求 Git 初始化，compression、legacy、web update notice、DevTools、code inspector 等能力改为环境变量开关。

React 模板 (vite_react_init)

架构调整

• 新增 src/app：应用装配、路由、通知、导航、全局样式入口集中到应用层。
• 新增 src/features/auth：登录页、session token 读写和认证相关接口归入 auth 模块。
• 新增 src/features/docs：作为登录后的默认入口，帮助开发者和 AI Agent 快速理解模板结构。
• 新增 src/shared：沉淀跨业务基础能力，包括 ui、api、lib、config 和通用组件。
• 删除旧的 src/pages/module-home 首页 demo、旧 src/apis、旧 src/components、旧 src/routes 等扁平目录。

UI 与样式

• 移除 antd、antd-style、@ant-design/*。
• 移除 unocss、@unocss/*、virtual:uno.css 和 Uno 图标预设。
• 新增 Tailwind CSS 4 + @tailwindcss/vite，全局样式入口迁移到 src/app/styles/index.css。
• 新增 shadcn/ui 配置和基础组件，统一放在 src/shared/ui。
• 新增 @heroicons/react，文档页使用 Heroicons 展示目录和依赖职责。
• 继续保留 lucide-react，供 shadcn 组件和少量基础 UI 使用。

认证、路由与 API

• RouterAuth 拆分为新的 RouteGuard 和页面标题逻辑，路由 meta 继续保留 title、needLogin。
• 默认路由从 /home 改为 /docs，未登录访问受保护路由会跳转 /login。
• session 读写收敛到 features/auth/session。
• Axios 基础实例迁移到 shared/api/http，负责 token 注入、响应解包和标准错误抛出。
• toast 通知通过 app/notifications 适配，业务代码不直接依赖 sonner。
• 401 跳转收敛到 app/navigation，避免请求层散落跳转逻辑。

Vue3 模板 (vite_vue3_init)

架构调整

• 新增 src/app：应用组合层集中管理路由、layout、stores、notifications、navigation 和全局样式。
• 新增 src/features/auth：保留原登录页视觉风格，登录页背景继续使用 OGL 实现，session 和认证接口归入 auth 模块。
• 新增 src/features/docs：作为登录后的默认入口，以文档形式展示模板介绍、目录约定和依赖职责。
• 新增 src/shared：沉淀 api、lib、config、components 和 ui 等跨业务能力。
• 删除旧 src/pages、src/routes、src/stores、src/apis、src/components、src/utils 等扁平目录。
• 新增 .agents/skills/shadcn-vue，同步 unovue/shadcn-vue 官方 skill，辅助 AI Agent 稳定操作组件。

UI 与样式

• 移除 Element Plus、unplugin-element-plus 和 Element Plus 主题样式。
• 移除 UnoCSS、Uno 图标预设、virtual:uno.css 和 unocss.config.js。
• 新增 Tailwind CSS 4 + @tailwindcss/vite，全局样式入口迁移到 src/app/styles/index.css。
• 新增 shadcn-vue 配置 components.json，基础组件统一放在 src/shared/ui。
• 新增 @heroicons/vue，业务图标从 @heroicons/vue/24/outline 按需导入。
• 新增 reka-ui、vue-sonner、tailwind-merge、class-variance-authority、tw-animate-css 等 shadcn-vue 相关依赖。

认证、路由与 API

• 默认路由从旧首页调整为 /docs，/login 继续作为未登录入口。
• route meta 类型继续保留 title、needLogin，feature routes 由 src/app/routes 聚合。
• session token 读写收敛到 features/auth/session。
• Axios 基础实例迁移到 shared/api/http，负责 token 注入、响应解包和标准错误抛出。
• toast 通知通过 app/notifications 适配，业务代码不直接依赖 vue-sonner。
• 401 跳转收敛到 app/navigation，避免请求层散落跳转逻辑。

构建与开发工具

• Vite 配置改用 loadEnv(mode, process.cwd(), '') 读取环境变量，避免 env 开关不生效。
• 新增 vite-plugin-vue-devtools，由 VITE_ENABLE_VUE_DEVTOOLS=true 控制。
• 保留 @vitejs/devtools，由 VITE_ENABLE_DEVTOOLS=true 控制。
• 删除 vite-plugin-no-bug、unplugin-printer/vite 和 react-grab 依赖及其插件使用。
• compression、legacy、web update notice、code inspector 均改为环境变量按需启用。
• 修复 docs 页面横向滚动条问题：全局容器从 min-width: 100vw 调整为 width: 100% 并限制横向溢出。

文档站同步

• 更新 React 模板页，说明新的 shadcn/ui + Tailwind CSS + Heroicons UI 栈。
• 更新 Vue3 模板页，说明新的 shadcn-vue + Tailwind CSS + Heroicons Vue UI 栈。
• 更新快速开始页的 Vue3 模板目录结构，替换旧的 apis/components/routes/stores 说明。
• 更新脚手架核心页，将 AI 协作和现代 UI 栈说明从 React 扩展到 React + Vue3。
• 更新日志导航，将最新日志指向 2026-06-17。

验证结果

• React 模板：
  • pnpm lint：通过。
  • pnpm build：通过。
  • 残留扫描：antd、unocss、autofit、旧首页模块无残留。
• Vue3 模板：
  • pnpm lint：通过。
  • pnpm typecheck：通过。
  • pnpm build：通过。
  • 构建中存在 VueUse #__PURE__ 注释位置提示，属于第三方依赖产物提示，不阻塞构建。
• cwa-docs：
  • npm run build：通过。

注意事项

• 历史更新日志保留当时版本记录，不回写旧日志内容；当前模板状态以 React 模板页、Vue3 模板页和 2026-06-17 日志为准。
• Vue3 模板不再以内置 Element Plus 和 UnoCSS 作为默认 UI/样式方案，后续新增组件请优先通过 shadcn-vue 生成到 src/shared/ui。