docs: 为缩略图、最近文件相关新增类型补全中文 XML 文档注释

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

FileShare-Services/Services/FileLibrary/IFileLibraryService.cs

@@ -98,8 +98,20 @@ namespace FileShare_Services.Services.FileLibrary
         /// <returns>目录浏览响应，包含子目录和文件列表。</returns>
         Task<BrowseDirectoryResponse> BrowseDirectoryAsync(BrowseDirectoryRequest request, CancellationToken cancellationToken = default);
 
+        /// <summary>
+        /// 获取最近添加或最近播放的文件列表。
+        /// </summary>
+        /// <param name="type">筛选类型，"added" 按创建时间排序，"played" 按最近播放时间排序。</param>
+        /// <param name="count">返回数量，范围 1-48，默认 12。</param>
+        /// <param name="cancellationToken">取消令牌。</param>
+        /// <returns>文件记录 DTO 列表。</returns>
         Task<List<FileRecordDto>> GetRecentFilesAsync(string type, int count = 12, CancellationToken cancellationToken = default);
 
+        /// <summary>
+        /// 将指定文件的最近播放时间更新为当前 UTC 时间。
+        /// </summary>
+        /// <param name="id">文件记录 ID。</param>
+        /// <param name="cancellationToken">取消令牌。</param>
         Task MarkFilePlayedAsync(int id, CancellationToken cancellationToken = default);
     }
 }