feat: Enhanced song matching logic (NetEaseMusic).

src/ZonyLrcTools.Cli/Infrastructure/Lyric/ILyricDownloader.cs

@@ -12,8 +12,9 @@ namespace ZonyLrcTools.Cli.Infrastructure.Lyric
         /// </summary>
         /// <param name="songName">歌曲的名称。</param>
         /// <param name="artist">歌曲的作者。</param>
+        /// <param name="duration">歌曲的时长。</param>
         /// <returns>歌曲的歌词数据对象。</returns>
-        ValueTask<LyricItemCollection> DownloadAsync(string songName, string artist);
+        ValueTask<LyricItemCollection> DownloadAsync(string songName, string artist, long? duration = null);
 
         /// <summary>
         /// 下载器的名称。

src/ZonyLrcTools.Cli/Infrastructure/Lyric/LyricDownloader.cs

@@ -16,10 +16,11 @@ namespace ZonyLrcTools.Cli.Infrastructure.Lyric
         /// </summary>
         /// <param name="songName">歌曲名称。</param>
         /// <param name="artist">歌曲作者/艺术家。</param>
+        /// <param name="duration">歌曲的时长。</param>
         /// <returns>下载完成的歌曲数据。</returns>
-        public virtual async ValueTask<LyricItemCollection> DownloadAsync(string songName, string artist)
+        public virtual async ValueTask<LyricItemCollection> DownloadAsync(string songName, string artist, long? duration = null)
         {
-            var args = new LyricDownloaderArgs(songName, artist);
+            var args = new LyricDownloaderArgs(songName, artist, duration ?? 0);
             await ValidateAsync(args);
             var downloadDataBytes = await DownloadDataAsync(args);
             return await GenerateLyricAsync(downloadDataBytes, args);

src/ZonyLrcTools.Cli/Infrastructure/Lyric/LyricDownloaderArgs.cs

@@ -6,10 +6,13 @@ namespace ZonyLrcTools.Cli.Infrastructure.Lyric
 
         public string Artist { get; set; }
 
-        public LyricDownloaderArgs(string songName, string artist)
+        public long Duration { get; set; }
+
+        public LyricDownloaderArgs(string songName, string artist, long duration)
         {
             SongName = songName;
             Artist = artist;
+            Duration = duration;
         }
     }
 }

src/ZonyLrcTools.Cli/Infrastructure/Lyric/NetEase/JsonModel/SongSearchRequest.cs

@@ -49,7 +49,7 @@ namespace ZonyLrcTools.Cli.Infrastructure.Lyric.NetEase.JsonModel
             Type = 1;
             Offset = 0;
             IsTotal = true;
-            Limit = 5;
+            Limit = 10;
         }
 
         public SongSearchRequest(string musicName, string artistName) : this()

src/ZonyLrcTools.Cli/Infrastructure/Lyric/NetEase/JsonModel/SongSearchResponse.cs

@@ -1,3 +1,4 @@
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using Newtonsoft.Json;
@@ -10,10 +11,20 @@ namespace ZonyLrcTools.Cli.Infrastructure.Lyric.NetEase.JsonModel
 
         [JsonProperty("code")] public int StatusCode { get; set; }
 
-        public int GetFirstMatchSongId(string songName)
+        public int GetFirstMatchSongId(string songName, long? duration)
         {
-            var item = Items.SongItems.FirstOrDefault(x => x.Name == songName);
-            return item?.Id ?? Items.SongItems[0].Id;
+            var perfectMatch = Items.SongItems.FirstOrDefault(x => x.Name == songName);
+            if (perfectMatch != null)
+            {
+                return perfectMatch.Id;
+            }
+
+            if (duration is null or 0)
+            {
+                return Items.SongItems.First().Id;
+            }
+
+            return Items.SongItems.OrderBy(t => Math.Abs(t.Duration - duration.Value)).First().Id;
         }
     }
 
@@ -49,6 +60,12 @@ namespace ZonyLrcTools.Cli.Infrastructure.Lyric.NetEase.JsonModel
         /// </summary>
         [JsonProperty("album")]
         public SongAlbumModel Album { get; set; }
+
+        /// <summary>
+        /// 歌曲的实际长度。
+        /// </summary>
+        [JsonProperty("duration")]
+        public long Duration { get; set; }
     }
 
     public class SongArtistModel

src/ZonyLrcTools.Cli/Infrastructure/Lyric/NetEase/NetEaseLyricDownloader.cs

@@ -48,7 +48,7 @@ namespace ZonyLrcTools.Cli.Infrastructure.Lyric.NetEase
 
             var lyricResponse = await _warpHttpClient.GetAsync(
                 NetEaseGetLyricUrl,
-                new GetLyricRequest(searchResult.GetFirstMatchSongId(args.SongName)),
+                new GetLyricRequest(searchResult.GetFirstMatchSongId(args.SongName, args.Duration)),
                 msg => msg.Headers.Referrer = new Uri(NetEaseRequestReferer));
 
             return Encoding.UTF8.GetBytes(lyricResponse);