📦 vdesign-ui 项目结构说明

本项目为 vdesign-ui 前端组件库，包含组件源码、构建脚本、设计 Tokens、多语言配置等。以下是项目目录结构与主要文件说明。

📁 目录结构

vdesign-ui/
├── bin/                         # 构建与工具脚本目录
│   ├── backup-token-css.js      # 备份 token.css 文件（保存至 dist-token-history，文件名带时间戳）
│   ├── build-components.js      # 构建 packages/components 下的组件并输出到 dist/components，按需加载，暂未用到
│   ├── concat-css.js            # 合并 tokens 中多个 CSS 文件为 token.css
│   ├── copy-locales.js          # 拷贝 packages/locale 的内容到 dist/locale
│   └── node.js                  # 输出官网导航目录
├── dist/                        # 构建输出目录
│   ├── components/              # 拷贝组件
│   ├── locale/                  # 拷贝语言资源
│   ├── demo.html                # 构建预览页面（可能用于调试或预览组件）
│   ├── token.css                # 当前 Design Token 输出样式
│   ├── vdesign-ui.common.js     # CommonJS 格式构建文件
│   ├── vdesign-ui.css           # 所有样式文件合并后的主 CSS
│   ├── vdesign-ui.umd.js        # UMD 构建文件（未压缩）
│   ├── vdesign-ui.umd.min.js    # UMD 构建文件（压缩版）
│   └── dist-token-history/      # 历史 Token 样式备份（时间戳命名）
│       ├── token_20250314_155751.css
│       ├── token_20250314_160005.css
│       ├── token_20250314_160803.css
│       ├── token_20250321_171830.css
│       ├── token_20250324_152753.css
│       ├── token_20250324_153128.css
│       ├── token_20250325_114906.css
│       └── token_20250326_170122.css
├── node_modules/                # 项目依赖模块
├── packages/                    # 源码主目录
│   ├── components/              # Vue 组件源码（Button、Uploader 等）
│   ├── locale/                  # 多语言支持
│   │   ├── lang/                # 多语言翻译文件（如 zh-CN.js / en-US.js）
│   │   └── i18nPlugin.js        # 国际化插件封装（用于 Vue 插件注册）
│   └── tokens/                  # Design Token 配置（设计样式原子值）
│       ├── css/                 # 生成后的 CSS Token 文件
│       ├── fonts/               # 字体资源
│       ├── js/                  # 获取以及生成Token数据
│       ├── index.css            # 主样式文件
│       ├── reset.css            # 样式重置文件
│       └── style.css            # 组件通用样式
│   └──index.js                     # 项目主入口（可能用于组件库导出）
├── sites/                       # 主要包含该组件库的站点，用于文档描述
│   ├── assets/                  # 静态资源（如图片、图标）
│   ├── components/              # 站点使用的公共组件
│   ├── demos/                   # 组件演示页面（提供交互效果展示）
│   ├── docs/                    # 文档页面（介绍使用说明、API 参考等）
│   ├── i18n/                    # 站点的国际化支持
│   ├── json/                    # json格式的Token数据
│   ├── pages/                   # 站点页面路由（测试页面）
│   ├── router/                  # Vue 路由配置
│   ├── App.vue                  # 站点 Vue 入口文件
│   ├── insetTables.js           # Token数据插入到demo页面
│   └── main.js                  # 站点主入口文件