feat(plugin): 插件实例绑定版本，多实例并行运行不同版本

app/agent/policy/api.py

@@ -538,6 +538,26 @@ def _user_write(
     _write("plugin.folder.create", recovery=RecoveryMode.TRANSACTION),
     _write("plugin.folder.delete", effect=ActionEffect.DESTRUCTIVE_WRITE, recovery=_DELETE_RECOVERABLE),
     _write("plugin.folder.plugins.update", recovery=RecoveryMode.TRANSACTION),
+    _admin_read("plugin.versions.get", sensitivity=ResultSensitivity.PRIVATE),
+    _spec(
+        "plugin.versions.set_instance",
+        effect=ActionEffect.EXTERNAL_SIDE_EFFECT,
+        required_role=_ADMIN,
+        confirmation=_CONFIRM,
+        recovery=RecoveryMode.RECONCILE,
+    ),
+    _spec(
+        "plugin.versions.recycle",
+        effect=ActionEffect.EXTERNAL_SIDE_EFFECT,
+        required_role=_ADMIN,
+        confirmation=_CONFIRM,
+        recovery=RecoveryMode.RECONCILE,
+    ),
+    _admin_read("plugin.loglevel.get", sensitivity=ResultSensitivity.PRIVATE),
+    _write("plugin.loglevel.set"),
+    _write("plugin.loglevel.clear"),
+    _write("plugin.default_target.set"),
+    _write("plugin.default_target.clear"),
 )
 
 
@@ -755,6 +775,26 @@ def _user_write(
     "plugin.folder.create": ApiOperationRoute("POST", "/api/v1/plugin/folders/{folder_name}"),
     "plugin.folder.delete": ApiOperationRoute("DELETE", "/api/v1/plugin/folders/{folder_name}"),
     "plugin.folder.plugins.update": ApiOperationRoute("PUT", "/api/v1/plugin/folders/{folder_name}/plugins"),
+    "plugin.versions.get": ApiOperationRoute("GET", "/api/v1/plugin/versions/{plugin_id}"),
+    "plugin.versions.set_instance": ApiOperationRoute(
+        "PUT", "/api/v1/plugin/versions/{plugin_id}/{instance_id}"
+    ),
+    "plugin.versions.recycle": ApiOperationRoute(
+        "POST", "/api/v1/plugin/versions/{plugin_id}/recycle"
+    ),
+    "plugin.loglevel.get": ApiOperationRoute("GET", "/api/v1/plugin/loglevel/{plugin_id}"),
+    "plugin.loglevel.set": ApiOperationRoute(
+        "PUT", "/api/v1/plugin/loglevel/{plugin_id}/{instance_id}"
+    ),
+    "plugin.loglevel.clear": ApiOperationRoute(
+        "DELETE", "/api/v1/plugin/loglevel/{plugin_id}/{instance_id}"
+    ),
+    "plugin.default_target.set": ApiOperationRoute(
+        "PUT", "/api/v1/plugin/instances/{plugin_id}/{instance_id}/default_target"
+    ),
+    "plugin.default_target.clear": ApiOperationRoute(
+        "DELETE", "/api/v1/plugin/instances/{plugin_id}/{instance_id}/default_target"
+    ),
 }
 
 

app/agent/policy/mcp.py

@@ -209,6 +209,14 @@
     "plugin.folder.create": "Create one named plugin folder.",
     "plugin.folder.delete": "Delete one named plugin folder without uninstalling its plugins.",
     "plugin.folder.plugins.update": "Replace the ordered plugin IDs assigned to one named plugin folder.",
+    "plugin.versions.get": "List one plugin's installed source versions and each instance's version binding.",
+    "plugin.versions.set_instance": "Set one plugin instance's version binding and restart it to apply the change.",
+    "plugin.versions.recycle": "Delete one plugin's installed source versions that are unreferenced and outside the retention window.",
+    "plugin.loglevel.get": "List one plugin's instances, including its host binding, with each instance's configured and effective log level.",
+    "plugin.loglevel.set": "Set one plugin instance's log-level override, taking effect immediately without following the global log level.",
+    "plugin.loglevel.clear": "Clear one plugin instance's log-level override so it immediately follows the global log level again.",
+    "plugin.default_target.set": "Set one plugin instance as the plugin's default call target, automatically clearing any previous default.",
+    "plugin.default_target.clear": "Clear one plugin instance's default-call-target flag, only if it is the plugin's current default.",
 }
 
 
@@ -245,6 +253,7 @@
     "completed_episode": "Highest episode number already completed for the subscription.",
     "current_site_id": "Configured site ID currently handling the subscription execution.",
     "cookie": "Site authentication cookie. Treat this value as a secret.",
+    "configured_level": "Plugin instance's own configured log-level override, null when unset or expired.",
     "count": "Maximum number of records to return on the requested page.",
     "current_audio_format": "Audio format of the best version currently held.",
     "current_bit_depth": "Bit depth of the best version currently held.",
@@ -272,6 +281,7 @@
     "douban_sort": "Douban Music category order: U for comprehensive, S for rating, R for newest, or O for hottest.",
     "drive_id": "Provider-native storage drive identifier.",
     "effect": "Video or release-effect filter expression used by the subscription.",
+    "effective_level": "Plugin instance's actual log level after resolving its override and expiry against the global log level.",
     "error": "Human-readable workflow, provider, or execution error message.",
     "entity": "Music exploration entity: recording for tracks or album for release groups.",
     "enclosure": "Torrent download URL or enclosure supplied by the indexer result.",
@@ -284,6 +294,7 @@
     "episodes": "Episode-number expression recorded in history, such as E01-E03.",
     "errmsg": "Error message recorded for a failed transfer.",
     "expected_revision": "Exact current plugin source-identity revision returned by plugin.source.options.",
+    "expires_at": "Expiry timestamp for a plugin instance's log-level override; null means it never expires.",
     "exclude": "Regular expression or filter expression that rejects matching releases.",
     "extension": "Filename extension, including or excluding the leading dot as returned by storage.",
     "fileid": "Provider-native storage item identifier.",
@@ -292,6 +303,7 @@
     "files": "Serialized list of files recorded by the history item.",
     "filter": "Named filter rule or rule expression applied to this site or subscription.",
     "filter_groups": "Ordered filter-rule group names applied to the subscription.",
+    "follow_current_version": "Follow the plugin's currently installed version instead of a pinned one.",
     "force": "Force a marketplace refresh or plugin installation when true.",
     "freedate": "Torrent freeleech expiration timestamp reported by the site.",
     "freedate_diff": "Seconds remaining until the torrent freeleech period ends.",
@@ -310,13 +322,16 @@
     "include_group_refs": "Include custom rules referenced only through rule groups.",
     "include_usage": "Include the subscriptions or defaults that reference each rule group.",
     "include_values": "Return complete setting values instead of discovery summaries.",
+    "instance_id": "Exact plugin instance ID returned by plugin.versions.get.",
     "is_active": "Whether the configured site is enabled.",
+    "is_default_target": "Whether this plugin instance is the plugin's default call target, used when a caller does not specify an instance.",
     "jobid": "Exact scheduler job ID returned by scheduler.list.",
     "key": "Optional exact plugin data key used to narrow the returned preview.",
     "keyword": "Case-insensitive substring used to discover settings or filter storage entries.",
     "labels": "Torrent labels supplied by the site result.",
     "lack_episode": "Number of episodes still missing from the subscription.",
     "last_update": "Timestamp of the subscription's most recent update.",
+    "level": "Target log level, one of DEBUG, INFO, WARNING, ERROR, or CRITICAL.",
     "library_category_folder": "Create or use a category-level folder in the target library.",
     "library_type_folder": "Create or use a media-type folder in the target library.",
     "limit_count": "Maximum number of site requests allowed in one rate-limit interval.",
@@ -365,6 +380,7 @@
     "person_id": "Source-native person ID returned by person search.",
     "pickcode": "115 storage pickcode associated with the item.",
     "plugin_id": "Exact installed or marketplace plugin ID.",
+    "plugin_version": "Exact installed plugin version; required only when not following the current version.",
     "poster": "Poster image URL stored with the media or subscription.",
     "preview": "Validate and preview manual-transfer output without committing file changes.",
     "pri": "Site search priority; lower or higher ordering follows the existing site API convention.",
@@ -567,6 +583,8 @@
     "MediaSource": "Canonical metadata source identifier paired with a source-native media ID.",
     "MediaType": "MoviePilot media type.",
     "MusicRecognizeRequest": "Exact source-native recording or album identity to resolve into canonical music metadata.",
+    "PluginInstanceLogLevelUpdateRequest": "One plugin instance's log-level override update request.",
+    "PluginInstanceVersionUpdateRequest": "One plugin instance's version-binding update request.",
     "PluginSourceChangeRequest": "Explicit online-source change request guarded by the current identity revision.",
     "PluginSourceInstallRequest": "Explicit online-source installation request for an unbound plugin.",
     "Site-Input": "Complete site configuration and runtime state.",