1.3.1

.github/ISSUE_TEMPLATE/bug-report--提交-bug-.md

@@ -7,10 +7,10 @@ assignees: gitbobobo
 
 ---
 
-**Describe the bug (BUG 描述)**
+**Describe the bug (BUG 描述，多条问题请分别建立 issue)**
 A clear and concise description of what the bug is.
 
-**To Reproduce (复现步骤)**
+**To Reproduce (复现步骤，复现问题是处理问题的必要条件)**
 Steps to reproduce the behavior:
 1. Go to '...'
 2. Click on '....'
@@ -31,5 +31,8 @@ If applicable, add screenshots to help explain your problem.
 **Music Server Type (音乐服务器类型)**
 e.g. emby 4.17.
 
+- [ ] Direct Mode（直连模式）
+- [ ] Library Mode（媒体库模式）
+
 **Additional context (额外信息)**
 Add any other context about the problem here.

README.md

@@ -34,7 +34,7 @@ iOS 可直接在 AppStore 搜索 **[音流](https://apps.apple.com/cn/app/%E9%9F
 
 - [x] 窗口标题修改
 - [x] 媒体信息通知
-- [ ] 任务栏预览
+- [x] 任务栏快捷操作
 - [ ] 桌面歌词
 - [x] 最小化到系统托盘
 - [ ] 适配桌面平台 UI

docs/features.md

@@ -70,7 +70,7 @@ sidebar_position: 3
 
 内容请包含（缺一不可）：
 
-1. 会员购买凭证（Apple 的邮件收据截图或支付宝的订单购买记录截图，需包含订单号信息）
+1. 会员购买凭证（Apple 的邮件收据截图或支付宝的订单购买记录截图，需包含订单号信息，无法辨认的图片将被忽略）
 2. 接收邀请的邮箱（注册 Apple 账户时使用的邮箱）
 3. 常用的音乐服务器类型
 

docs/guides/install.md

@@ -12,6 +12,12 @@ Android 一共提供四个安装包，分别对应不同的芯片架构。
 
 一般最近几年的手机选择 `app-arm64-v8a-release.apk` 即可，若不确定自己手机的芯片架构，请选择 `app-release.apk` 下载安装。
 
+:::caution
+
+不同架构的安装包不能覆盖安装，只能选择卸载重装。
+
+:::
+
 ## Windows
 
 Windows 版音流目前只提供 x64 架构的 msix 格式安装包，这是微软应用商店的安装格式，因此在商店外安装，需要先在电脑上安装开发者对应的证书。

docs/guides/interfaces.md

@@ -75,6 +75,12 @@ sidebar_position: 4
 
 响应码：若响应码不是`20x`，则提示用户「歌词确认异常」，没有异常则不提示信息。
 
+:::note
+
+自 1.3.1 开始，调整歌词偏移后点击对勾按钮也会触发歌词确认接口，此时请求的数据中不包含 `lyricsId` 字段。
+
+:::
+
 ### 获取封面
 
 请求方式：GET

docs/guides/others.md

@@ -21,12 +21,6 @@ sidebar_position: 5
 
 ![](https://oss.aqzscn.cn/resource/blog/img/2024/90011-293fd6ac80a1ce9bc85adf176c807e19.png)
 
-:::tip
-
-歌曲在播放到 1/4 位置时会向服务器发送滚动播放记录的请求（AudioStation 不支持此接口）。
-
-:::
-
 在某个专辑的歌曲列表中，序号指的是音轨号，而右上角的数字表示碟号。
 
 ![](https://oss.aqzscn.cn/resource/blog/img/2024/90642-5882f5ffcf3b92988a49aaa5dac913c3.png)
@@ -48,4 +42,23 @@ sidebar_position: 5
 1. 扫码同步功能涉及到的数据仅会在局域网中传输，音流仅对数据做了最基础的加密，因此请尽量在安全的局域网环境中使用，避免泄露您的账号信息。
 2. 扫码识别二维码使用了 [mobile_scanner](https://github.com/juliansteenbakker/mobile_scanner) 插件，可能有部分识别不到的情况，可尝试返回重进更换一个新的二维码。
 
-:::
+:::
+
+## 歌词
+
+目前只支持 LRC 格式的歌词，详细可参考 [维基百科](https://zh.wikipedia.org/wiki/LRC%E6%A0%BC%E5%BC%8F)。
+
+对于双语歌词，目前支持以下两种格式：
+
+**相同时间轴**
+
+```
+[00:01.123] 歌词
+[00:01.123] 翻译
+```
+
+**以【】包裹**
+
+```
+[00:01.123] 歌词【翻译】
+```

docs/notes/plugins.md

@@ -32,7 +32,7 @@ sidebar_position: 1
 
 ![](https://oss.aqzscn.cn/resource/blog/img/2024/faae1-9ad0cf3582cd7ff590b3e02645f19bc7.png)
 
-## 平台相关
+## 平台特性
 
 ### macos_window_utils
 
@@ -42,6 +42,58 @@ sidebar_position: 1
 
 [flutter_acrylic](https://github.com/alexmercerind/flutter_acrylic) 可以在 macOS、Windows、Linux 平台实现窗口模糊/透明效果，其中 macOS 依赖了 `macos_window_utils` 插件，因此如果使用此插件就无需再引入 `macos_window_utils` 了。
 
+### window_manager
+
+[window_manager](https://pub.dev/packages/window_manager) 可用于在桌面端控制窗口的一系列属性。
+
+### tray_manager
+
+[tray_manager](https://pub.dev/packages/tray_manager) 可以定义桌面端的系统托盘。
+
+### windows_taskbar
+
+[windows_taskbar](https://pub.dev/packages/windows_taskbar) 用于在 Windows 的任务栏图标上添加预览按钮与进度条，对于音乐播放器来说非常实用。
+
+### flutter_carplay
+
+[flutter_carplay](https://pub.dev/packages/flutter_carplay) 可用于在 iOS 平台实现 CarPlay 功能，最低支持 iOS 14.
+
+作者已经很久没有更新过了，可以尝试其他开发者的修改版本。
+
+目前一个比较困扰我的问题是如何在打开 CarPlay 时启动 Flutter 引擎，同时保证再从手机上打开 APP 时界面不会卡住。
+
+
+
+## 网络
+
+### dio
+
+[dio](https://pub.dev/packages/dio) 是一个强大的 HTTP 网络请求库，其中的拦截器、请求取消、自定义适配器等特色功能都很好用，社区还提供了一些插件可让网络请求的处理更加轻松。
+
+dart 的 HTTP 请求是自己实现的，仅适配了标准的 HTTP 请求，处理一些非标准的 HTTP 请求就会出问题，在这一点上是不如原生平台的网络请求的。
+
+虽然 dio 目前也已经有了 [native_dio_adapter](https://github.com/cfug/dio/tree/main/plugins/native_dio_adapter) 插件可以通过原生平台发送请求，但只在安卓和 iOS 平台有效，这对于音流来说显然是不够的。
+
+最近新出了个 [rhttp](https://github.com/Tienisto/rhttp)，原理是使用 FRB 插件通过 Rust 发送网络请求，可以观察一段时间，如果稳定的话可能会尝试切换到这个插件上。
+
+### shelf
+
+[shelf](https://pub.dev/packages/shelf) 可用于创建本地的 HTTP 服务器，可通过 [shelf_proxy](https://pub.dev/packages/shelf_proxy) 等相关插件简化处理步骤。
+
+需要注意的是，iOS 平台创建的本地服务器会在应用不再位于前台后停用，应用需要检测本地服务是否可用并准备重启。
+
+### connectivity_plus
+
+[connectivity_plus](https://pub.dev/packages/connectivity_plus) 可用于检测应用当前的网络环境。
+
+### network_info_plus
+
+[network_info_plus](https://pub.dev/packages/network_info_plus) 可用于获取 Wi-Fi 信息，比如 IP 地址。
+
+### url_launcher
+
+[url_launcher](https://pub.dev/packages/url_launcher) 可用于在浏览器中打开链接。
+
 ## 音频
 
 ### media_kit
@@ -442,37 +494,6 @@ if (Platform.isAndroid) {
 | OGG         | `Vorbis Comments`       | ✅   |
 | Opus        | `Vorbis Comments`       | ✅   |
 
-### taggy
-
-[taggy](https://github.com/DMouayad/taggy) 同样也是一款读取/写入音乐文件标签信息的插件，但底层连接的是 [lofty](https://github.com/Serial-ATA/lofty-rs/)，拥有更为广泛的格式支持：
-
-| File Format | Metadata Format(s)           |
-|-------------|------------------------------|
-| AAC (ADTS)  | `ID3v2`, `ID3v1`             |
-| Ape         | `APE`, `ID3v2`\*, `ID3v1`    |
-| AIFF        | `ID3v2`, `Text Chunks`       |
-| FLAC        | `Vorbis Comments`, `ID3v2`\* |
-| MP3         | `ID3v2`, `ID3v1`, `APE`      |
-| MP4         | `iTunes-style ilst`          |
-| MPC         | `APE`, `ID3v2`\*, `ID3v1`\*  |                        
-| Opus        | `Vorbis Comments`            |
-| Ogg Vorbis  | `Vorbis Comments`            |
-| Speex       | `Vorbis Comments`            |
-| WAV         | `ID3v2`, `RIFF INFO`         |
-| WavPack     | `APE`, `ID3v1`               |
-
-\* The tag will be **read only**, due to lack of official support
-
-:::info
-
-既然 taggy 这么强大，我为什么还要先介绍 audio_metadata_reader 呢？
-
-因为我只能在安卓平台成功运行起 taggy😭，其他平台不知是我使用方法问题还是作者并未测试，我这里是无法运行的。
-
-因此目前音流会在安卓平台使用 taggy 解析音乐标签，而在其他平台使用 audio_metadata_reader 解析音乐标签。
-
-:::
-
 ## Flutter 社区
 
 ### Flutter Candies

docs/notes/resources.md

@@ -8,8 +8,16 @@ sidebar_position: 3
 
 ## 图片背景
 
+- [歌曲列表默认封面](https://pixabay.com/zh/vectors/record-disk-disc-music-musical-23281/) by Clker-Free-Vector-Images
 - [tv端歌手详情页面默认背景](https://pixabay.com/zh/photos/concert-singer-singing-stage-2566002/) by StockSnap
 
+## 彩色插画
+
+- [警告](https://pixabay.com/zh/vectors/warning-caution-alert-icon-media-145066/) by OpenClipart-Vectors
+- [成功](https://pixabay.com/zh/vectors/icon-symbol-confirmation-hook-ok-803718/) by Leovinus
+- [错误](https://pixabay.com/zh/vectors/error-button-failure-warning-24842/) by Clker-Free-Vector-Images
+- [信息](https://pixabay.com/zh/vectors/info-information-tips-icon-support-148099/) by OpenClipart-Vectors
+
 ## 单色插画
 
 - [tv端会员页面插画](https://pixabay.com/zh/vectors/jewelry-crown-king-royal-queen-2025491/) by OpenClipart-Vectors