From beb0506b0c3b888ffc8e7b068c4807481b751efe Mon Sep 17 00:00:00 2001
From: jxxghp <jxxghp@gmail.com>
Date: Wed, 20 May 2026 19:55:44 +0800
Subject: [PATCH] feat: show plugin system version compatibility

---
 src/api/types.ts                              |  6 +++++
 src/components/cards/PluginCard.vue           |  5 ++++
 .../dialog/PluginMarketDetailDialog.vue       | 26 ++++++++++++++++++-
 .../dialog/PluginVersionHistoryDialog.vue     | 10 ++++++-
 src/locales/en-US.ts                          |  2 ++
 src/locales/zh-CN.ts                          |  2 ++
 src/views/plugin/PluginCardListView.vue       |  8 ++++++
 7 files changed, 57 insertions(+), 2 deletions(-)

diff --git a/src/api/types.ts b/src/api/types.ts
index f7670926..39fc967b 100644
--- a/src/api/types.ts
+++ b/src/api/types.ts
@@ -646,6 +646,12 @@ export interface Plugin {
   has_page?: boolean
   // 是否有新版本
   has_update?: boolean
+  // 主系统版本是否兼容
+  system_version_compatible?: boolean
+  // 主系统版本兼容提示
+  system_version_message?: string
+  // 主系统版本限定范围
+  system_version?: string
   // 是否本地插件
   is_local?: boolean
   // 插件仓库地址
diff --git a/src/components/cards/PluginCard.vue b/src/components/cards/PluginCard.vue
index c21b3ab4..0ae3ba6f 100644
--- a/src/components/cards/PluginCard.vue
+++ b/src/components/cards/PluginCard.vue
@@ -226,6 +226,11 @@ async function resetPlugin() {
 
 // 更新插件
 async function updatePlugin() {
+  if (props.plugin?.system_version_compatible === false) {
+    $toast.error(props.plugin?.system_version_message || t('plugin.incompatibleSystemVersion'))
+    return
+  }
+
   try {
     // 显示等待提示框
     showPluginProgress(t('plugin.updating', { name: props.plugin?.plugin_name }))
diff --git a/src/components/dialog/PluginMarketDetailDialog.vue b/src/components/dialog/PluginMarketDetailDialog.vue
index a545c33f..5793d3ee 100644
--- a/src/components/dialog/PluginMarketDetailDialog.vue
+++ b/src/components/dialog/PluginMarketDetailDialog.vue
@@ -98,6 +98,11 @@ function visitPluginPage() {
 
 /** 安装插件并通知父级刷新市场列表。 */
 async function installPlugin() {
+  if (props.plugin?.system_version_compatible === false) {
+    $toast.error(props.plugin?.system_version_message || t('plugin.incompatibleSystemVersion'))
+    return
+  }
+
   try {
     showInstallProgress(
       t('plugin.installing', {
@@ -176,9 +181,28 @@ onUnmounted(() => {
                       </span>
                     </VListItemTitle>
                   </VListItem>
+                  <VListItem v-if="props.plugin?.system_version" class="ps-0">
+                    <VListItemTitle class="text-center text-md-left">
+                      <span class="font-weight-medium">{{ t('plugin.systemVersion') }}：</span>
+                      <span class="text-body-1">{{ props.plugin?.system_version }}</span>
+                    </VListItemTitle>
+                  </VListItem>
                 </VList>
+                <VAlert
+                  v-if="props.plugin?.system_version_compatible === false"
+                  type="warning"
+                  variant="tonal"
+                  density="compact"
+                  class="mb-3"
+                  :text="props.plugin?.system_version_message || t('plugin.incompatibleSystemVersion')"
+                />
                 <div class="text-center text-md-left">
-                  <VBtn color="primary" @click="installPlugin" prepend-icon="mdi-download">
+                  <VBtn
+                    color="primary"
+                    @click="installPlugin"
+                    prepend-icon="mdi-download"
+                    :disabled="props.plugin?.system_version_compatible === false"
+                  >
                     {{ t('plugin.installToLocal') }}
                   </VBtn>
                   <div class="text-xs mt-2" v-if="props.count">
diff --git a/src/components/dialog/PluginVersionHistoryDialog.vue b/src/components/dialog/PluginVersionHistoryDialog.vue
index af0997d6..a4742882 100644
--- a/src/components/dialog/PluginVersionHistoryDialog.vue
+++ b/src/components/dialog/PluginVersionHistoryDialog.vue
@@ -49,7 +49,15 @@ function handleUpdate() {
       <template v-if="props.showUpdateAction">
         <VDivider />
         <VCardItem>
-          <VBtn @click="handleUpdate" block>
+          <VAlert
+            v-if="props.plugin?.system_version_compatible === false"
+            type="warning"
+            variant="tonal"
+            density="compact"
+            class="mb-3"
+            :text="props.plugin?.system_version_message || t('plugin.incompatibleSystemVersion')"
+          />
+          <VBtn @click="handleUpdate" block :disabled="props.plugin?.system_version_compatible === false">
             <template #prepend>
               <VIcon icon="mdi-arrow-up-circle-outline" />
             </template>
diff --git a/src/locales/en-US.ts b/src/locales/en-US.ts
index f1faf345..c3b33194 100644
--- a/src/locales/en-US.ts
+++ b/src/locales/en-US.ts
@@ -2842,6 +2842,8 @@ export default {
     projectHome: 'Project Home',
     updateHistory: 'Update History',
     local: 'Local',
+    systemVersion: 'System Version',
+    incompatibleSystemVersion: 'The current MoviePilot version does not meet this plugin requirement.',
     installToLocal: 'Install to Local',
     totalDownloads: 'Total {count} downloads',
     viewData: 'View Data',
diff --git a/src/locales/zh-CN.ts b/src/locales/zh-CN.ts
index ea11e717..b82cbc7f 100644
--- a/src/locales/zh-CN.ts
+++ b/src/locales/zh-CN.ts
@@ -2795,6 +2795,8 @@ export default {
     projectHome: '项目主页',
     updateHistory: '更新说明',
     local: '本地',
+    systemVersion: '系统版本',
+    incompatibleSystemVersion: '当前 MoviePilot 版本不满足插件要求，无法安装',
     installToLocal: '安装到本地',
     totalDownloads: '共 {count} 次下载',
     viewData: '查看数据',
diff --git a/src/views/plugin/PluginCardListView.vue b/src/views/plugin/PluginCardListView.vue
index c79ed7cc..380637e4 100644
--- a/src/views/plugin/PluginCardListView.vue
+++ b/src/views/plugin/PluginCardListView.vue
@@ -665,6 +665,11 @@ function closePluginProgressDialog() {
 
 // 安装插件
 async function installPlugin(item: Plugin) {
+  if (item?.system_version_compatible === false) {
+    $toast.error(item.system_version_message || t('plugin.incompatibleSystemVersion'))
+    return
+  }
+
   try {
     // 显示等待提示框
     progressText.value = t('plugin.installing', { name: item?.plugin_name, version: item?.plugin_version })
@@ -775,6 +780,9 @@ async function fetchUninstalledPlugins(force: boolean = false, context: KeepAliv
           data.has_update = true
           data.repo_url = uninstalled.repo_url
           data.history = uninstalled.history
+          data.system_version = uninstalled.system_version
+          data.system_version_compatible = uninstalled.system_version_compatible
+          data.system_version_message = uninstalled.system_version_message
         }
       }
     }