fix(media): fix media scan sub path error

Author: PIKACHUIM

internal/db/db.go

@@ -12,8 +12,8 @@ var db *gorm.DB
 
 func Init(d *gorm.DB) {
 	db = d
-	// 迁移前处理：删除旧的 folder_path 唯一索引（如果存在），避免迁移冲突
-	// 同时清空旧的 media_items 数据（folder_path 语义已变更，旧数据不可复用）
+	// 迁移前处理：处理 media_items 的存储语义变更，避免旧数据与新代码不一致
+	// 语义变更：folder_path 现为文件实际父目录（之前为扫描根路径），旧数据需重扫
 	migrateMediaItems()
 	err := AutoMigrate(new(model.Storage), new(model.User), new(model.Meta), new(model.SettingItem), new(model.SearchNode), new(model.TaskItem), new(model.SSHPublicKey), new(model.SharingDB), new(model.MediaItem), new(model.MediaConfig), new(model.MediaScanPath))
 	if err != nil {
@@ -22,24 +22,28 @@ func Init(d *gorm.DB) {
 }
 
 // migrateMediaItems 处理 media_items 表的迁移兼容性
-// 存储语义已变更：folder_path 恒定为扫描根路径，file_name 为文件/文件夹名
+// 存储语义历史变更：
+//   v1: folder_path 为文件完整路径
+//   v2: folder_path 恒定为扫描根路径
+//   v3（当前）: folder_path 为文件/文件夹的实际父目录，供前端拼接播放地址
 // 唯一性由 folder_path + file_name + album_name 组合索引保证
 func migrateMediaItems() {
 	// 检查表是否存在
 	if !db.Migrator().HasTable("x_media_items") {
 		return
 	}
-	// 已迁移到新组合索引
+	// 语义标记：在设置表中写一个版本号，用来检测是否需要重扫。
+	// 这里采用轻量方式：检查是否存在以 sp.Path 开头的 folder_path 且可能丢了子路径的记录。
+	// 为避免复杂判断，直接在检测到旧版本索引时清空数据。
 	if db.Migrator().HasIndex("x_media_items", "idx_media_folder_file_album") {
-		// 清理掉之前软删除留下的脏数据，避免与组合唯一索引冲突
-		// （唯一索引在物理层不区分软删除，残留行会导致后续插入/更新报 UNIQUE constraint failed）
+		// 已是新索引：仅清理软删除残留数据，避免与唯一索引冲突
 		if err := db.Exec("DELETE FROM x_media_items WHERE deleted_at IS NOT NULL").Error; err != nil {
 			log.Warnf("media_items: 清理软删除残留数据失败: %v", err)
 		}
 		return
 	}
 	// 旧表存在但没有新组合索引，说明是旧版本数据，需要清空后重建
-	// 旧数据的 folder_path 语义已变更（原来存完整路径，现在恒定为扫描根路径），无法复用
+	// 旧数据的 folder_path 语义已变更，无法复用
 	log.Info("media_items: 检测到旧版本数据，清空后重新迁移（存储结构已变更）")
 	// 先尝试删除旧的单字段唯一索引（如果存在），避免 AutoMigrate 冲突
 	if db.Migrator().HasIndex("x_media_items", "idx_x_media_items_folder_path") {

internal/media/scanner.go

@@ -262,9 +262,9 @@ func doScanPath(sp *model.MediaScanPath, p *ScanProgress) error {
 // doScanMusicByAlbum 音乐扫描
 // 存储规则：
 //   - 普通文件（is_folder=false）：
-//     folder_path=文件所在目录，file_name=音乐文件名，episodes=空
+//     folder_path=文件所在真实目录，file_name=音乐文件名，episodes=空
 //   - 合并文件夹（is_folder=true）：
-//     folder_path=扫描根路径(sp.Path)，file_name=文件夹名，
+//     folder_path=文件夹所在真实父目录，file_name=文件夹名，
 //     episodes=文件夹内所有音乐文件列表，封面/标签取第一首
 func doScanMusicByAlbum(ctx context.Context, targets []string, sp *model.MediaScanPath, p *ScanProgress) error {
 	for _, target := range targets {
@@ -375,8 +375,8 @@ func doScanMusicByAlbum(ctx context.Context, targets []string, sp *model.MediaSc
 			item := &model.MediaItem{
 				MediaType:   sp.MediaType,
 				ScanPathID:  sp.ID,
-				FileName:    name,     // 文件夹名
-				FolderPath:  sp.Path,  // 扫描根路径
+				FileName:    name,                 // 文件夹名
+				FolderPath:  stdpath.Dir(target),  // 文件夹所在的真实父目录
 				IsFolder:    true,
 				AlbumName:   albumName,
 				AlbumArtist: albumArtist,
@@ -578,7 +578,7 @@ func walkVFS(ctx context.Context, dirPath string, mediaType model.MediaType, tar
 
 // buildMediaItemFromVFS 根据 VFS 路径构建 MediaItem（非音乐类型使用）
 // 存储规则：
-//   - folder_path：恒定为扫描根路径 sp.Path
+//   - folder_path：文件/文件夹所在的真实父目录（VFS 父路径），用于前端按 folder_path + file_name 反查真实文件
 //   - file_name：文件夹就是文件夹名，文件就是文件名
 //   - episodes：文件夹时存里面每个文件的信息，文件时为空
 func buildMediaItemFromVFS(ctx context.Context, vfsPath string, sp *model.MediaScanPath) (*model.MediaItem, error) {
@@ -593,8 +593,8 @@ func buildMediaItemFromVFS(ctx context.Context, vfsPath string, sp *model.MediaS
 	item := &model.MediaItem{
 		MediaType:  sp.MediaType,
 		ScanPathID: sp.ID,
-		FileName:   name,                          // 文件夹名 或 文件名
-		FolderPath: sp.Path,                       // 恒定为扫描根路径
+		FileName:   name,                 // 文件夹名 或 文件名
+		FolderPath: stdpath.Dir(vfsPath), // 真实父目录
 		IsFolder:   obj.IsDir(),
 		ScrapedName: strings.TrimSuffix(name, stdpath.Ext(name)), // 去掉扩展名作为默认名称
 	}