From daa342c2ec024e6a094a8d3d78bceb5f791ef5e8 Mon Sep 17 00:00:00 2001
From: QZMusic <qzmusic@example.com>
Date: Thu, 4 Jun 2026 13:57:25 +0000
Subject: [PATCH] =?UTF-8?q?feat:=20=E9=85=8D=E7=BD=AE10096=E7=AB=AF?=
 =?UTF-8?q?=E5=8F=A3=E5=B9=B6=E6=B7=BB=E5=8A=A0=E4=B8=80=E9=94=AE=E9=83=A8?=
 =?UTF-8?q?=E7=BD=B2=E8=84=9A=E6=9C=AC?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md      | 39 +++++++++++++++++++++++++++++++
 deploy.sh      | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++
 package.json   |  4 +++-
 start.sh       | 27 ++++++++++++++++++++++
 vite.config.ts |  3 ++-
 5 files changed, 134 insertions(+), 2 deletions(-)
 create mode 100755 deploy.sh
 create mode 100755 start.sh

diff --git a/README.md b/README.md
index 7ec8255..239592d 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,27 @@ QZMusic 网页版，基于 Vue 3 + TypeScript + Vite 构建的音乐播放器。
 - 🎚️ 音量控制
 - 📊 音频可视化（基于 Web Audio API）
 - 🔍 搜索功能
+- 🌐 默认端口：10096
+
+## 快速开始
+
+### 一键部署（推荐）
+
+```bash
+# 使用一键部署脚本
+npm run deploy
+# 或者直接运行
+./deploy.sh
+```
+
+### 一键启动
+
+```bash
+# 使用启动脚本
+npm run start
+# 或者直接运行
+./start.sh
+```
 
 ## 开发
 
@@ -25,12 +46,30 @@ npm install
 npm run dev
 ```
 
+服务器将在 http://localhost:10096 启动
+
 ### 构建生产版本
 
 ```bash
 npm run build
 ```
 
+### 预览生产构建
+
+```bash
+npm run preview
+```
+
+## 脚本说明
+
+| 命令 | 说明 |
+|------|------|
+| `npm run dev` | 启动开发服务器（端口 10096） |
+| `npm run build` | 构建生产版本 |
+| `npm run preview` | 预览生产构建（端口 10096） |
+| `npm run deploy` | 一键部署（安装依赖 + 构建） |
+| `npm run start` | 一键启动（自动安装依赖 + 启动开发服务器） |
+
 ## 项目结构
 
 ```
diff --git a/deploy.sh b/deploy.sh
new file mode 100755
index 0000000..422bf73
--- /dev/null
+++ b/deploy.sh
@@ -0,0 +1,63 @@
+#!/bin/bash
+
+# QZMusic-Web 一键部署脚本
+# 端口：10096
+
+echo "=========================================="
+echo "   QZMusic-Web 一键部署"
+echo "=========================================="
+echo ""
+
+# 检查Node.js是否安装
+if ! command -v node &> /dev/null; then
+    echo "❌ Node.js 未安装！请先安装 Node.js"
+    exit 1
+fi
+
+echo "✅ Node.js 版本: $(node -v)"
+
+# 检查npm是否安装
+if ! command -v npm &> /dev/null; then
+    echo "❌ npm 未安装！"
+    exit 1
+fi
+
+echo "✅ npm 版本: $(npm -v)"
+echo ""
+
+# 安装依赖
+echo "📦 正在安装依赖..."
+npm install
+
+if [ $? -ne 0 ]; then
+    echo "❌ 依赖安装失败！"
+    exit 1
+fi
+
+echo "✅ 依赖安装成功！"
+echo ""
+
+# 构建项目
+echo "🔨 正在构建项目..."
+npm run build
+
+if [ $? -ne 0 ]; then
+    echo "❌ 构建失败！"
+    exit 1
+fi
+
+echo "✅ 项目构建成功！"
+echo ""
+
+echo "=========================================="
+echo "   部署完成！"
+echo "=========================================="
+echo ""
+echo "📂 构建产物目录: ./dist"
+echo ""
+echo "🚀 启动方式："
+echo "   开发模式: npm run dev"
+echo "   预览模式: npm run preview"
+echo ""
+echo "🌐 访问地址: http://localhost:10096"
+echo ""
diff --git a/package.json b/package.json
index 5fe3d49..43297fa 100644
--- a/package.json
+++ b/package.json
@@ -8,7 +8,9 @@
   "scripts": {
     "dev": "vite",
     "build": "vue-tsc && vite build",
-    "preview": "vite preview"
+    "preview": "vite preview --port 10096 --host",
+    "deploy": "./deploy.sh",
+    "start": "./start.sh"
   },
   "dependencies": {
     "@applemusic-like-lyrics/core": "^0.2.0",
diff --git a/start.sh b/start.sh
new file mode 100755
index 0000000..7dd6d7c
--- /dev/null
+++ b/start.sh
@@ -0,0 +1,27 @@
+#!/bin/bash
+
+# QZMusic-Web 启动脚本
+# 端口：10096
+
+echo "=========================================="
+echo "   启动 QZMusic-Web"
+echo "=========================================="
+echo ""
+
+# 检查是否已安装依赖
+if [ ! -d "node_modules" ]; then
+    echo "📦 依赖未安装，正在安装..."
+    npm install
+    if [ $? -ne 0 ]; then
+        echo "❌ 依赖安装失败！"
+        exit 1
+    fi
+fi
+
+echo "🚀 正在启动开发服务器..."
+echo "🌐 访问地址: http://localhost:10096"
+echo ""
+echo "按 Ctrl+C 停止服务器"
+echo ""
+
+npm run dev
diff --git a/vite.config.ts b/vite.config.ts
index 5c575e8..9884252 100644
--- a/vite.config.ts
+++ b/vite.config.ts
@@ -21,7 +21,8 @@ export default defineConfig({
     }
   },
   server: {
-    port: 3000,
+    port: 10096,
+    host: '0.0.0.0',
     open: false
   },
   build: {