[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-9038":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":16,"stars7d":15,"stars30d":17,"stars90d":16,"forks30d":16,"starsTrendScore":16,"compositeScore":18,"rankGlobal":10,"rankLanguage":10,"license":10,"archived":19,"fork":19,"defaultBranch":20,"hasWiki":21,"hasPages":19,"topics":22,"createdAt":10,"pushedAt":10,"updatedAt":34,"readmeContent":35,"aiSummary":36,"trendingCount":16,"starSnapshotCount":16,"syncStatus":37,"lastSyncTime":38,"discoverSource":39},9038,"Robot_Admin","ChenyCHENYU\u002FRobot_Admin","ChenyCHENYU","道友请留步！🚀 一款专为开发者省时间、提效率的现代化中后台模板，跳过低质造轮子，上手即开工！Vue 3 + TS + Naive UI，更有 Bun+Vite 双引擎，性能直接拉满💥 毫秒级热更新不卡顿，开发丝滑，您试试！还有49 个成熟组件，演示页+文档双重完善，无残缺、无坑点，复制即用无需额外调试；配套 8 个 @robot-admin 专属包生态，插件式集成更灵活，轻松适配单体、Monorepo、MicroApp、模块联邦等企业级架构，个人练手、团队协作、大型商业应用，一套模板全搞定！纯为爱发电，不玩虚的！你的任何需求、任何bug，尽管往 issues 里丢，我们一起打磨真实业务场景、高效解决实际难题；诚邀每一位道友加入共建，你有想法和需求我来落地，来，一起玩玩。","https:\u002F\u002Frobotadmin.cn",null,"Vue",1011,72,36,1,0,8,51.89,false,"main",true,[23,24,25,26,27,28,29,30,31,32,33],"axios","bun","naive-ui","nodejs","pinia","scss","typescript","unocss","vite","vite7","vue3","2026-06-12 04:00:42","\u003Cdiv align=\"center\">\n  \u003Ca href=\"https:\u002F\u002Frobotadmin.cn\">\n    \u003Cpicture>\n      \u003Csource srcset=\"https:\u002F\u002Fcheny-chenyu.oss-cn-chengdu.aliyuncs.com\u002Fimg\u002Frobot-left.png\" media=\"(prefers-color-scheme: dark)\">\n      \u003Cimg src=\"https:\u002F\u002Fcheny-chenyu.oss-cn-chengdu.aliyuncs.com\u002Fimg\u002Frobot-left.png\" height=\"120\" \u002F>\n    \u003C\u002Fpicture>\n  \u003C\u002Fa>\n  \n  \u003Ch1>\n    \u003Cimg src=\"https:\u002F\u002Freadme-typing-svg.herokuapp.com?font=Fira+Code&size=32&duration=3000&pause=1000&color=4FC08D&background=FFFFFF00&center=true&vCenter=true&multiline=true&width=600&height=100&lines=🤖+Robot+Admin;重新定义企业级中后台开发体验\" alt=\"Robot Admin\" \u002F>\n  \u003C\u002Fh1>\n  \n  \u003Cp>\u003Cstrong>Robot Admin - 多架构企业级解决方案\u003C\u002Fstrong>\u003C\u002Fp>\n\n  \u003C!-- 架构选择器 -->\n  \u003Ctable>\n    \u003Ctr>\n      \u003Ctd align=\"center\" width=\"200\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🏗️-单体架构-4A90E2?style=for-the-badge\" alt=\"Monolithic\">\u003Cbr>\n        \u003Csub>\u003Cstrong>当前分支\u003C\u002Fstrong>\u003C\u002Fsub>\u003Cbr>\n        \u003Csub>传统 SPA 架构\u003C\u002Fsub>\u003Cbr>\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Ftree\u002Fmain\">\n          \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F查看代码-main-blue?style=flat-square\" alt=\"Main Branch\">\n        \u003C\u002Fa>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"200\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F📦-Monorepo-00D8FF?style=for-the-badge\" alt=\"Monorepo\">\u003Cbr>\n        \u003Csub>\u003Cstrong>Bun Workspaces\u003C\u002Fstrong>\u003C\u002Fsub>\u003Cbr>\n        \u003Csub>多应用管理\u003C\u002Fsub>\u003Cbr>\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Ftree\u002Fmonorepo\">\n          \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F查看代码-monorepo-00D8FF?style=flat-square\" alt=\"Monorepo Branch\">\n        \u003C\u002Fa>\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fblob\u002Fmonorepo\u002FREADME.md\">\n          \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F完整文档-README-orange?style=flat-square\" alt=\"Monorepo Docs\">\n        \u003C\u002Fa>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"200\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🔮-模块联邦-9B59B6?style=for-the-badge\" alt=\"Module Federation\">\u003Cbr>\n        \u003Csub>\u003Cstrong>Module Federation\u003C\u002Fstrong>\u003C\u002Fsub>\u003Cbr>\n        \u003Csub>初版完成\u003C\u002Fsub>\u003Cbr>\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Ftree\u002Fmodule-federation\">\n          \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F查看代码-module--federation-9B59B6?style=flat-square\" alt=\"MF Branch\">\n        \u003C\u002Fa>\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fblob\u002Fmodule-federation\u002FREADME.md\">\n          \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F使用指南-README-orange?style=flat-square\" alt=\"MF Docs\">\n        \u003C\u002Fa>\n      \u003C\u002Ftd>\n      \u003Ctd align=\"center\" width=\"200\">\n        \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🚀-微前端-E74C3C?style=for-the-badge\" alt=\"Micro Frontend\">\u003Cbr>\n        \u003Csub>\u003Cstrong>MicroApp\u003C\u002Fstrong>\u003C\u002Fsub>\u003Cbr>\n        \u003Csub>初版完成\u003C\u002Fsub>\u003Cbr>\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Ftree\u002Fmicro-app\">\n          \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F查看代码-micro--app-E74C3C?style=flat-square\" alt=\"MicroApp Branch\">\n        \u003C\u002Fa>\n        \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fblob\u002Fmicro-app\u002FREADME.md\">\n          \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F查看文档-README-orange?style=flat-square\" alt=\"MicroApp Docs\">\n        \u003C\u002Fa>\n      \u003C\u002Ftd>\n    \u003C\u002Ftr>\n  \u003C\u002Ftable>\n\n  \u003Cp>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fbun-%E2%89%A51.3.x-ff1e56?style=flat&logo=bun\" alt=\"Bun Version\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fvue-3.5.13-4FC08D?style=flat&logo=vue.js\" alt=\"Vue Version\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Ftypescript-5.8.0-blue?style=flat&logo=typescript\" alt=\"TypeScript Version\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fvite-8.0.3-646CFF?style=flat&logo=vite\" alt=\"Vite Version\">\n    \u003Ca href=\"https:\u002F\u002Fvercel.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fdeployments\u002FChenyCHENYU\u002Frobot_admin\u002Fproduction?label=vercel&logo=vercel\" alt=\"Vercel\">\u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fstandardjs.com\">\u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcode_style-standard-brightgreen\" alt=\"Code Style\">\u003C\u002Fa>\n  \u003C\u002Fp>\n  \u003Cp>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcomponents-51+-success?style=flat\" alt=\"Components\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdemos-54+-orange?style=flat\" alt=\"Demo Pages\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdirectives-7-purple?style=flat\" alt=\"Custom Directives\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fi18n-auto_translate-00D8FF?style=flat&logo=googletranslate\" alt=\"Auto i18n\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%E2%89%A522.18-339933?style=flat&logo=nodedotjs\" alt=\"Node Version\">\n  \u003C\u002Fp>\n  \u003Cp>\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FChenyCHENYU\u002Frobot_admin?style=social\" alt=\"GitHub stars\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FChenyCHENYU\u002Frobot_admin?style=social\" alt=\"GitHub forks\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fwatchers\u002FChenyCHENYU\u002Frobot_admin?style=social\" alt=\"GitHub watchers\">\n  \u003C\u002Fp>\n\n  \u003C!-- 快速导航 -->\n  \u003Cp>\n    \u003Ca href=\"https:\u002F\u002Frobotadmin.cn\">\n      \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🚀-在线体验-00D8FF?style=for-the-badge&logo=vercel\" alt=\"Live Demo\">\n    \u003C\u002Fa>\n    \u003Ca href=\"https:\u002F\u002Fwww.tzagileteam.com\">\n      \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F📖-完整文档-FF6B6B?style=for-the-badge&logo=gitbook\" alt=\"Documentation\">\n    \u003C\u002Fa>\n    \u003Ca href=\"#-快速开始真的很快\">\n      \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F⚡-快速开始-4ECDC4?style=for-the-badge&logo=rocket\" alt=\"Quick Start\">\n    \u003C\u002Fa>\n    \u003Ca href=\".\u002FCONTRIBUTING.md\">\n      \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🤝-参与贡献-FFA726?style=for-the-badge&logo=github\" alt=\"Contributing\">\n    \u003C\u002Fa>\n    \u003Ca href=\".\u002FREADME_EN.md\">\n      \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🌍-English-95E1D3?style=for-the-badge&logo=googletranslate\" alt=\"English Version\">\n    \u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\n---\n\n\u003Cdiv align=\"center\">\n  \u003Cp>\n    \u003Cstrong>中文\u003C\u002Fstrong> | \u003Ca href=\".\u002FREADME_EN.md\">English\u003C\u002Fa>\n  \u003C\u002Fp>\n\u003C\u002Fdiv>\n\n## 🎯 多架构支持\n\n> 💡 Robot Admin 提供多种架构分支，支持从单体到微前端的渐进演进。当前所在为**单体 SPA 开发主线**（`dev`\u002F`main`）。\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>👉 查看各架构对比一览\u003C\u002Fb>\u003C\u002Fsummary>\n\n| 架构类型          | 适用场景             | 特点                             | 分支                                                                                     | 文档                                                                                    |\n| ----------------- | -------------------- | -------------------------------- | ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------- |\n| **🏗️ 单体架构** ← | 中小型项目、快速原型 | 简单直接、开箱即用               | [`main`](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Ftree\u002Fmain)                           | 本文档                                                                                  |\n| **📦 Monorepo**   | 多应用统一管理       | 代码复用、统一工具链、独立部署   | [`monorepo`](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Ftree\u002Fmonorepo)                   | [完整指南](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fblob\u002Fmonorepo\u002FREADME.md)          |\n| **🔮 模块联邦**   | 微应用动态加载       | 运行时共享、独立部署、版本隔离   | [`module-federation`](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Ftree\u002Fmodule-federation) | [使用指南](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fblob\u002Fmodule-federation\u002FREADME.md) |\n| **🚀 微前端**     | 大型应用、团队协作   | 技术栈无关、独立部署、渐进式迁移 | [`micro-app`](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Ftree\u002Fmicro-app)                 | [查看文档](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fblob\u002Fmicro-app\u002FREADME.md)         |\n\n\u003C\u002Fdetails>\n\n---\n\n## 🚀 重新定义企业级中后台开发体验\n\n> **🎯 一个敏捷的，为开发者体验而生的企业级中后台解决方案**\n\n_在这里，当 `Bun` 的极致性能遇上 `Vue3` 的组合式 API，当 `TypeScript` 的类型安全拥抱 `UnoCSS` 的原子化样式..._\n\n---\n\n## ⚡ 为什么选择 Robot Admin？\n\n### 🔥 性能怪兽级别的开发体验\n\n- **毫秒级热更新** - Bun + Vite8 化学反应，告别等待\n- **智能类型提示** - TypeScript5.8 + 51+ 自定义组件，IDE 智能感知体验拉满\n- **零配置开箱即用** - 一条命令启动，30 秒内搭建完整后台系统\n\n### 🎨 不只是一个管理系统，更是一个作品\n\n- **54+ 精心打磨的演示页面** - 每一个都是可直接用于生产的业务组件，51 个组件支持文档站 iframe 在线预览\n- **7 种自定义指令** - 防抖、节流、长按、拖拽、权限...让开发更优雅\n- **主题系统** - 深色\u002F浅色模式\u002F跟随系统 + 支持自定义扩展\n- **Preview 路由系统** - 38 个无鉴权独立预览路由，供 [文档站](https:\u002F\u002Fwww.tzagileteam.com) 通过 iframe 嵌入实时组件演示\n\n### 🛠️ 企业级架构，个人项目也能享受\n\n- **RBAC 权限体系** - 菜单级、按钮级、接口级，权限控制细致入微\n- **渐进式微前端** - 架构设计支持从单体到微前端的平滑演进\n- **生产级工程化** - ESLint + Prettier + Husky，代码质量无忧\n\n---\n\n## 🚀 快速开始（真的很快！）\n\n> 🎉 **推荐使用 Bun** - 体验前所未有的安装速度\n\n```bash\n# 1. 克隆项目\ngit clone https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002Frobot_admin.git\n\n# 2. 进入目录\ncd robot_admin\n\n# 3. 安装依赖（如闪电般快速）\nbun install    # 推荐！速度提升10倍\n# 或使用 npm install \u002F yarn install \u002F pnpm install\n\n# 4. 启动项目（毫秒级启动）\nbun dev\n```\n\n**🔥 首次启动只需 2 秒不到，后续热更新不到 100ms！**\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>📦 更多命令\u003C\u002Fb>\u003C\u002Fsummary>\n\n```bash\n# 开发相关\nbun dev                # 开发环境启动\nbun run build          # 生产环境构建\nbun run build:test     # 测试环境构建\nbun run build:staging  # 预发布构建\nbun run preview        # 本地预览构建结果\n\n# 代码质量\nbun run lint           # 代码检查和修复\nbun run format         # 代码格式化\nbun test:unit          # 单元测试\n\n# 类型检查\nbun run type-watch     # 监听模式类型检查\nbun run type:check     # 智能类型分析\n\n# 其他\nbun run commit         # 规范化提交（git cz）\nbun outdated           # 检查依赖更新\nbun clean              # 清理缓存\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## ✨ 核心亮点\n\n### 🏗️ 技术栈（高富帅阵容）\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看完整技术栈\u003C\u002Fb>\u003C\u002Fsummary>\n\n**🎭 前端核心**\n\n- **Vue 3.5.13** - 🔥 最新稳定版，Composition API 丝滑体验\n- **TypeScript 5.8** - 🛡️ 类型安全，智能提示\n- **Naive UI 2.41.0** - 🎨 颜值与性能并存的组件库\n- **@robot-admin\u002Fnaive-ui-components** - 🧩 51+ 业务组件库，按需自动导入\n- **UnoCSS 66.3.3** - ⚡ 原子化CSS，按需生成，体积极小\n\n**⚙️ 构建工具**\n\n- **Bun 1.3.x** - 🚀 性能怪兽，安装速度提升10倍\n- **Vite 8.0.3** - ⚡ Rolldown 统一构建引擎，构建速度提升 10-30x\n- **Sass 1.87** - 🎨 成熟的CSS预处理器\n\n**🔧 开发工具**\n\n- **ESLint 9.21** - 📏 代码质量守护者\n- **Prettier 3.5** - ✨ 代码格式化\n- **Oxlint 0.15** - 🦀 Rust编写的超快Linter\n- **Vitest 3.0** - 🧪 现代化测试框架\n\n**📊 功能组件（via @robot-admin\u002Fnaive-ui-components）**\n\n- **ECharts 5.6** - 企业级图表库\n- **AntV X6** - 专业流程图引擎（BPMN\u002FER\u002FUML）\n- **FullCalendar** - 完整的日程管理\n- **WangEditor** - 富文本编辑器\n- **XGPlayer** - 视频播放器（HLS\u002F防作弊）\n- **Vue Flow** - 工作流编辑器\n\u003C\u002Fdetails>\n\n### 🎯 功能矩阵\n\n#### 🔐 权限管理\n\n- **RBAC权限体系** - 用户-角色-权限，灵活分配\n- **动态路由** - 根据权限实时生成菜单\n- **按钮级权限** - 精确到每一个操作按钮\n- **接口级权限** - API调用权限控制\n\n#### 🧩 组件库（51+ 开箱即用）\n\n> 所有业务组件已独立发布为 [`@robot-admin\u002Fnaive-ui-components`](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@robot-admin\u002Fnaive-ui-components)，支持按需自动导入。\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看所有组件\u003C\u002Fb>\u003C\u002Fsummary>\n\n**核心组件**\n\n- `C_Form` - 动态表单引擎，支持8种布局\n- `C_Table` - 超级表格，支持虚拟滚动、打印水印、列设置\n- `C_FormSearch` - 高级搜索表单组件\n- `C_ActionBar` - 操作按钮组组件，统一按钮布局\n- `C_Icon` - Iconify 运行时图标管理系统\n- `C_Theme` - 主题切换组件\n- `C_Language` - 国际化语言切换\n\n**业务组件**\n\n- `C_Code` - 代码编辑器组件\n- `C_Markdown` - Markdown编辑器\n- `C_Editor` - WangEditor 富文本编辑器\n- `C_FormulaEditor` - 公式编辑器\n- `C_Time` - 时间处理组件\n- `C_Date` - 日期选择组件\n- `C_Progress` - 进度展示组件\n- `C_Upload` - 文件上传组件\n- `C_Cron` - Cron 表达式编辑器\n- `C_Steps` - 步骤条组件\n\n**可视化 & 图表**\n\n- `C_AntV` - AntV X6 流程图引擎（BPMN\u002FER\u002FUML）\n- `C_WorkFlow` - Vue Flow 工作流编辑器\n- `C_VtableGantt` - 甘特图组件\n- `C_FullCalendar` - 完整日程管理\n\n**媒体 & 文件**\n\n- `C_VideoPlayer` - XGPlayer 视频播放器（HLS\u002F防作弊）\n- `C_FilePreview` - 文件预览（PDF\u002FExcel\u002FWord\u002F图片）\n- `C_ImageCropper` - 图片裁剪\n- `C_Signature` - 电子签名\n- `C_QRCode` - 二维码生成\n- `C_Barcode` - 条形码生成\n- `C_AudioPlayer` - 音频播放器，播放列表、多循环模式\n\n**交互 & 布局**\n\n- `C_Draggable` - 拖拽排序\n- `C_SplitPane` - 分割面板\n- `C_CollapsePanel` - 折叠面板\n- `C_WaterFall` - 瀑布流布局\n- `C_Cascade` - 地区级联选择\n- `C_City` - 城市选择器\n- `C_Map` - Leaflet 地图\n- `C_Captcha` - 验证码\n- `C_Guide` - 新手引导\n- `C_GlobalSearch` - 全局搜索\n- `C_NotificationCenter` - 通知中心\n- `C_Chat` - 聊天组件，消息泡泡、会话列表\n- `C_Timeline` - 时间线，垂直\u002F水平多布局\n- `C_ContextMenu` - 右键上下文菜单\n- `C_Transfer` - 穿梭框，跨列表数据迁移\n- `C_AvatarGroup` - 叠加头像组，状态徽标\n\u003C\u002Fdetails>\n\n#### 🎮 自定义指令\n\n`v-copy` 复制 | `v-debounce` 防抖 | `v-throttle` 节流 | `v-permission` 权限 | `v-watermark` 水印 | `v-draggable` 拖拽 | `v-longpress` 长按\n\n### 🎪 演示页面（54+ 完整示例）\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看所有演示页面\u003C\u002Fb>\u003C\u002Fsummary>\n\n**🎨 基础组件展示**\n\n- 图标组件 - 完整的图标系统使用指南\n- 地区联动 - 省市区三级联动实现\n- 进度条 - 多种样式进度展示\n- 时间组件 - 时间选择和格式化\n- 日期选择 - 日期范围选择器\n- 城市选择 - 城市选择器组件\n\n**📝 表单与表格**\n\n- 表单布局 - 8种表单布局模式\n- 表单搜索 - 高级搜索功能\n- 超级表格 - 表格的各种高级用法\n\n**✏️ 编辑器展示**\n\n- 日历组件 - FullCalendar完整功能\n- 代码编辑器 - 多语言语法高亮\n- Markdown编辑器 - 实时预览编辑\n- 富文本编辑 - WangEditor完整功能\n\n**🛠️ 实用功能**\n\n- 导出ZIP - 批量文件打包下载\n- 复制功能 - 文本复制到剪贴板\n- 批量下载 - 文件批量下载处理\n- 拖拽排序 - 列表项拖拽排序\n- 3D展示 - Spline 3D场景\n- 动画系统 - 流畅的页面转场\n- 用户引导 - 新手引导系统\n\n**💬 示范组件**\n\n- 聊天 - 即时聊天 UI，消息泡泡与会话列表\n- 时间线 - 时间轴事件展示，垂直\u002F水平布局\n- 右键菜单 - 自定义上下文菜单\n- 穿梭框 - 跨列表数据迁移\n- 头像组 - 叠加头像展示，状态徽标\n- 音频播放器 - 播放列表、进度控制、多循环模式\n\u003C\u002Fdetails>\n\n---\n\n## 🏗️ 项目架构\n\n### 📁 目录结构\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看完整目录结构\u003C\u002Fb>\u003C\u002Fsummary>\n\n```\nRobot_Admin\u002F\n├── 📁 src\u002F                          # 源代码目录\n│   ├── 📁 api\u002F                      # 接口管理层\n│   ├── 📁 components\u002F               # 组件（桥接层 + 局部组件）\n│   │   ├── 📁 global\u002F               # 全局桥接组件（按需引用组件库）\n│   │   └── 📁 local\u002F                # 局部组件\n│   ├── 📁 views\u002F                    # 页面视图\n│   │   ├── 📁 dashboard\u002F            # 数据看板\n│   │   ├── 📁 demo\u002F                 # 演示页面（54+ 功能展示）\n│   │   ├── 📁 preview\u002F              # 组件预览页面（38 个 iframe 嵌入路由）\n│   │   ├── 📁 sys-manage\u002F           # 系统管理\n│   │   ├── 📁 login\u002F                # 登录注册\n│   │   └── 📁 home\u002F                 # 项目主页\n│   ├── 📁 stores\u002F                   # Pinia状态管理\n│   ├── 📁 composables\u002F              # 组合式API\n│   ├── 📁 hooks\u002F                    # 自定义Hooks\n│   ├── 📁 router\u002F                   # 路由配置\n│   ├── 📁 utils\u002F                    # 工具函数\n│   ├── 📁 types\u002F                    # TypeScript类型定义\n│   ├── 📁 directives\u002F               # 自定义指令（7个实用指令）\n│   ├── 📁 assets\u002F                   # 静态资源\n│   └── 📁 plugins\u002F                  # 插件配置\n├── 📁 scripts\u002F                      # 构建脚本\n├── 📁 public\u002F                       # 静态资源\n├── ⚙️ vite.config.ts                # Vite配置\n├── 🎨 unocss.config.ts              # UnoCSS配置\n├── 📦 package.json                  # 项目配置\n└── 🔧 tsconfig.json                 # TypeScript配置\n```\n\n\u003C\u002Fdetails>\n\n### 🔄 架构演进路线\n\n```mermaid\ngraph LR\n    A[🏠 Monomer\u003Cbr\u002F>单体架构] --> B[📦 Monorepo\u003Cbr\u002F>单仓多包]\n    B --> C[� Module Federation\u003Cbr\u002F>模块联邦]\n    B --> D[🔗 MicroApp\u003Cbr\u002F>微前端]\n    C --> E[🚀 NestJS\u003Cbr\u002F>全栈方案]\n    D --> E\n```\n\n---\n\n## 🛠️ 开发者工具\n\n### VS Code 插件推荐\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看完整插件列表和使用说明\u003C\u002Fb>\u003C\u002Fsummary>\n\n#### 必装插件\n\n- **Vue - Official** - Vue 3 官方支持\n- **TypeScript Vue Plugin** - TypeScript 支持\n- **UnoCSS** - 原子化CSS智能提示\n- **Naive UI Snippets** - Naive UI 代码片段\n\n#### 实用插件详解\n\n**1. Vscode Samge Translate 插件**\n\n- `desc：` 用于快速中英文翻译切换，并生成变量命名方式\n- `use：` Ctrl+Shift+P， 选择 Samge 进行对应功能使用\n- `key：` `Alt+x` 翻译成中文， `Alt+z` 翻译成英文\n\n**2. any-rule 插件**\n\n- `desc：` 用于快速生成正则\n- `use：` 右键 => 正则大全\n- `key：` `@zz` 弹出正则选项,根据生成的选项,可以图解正则\n\n**3. Better Comments 插件**\n\n- `desc：` 在js文件中,通过颜色标记区分注释评论描述\n- `use：` \u002F\u002F\\* 绿色 \u002F\u002F! 红色 \u002F\u002F? 蓝色\n\n**4. code settings sync 插件**\n\n- `desc：` 用于快速团队同步 vscode 插件及配置\n- `use：` [使用文档](https:\u002F\u002Fmarketplace.visualstudio.com\u002Fitems?itemName=Alex-Chen.gitee-code-settings-sync)\n\n**5. Code Spell Checker 插件**\n\n- `desc：` 用于快速检查代码和文档拼写是否正确\n- `use：` 将非语法错误的单词添加到 cspell.json\n- `key：` 拼写后单词上方提示的黄色小灯泡💡\n\n**6. CodeSnap 插件**\n\n- `desc：` 用于快速生成代码截图\n- `use：` 右键 => 底部选项 CodeSnap\n\n**7. EmoJi 插件**\n\n- `desc：` 用于快速选择表情符号\n- `use：` 输入 `Ctrl+Shift+P` => 输入 `emo`\n- `key：` `F1 => emo`\n\n**8. JSON to JS 插件**\n\n- `desc：` 用于快速将json格式转换为js格式\n- `use：` 从剪切板，选择转换，可选引号 3种 方式进行转换\n- `key：` `Shift + Ctrl + Alt + V | S` 或 `F1 => Clipboard`\n\n**9. koroFileHeader 插件**\n\n- `desc：` 用于添加头部注释，函数注释\n- `use：` 在文件头部使用快捷键，或自动识别生成\n- `key：` `ctrl+win+i` 头部注释 `ctrl+win+t` 函数注释\n\n**10. TODO Tree 插件**\n\n- `desc：` 用于快速高亮代码中的 TODO 等标记性注释\n- `use：` 通过注释关键词的方式，高亮显示\n- `key：` TODO: 待完成 | BUG: 问题 | FIXME: 待修复 | HACK: 自定义\n\n**11. Turbo Console Log 插件**\n\n- `desc：` 用于快速生成 console 打印信息\n- `use：` 通过选中变量，按下快捷键，生成打印句柄\n- `key：` `ctrl+alt+l` 生成 `alt+shift+c` 注释所有 **+u** 启用所有 **+d** 删除所有\n\u003C\u002Fdetails>\n\n---\n\n## 🌍 国际化 (i18n)\n\n### 自动化路由翻译\n\n项目集成了 **vite-auto-i18n-plugin**，支持路由标题的自动翻译。\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看详细使用说明\u003C\u002Fb>\u003C\u002Fsummary>\n\n#### 快速使用\n\n```bash\n# 1. 在 dynamicRouter.json 中添加新菜单（只需要中文）\n{\n  \"meta\": {\n    \"title\": \"新功能模块\"\n  }\n}\n\n# 2. 运行自动生成脚本\nbun run gen:route-i18n\n\n# 3. 重启开发服务器（首次需要）\nbun run dev\n```\n\n**就这么简单！** 插件会自动调用有道翻译 API 将中文翻译成英文。\n\n#### 工作原理\n\n```mermaid\ngraph LR\n    A[dynamicRouter.json] --> B[gen:route-i18n]\n    B --> C[提取路由标题]\n    C --> D[vite-auto-i18n-plugin]\n    D --> E[有道翻译 API]\n    E --> F[lang\u002Findex.json]\n    F --> G[编译时构建映射]\n    G --> H[运行时 O1 查找]\n```\n\n#### 特性\n\n- ✅ **零配置** - 添加中文标题后运行一条命令即可\n- ✅ **自动翻译** - 调用有道翻译 API 自动生成英文\n- ✅ **高性能** - O(1) 查找，编译时构建映射表\n- ✅ **零维护** - HMR 自动更新，无需手动管理翻译\n\n#### 详细文档\n\n#### 详细文档\n\n📖 完整使用指南：[国际化实践指南 - 在线文档](https:\u002F\u002Fwww.tzagileteam.com\u002Frobot\u002Fguide\u002Fi18n-practice)\n\n\u003C\u002Fdetails>\n\n\u003C\u002Fdetails>\n\n---\n\n## 📊 性能优化\n\n### ⚡ 性能基准测试\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看详细性能数据\u003C\u002Fb>\u003C\u002Fsummary>\n\n|     指标      | Robot Admin | 传统方案 | 提升幅度 |\n| :-----------: | :---------: | :------: | :------: |\n|  🚀 首屏加载  |   \u003C 800ms   |  ~2.5s   | **70%+** |\n| ⚡ 热更新速度 |   \u003C 100ms   |  ~1.5s   | **90%+** |\n|  📦 构建速度  |    \u003C 30s    |  ~2min   | **75%+** |\n| 💾 Bundle大小 |    \u003C 2MB    |   ~5MB   | **60%+** |\n|  🔄 页面切换  |   \u003C 50ms    |  ~300ms  | **85%+** |\n\n**测试环境**: HP 幽灵360, 16GB RAM, Node.js 22+\n\n### 构建优化\n\n- **Tree Shaking** - 无用代码自动移除\n- **代码分割** - 按需加载，减少首屏时间\n- **资源压缩** - CSS\u002FJS\u002F图片智能压缩\n- **CDN加速** - 静态资源CDN部署\n\n### 运行时优化\n\n- **虚拟滚动** - 大数据表格流畅渲染\n- **组件懒加载** - 路由级别懒加载\n- **图片懒加载** - 视口内图片按需加载\n- **防抖节流** - 高频操作性能优化\n\u003C\u002Fdetails>\n\n---\n\n## 💬 社区互动\n\n> 🚧 **本项目仍在快速迭代，欢迎任何使用反馈、功能建议、甚至吐槽！没有蠢问题，只有没被发现的优化点。**\n\n### 🎯 你的反馈，让项目变得更好\n\n我明确想知道这些，请直接告诉我：\n\n| 反馈类型        | 你可以告诉我                         | 入口                                                                |\n| --------------- | ------------------------------------ | ------------------------------------------------------------------- |\n| 🏢 **使用场景** | 你在做什么项目？解决了什么业务问题？ | [提 Issue →](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fissues\u002Fnew) |\n| 🧩 **组件体验** | 哪些组件用着顺手？哪些还需要打磨？   | [提 Issue →](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fissues\u002Fnew) |\n| 🚀 **上手体验** | 文档哪里说不清楚？部署遇到了什么坑？ | [提 Issue →](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fissues\u002Fnew) |\n| 💡 **业务需求** | 你需要但还没有的组件或功能是什么？   | [提 Issue →](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002FRobot_Admin\u002Fissues\u002Fnew) |\n\n---\n\n## 🤝 参与贡献\n\n> **来啊，快活啊！一起搞事情啊！** 🎉\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看贡献指南\u003C\u002Fb>\u003C\u002Fsummary>\n\n### 🚀 30秒快速上手贡献\n\n```bash\n# 1. Fork + Clone\ngit clone https:\u002F\u002Fgithub.com\u002F你的用户名\u002Frobot_admin.git\n\n# 2. 安装依赖\nbun install\n\n# 3. 创建分支\ngit checkout -b feat\u002Fawesome-feature\n\n# 4. 提交修改\ngit commit -m \"feat: 新功能\"\n\n# 5. 提交PR\n```\n\n### 💡 贡献方向\n\n**🎨 UI\u002F演示页面贡献**\n\n- 在 `src\u002Fviews\u002Fdemo\u002F` 下新建页面\n- 展示一个完整的业务场景\n- 代码要有注释，能复制粘贴直接用\n\n**🧩 组件开发贡献**\n\n- 放在 `src\u002Fcomponents\u002Fglobal\u002F`\n- 组件名以 `C_` 开头\n- 必须有 TypeScript 类型定义\n\n**🛠️ 工具函数贡献**\n\n- `src\u002Futils\u002F` 目录下\n- 要有单元测试\n- 要有 JSDoc 注释\n\n查看 [贡献指南](.\u002FCONTRIBUTING.md) 了解更多。\n\n\u003C\u002Fdetails>\n\n---\n\n## 🚀 部署方案\n\n### ☁️ 多环境支持\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看部署详情\u003C\u002Fb>\u003C\u002Fsummary>\n\n**环境配置**\n\n- **开发环境** - 本地开发调试\n- **测试环境** - 功能测试验证\n- **预发布环境** - 生产前最后验证\n- **生产环境** - 线上正式环境\n\n**部署选项**\n\n- **Vercel** - 零配置部署（推荐）\n- **GitHub Pages** - 静态部署\n- **Docker** - 容器化部署\n- **传统服务器** - Nginx部署\n\n```bash\n# Docker部署\ndocker build -t robot-admin .\ndocker run -p 80:80 robot-admin\n\n# Nginx配置\nlocation \u002F {\n  try_files $uri $uri\u002F \u002Findex.html;\n}\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 📈 路线图\n\n### ✅ 已完成里程碑\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看完整版本历程 (v1.0 → v2.2)\u003C\u002Fb>\u003C\u002Fsummary>\n\n| 版本   | 时间    | 主要更新                                             |\n| ------ | ------- | ---------------------------------------------------- |\n| v1.0   | 2025-07 | 🎉 项目初版：Vue3 + Vite + Naive UI + Pinia 基础架构 |\n| v1.6   | 2025-10 | 🎨 主题系统 + UnoCSS + 演示页面体系                  |\n| v1.11  | 2025-12 | 🧩 组件库雏形 + i18n 国际化 + 性能优化               |\n| v1.12  | 2026-02 | 📦 `@robot-admin\u002Frequest-core` 独立发布              |\n| v1.13  | 2026-02 | 🔧 Composable 架构重构，各 npm 包逐步独立发布        |\n| v1.14  | 2026-02 | ✨ 新增 10 个组件（签名\u002F裁剪\u002FCron\u002F瀑布流等）         |\n| v2.0   | 2026-03 | 🏗️ **架构重构**：39 个组件迁移至独立 npm 包，零冗余  |\n| v2.1   | 2026-03 | 🔐 Token 无感刷新 + 权限体系升级 + 可插拔登录组件    |\n| v2.2   | 2026-03 | 🎭 菜单双主题 + Vite 8 升级 + 全量 TypeScript 通过   |\n| v2.2.1 | 2026-03 | 🔧 Vite 8.0.3 正式升级 + 样式细节优化                |\n\n\u003C\u002Fdetails>\n\n### 🚀 近期计划 (2026 Q2)\n\n- [ ] 📊 性能监控与错误追踪集成\n- [ ] 🎨 可视化低代码页面模板\n- [ ] 🏢 多租户系统支持\n- [x] 🔌 Robot CLI 脚手架工具\n- [x] 📱 Robot uniApp 移动端方案\n\n### 🌟 长期规划 (2026 Q3+)\n\n- [ ] 🏗️ Robot Nest — NestJS 全栈服务\n- [ ] 🔄 完整的 CI\u002FCD 流水线集成示例\n- [ ] 🌐 完整 i18n 国际化方案（更多语言）\n\n---\n\n## 🌟 生态系统\n\n### 🔗 相关项目\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看生态项目\u003C\u002Fb>\u003C\u002Fsummary>\n\n**已发布组件库**\n\n- **[@robot-admin\u002Fnaive-ui-components](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@robot-admin\u002Fnaive-ui-components)** `v0.8.2` - 基于 Naive UI 的 Vue 3 业务组件库（51+ 组件，按需导入）\n- **[@robot-admin\u002Flayout](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@robot-admin\u002Flayout)** `v2.2.0` - 6 种布局模式 + 设置管理系统\n- **[@robot-admin\u002Frequest-core](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@robot-admin\u002Frequest-core)** `v0.1.3` - Axios 请求核心 + 7 插件 + useTableCrud\n- **[@robot-admin\u002Fform-validate](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@robot-admin\u002Fform-validate)** `v2.0.0` - 48+ 企业级表单验证规则库\n- **[@robot-admin\u002Fdirectives](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@robot-admin\u002Fdirectives)** `v1.1.0` - 11 个实用 Vue 指令\n- **[@robot-admin\u002Ffile-utils](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@robot-admin\u002Ffile-utils)** `v1.0.0` - Excel\u002FZIP\u002F分片上传文件工具集\n- **[@robot-admin\u002Ftheme](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@robot-admin\u002Ftheme)** `v0.1.1` - 主题切换（Light\u002FDark\u002FSystem）\n- **[@robot-admin\u002Fgit-standards](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@robot-admin\u002Fgit-standards)** `v1.0.3` - Git 工程化标准\n\n**已发布周边工具**\n\n- **[Robot CLI](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002Frobot-cli)** ✅ - 脚手架工具，快速初始化项目模板\n- **[Robot uniApp](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002Frobot-uniapp)** ✅ - 移动端跨平台解决方案（已完成）\n- **[Robot Nest](https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002Frobot-nest)** 🚧 - NestJS 全栈后端服务（规划中）\n\n**已发布 npm 插件**\n\n- **[vite-console-plugin](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fvite-console-plugin)** `v2.0.15` - Vite 启动台控制台美化与提示插件\n- **[ts-type-cleaner](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fts-type-cleaner)** `v5.0.8` - 智能 TypeScript 类型分析和清理工具\n- **[vite-plugin-preloader](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fvite-plugin-preloader)** `v2.0.1` - 智能路由预加载插件\n- **[robot-admin-env-manager](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Frobot-admin-env-manager)** `v1.0.5` - Robot Admin 环境配置管理工具\n- **[git-branch-check-diff-commits](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fgit-branch-check-diff-commits)** `v1.2.2` - Git 分支快速比对合并检查\n- **[git-log-formatter](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fgit-log-formatter)** `v1.0.2` - Git log 格式化美化工具\n- **[standards-cli](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fstandards-cli)** `v1.0.13` - 前端工程化提交规范初始化工具\n- **[mgit-push](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Fmgit-push)** `v1.0.5` - 同时推送到多个 Git 平台\n- **[@agile-team\u002Frobot-cli](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@agile-team\u002Frobot-cli)** `v1.1.12` - 现代化项目脚手架工具\n- **[@agile-team\u002Fnaive-ui-components](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@agile-team\u002Fnaive-ui-components)** `v0.1.4` - Naive UI 组件库（旧版，已迁移至 @robot-admin）\n- **[@agile-team\u002Fvscode-config](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@agile-team\u002Fvscode-config)** `v2.0.8` - 团随 VSCode 配置一键安装工具\n\u003C\u002Fdetails>\n\n---\n\n## 🖼️ 项目预览\n\n\u003Ctable width=\"100%\">\n\u003Ctr>\n\u003Ctd width=\"50%\" align=\"center\">\n\n![login](https:\u002F\u002Fcheny-chenyu.oss-cn-chengdu.aliyuncs.com\u002Frobot_admin\u002Flogin.png)\n\u003Cbr>\u003Cstrong>登录页面\u003C\u002Fstrong>\n\n\u003C\u002Ftd>\n\u003Ctd width=\"50%\" align=\"center\">\n\n![home](https:\u002F\u002Fcheny-chenyu.oss-cn-chengdu.aliyuncs.com\u002Frobot_admin\u002Fhome.png)\n\u003Cbr>\u003Cstrong>首页页面\u003C\u002Fstrong>\n\n\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftable>\n\n> **🎯 [在线预览](https:\u002F\u002Fwww.robotadmin.cn\u002F)** | **📖 [项目文档](https:\u002F\u002Fwww.tzagileteam.com)**\n>\n> 注意：若无法访问请关闭科学上网，或访问 [备用地址](https:\u002F\u002Frobot-admin-new.vercel.app\u002F)\n\n---\n\n## 🖥️ 浏览器支持\n\n**现代浏览器，拒绝IE**\n\n| [\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Falrra\u002Fbrowser-logos\u002Fmaster\u002Fsrc\u002Fedge\u002Fedge_48x48.png\" alt=\"Edge\" width=\"24px\" height=\"24px\" \u002F>](http:\u002F\u002Fgodban.github.io\u002Fbrowsers-support-badges\u002F)\u003Cbr\u002F>Edge | [\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Falrra\u002Fbrowser-logos\u002Fmaster\u002Fsrc\u002Ffirefox\u002Ffirefox_48x48.png\" alt=\"Firefox\" width=\"24px\" height=\"24px\" \u002F>](http:\u002F\u002Fgodban.github.io\u002Fbrowsers-support-badges\u002F)\u003Cbr\u002F>Firefox | [\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Falrra\u002Fbrowser-logos\u002Fmaster\u002Fsrc\u002Fchrome\u002Fchrome_48x48.png\" alt=\"Chrome\" width=\"24px\" height=\"24px\" \u002F>](http:\u002F\u002Fgodban.github.io\u002Fbrowsers-support-badges\u002F)\u003Cbr\u002F>Chrome | [\u003Cimg src=\"https:\u002F\u002Fraw.githubusercontent.com\u002Falrra\u002Fbrowser-logos\u002Fmaster\u002Fsrc\u002Fsafari\u002Fsafari_48x48.png\" alt=\"Safari\" width=\"24px\" height=\"24px\" \u002F>](http:\u002F\u002Fgodban.github.io\u002Fbrowsers-support-badges\u002F)\u003Cbr\u002F>Safari |\n| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| last 2 versions                                                                                                                                                                                       | last 2 versions                                                                                                                                                                                                   | last 2 versions                                                                                                                                                                                               | last 2 versions                                                                                                                                                                                               |\n\n---\n\n## 💻 系统要求\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>查看详细要求\u003C\u002Fb>\u003C\u002Fsummary>\n\n### 🔧 开发环境\n\n- **Node.js**: >= 22.18 (推荐最新 LTS)\n- **Bun**: >= 1.3.x (推荐最新版)\n- **内存**: >= 8GB RAM\n- **存储**: >= 1GB 可用空间\n- **系统**: Windows 10+, macOS 12+, Ubuntu 20.04+\n\n### ⚙️ 可选工具\n\n- **VS Code**: 推荐编辑器\n- **Git**: >= 2.20.0\n- **Docker**: >= 20.0 (容器部署)\n\u003C\u002Fdetails>\n\n---\n\n## 🛠️ 故障排除\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>常见问题解决\u003C\u002Fb>\u003C\u002Fsummary>\n\n### ❌ Bun 安装失败\n\n```bash\n# Windows 用户\ncurl -fsSL https:\u002F\u002Fbun.sh\u002Finstall | bash\n\n# macOS 用户\nbrew install oven-sh\u002Fbun\u002Fbun\n\n# 或使用 npm 安装\nnpm install -g bun\n```\n\n### ⚠️ 端口占用问题\n\n```bash\n# 修改 vite.config.ts 中的端口\nserver: {\n  port: 1988, # 改为其他端口\n  host: true\n}\n```\n\n### 🔧 TypeScript 类型错误\n\n```bash\n# 重新生成类型文件\nbun run type:check\n\n# 清除类型缓存\nrm -rf node_modules\u002F.cache\nbun install\n```\n\n### 📦 构建失败\n\n```bash\n# 检查依赖版本\nbun outdated\n\n# 清除缓存重新安装\nrm -rf node_modules bun.lockb\nbun install\n\n# 强制类型检查\nbun run type-build\n```\n\n\u003C\u002Fdetails>\n\n---\n\n## 🔒 安全与权限\n\n### 🛡️ 多层次权限控制\n\n- **页面级权限** - 路由访问控制\n- **菜单级权限** - 导航菜单显示控制\n- **按钮级权限** - 操作按钮权限控制\n- **接口级权限** - API调用权限验证\n\n### 🔐 身份认证\n\n- `JWT Token` 认证\n- 刷新Token自动续期\n- 多终端登录管理\n- 密码强度验证\n\n---\n\n## 🆚 对比其他解决方案\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>为什么选择 Robot Admin？\u003C\u002Fb>\u003C\u002Fsummary>\n\n|   特性对比    |       Robot Admin       | Ant Design Pro | Vue Element Admin |   其他框架   |\n| :-----------: | :---------------------: | :------------: | :---------------: | :----------: |\n|  🚀 启动速度  |     **Bun \u003C 100ms**     |    npm ~2s     |    yarn ~1.5s     |   普遍较慢   |\n| ⚡ 热更新速度 |    **\u003C 100ms 极速**     |   ~1.5s 等待   |     ~1s 等待      |   普遍较慢   |\n|  📦 构建工具  | **Vite 8.x (Rolldown)** |  Webpack\u002FVite  |    Webpack 4\u002F5    |   工具多样   |\n| 🎨 UI 组件库  |    **Naive UI 轻量**    |   Ant Design   |   Element Plus    |   选择多样   |\n| 💪 TypeScript |    **完整类型支持**     |    基础支持    |     基础支持      | 支持程度不一 |\n| 🔧 自定义指令 |     **7个实用指令**     |    少量指令    |     基础指令      |   功能有限   |\n|  📊 演示页面  |    **54+ 完整示例**     |    有限示例    |     有限示例      |   基础示例   |\n|  🎯 学习成本  |      **中等友好**       |    较高门槛    |     中等门槛      |   差异较大   |\n|  📈 维护状态  |     **🔥 积极维护**     |    持续维护    |     持续维护      |   状态不一   |\n\n**选择 Robot Admin 的理由**:\n\n- 🚀 **性能优先**: Bun + Vite8 (Rolldown) 双引擎，开发体验极致\n- 🧩 **组件丰富**: 51+ 业务组件，独立组件库按需导入\n- 🎨 **设计现代**: Naive UI + UnoCSS，颜值与性能并存\n- 📚 **学习友好**: 54+ 演示页面，每个都是最佳实践\n\u003C\u002Fdetails>\n\n---\n\n## ❓ 你可能会有的一些小疑问\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>FAQ\u003C\u002Fb>\u003C\u002Fsummary>\n\n**🔧 为什么推荐使用Bun？**\n\n- 安装速度提升10倍+\n- 内存占用更低\n- 内置打包器、测试运行器\n- 完全兼容Node.js生态\n\n**🎨 如何自定义主题？**\n\n1. 修改 `src\u002Fassets\u002Fcss\u002Ftheme.scss` 中的CSS变量\n2. 使用 `C_Theme` 组件进行动态切换\n3. 支持深色\u002F浅色模式自动切换\n\n**🔐 权限系统如何使用？**\n\n- 页面级：路由守卫控制\n- 菜单级：动态菜单生成\n- 按钮级：v-permission指令\n- 接口级：axios拦截器\n\n**📱 是否支持移动端？**\n\n- 完全支持！响应式设计适配所有设备\n\n**🔄 如何从其他项目迁移？**\n\n- 提供详细的迁移指南\n- 组件API基本兼容\n- 渐进式迁移支持\n\u003C\u002Fdetails>\n\n---\n\n## 📞 联系我们\n\n**🧑‍💻 作者信息**\n\n- **姓名：** CHENY\n- **身份：** 个人开发者 · 前端架构师（开源爱好者）\n- **公众号：** 前端咔啦咪（小红书同名）\n- **邮箱：** [ycyplus@gmail.com](mailto:ycyplus@gmail.com)\n- **GitHub：** [@ChenyCHENYU](https:\u002F\u002Fgithub.com\u002FChenyCHENYU)\n- **npm：** [@cheny_yang](https:\u002F\u002Fwww.npmjs.com\u002F~cheny_yang)\n\n---\n\n### 💬 加入交流群\n\n\u003Cp align=\"center\">\n  \u003Cimg src=\"public\u002F交流群.jpg\" width=\"200\" alt=\"微信交流群\">\n  \u003Cbr>\n  \u003Cem>扫码加入微信交流群，与开发者一起交流讨论\u003C\u002Fem>\n\u003C\u002Fp>\n\n---\n\n### 🤝 贡献者\n\n感谢所有为项目做出贡献的开发者：\n\n\u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002Frobot-admin\u002Fgraphs\u002Fcontributors\">\n  \u003Cimg src=\"https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=ChenyCHENYU\u002Frobot-admin\" \u002F>\n\u003C\u002Fa>\n\n**期望你成为贡献者:**\n\n- 🐛 报告 Bug | 💡 提出功能建议 | 📝 改进文档 | 🔧 提交代码 | 🌍 翻译文档 | 📢 推广项目\n\n---\n\n## 🏆 特别鸣谢\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>致谢名单\u003C\u002Fb>\u003C\u002Fsummary>\n\n### 🌟 开源项目致谢\n\n**核心技术**\n\n- **Vue.js 团队** - 提供强大的框架基础\n- **Naive UI 团队** - 提供优秀的组件库\n- **Vite 团队** - 提供极速的构建工具\n- **Bun 团队** - 提供革命性的运行时\n- **Anthony Fu** - UnoCSS、unplugin等工具的创作者\n- **尤雨溪 (Evan You)** - Vue.js 的创造者\n\n**功能组件**\n\n- **ECharts** - 数据可视化图表库\n- **AntV X6** - 图编辑引擎\n- **FullCalendar** - 日历组件\n- **WangEditor** - 富文本编辑器\n\n### 👨‍💻 社区支持\n\n- **所有 Star 的开发者** - 给予项目信心和动力\n- **提出 Issue 的用户** - 帮助项目发现和改进问题\n- **贡献 PR 的开发者** - 让项目变得更好\n- **使用项目的企业** - 验证项目的实用价值\n\n> _\"一个人可以走得很快，但一群人可以走得更远。感谢每一位支持 Robot Admin 的朋友！\"_\n\n\u003C\u002Fdetails>\n\n---\n\n## 📄 更新日志\n\n### 🚀 v2.2.1 (2026-03-27) — 最新版本\n\n- 🔧 **Vite 8.0.3 + Rolldown**：升级至 Vite 最新版，构建引擎持续优化\n- 🎨 **样式细节优化**：NCard 全局间距优化，暗色主题细节全面提升\n- 🔒 **工程化修复**：oxlint 版本锁定，修复 pre-commit 钩子兼容性问题\n- 📐 **代码质量**：全量 TypeScript 类型检查通过，演示页面样式统一规范\n\n\u003Cdetails>\n\u003Csummary>\u003Cb>📆 查看历史版本记录 (v1.0 — v2.2)\u003C\u002Fb>\u003C\u002Fsummary>\n\n### 🎭 v2.2.0 (2026-03-11)\n\n- ✨ **菜单双主题**：增加菜单主题切换，提供个性\u002F标准两种多态模式\n- 🔐 **权限体系升级**：按钮权限、路由鉴权、数据权限全面启用\n- ⚡ **Token 无感刷新**：登录态不中断自动刷新 Token\n- 🔧 **Vite 8 + Rolldown**：构建速度提升 10-30 倍\n- 🧩 演示页面批量优化，全量 TypeScript 类型检查通过\n\n### 🎨 v2.1.0 (2026-03-06)\n\n- ✨ 可插拔式 `C_Login` 登录组件，支持自定义扩展\n- 🔄 新增穿梭框 \u002F 头像组 \u002F 音频播放器组件\n- 🚀 38 个无鉴权预览路由，供文档站 iframe 嵌入\n- 🐛 登录页性能、错误拦截、中英文验证全面优化\n\n### 🏗️ v2.0.0 (2026-03-02) — 破坏性升级\n\n- 📦 **39 个组件全面迁移** 至 `@robot-admin\u002Fnaive-ui-components`\n- ✅ 全量 `vue-tsc` 类型检查通过\n- 🔧 清理冗余依赖，简化主项目依赖树\n\n### ✨ v1.14.0 (2026-02-27)\n\n- 新增电子签名 \u002F 图片裁剪 \u002F Cron 表达式编辑器 \u002F 分割面板 \u002F 公式编辑器 \u002F 瀑布流 等 10 个组件\n- 将 `C_Notice` 升级为 `C_NotificationCenter` 全局通知插件\n\n### 📦 v1.13.x (2026-02-08 — 2026-02-17)\n\n- `@robot-admin\u002Flayout` 升级 v2.2.0，支持 View Transition API 主题切换\n- `@robot-admin\u002F*` 各包逐步独立发布到 npm\n- i18n 自动翻译路由 + 分包优化\n\n### v1.11.x (2025-11 — 2025-12)\n\n- 组件库雏形建立、Vitest 测试框架集成\n- 全局搜索组件、内置权限指令系统\n\n### v1.0 — v1.11 (2025-07 — 2025-12)\n\n- 项目核心框架建立、主题系统、动态表单\u002F表格引擎、Demo 页面体系建设\n\n\u003C\u002Fdetails>\n\n> 📚 查看完整 [CHANGELOG.md](.\u002FCHANGELOG.md)\n\n---\n\n## 📄 开源许可\n\n本项目基于 [MIT License](.\u002FLICENSE) 开源协议。\n\n```\nMIT License\n\nCopyright (c) 2026 ChenY (Robot Admin)\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and\u002For sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n```\n\n**这意味着您可以：**\n✅ 免费使用 | ✅ 修改源代码 | ✅ 商业使用 | ✅ 私有部署 | ✅ 分发和再许可\n\n**唯一要求：**\n📄 保留版权声明和许可证\n\n---\n\n\u003Cdiv align=\"center\">\n\n## 🚀 加入 Robot Admin\n\n\u003Cp>\n  \u003Cstrong>如果这个项目帮助到了你，请给个 ⭐ Star 支持一下！\u003C\u002Fstrong>\u003Cbr>\n  \u003Cem>你的 Star 是我们前进的动力 🌟\u003C\u002Fem>\n\u003C\u002Fp>\n\n\u003Cp>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002Frobot_admin\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F⭐-给个Star-yellow?style=for-the-badge&logo=github\" alt=\"GitHub Star\">\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002Frobot_admin\u002Ffork\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🍴-Fork项目-blue?style=for-the-badge&logo=github\" alt=\"GitHub Fork\">\n  \u003C\u002Fa>\n  \u003Ca href=\"https:\u002F\u002Fwww.robotadmin.cn\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F🚀-在线体验-green?style=for-the-badge&logo=vercel\" alt=\"Live Demo\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr>\n\n### 🎯 下一步行动\n\n\u003Cp>\n  🔥 \u003Cstrong>立即使用\u003C\u002Fstrong>\u003Cbr>\n  \u003Ccode>git clone https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002Frobot_admin.git\u003C\u002Fcode>\u003Cbr>\n  \u003Cem>30秒启动你的项目\u003C\u002Fem>\n\u003C\u002Fp>\n\n\u003Cp>\n  📚 \u003Cstrong>学习文档\u003C\u002Fstrong>\u003Cbr>\n  \u003Ca href=\"https:\u002F\u002Fwww.tzagileteam.com\">查看完整文档\u003C\u002Fa>\u003Cbr>\n  \u003Cem>从入门到精通\u003C\u002Fem>\n\u003C\u002Fp>\n\n\u003Cp>\n  💬 \u003Cstrong>加入讨论\u003C\u002Fstrong>\u003Cbr>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\u002Frobot-admin\u002Fdiscussions\">GitHub讨论区\u003C\u002Fa>\u003Cbr>\n  \u003Cem>与开发者交流\u003C\u002Fem>\n\u003C\u002Fp>\n\n\u003Cbr>\n\n### 💝 支持项目发展\n\n\u003Cp>\n  \u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fsponsors\u002FChenyCHENYU\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F💖-赞助支持-red?style=for-the-badge&logo=github-sponsors\" alt=\"Sponsor\">\n  \u003C\u002Fa>\n  \u003Ca href=\"mailto:ycyplus@gmail.com\">\n    \u003Cimg src=\"https:\u002F\u002Fimg.shields.io\u002Fbadge\u002F📧-联系作者-blue?style=for-the-badge&logo=gmail\" alt=\"Contact\">\n  \u003C\u002Fa>\n\u003C\u002Fp>\n\n\u003Cbr>\n\n**🤖 Robot Admin - 让中后台开发变得简单而优雅**\n\n\u003Cp>\n  \u003Cem>\"好的工具不仅要功能强大，更要让开发者用得愉快\"\u003C\u002Fem>\u003Cbr>\n  \u003Cstrong>— Robot Admin 团队\u003C\u002Fstrong>\n\u003C\u002Fp>\n\n\u003Cbr>\n\n\u003Cp>\n  \u003Cstrong>Made with ❤️ by \u003Ca href=\"https:\u002F\u002Fgithub.com\u002FChenyCHENYU\">@ChenyCHENYU\u003C\u002Fa>\u003C\u002Fstrong>\u003Cbr>\n  \u003Cem>感谢开源让世界更美好 🌍\u003C\u002Fem>\n\u003C\u002Fp>\n\n\u003C\u002Fdiv>\n","Robot Admin 是一个现代化的中后台模板，旨在帮助开发者节省时间、提高效率。它基于 Vue 3 和 TypeScript 构建，并使用了 Naive UI 作为组件库，结合 Bun 和 Vite 双引擎，提供了卓越的开发性能和毫秒级热更新体验。项目包含 49 个成熟组件，文档详尽，支持复制即用，无需额外调试。此外，项目还提供了 8 个 @robot-admin 专属包生态，能够灵活适配单体架构、Monorepo、MicroApp、模块联邦等企业级架构。无论是个人练手、团队协作还是大型商业应用，Robot Admin 都能提供全面的支持。",2,"2026-06-11 03:20:55","top_language"]