Files

T

OpenCode 83570b115a feat: 标签栏样式优化及侧边栏交互改进

- 标签栏改为圆角药丸样式，激活标签添加阴影和底部指示条
- 标签页尺寸缩小(120-180px)，关闭按钮hover时淡入显示
- 激活标签背景色改为secondary(更柔和)，亮色/暗色主题同步更新
- 移除smart模式下二级菜单仅一项时点击一级标签自动跳转的逻辑
- 再次点击已激活的一级标签可收起二级侧边栏
- 移除二级侧边栏收起按钮

2026-07-09 13:04:00 +08:00

3.3 KiB

Executable File

Raw Permalink Blame History

Fantastic-admin

项目概述

Fantastic-admin 是一个基于 Vue 3 的后台管理框架。

技术栈

框架: Vue 3.6 + TypeScript + Vite 8
UI 组件: Element Plus（默认，可替换） + Reka UI + UnoCSS（原子化 CSS）
状态管理: Pinia + pinia-plugin-persistedstate
路由: Vue Router 5
包管理器: pnpm（必须使用 pnpm，禁止使用 npm/yarn）
HTTP: Axios
Mock: vite-plugin-fake-server

目录结构

采用 pnpm monorepo 架构：

├── apps/
│   └── <app>/                # 应用
│       └── src/
│           ├── api/          # API 请求模块
│           ├── assets/       # 静态资源
│           ├── components/   # 全局业务组件
│           ├── composables/  # 组合式函数
│           ├── layouts/      # 布局组件
│           ├── router/       # 路由配置
│           ├── slots/        # 插槽组件
│           ├── store/        # Pinia store
│           ├── types/        # TypeScript 类型定义
│           ├── ui/           # 框架内建 UI 组件（本地）
│           ├── utils/        # 工具函数
│           └── views/        # 页面视图
├── packages/
│   ├── components/           # 框架内建 UI 组件库（子包，跨应用共享）
│   ├── settings/             # 框架设置（子包，跨应用共享）
│   └── themes/               # 主题配置（子包，跨应用共享）
├── scripts/                  # 工程脚本
└── pnpm-workspace.yaml       # monorepo workspace 配置

常用命令

pnpm dev          # 启动开发服务器
pnpm build        # 构建
pnpm lint         # 运行全量 lint（tsc + eslint + stylelint）

开发规范

使用 <script setup lang="ts"> 语法
样式优先使用 UnoCSS 原子类，复杂样式用 SCSS
组件命名使用 PascalCase，文件名与组件名一致
API 模块放在 apps/<app>/src/api/modules/，按业务模块拆分
Store 模块放在 apps/<app>/src/store/modules/，使用 Pinia composition API 风格
路由配置在 apps/<app>/src/router/，meta 属性可借助 fa-route-generator skill

注意事项

框架内建组件在 packages/components/ 子包中，优先使用内建组件而非第三方组件或自定义实现
在任何情况下都请勿直接修改内建组件，确定修改前需要和用户进行确认
Mock 数据使用 vite-plugin-fake-server，文件放在 apps/<app>/src/api/modules/ 对应模块旁
代码提交前会自动运行 lint-staged，确保代码符合规范
Node.js 版本要求以根目录下 package.json 中定义的为准

清理规范

每个功能完成后，必须删除调试产生的临时文件，包括但不限于：
- .playwright-mcp/ 目录（浏览器自动化产生的日志、截图、快照）
- 项目根目录下的 *.log 文件
- 任何其他由工具生成的临时文件
提交代码前确认无多余文件被包含

反复修改检测

在使用任何 fa-* 系列技能时，如果用户针对同一功能点已经要求修改 3 次及以上仍未达到预期（例如连续说"不对"、"再改改"、"还是不行"），必须触发 fa-feedback 技能，询问用户是否将问题反馈给框架作者。

3.3 KiB Executable File Raw Permalink Blame History Unescape Escape