| # 第三方库依赖 |
|
|
| ## Client 核心依赖 |
|
|
| | 分类 | 库 | 版本 | 用途 | |
| | ------------ | ---------------------------------------------------------- | -------- | --------------------------------------- | |
| | **UI 框架** | react, react-dom | ^19.2.0 | UI 基础 | |
| | | shadcn/ui (new-york) | — | 组件库（基于 Radix UI） | |
| | | radix-ui | ^1.4.3 | 无障碍 UI 原语 | |
| | | tailwindcss | ^4.1.18 | 原子化 CSS | |
| | | class-variance-authority | ^0.7.1 | 组件变体样式 | |
| | | tailwind-merge | ^3.4.0 | class 合并去重 | |
| | | clsx | ^2.1.1 | 条件 class 拼接 | |
| | **权限** | @casl/react | ^5.0.1 | RBAC 权限（配合 @casl/ability） | |
| | **错误边界** | react-error-boundary | ^6.1.0 | React Error Boundary | |
| | **状态管理** | zustand | ^5.0.11 | 轻量全局状态 | |
| | **路由** | react-router-dom | ^7.13.0 | 客户端路由 | |
| | **实时通信** | socket.io-client | ^4.8.3 | WebSocket 客户端 | |
| | **音频** | howler | ^2.2.4 | 音频播放引擎 | |
| | | @applemusic-like-lyrics/core | ^0.2.0 | 歌词解析核心 | |
| | | @applemusic-like-lyrics/react | ^0.2.0 | 歌词 React 组件 | |
| | **动画** | motion | ^12.34.0 | Framer Motion 动画 | |
| | | tw-animate-css | ^1.4.0 | Tailwind 动画预设 | |
| | **图形渲染** | @pixi/app, core, display, sprite | ^7.4.3 | PixiJS（歌词背景渲染） | |
| | | @pixi/filter-blur, filter-bulge-pinch, filter-color-matrix | — | PixiJS 滤镜 | |
| | **弹窗** | vaul | ^1.x | 移动端 Drawer（底部抽屉，支持拖拽关闭） | |
| | **虚拟列表** | @tanstack/react-virtual | ^3.13.18 | 虚拟滚动（歌单详情大列表） | |
| | **工具** | dayjs | ^1.11.19 | 日期格式化 | |
| | | nanoid | ^5.1.6 | ID 生成 | |
| | | sonner | ^2.0.7 | Toast 通知 | |
| | | lucide-react | ^0.563.0 | 图标库 | |
| | | jss, jss-preset-default | ^10.10.0 | CSS-in-JS（AMLL 依赖） | |
|
|
| ## Server 核心依赖 |
|
|
| | 库 | 版本 | 用途 | |
| | --------------------------------- | ------- | ------------------------------------------------------------------- | |
| | express | ^4.21.0 | HTTP 框架 | |
| | socket.io | ^4.8.3 | WebSocket 服务端 | |
| | @meting/core | ^1.6.0 | 多音源音乐数据聚合 | |
| | @s4p/kugou-lrc | ^0.2.0 | 酷狗 KRC 逐字歌词获取与解析 | |
| | nanoid | ^5.0.9 | 房间 ID 生成 | |
| | cors | ^2.8.5 | 跨域 | |
| | dotenv | ^16.4.5 | 环境变量 | |
| | zod | ^4.3.6 | 请求数据验证（配合 shared schemas） | |
| | pino | ^10.3.1 | 结构化日志 | |
| | rate-limiter-flexible | ^9.1.1 | 聊天限流 | |
| | @neteasecloudmusicapienhanced/api | ^4.30.1 | 网易云 QR 登录 / Cookie 验证 / 用户信息 | |
| | qrcode | ^1.5.4 | QR 码生成（酷狗扫码登录，API 仅返回 URL 需服务端转 base64 DataURL） | |
| | escape-html | ^1.0.3 | HTML 转义（防注入） | |
| | p-limit | ^7.3.0 | 并发控制（封面批量解析） | |
| | lru-cache | ^11.2.6 | LRU 缓存（musicProvider 外部 API 结果缓存） | |
|
|
| ## Shared 核心依赖 |
|
|
| | 库 | 版本 | 用途 | |
| | ------------- | ------ | --------------------------- | |
| | @casl/ability | ^6.8.0 | RBAC 权限定义（前后端共用） | |
| | zod | ^4.3.6 | 数据验证 Schema | |
|
|
| ## 开发工具 |
|
|
| | 库 | 版本 | 包 | 用途 | |
| | --------------------------- | ------- | ------ | ----------------------- | |
| | vite | ^7.3.1 | client | 前端构建 | |
| | @vitejs/plugin-react | ^5.1.1 | client | Vite React 插件 | |
| | @tailwindcss/vite | ^4.1.18 | client | Vite Tailwind 插件 | |
| | typescript | ~5.9.3 | all | 类型系统 | |
| | tsx | ^4.19.0 | server | 服务端 TS 运行/热重载 | |
| | pino-pretty | ^13.1.3 | server | 开发环境日志美化 | |
| | eslint | ^9.39.1 | client | 代码检查 | |
| | eslint-plugin-react-hooks | ^7.0.1 | client | React Hooks 规则 | |
| | eslint-plugin-react-refresh | ^0.4.24 | client | React Fast Refresh 规则 | |
| | concurrently | ^9.2.1 | root | 并行运行前后端 | |
| | kill-port | ^2.0.1 | root | 端口清理 | |
|
|
| --- |
|
|
