🦄 refactor: Linux 优先使用原始字节更新封面，并在切歌时重置播放进度。补全部分文档

Author: apoint123

native/external-media-integration/src/model.rs

@@ -75,6 +75,7 @@ impl fmt::Debug for MetadataPayload {
 }
 
 #[napi(object)]
+#[allow(clippy::doc_markdown)]
 pub struct MetadataParam {
     pub song_name: String,
     pub author_name: String,
@@ -85,12 +86,15 @@ pub struct MetadataParam {
 
     /// 封面的 HTTP URL，更新 Discord RPC 时必传，其他平台可不传
     ///
-    /// Linux 平台会优先使用 URL 来更新封面
+    /// Linux 平台在没有提供 `cover_data` 时会使用它
     pub original_cover_url: Option<String>,
 
-    /// 网易云音乐 ID
+    /// 网易云音乐中对应的曲目 ID
     ///
-    /// 会以 "NCM-{ID}" 的格式上传到 SMTC 的 “流派” 字段，以及用来生成 Discord RPC 的按钮链接
+    /// ### 用途
+    /// - 以 "NCM-{ID}" 的格式上传到 SMTC 的 “流派” 字段
+    /// - 生成 Discord RPC 的按钮链接
+    /// - MacOS 和 Linux 会使用此值来填充唯一的曲目 ID
     pub ncm_id: Option<i64>,
 
     /// 当前歌曲时长，单位是毫秒

native/external-media-integration/src/sys_media/linux.rs

@@ -167,10 +167,7 @@ async fn process_metadata_update(
     payload: MetadataPayload,
     cover_guard: &mut Option<NamedTempFile>,
 ) {
-    let art_url = if let Some(url) = payload.original_cover_url {
-        *cover_guard = None;
-        Some(url)
-    } else if let Some(data) = payload.cover_data {
+    let art_url = if let Some(data) = payload.cover_data {
         match tempfile::Builder::new().suffix(".jpg").tempfile() {
             Ok(mut file) => {
                 if file.write_all(&data).is_ok() {
@@ -189,6 +186,9 @@ async fn process_metadata_update(
                 None
             }
         }
+    } else if let Some(url) = payload.original_cover_url {
+        *cover_guard = None;
+        Some(url)
     } else {
         *cover_guard = None;
         None
@@ -228,6 +228,7 @@ async fn process_metadata_update(
     }
 
     player.set_metadata(mb.build()).await.ok();
+    player.set_position(Time::from_millis(0));
 }
 
 #[allow(clippy::future_not_send)]