feat(func): media library support change api url

Author: PIKACHUIM

internal/bootstrap/data/setting.go

@@ -245,9 +245,9 @@ func InitialSettings() []model.SettingItem {
 
 		// media settings
 		{Key: conf.MediaTMDBKey, Value: "", Type: conf.TypeString, Group: model.MEDIA, Flag: model.PRIVATE},
-		{Key: conf.MediaTMDBAPIURL, Value: "https://api.themoviedb.org", Type: conf.TypeString, Group: model.MEDIA, Flag: model.PRIVATE},
+		{Key: conf.MediaTMDBAPIURL, Value: "api.themoviedb.org", Type: conf.TypeString, Group: model.MEDIA, Flag: model.PRIVATE},
 		{Key: conf.MediaDiscogsToken, Value: "", Type: conf.TypeString, Group: model.MEDIA, Flag: model.PRIVATE},
-		{Key: conf.MediaDiscogsAPIURL, Value: "https://api.discogs.com", Type: conf.TypeString, Group: model.MEDIA, Flag: model.PRIVATE},
+		{Key: conf.MediaDiscogsAPIURL, Value: "api.discogs.com", Type: conf.TypeString, Group: model.MEDIA, Flag: model.PRIVATE},
 		{Key: conf.MediaStoreThumbnail, Value: "false", Type: conf.TypeBool, Group: model.MEDIA, Flag: model.PRIVATE},
 		{Key: conf.MediaThumbnailMode, Value: "base64", Type: conf.TypeSelect, Options: "base64,local", Group: model.MEDIA, Flag: model.PRIVATE},
 		{Key: conf.MediaThumbnailPath, Value: "/.thumbnail", Type: conf.TypeString, Group: model.MEDIA, Flag: model.PRIVATE},

internal/db/db.go

@@ -29,8 +29,13 @@ func migrateMediaItems() {
 	if !db.Migrator().HasTable("x_media_items") {
 		return
 	}
-	// 已迁移到新组合索引，跳过
+	// 已迁移到新组合索引
 	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
 	}
 	// 旧表存在但没有新组合索引，说明是旧版本数据，需要清空后重建

internal/db/media.go

@@ -174,9 +174,13 @@ func GetMediaItemByFolderPath(folderPath string) (*model.MediaItem, error) {
 
 // CreateOrUpdateMediaItem 创建或更新媒体条目（按 folder_path + file_name + album_name 组合唯一）
 // 更新时保留已有的刮削数据，避免重新扫描时把已刮削的字段清空
+//
+// 注意：使用 Unscoped() 查询是为了把软删除残留记录也包含进来，
+// 否则唯一索引 idx_media_folder_file_album 会与软删除行冲突，
+// 导致新建条目时报 UNIQUE constraint failed。
 func CreateOrUpdateMediaItem(item *model.MediaItem) error {
 	var existing model.MediaItem
-	result := db.Where("folder_path = ? AND file_name = ? AND album_name = ?", item.FolderPath, item.FileName, item.AlbumName).First(&existing)
+	result := db.Unscoped().Where("folder_path = ? AND file_name = ? AND album_name = ?", item.FolderPath, item.FileName, item.AlbumName).First(&existing)
 	if result.Error == gorm.ErrRecordNotFound {
 		return db.Create(item).Error
 	}
@@ -185,6 +189,8 @@ func CreateOrUpdateMediaItem(item *model.MediaItem) error {
 	}
 	item.ID = existing.ID
 	item.CreatedAt = existing.CreatedAt
+	// 复用已有记录时清除软删除标记，确保该条目“恢复”为正常记录
+	item.DeletedAt = gorm.DeletedAt{}
 	// 如果已有刮削数据，保留刮削字段，防止重新扫描时覆盖刮削结果
 	if existing.ScrapedAt != nil {
 		item.ScrapedAt = existing.ScrapedAt
@@ -204,12 +210,13 @@ func CreateOrUpdateMediaItem(item *model.MediaItem) error {
 		item.ISBN = existing.ISBN
 		item.ExternalID = existing.ExternalID
 	}
-	return db.Save(item).Error
+	return db.Unscoped().Save(item).Error
 }
 
-// UpdateMediaItem 更新媒体条目（仅更新可编辑字段）
+// UpdateMediaItem 更新媒体条目
+// 使用 Unscoped 确保即使存在软删除标记也能正确更新（避免命中唯一索引但行不可见的诡异情况）。
 func UpdateMediaItem(item *model.MediaItem) error {
-	return db.Save(item).Error
+	return db.Unscoped().Save(item).Error
 }
 
 // DeleteMediaItem 硬删除媒体条目（真正从数据库删除）

server/handles/media.go

@@ -462,7 +462,7 @@ func StartMediaScrape(c *gin.Context) {
 			now := time.Now()
 			item.ScrapedAt = &now
 			if err := db.UpdateMediaItem(item); err != nil {
-				log.Warnf("保存刮削结果失败 [%s]: %v", item.FolderPath, err)
+				log.Warnf("保存刮削结果失败 [id=%d, %s/%s]: %v", item.ID, item.FolderPath, item.FileName, err)
 			}
 		}
 		log.Infof("刮削完成 [%s]，共处理 %d 条", req.MediaType, len(items))