1

Dockerfile

@@ -0,0 +1,22 @@
+# 使用 Python 3.10 轻量级镜像
+FROM python:3.10-slim
+
+# 设置工作目录
+WORKDIR /app
+
+# 设置环境变量
+ENV PYTHONUNBUFFERED=1
+
+# 复制依赖文件并安装
+COPY requirements.txt .
+RUN pip install --no-cache-dir -r requirements.txt
+
+# 复制应用代码到容器中
+COPY . .
+
+# Hugging Face Spaces 默认使用 7860 端口
+EXPOSE 7860
+
+# 启动命令
+# 注意：这里必须是 uvicorn music_api:app，对应您的文件名 music_api.py
+CMD ["uvicorn", "music_api:app", "--host", "0.0.0.0", "--port", "7860"]

README.md

@@ -1,12 +1,25 @@
----
-title: Api
-emoji: 🏆
-colorFrom: indigo
-colorTo: green
-sdk: docker
-pinned: false
-license: mit
-short_description: 音乐api
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+title: Music API
+emoji: 🎵
+colorFrom: blue
+colorTo: indigo
+sdk: docker
+pinned: false
+license: mit
+---
+
+# 🎵 极简音乐 API
+
+这是一个基于 FastAPI 的轻量级音乐流媒体服务，托管在 Hugging Face Spaces 上。
+
+## 功能特性
+- 🔍 **搜索**: 按歌名、艺术家搜索。
+- 🎵 **播放**: 在线流媒体播放 MP3。
+- 🖼️ **封面**: 支持自定义封面或自动生成默认封面。
+- 📊 **统计**: 获取歌曲库统计信息。
+
+## API 文档
+访问 Space 首页即可查看详细的 API 文档，或访问 `/docs` 查看 Swagger UI。
+
+## 如何添加音乐
+目前版本数据库需要手动添加元数据。请使用 SQLite 客户端连接 `data/music.db` 并插入数据，或者联系管理员添加自动扫描脚本。

requirements.txt

@@ -0,0 +1,4 @@
+fastapi==0.104.1
+uvicorn[standard]==0.24.0
+Pillow==10.1.0
+python-multipart