music/
├── .dockerignore              # Docker 构建忽略
├── .edgeignore                # EdgeOne 部署忽略
├── .gitignore                 # Git 忽略规则
├── .prettierignore            # Prettier 忽略路径
├── .prettierrc                # Prettier 格式化配置
├── .stylelintrc.json          # Stylelint 规则
├── .vercelignore              # Vercel 部署忽略
├── Dockerfile                 # 容器镜像构建
├── docker-compose.yml         # Docker Compose 编排（可选）
├── env.example                # 环境变量示例
├── eslint.config.js           # ESLint 扁平配置（src / api / lib 等）
├── tsconfig.base.json         # tsc 共用 compilerOptions（供 extends）
├── tsconfig.json              # 前端 src：`checkJs`，宽松 strict（IDE / `npm run typecheck`）
├── tsconfig.lib.json          # `lib/`：strict + noImplicitAny（JSDoc；第二条 typecheck）
├── vite.config.js             # Vite 构建配置
├── vercel.json                # Vercel 路由与 Functions 配置
├── edgeone.json               # EdgeOne 相关配置
├── r2-cors.json               # R2 CORS 参考配置
├── package.json               # 依赖与 npm 脚本
├── package-lock.json          # 锁定依赖版本
├── index.html                 # SPA 入口 HTML
├── server.js                  # Node 一体化后端（本地 npm start / Docker）
├── GIT_URL.js                 # Git 代理相关脚本
├── music.py                   # 辅助脚本
├── README.md                  # 项目说明
├── LICENSE                    # 开源许可证（MIT）
├── music.webp / zxlwq.webp    # 文档配图
│
├── .github/workflows/         # GitHub Actions
│   ├── docker.yml             # 构建 / 推送 Docker 镜像
│   ├── music-api.yml          # Hugging Face Spaces 等流程
│   └── webdav..yml            # WebDAV 相关 CI
│
├── api/                       # Vercel Functions
│   ├── audio.js / delete.js / exists.js / fetch.js / gist.js
│   ├── r2.js / upload.js / webdav.js
│   ├── music/list.js
│   └── webdav/list.js / stream.js / upload.js
│
├── functions/api/             # Cloudflare Pages Functions
│   └── （同上文件名镜像）
│
├── edge-functions/api/        # EdgeOne Pages 边缘函数
│   └── （同上文件名镜像）
│
├── lib/
│   └── sync.js                # 收藏歌单 / 音频缓存：Gist · Upstash Redis · Cloudflare KV 同步逻辑
│
├── scripts/
│   ├── generate.mjs           # `prebuild`：扫描 public/music 生成 music.json（歌单）
│   └── precache.mjs           # `build` 末尾：向 dist/sw.js 注入预缓存与 CACHE_VERSION（离线壳）
│
├── public/                    # 静态资源
│   ├── _headers               # 边缘响应头
│   ├── favicon.ico            # 站点图标
│   ├── webmanifest            # PWA：名称、图标、theme_color、display 等（标准安装清单）
│   ├── music.json             # 由 generate.mjs 生成的本地歌单（tracks），运行时拉取
│   ├── sw.js                  # Service Worker
│   ├── covers/                # 默认唱片封面
│   ├── images/                # 内置图片
│   └── music/                 # 音频目录
│
└── src/                       # React 前端源码
    ├── main.jsx               # 入口：挂载根组件、全局 ErrorBoundary 等
    ├── App.jsx                # 应用根组件：歌单、播放、收藏、搜索与设置总装配
    ├── styles.css             # 全局样式（布局、主题变量、组件公共样式）
    ├── vite.ts                # Vite 客户端类型声明（含全局 Window/CSS 扩展）
    ├── components/            # UI：Player、Settings、Playlist、虚拟列表等
    ├── hooks/                 # Cache、theme、VScroll、全局状态等
    ├── services/              # api.js、Audio.js、upload/delete 等
    └── utils/                 # covers、errors、manifest、storage、image 等