From 23ca574a8196809f1157e4a75b6a9a1c89b1eaba Mon Sep 17 00:00:00 2001
From: DrSmoothl <1787882683@qq.com>
Date: Sat, 2 May 2026 19:08:24 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E6=B7=BB=E5=8A=A0=E8=8E=B7=E5=8F=96?=
 =?UTF-8?q?=E4=B8=8D=E5=85=BC=E5=AE=B9=E5=8E=9F=E5=9B=A0=E7=9A=84=E5=8A=9F?=
 =?UTF-8?q?=E8=83=BD=EF=BC=8C=E4=BC=98=E5=8C=96=E6=8F=92=E4=BB=B6=E5=85=BC?=
 =?UTF-8?q?=E5=AE=B9=E6=80=A7=E6=8F=90=E7=A4=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 dashboard/src/routes/plugins/InstalledTab.tsx |  3 +
 .../src/routes/plugins/MarketplaceTab.tsx     |  3 +
 dashboard/src/routes/plugins/PluginCard.tsx   | 14 ++++-
 dashboard/src/routes/plugins/index.tsx        | 57 +++++++++++++++++--
 4 files changed, 69 insertions(+), 8 deletions(-)

diff --git a/dashboard/src/routes/plugins/InstalledTab.tsx b/dashboard/src/routes/plugins/InstalledTab.tsx
index a2ffe04d..3447f949 100644
--- a/dashboard/src/routes/plugins/InstalledTab.tsx
+++ b/dashboard/src/routes/plugins/InstalledTab.tsx
@@ -16,6 +16,7 @@ interface InstalledTabProps {
   checkPluginCompatibility: (plugin: PluginInfo) => boolean
   needsUpdate: (plugin: PluginInfo) => boolean
   getStatusBadge: (plugin: PluginInfo) => React.JSX.Element | null
+  getIncompatibleReason: (plugin: PluginInfo) => string | null
 }
 
 export function InstalledTab({
@@ -33,6 +34,7 @@ export function InstalledTab({
   checkPluginCompatibility,
   needsUpdate,
   getStatusBadge,
+  getIncompatibleReason,
 }: InstalledTabProps) {
   // 过滤已安装插件
   const filteredPlugins = plugins.filter(plugin => {
@@ -80,6 +82,7 @@ export function InstalledTab({
           checkPluginCompatibility={checkPluginCompatibility}
           needsUpdate={needsUpdate}
           getStatusBadge={getStatusBadge}
+          getIncompatibleReason={getIncompatibleReason}
         />
       ))}
     </div>
diff --git a/dashboard/src/routes/plugins/MarketplaceTab.tsx b/dashboard/src/routes/plugins/MarketplaceTab.tsx
index bcd4b8c2..e623530c 100644
--- a/dashboard/src/routes/plugins/MarketplaceTab.tsx
+++ b/dashboard/src/routes/plugins/MarketplaceTab.tsx
@@ -16,6 +16,7 @@ interface MarketplaceTabProps {
   checkPluginCompatibility: (plugin: PluginInfo) => boolean
   needsUpdate: (plugin: PluginInfo) => boolean
   getStatusBadge: (plugin: PluginInfo) => React.JSX.Element | null
+  getIncompatibleReason: (plugin: PluginInfo) => string | null
 }
 
 export function MarketplaceTab({
@@ -33,6 +34,7 @@ export function MarketplaceTab({
   checkPluginCompatibility,
   needsUpdate,
   getStatusBadge,
+  getIncompatibleReason,
 }: MarketplaceTabProps) {
   // 过滤插件
   const filteredPlugins = plugins.filter(plugin => {
@@ -76,6 +78,7 @@ export function MarketplaceTab({
           checkPluginCompatibility={checkPluginCompatibility}
           needsUpdate={needsUpdate}
           getStatusBadge={getStatusBadge}
+          getIncompatibleReason={getIncompatibleReason}
         />
       ))}
     </div>
diff --git a/dashboard/src/routes/plugins/PluginCard.tsx b/dashboard/src/routes/plugins/PluginCard.tsx
index ad6d3f1e..93a0fdb1 100644
--- a/dashboard/src/routes/plugins/PluginCard.tsx
+++ b/dashboard/src/routes/plugins/PluginCard.tsx
@@ -20,6 +20,7 @@ interface PluginCardProps {
   checkPluginCompatibility: (plugin: PluginInfo) => boolean
   needsUpdate: (plugin: PluginInfo) => boolean
   getStatusBadge: (plugin: PluginInfo) => React.JSX.Element | null
+  getIncompatibleReason: (plugin: PluginInfo) => string | null
 }
 
 export function PluginCard({
@@ -34,6 +35,7 @@ export function PluginCard({
   checkPluginCompatibility,
   needsUpdate,
   getStatusBadge,
+  getIncompatibleReason,
 }: PluginCardProps) {
   const navigate = useNavigate()
 
@@ -114,8 +116,14 @@ export function PluginCard({
             needsUpdate(plugin) ? (
               <Button 
                 size="sm"
-                disabled={!gitStatus?.installed}
-                title={!gitStatus?.installed ? 'Git 未安装' : undefined}
+                disabled={!gitStatus?.installed || (maimaiVersion !== null && !checkPluginCompatibility(plugin))}
+                title={
+                  !gitStatus?.installed
+                    ? 'Git 未安装'
+                    : (maimaiVersion !== null && !checkPluginCompatibility(plugin))
+                      ? (getIncompatibleReason(plugin) ?? '插件与当前麦麦版本不兼容')
+                      : undefined
+                }
                 onClick={() => onUpdate(plugin)}
               >
                 <RefreshCw className="h-4 w-4 mr-1" />
@@ -145,7 +153,7 @@ export function PluginCard({
                 !gitStatus?.installed 
                   ? 'Git 未安装' 
                   : (maimaiVersion !== null && !checkPluginCompatibility(plugin))
-                    ? `不兼容当前版本 (需要 ${plugin.manifest?.host_application?.min_version || '未知'}${plugin.manifest?.host_application?.max_version ? ` - ${plugin.manifest.host_application.max_version}` : '+'}，当前 ${maimaiVersion?.version})`
+                    ? (getIncompatibleReason(plugin) ?? '插件与当前麦麦版本不兼容')
                     : undefined
               }
               onClick={() => onInstall(plugin)}
diff --git a/dashboard/src/routes/plugins/index.tsx b/dashboard/src/routes/plugins/index.tsx
index 2446c570..51013669 100644
--- a/dashboard/src/routes/plugins/index.tsx
+++ b/dashboard/src/routes/plugins/index.tsx
@@ -268,8 +268,8 @@ function PluginsPageContent() {
 
   // 获取插件状态徽章
   const getStatusBadge = (plugin: PluginInfo) => {
-    // 优先显示兼容性状态
-    if (!plugin.installed && maimaiVersion && !checkPluginCompatibility(plugin)) {
+    // 优先显示兼容性状态（已安装但不兼容也需要提示，避免用户误以为可继续更新）
+    if (maimaiVersion && !checkPluginCompatibility(plugin)) {
       return (
         <Badge variant="destructive" className="gap-1">
           <AlertCircle className="h-3 w-3" />
@@ -317,9 +317,20 @@ function PluginsPageContent() {
   }
 
   // 检查插件兼容性
+  // 规则：
+  // 1. manifest_version === 1 的插件在麦麦 >= 1.0.0 时一律视为不兼容（旧 manifest 已不再被宿主接受）；
+  // 2. 否则若声明了 host_application 范围，则按版本范围判定。
   const checkPluginCompatibility = (plugin: PluginInfo): boolean => {
-    if (!maimaiVersion || !plugin.manifest?.host_application) return true
-    
+    if (!maimaiVersion) return true
+
+    // manifest v1 在 1.0.0+ 麦麦上不再兼容
+    const manifestVersion = plugin.manifest?.manifest_version ?? 1
+    if (manifestVersion <= 1 && maimaiVersion.version_major >= 1) {
+      return false
+    }
+
+    if (!plugin.manifest?.host_application) return true
+
     return isPluginCompatible(
       plugin.manifest.host_application.min_version,
       plugin.manifest.host_application.max_version,
@@ -327,11 +338,35 @@ function PluginsPageContent() {
     )
   }
 
+  // 不兼容原因（用于 UI 提示）
+  const getIncompatibleReason = (plugin: PluginInfo): string | null => {
+    if (!maimaiVersion) return null
+    const manifestVersion = plugin.manifest?.manifest_version ?? 1
+    if (manifestVersion <= 1 && maimaiVersion.version_major >= 1) {
+      return `该插件使用旧版 manifest (v${manifestVersion})，已不被麦麦 ${maimaiVersion.version} 支持`
+    }
+    if (plugin.manifest?.host_application && !isPluginCompatible(
+      plugin.manifest.host_application.min_version,
+      plugin.manifest.host_application.max_version,
+      maimaiVersion
+    )) {
+      const min = plugin.manifest.host_application.min_version || '未知'
+      const max = plugin.manifest.host_application.max_version
+      const range = max ? `${min} - ${max}` : `${min}+`
+      return `不兼容当前版本 (需要 ${range}，当前 ${maimaiVersion.version})`
+    }
+    return null
+  }
+
   // 检查是否需要更新（市场版本比已安装版本新）
   const needsUpdate = (plugin: PluginInfo): boolean => {
     if (!plugin.installed || !plugin.installed_version || !plugin.manifest?.version) {
       return false
     }
+    // 不兼容的插件不允许更新
+    if (!checkPluginCompatibility(plugin)) {
+      return false
+    }
     
     const installedVer = plugin.installed_version.trim()
     const marketVer = plugin.manifest.version.trim()
@@ -368,7 +403,7 @@ function PluginsPageContent() {
     if (maimaiVersion && !checkPluginCompatibility(plugin)) {
       toast({
         title: '无法安装',
-        description: '插件与当前麦麦版本不兼容',
+        description: getIncompatibleReason(plugin) ?? '插件与当前麦麦版本不兼容',
         variant: 'destructive',
       })
       return
@@ -526,6 +561,16 @@ function PluginsPageContent() {
       return
     }
 
+    // 不兼容的插件不允许更新
+    if (maimaiVersion && !checkPluginCompatibility(plugin)) {
+      toast({
+        title: '无法更新',
+        description: getIncompatibleReason(plugin) ?? '插件与当前麦麦版本不兼容',
+        variant: 'destructive',
+      })
+      return
+    }
+
     try {
       const updateResult = await updatePlugin(
         plugin.id,
@@ -833,6 +878,7 @@ function PluginsPageContent() {
             checkPluginCompatibility={checkPluginCompatibility}
             needsUpdate={needsUpdate}
             getStatusBadge={getStatusBadge}
+            getIncompatibleReason={getIncompatibleReason}
           />
         ) : activeTab === 'installed' ? (
           <InstalledTab
@@ -850,6 +896,7 @@ function PluginsPageContent() {
             checkPluginCompatibility={checkPluginCompatibility}
             needsUpdate={needsUpdate}
             getStatusBadge={getStatusBadge}
+            getIncompatibleReason={getIncompatibleReason}
           />
         ) : (
           <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-6">