Add: 添加 MetadataProvidersGuard 日志开关并更新配置说明

Author: honue

Configuration/GeneralOptions.cs

@@ -24,6 +24,10 @@ public class GeneralOptions : EditableOptionsBase
         [Description("开启后阻止 Emby 默认的 CanRefresh 通过，仅插件内部允许调用。")]
         public bool DisableSystemMetadataRefresh { get; set; } = true;
 
+        [DisplayName("显示 MetadataProvidersGuard 日志")]
+        [Description("开启后记录 CanRefresh 拦截/放行日志，默认关闭。")]
+        public bool EnableMetadataProvidersGuardLog { get; set; } = false;
+
         [DisplayName("MediaInfo JSON 存储根目录")]
         [Description("为空时，JSON 保存到媒体文件同目录。填写后会用这个值，拼接媒体路径存储Json。")]
         [Editor(typeof(EditorFolderPicker), typeof(EditorBase))]

MediaInfoKeeper.csproj

@@ -4,9 +4,9 @@
     <Description>MediaInfoKeeper Emby plugin</Description>
     <PackageTags>emby;plugin;pms;media;server;</PackageTags>
     <BaseOutputPath>Build\bin\</BaseOutputPath>
-    <AssemblyVersion>1.3.5.0</AssemblyVersion>
-    <FileVersion>1.3.5.0</FileVersion>
-    <Version>1.3.5</Version>
+    <AssemblyVersion>1.3.6.0</AssemblyVersion>
+    <FileVersion>1.3.6.0</FileVersion>
+    <Version>1.3.6</Version>
     <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies>
   </PropertyGroup>
   <ItemGroup>

Plugin.cs

@@ -66,7 +66,9 @@ public Plugin(
             FileSystem = fileSystem;
 
             FfprobeGuard.Initialize(this.logger, this.Options.General.DisableSystemFfprobe);
-            MetadataProvidersGuard.Initialize(this.logger, this.Options.General.DisableSystemMetadataRefresh);
+            MetadataProvidersGuard.Initialize(this.logger,
+                this.Options.General.DisableSystemMetadataRefresh,
+                this.Options.General.EnableMetadataProvidersGuardLog);
 
             this.currentPersistMediaInfo = this.Options.General.PersistMediaInfoEnabled;
 
@@ -149,6 +151,8 @@ protected override void OnOptionsSaved(PluginConfiguration options)
             this.logger.Info($"ScheduledTaskLibraries 设置为 {(string.IsNullOrEmpty(options.LibraryScope.ScheduledTaskLibraries) ? "EMPTY" : options.LibraryScope.ScheduledTaskLibraries)}");
 
             FfprobeGuard.Configure(options.General.DisableSystemFfprobe);
+            MetadataProvidersGuard.Configure(options.General.DisableSystemMetadataRefresh,
+                options.General.EnableMetadataProvidersGuardLog);
         }
 
         private string NormalizeScopedLibraries(string raw)

README.md

@@ -62,6 +62,7 @@ MediaInfoKeeper 的目标是把媒体信息保存为 JSON，在需要时快速
 - 条目移除时删除 JSON：删除条目时移除对应 JSON。
 - 禁用 Emby 系统 ffprobe：仅插件内部允许调用。
 - 禁用 Emby 系统元数据刷新：仅插件内部允许调用。
+- 显示 MetadataProvidersGuard 日志：记录 CanRefresh 拦截/放行日志，默认关闭。
 - 追更媒体库：用于入库触发与删除 JSON 逻辑；留空表示全部。支持多选。
 - 计划任务媒体库：用于计划任务范围；留空表示全部。支持多选。
 - 最近入库条目数量：用于“最近入库”相关计划任务，默认 100。

Services/MetadataProvidersGuard.cs

@@ -22,13 +22,15 @@ public static class MetadataProvidersGuard
         private static MethodInfo instanceCanRefresh;
         private static ILogger logger;
         private static bool isEnabled;
+        private static bool logEnabled;
 
-        public static void Initialize(ILogger pluginLogger, bool disableSystemMetadata)
+        public static void Initialize(ILogger pluginLogger, bool disableSystemMetadata, bool enableLog)
         {
             if (harmony != null) return;
 
             logger = pluginLogger;
             isEnabled = disableSystemMetadata;
+            logEnabled = enableLog;
 
             try
             {
@@ -89,10 +91,14 @@ public static void Initialize(ILogger pluginLogger, bool disableSystemMetadata)
             }
         }
 
-        public static void Configure(bool disableSystemMetadata)
+        public static void Configure(bool disableSystemMetadata, bool enableLog)
         {
             isEnabled = disableSystemMetadata;
-            logger?.Info("MetadataProvidersGuard " + (isEnabled ? "enabled" : "disabled"));
+            logEnabled = enableLog;
+            if (logEnabled)
+            {
+                logger?.Info("MetadataProvidersGuard " + (isEnabled ? "enabled" : "disabled"));
+            }
         }
 
         public static IDisposable Allow()
@@ -111,11 +117,17 @@ private static bool CanRefreshPrefix(ref bool __result)
             if (GuardCount.Value == 0)
             {
                 __result = false;
-                logger?.Info($"MetadataProvidersGuard 拦截 CanRefresh");
+                if (logEnabled)
+                {
+                    logger?.Info($"MetadataProvidersGuard 拦截 CanRefresh");
+                }
                 return false;
             }
 
-            logger?.Info($"MetadataProvidersGuard 放行 CanRefresh");
+            if (logEnabled)
+            {
+                logger?.Info($"MetadataProvidersGuard 放行 CanRefresh");
+            }
             return true;
         }