feat: auto-detect counterpart plugins when installing from marketplace

When selecting plugins from the market, automatically find matching
frontend/backend counterparts (by name ↔ name_ui convention), skip
those already installed locally or already selected, and prompt the
user to install them together.

Made-with: Cursor

Author: yuWorm

src/commands/plugin/add.ts

@@ -1,13 +1,12 @@
 // plugin/add.ts — 插件添加
 import * as clack from '@clack/prompts'
 import chalk from 'chalk'
-import { basename } from 'path'
 import { t } from '../../lib/i18n.js'
 import { requireProjectDir, fatal } from '../../lib/errors.js'
-import { fetchPluginMarketData, filterByType, getMarketPluginType } from '../../lib/plugin-market.js'
-import { installFromMarket, installFrontendPlugin, installBackendPlugin, runPnpmInstall } from '../../lib/plugin-install.js'
+import { fetchPluginMarketData, filterByType, getMarketPluginType, findCounterparts } from '../../lib/plugin-market.js'
+import { installFromMarket, installFrontendPlugin, installBackendPlugin, runPnpmInstall, scanInstalledPlugins } from '../../lib/plugin-install.js'
 import type { PluginData } from '../../types/plugin.js'
-import { inferPluginType, stripWebPluginSuffix } from '../../types/plugin.js'
+import { stripWebPluginSuffix } from '../../types/plugin.js'
 
 /**
  * fba plugin add — 添加插件
@@ -114,10 +113,33 @@ export async function pluginMarketFlow(projectDir: string) {
   })
   if (clack.isCancel(selected) || selected.length === 0) return
 
-  const selectedPlugins = selected
+  let selectedPlugins = selected
     .map(i => filtered[i as number])
     .filter((p): p is PluginData => p !== undefined)
 
+  // 配套插件检测
+  const installed = scanInstalledPlugins(projectDir)
+  const counterparts = findCounterparts(selectedPlugins, plugins, installed)
+
+  if (counterparts.length > 0) {
+    const cpSelected = await clack.multiselect({
+      message: `${t('pluginCounterpartFound')} ${chalk.dim(t('multiselectHint'))}`,
+      options: counterparts.map((p, i) => ({
+        value: i,
+        label: `${p.plugin.summary}`,
+        hint: `${t('pluginCounterpartHint')} | ${getMarketPluginType(p)} | @${p.plugin.author}`,
+      })),
+      initialValues: counterparts.map((_, i) => i),
+      required: false,
+    })
+    if (!clack.isCancel(cpSelected) && cpSelected.length > 0) {
+      const extras = cpSelected
+        .map(i => counterparts[i as number])
+        .filter((p): p is PluginData => p !== undefined)
+      selectedPlugins = [...selectedPlugins, ...extras]
+    }
+  }
+
   // 安装
   clack.log.step(t('pluginInstalling'))
   const installResult = await installFromMarket(projectDir, selectedPlugins)

src/lib/i18n.ts

@@ -110,6 +110,8 @@ const messages = {
     pluginMarketTitle: "FBA 插件市场",
     pluginSearch: "搜索",
     pluginFilter: "筛选",
+    pluginCounterpartFound: "以下插件有配套的前/后端插件，是否一并安装？",
+    pluginCounterpartHint: "配套",
     pluginInstalling: "正在安装插件...",
     pluginInstallSuccess: "插件安装成功",
     pluginInstallFail: "插件安装失败",
@@ -208,8 +210,12 @@ const messages = {
 
     // Go
     goEnteringProject: "进入项目:",
+    goEnteringBackend: "进入后端目录:",
+    goEnteringFrontend: "进入前端目录:",
     goShell: "Shell:",
     goExitHint: '输入 "exit" 或 Ctrl+D 返回',
+    optGoServer: "进入后端 (server) 目录",
+    optGoFrontend: "进入前端 (web) 目录",
 
     // Remove
     removeSelectProjects: "选择要移除的项目",
@@ -381,6 +387,8 @@ const messages = {
     pluginMarketTitle: "FBA Plugin Marketplace",
     pluginSearch: "Search",
     pluginFilter: "Filter",
+    pluginCounterpartFound: "The following plugins have matching frontend/backend counterparts. Install them too?",
+    pluginCounterpartHint: "counterpart",
     pluginInstalling: "Installing plugins...",
     pluginInstallSuccess: "Plugin installed",
     pluginInstallFail: "Plugin installation failed",
@@ -474,8 +482,12 @@ const messages = {
     validOptions: "Valid options",
 
     goEnteringProject: "Entering project:",
+    goEnteringBackend: "Entering backend directory:",
+    goEnteringFrontend: "Entering frontend directory:",
     goShell: "Shell:",
     goExitHint: 'Type "exit" or Ctrl+D to return',
+    optGoServer: "Enter backend (server) directory",
+    optGoFrontend: "Enter frontend (web) directory",
 
     removeSelectProjects: "Select projects to remove",
     removeConfirm:

src/lib/plugin-market.ts

@@ -5,7 +5,8 @@ import { homedir } from 'os'
 import { ofetch } from 'ofetch'
 import { basename } from 'path'
 import type { PluginData } from '../types/plugin.js'
-import { inferPluginType } from '../types/plugin.js'
+import { inferPluginType, PLUGIN_WEB_SUFFIX, stripWebPluginSuffix } from '../types/plugin.js'
+import type { InstalledPlugin } from '../types/plugin.js'
 
 const PLUGIN_DATA_URL =
   'https://raw.githubusercontent.com/fastapi-practices/plugins/refs/heads/master/plugins-data.ts'
@@ -74,3 +75,44 @@ export function filterByType(plugins: PluginData[], type: string): PluginData[]
 export function getMarketPluginType(p: PluginData): 'web' | 'server' {
   return inferPluginType(basename(p.git.path))
 }
+
+/**
+ * 在市场数据中查找已选插件的未选配套插件（前端 ↔ 后端）
+ *
+ * 排除：已被用户选中的、本地已安装的
+ */
+export function findCounterparts(
+  selected: PluginData[],
+  allPlugins: PluginData[],
+  installedPlugins: InstalledPlugin[],
+): PluginData[] {
+  const selectedPaths = new Set(selected.map(p => basename(p.git.path)))
+  const installedNames = new Set(installedPlugins.map(p => p.name))
+
+  const counterparts: PluginData[] = []
+  const seen = new Set<string>()
+
+  for (const sel of selected) {
+    const name = basename(sel.git.path)
+    const type = inferPluginType(name)
+
+    // server → 找 name_ui ; web → 找去掉 _ui
+    const counterpartName = type === 'server'
+      ? `${name}${PLUGIN_WEB_SUFFIX}`
+      : stripWebPluginSuffix(name)
+
+    if (selectedPaths.has(counterpartName)) continue
+    if (installedNames.has(counterpartName)) continue
+    // 前端插件本地目录名是去掉 _ui 的
+    if (type === 'server' && installedNames.has(stripWebPluginSuffix(counterpartName))) continue
+    if (seen.has(counterpartName)) continue
+
+    const match = allPlugins.find(p => basename(p.git.path) === counterpartName)
+    if (match) {
+      counterparts.push(match)
+      seen.add(counterpartName)
+    }
+  }
+
+  return counterparts
+}