v3.0.0-rc.3

☁️ 新增 WebDAV 音乐源
🎵 新增本地歌曲
🔍 新增页面缩放 (50%-150%)
📂 新增本地 TTML/LRC 歌词支持
🔗 新增网络代理设置
⬇️ 新增音乐下载
🌐 完善流媒体支持 (Navidrome/Jellyfin/Emby/Subsonic)
📱 最低兼容性调整为 Android 10
📐 重做手机端底栏/播放栏布局
🔧 修复显示系统状态栏滑动后自动隐藏
🔧 修复允许与其他应用同时播放无效
🔧 修复 Android 触控跳转 & seek 位置丢失
🎚️ 新增全局歌词偏移设置

Author: Re-BeiChen

.github/PULL_REQUEST_TEMPLATE.md

@@ -9,23 +9,21 @@
 
 <!-- 勾选一项或多项 -->
 
-- [ ] ✨ feat       — 新功能
-- [ ] 🐞 fix        — Bug 修复
-- [ ] 🎨 style      — 仅样式 / 格式，不影响逻辑
-- [ ] ♻️ refactor   — 重构，不改变外部行为
-- [ ] ⚡ perf       — 性能优化
-- [ ] 📝 docs       — 仅文档
-- [ ] 🧪 test       — 新增 / 修改测试
-- [ ] 🔧 chore      — 构建 / 脚本 / 依赖
-- [ ] 🚀 ci         — 仅 CI 配置
-- [ ] ⏪ revert     — 回滚
+- [ ] ✨ feat — 新功能
+- [ ] 🐞 fix — Bug 修复
+- [ ] 🎨 style — 仅样式 / 格式，不影响逻辑
+- [ ] ♻️ refactor — 重构，不改变外部行为
+- [ ] ⚡ perf — 性能优化
+- [ ] 📝 docs — 仅文档
+- [ ] 🧪 test — 新增 / 修改测试
+- [ ] 🔧 chore — 构建 / 脚本 / 依赖
+- [ ] 🚀 ci — 仅 CI 配置
+- [ ] ⏪ revert — 回滚
 
 ## 📝 变更说明
 
 <!-- 清晰说明 **改了什么** 与 **为什么改**，而不是逐行复述 diff -->
 
-
-
 ## 🔗 关联 Issue
 
 <!-- 用 Closes / Fixes 关键字关联，会在合并时自动关闭对应 Issue -->
@@ -62,8 +60,8 @@ Closes #
 <!-- 前后对比更佳，可直接拖拽图片或视频 -->
 
 | 改动前 | 改动后 |
-| :---: | :---: |
-|  |  |
+| :----: | :----: |
+|        |        |
 
 ## 🧪 测试方式
 

.github/workflows/android-release.yml

@@ -168,13 +168,13 @@ jobs:
           if [ -n "${{ inputs.release_tag }}" ]; then
             TAG="${{ inputs.release_tag }}"
           else
-            TAG="android-${BUILD_TYPE}-v${VERSION}-run.${GITHUB_RUN_NUMBER}"
+            TAG="v${VERSION}"
           fi
 
           if [ -n "${{ inputs.release_name }}" ]; then
             NAME="${{ inputs.release_name }}"
           else
-            NAME="SPlayer for Android ${VERSION} ${BUILD_TYPE} (${SHORT_SHA})"
+            NAME="SPlayer for Android ${VERSION} ${BUILD_TYPE}"
           fi
 
           if [ "$BUILD_TYPE" = "release" ]; then
@@ -200,7 +200,7 @@ jobs:
                 continue
               fi
             fi
-            DST="release/SPlayer-for-Android-${TAG}-${abi}.apk"
+            DST="release/SPA-${BUILD_TYPE}-${VERSION}-${abi}.apk"
             cp "${SRC}" "${DST}"
             sha256sum "${DST}" > "${DST}.sha256"
             FOUND=$((FOUND + 1))
@@ -222,7 +222,7 @@ jobs:
       - name: Upload workflow artifact
         uses: actions/upload-artifact@v4
         with:
-          name: SPlayer-for-Android-${{ steps.meta.outputs.tag }}
+          name: SPA-${{ steps.meta.outputs.build_type }}-${{ steps.meta.outputs.tag }}
           path: |
             release/*.apk
             release/*.sha256

.github/workflows/opencode.yml

@@ -0,0 +1,46 @@
+name: opencode
+on:
+  issue_comment:
+    types: [created]
+  pull_request_review_comment:
+    types: [created]
+
+jobs:
+  opencode:
+    if: |
+      contains(github.event.comment.body, '/oc') ||
+      contains(github.event.comment.body, '/opencode')
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: write
+      pull-requests: write
+      issues: write
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 1
+          persist-credentials: false
+
+      - name: Run OpenCode (OpenAI format)
+        if: secrets.LLM_TYPE == 'openai'
+        uses: anomalyco/opencode/github@latest
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
+          OPENAI_BASE_URL: ${{ secrets.OPENCODE_API_URL }}
+        with:
+          model: openai/${{ secrets.OPENCODE_MODEL }}
+          prompt: |
+            你的名字是「${{ secrets.OPENCODE_NAME }}」，在回复开头用这个名字自我介绍。
+
+      - name: Run OpenCode (Anthropic format)
+        if: secrets.LLM_TYPE == 'anthropic'
+        uses: anomalyco/opencode/github@latest
+        env:
+          ANTHROPIC_API_KEY: ${{ secrets.OPENCODE_API_KEY }}
+          ANTHROPIC_BASE_URL: ${{ secrets.OPENCODE_API_URL }}
+        with:
+          model: anthropic/${{ secrets.OPENCODE_MODEL }}
+          prompt: |
+            你的名字是「${{ secrets.OPENCODE_NAME }}」，在回复开头用这个名字自我介绍。

CHANGELOG.md

@@ -0,0 +1,38 @@
+# 更新日志
+
+所有版本的更新记录。最新版本在最上方。
+
+---
+
+## v3.0.0-rc.3
+
+- ☁️ 新增 **WebDAV 音乐源** — 支持通过 WebDAV 连接并播放远程音乐
+- 🎵 新增 **本地歌曲** — 扫描本地音乐文件，与在线曲库统一管理
+- 🔍 新增 **页面缩放** — 50%–150% 全局缩放，缩小后等效视口变宽，达到阈值可切换到 Pad 布局（尚未完全适配，欢迎 PR 帮忙完善；没有 PR 的话也尽量在下个版本彻底做好）
+- 📂 新增 **本地 TTML/LRC 歌词支持** — 歌词目录扫描支持 `.lrc` 和 `.ttml`，按文件名 ID 和元数据匹配
+- 🎵 新增 **同目录歌词查找** — 播放本地音乐时自动查找同目录下的歌词文件
+- 🔗 新增 **网络代理设置** — Android 端可配置 HTTP/HTTPS 代理用于内置 API 请求
+- ⬇️ 新增 **音乐下载** — 开发者模式下可通过 SAF 选择下载目录，下载歌曲及歌词
+- 🌐 完善 **流媒体支持** — Navidrome / Jellyfin / Emby / Subsonic / OpenSubsonic 全平台可用
+- 📱 最低兼容性调整为 **Android 10**
+- 📐 重做 **手机端底栏 / 播放栏布局** — 底栏改成全宽贴底实心条，播放栏改为圆角浮岛悬浮其上；底栏选中高亮改为基于 JS 测量的**滑动指示器**，切换页签时平滑过渡而非瞬移
+- 🎯 手机端整体 **轻度紧凑（约 -15%）** — 收紧 CoverList 卡片间距与文字区 padding/字号、SongCard 内边距与 cover 尺寸、ListDetail 头部高度、Setting 项间距与卡片 padding；平板（shortestSide ≥ 768）保持原样
+- 🔧 修复 **显示系统状态栏** 滑动后自动隐藏的问题
+- 🔧 修复 **允许与其他应用同时播放** 无效的问题 — 开启时改用 ExoPlayer 引擎（handleAudioFocus=false）
+- 🔧 修复 **Android 触控跳转** — 修复触控进度跳转异常
+- 🔧 修复 **跳转后 seek 位置丢失回到 0:00**
+- 🔧 修复 **自动切下一首进度条跳到非 0:00 错误位置**
+- 🎚️ 新增 **全局歌词偏移设置**（PR #11）
+---
+
+## v3.0.0-rc.2
+
+- 🔄 修复 **横竖屏切换** 时部分界面布局错乱
+- 📱 修复 **手机小屏** 下文字挤压成一团的问题
+- ⬆️ 调整 **"回到顶部"按钮** 位置，不再遮挡其他控件
+- 🎨 修复 **桌面歌词** 在未开启文本背景遮罩时、锁定状态下仍显示背景的 bug
+- 📦 GitHub Actions 构建改为 **分架构打包**，单包体积更小
+
+---
+
+……

CONTRIBUTING.md

@@ -10,10 +10,10 @@
 
 请使用对应的 Issue 模板（点击 **New Issue** 会出现选择页）：
 
-| 模板 | 用途 |
-| --- | --- |
-| 🐞 **Bug 反馈** | 使用过程中遇到的缺陷、闪退、异常行为 |
-| ✨ **功能建议** | 新功能 / 改进想法 |
+| 模板             | 用途                                            |
+| ---------------- | ----------------------------------------------- |
+| 🐞 **Bug 反馈**  | 使用过程中遇到的缺陷、闪退、异常行为            |
+| ✨ **功能建议**  | 新功能 / 改进想法                               |
 | 💬 **QQ 交流群** | 群号 `602750631` — 使用疑问与讨论，不替代 Issue |
 
 ### 基本要求
@@ -41,8 +41,8 @@
 
 - 目标分支：`master`
 - 从最新的 `master` 新建分支，命名建议：
-  - `feat/<模块>-<简述>`  — 新功能
-  - `fix/<模块>-<简述>`   — Bug 修复
+  - `feat/<模块>-<简述>` — 新功能
+  - `fix/<模块>-<简述>` — Bug 修复
   - `refactor/<模块>-<简述>`
   - `docs/<简述>`
 - 分支名用小写与短横线，不要用中文
@@ -61,18 +61,18 @@
 
 `<type>` 取值：
 
-| type | 含义 |
-| --- | --- |
-| `feat` | 新功能 |
-| `fix` | Bug 修复 |
-| `perf` | 性能优化 |
-| `refactor` | 重构，不改变外部行为 |
-| `style` | 仅代码格式 / 样式，不影响逻辑 |
-| `docs` | 仅文档 |
-| `test` | 测试相关 |
-| `chore` | 构建 / 依赖 / 脚本 |
-| `ci` | GitHub Actions 等 CI 配置 |
-| `revert` | 回滚之前的提交 |
+| type       | 含义                          |
+| ---------- | ----------------------------- |
+| `feat`     | 新功能                        |
+| `fix`      | Bug 修复                      |
+| `perf`     | 性能优化                      |
+| `refactor` | 重构，不改变外部行为          |
+| `style`    | 仅代码格式 / 样式，不影响逻辑 |
+| `docs`     | 仅文档                        |
+| `test`     | 测试相关                      |
+| `chore`    | 构建 / 依赖 / 脚本            |
+| `ci`       | GitHub Actions 等 CI 配置     |
+| `revert`   | 回滚之前的提交                |
 
 `<scope>` 建议取模块名，常见示例：`DesktopLyric`、`Player`、`Lyric`、`Search`、`Setting`、`Notification`、`Capacitor`、`Android`、`CI`。