Explorar el Código

feat: add cloud plugin management and hot-reload upgrade dispatch UI

jerry hace 2 meses
padre
commit
dff9d404c9

+ 343 - 0
src/app/admin/plugins/page.tsx

@@ -0,0 +1,343 @@
+// src/app/admin/plugins/page.tsx
+'use client';
+
+import { useEffect, useState, useMemo, useCallback } from 'react';
+import {
+  Puzzle,
+  Plus,
+  Zap,
+  RefreshCw,
+  Search,
+  CheckCircle2,
+  XCircle,
+  Layers,
+  Sparkles,
+  Server,
+  FileCode,
+} from 'lucide-react';
+import { pluginService } from '@/lib/services/pluginService';
+import { PluginItem, PluginDetail } from '@/types';
+import PluginTable from '@/components/admin/plugins/PluginTable';
+import PluginPublishModal from '@/components/admin/plugins/PluginPublishModal';
+import PluginDetailDrawer from '@/components/admin/plugins/PluginDetailDrawer';
+import PluginUpgradeDispatchModal from '@/components/admin/plugins/PluginUpgradeDispatchModal';
+import PluginEditModal from '@/components/admin/plugins/PluginEditModal';
+
+export default function AdminPluginsPage() {
+  const [plugins, setPlugins] = useState<PluginItem[]>([]);
+  const [loading, setLoading] = useState(true);
+  const [keyword, setKeyword] = useState('');
+  const [statusFilter, setStatusFilter] = useState<string>('all');
+
+  // Modals & Drawers State
+  const [isPublishModalOpen, setIsPublishModalOpen] = useState(false);
+  const [publishTargetPlugin, setPublishTargetPlugin] = useState<PluginItem | null>(null);
+
+  const [selectedDrawerPluginId, setSelectedDrawerPluginId] = useState<number | null>(null);
+  const [isDrawerOpen, setIsDrawerOpen] = useState(false);
+
+  const [isUpgradeModalOpen, setIsUpgradeModalOpen] = useState(false);
+  const [upgradeTargetPluginName, setUpgradeTargetPluginName] = useState<string | null>(null);
+
+  const [isEditModalOpen, setIsEditModalOpen] = useState(false);
+  const [editingPlugin, setEditingPlugin] = useState<PluginItem | null>(null);
+
+  const fetchPlugins = useCallback(async () => {
+    setLoading(true);
+    try {
+      const res = await pluginService.getList();
+      if (res.code === 0 && res.data) {
+        const list = res.data.list || (Array.isArray(res.data) ? res.data : []);
+        setPlugins(list);
+      } else {
+        // 若直接返回数组或包装对象
+        const list = res.data?.list || res.list || [];
+        setPlugins(list);
+      }
+    } catch (e: any) {
+      console.error('Fetch plugins error:', e);
+      // 避免空数据时阻塞界面
+      setPlugins([]);
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    fetchPlugins();
+  }, [fetchPlugins]);
+
+  // 过滤处理
+  const filteredPlugins = useMemo(() => {
+    return plugins.filter((item) => {
+      const query = keyword.trim().toLowerCase();
+      const matchKeyword =
+        !query ||
+        item.name.toLowerCase().includes(query) ||
+        (item.display_name && item.display_name.toLowerCase().includes(query)) ||
+        (item.description && item.description.toLowerCase().includes(query));
+
+      const matchStatus =
+        statusFilter === 'all' ||
+        (statusFilter === 'active' && item.status === 1) ||
+        (statusFilter === 'disabled' && item.status === 0);
+
+      return matchKeyword && matchStatus;
+    });
+  }, [plugins, keyword, statusFilter]);
+
+  // 统计指标
+  const stats = useMemo(() => {
+    const total = plugins.length;
+    const active = plugins.filter((p) => p.status === 1).length;
+    const disabled = total - active;
+    return { total, active, disabled };
+  }, [plugins]);
+
+  // Handlers
+  const handleOpenPublishNew = () => {
+    setPublishTargetPlugin(null);
+    setIsPublishModalOpen(true);
+  };
+
+  const handleOpenPublishVersion = (plugin: PluginItem | PluginDetail) => {
+    setPublishTargetPlugin(plugin as PluginItem);
+    setIsPublishModalOpen(true);
+  };
+
+  const handleOpenVersionsDrawer = (plugin: PluginItem) => {
+    setSelectedDrawerPluginId(plugin.id);
+    setIsDrawerOpen(true);
+  };
+
+  const handleOpenGlobalUpgradeModal = () => {
+    setUpgradeTargetPluginName(null);
+    setIsUpgradeModalOpen(true);
+  };
+
+  const handleQuickDispatchUpgrade = (plugin: PluginItem) => {
+    setUpgradeTargetPluginName(plugin.name);
+    setIsUpgradeModalOpen(true);
+  };
+
+  const handleOpenEdit = (plugin: PluginItem) => {
+    setEditingPlugin(plugin);
+    setIsEditModalOpen(true);
+  };
+
+  const handleDeletePlugin = async (plugin: PluginItem) => {
+    if (
+      !confirm(
+        `确定要永久删除插件【${plugin.display_name || plugin.name}】及其所有历史版本吗?\n此操作不可恢复!`
+      )
+    ) {
+      return;
+    }
+
+    try {
+      const res = await pluginService.deletePlugin(plugin.id);
+      if (res.code === 0 || res.code === undefined) {
+        fetchPlugins();
+      } else {
+        alert(res.msg || '删除失败');
+      }
+    } catch (e: any) {
+      console.error(e);
+      alert('删除失败: ' + (e.response?.data?.msg || e.message || '未知错误'));
+    }
+  };
+
+  return (
+    <div className="space-y-6 animate-fadeIn pb-12">
+      {/* 顶部标题与主要操作 */}
+      <div className="flex flex-col sm:flex-row sm:items-center justify-between gap-4 bg-white p-6 rounded-2xl border border-slate-200 shadow-sm">
+        <div className="flex items-center gap-4">
+          <div className="w-12 h-12 rounded-2xl bg-blue-600/10 text-blue-600 flex items-center justify-center font-bold">
+            <Puzzle size={26} />
+          </div>
+          <div>
+            <h1 className="text-xl font-black text-slate-900 flex items-center gap-2.5">
+              <span>插件管理与热重载分发</span>
+              <span className="text-xs font-semibold px-2.5 py-0.5 rounded-full bg-blue-100 text-blue-700">
+                Coordinate Engine
+              </span>
+            </h1>
+            <p className="text-xs text-slate-500 mt-1">
+              管理云端 Python 自动化插件包,发布新版本,并向节点集群广播热更指令
+            </p>
+          </div>
+        </div>
+
+        <div className="flex flex-wrap items-center gap-2.5">
+          {/* 下发集群升级 */}
+          <button
+            onClick={handleOpenGlobalUpgradeModal}
+            className="px-4 py-2.5 bg-purple-600 hover:bg-purple-700 active:bg-purple-800 text-white rounded-xl font-semibold text-xs shadow-md shadow-purple-500/20 flex items-center gap-2 transition"
+          >
+            <Zap size={16} />
+            下发集群升级
+          </button>
+
+          {/* 发布新插件 */}
+          <button
+            onClick={handleOpenPublishNew}
+            className="px-4 py-2.5 bg-blue-600 hover:bg-blue-700 active:bg-blue-800 text-white rounded-xl font-semibold text-xs shadow-md shadow-blue-500/20 flex items-center gap-2 transition"
+          >
+            <Plus size={16} />
+            发布新插件
+          </button>
+        </div>
+      </div>
+
+      {/* 指标卡片 */}
+      <div className="grid grid-cols-1 sm:grid-cols-3 gap-4">
+        <div className="bg-white p-5 rounded-2xl border border-slate-200 shadow-sm flex items-center justify-between">
+          <div>
+            <span className="text-xs font-semibold text-slate-400 uppercase tracking-wider block">
+              已注册插件总数
+            </span>
+            <span className="text-2xl font-black text-slate-900 mt-1 block font-mono">
+              {stats.total}
+            </span>
+          </div>
+          <div className="w-11 h-11 rounded-xl bg-blue-50 text-blue-600 flex items-center justify-center">
+            <Layers size={20} />
+          </div>
+        </div>
+
+        <div className="bg-white p-5 rounded-2xl border border-slate-200 shadow-sm flex items-center justify-between">
+          <div>
+            <span className="text-xs font-semibold text-slate-400 uppercase tracking-wider block">
+              启用运行中 (Active)
+            </span>
+            <span className="text-2xl font-black text-emerald-600 mt-1 block font-mono">
+              {stats.active}
+            </span>
+          </div>
+          <div className="w-11 h-11 rounded-xl bg-emerald-50 text-emerald-600 flex items-center justify-center">
+            <CheckCircle2 size={20} />
+          </div>
+        </div>
+
+        <div className="bg-white p-5 rounded-2xl border border-slate-200 shadow-sm flex items-center justify-between">
+          <div>
+            <span className="text-xs font-semibold text-slate-400 uppercase tracking-wider block">
+              已停用插件 (Disabled)
+            </span>
+            <span className="text-2xl font-black text-slate-400 mt-1 block font-mono">
+              {stats.disabled}
+            </span>
+          </div>
+          <div className="w-11 h-11 rounded-xl bg-slate-100 text-slate-500 flex items-center justify-center">
+            <XCircle size={20} />
+          </div>
+        </div>
+      </div>
+
+      {/* 搜索与过滤工具栏 */}
+      <div className="bg-white p-4 rounded-2xl border border-slate-200 shadow-sm flex flex-col sm:flex-row items-center justify-between gap-3">
+        <div className="relative w-full sm:w-80">
+          <Search
+            size={16}
+            className="absolute left-3.5 top-1/2 -translate-y-1/2 text-slate-400 pointer-events-none"
+          />
+          <input
+            type="text"
+            value={keyword}
+            onChange={(e) => setKeyword(e.target.value)}
+            placeholder="搜索插件名称、英文标识或描述..."
+            className="w-full pl-10 pr-4 py-2 rounded-xl border border-slate-200 text-xs focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white transition"
+          />
+        </div>
+
+        <div className="flex items-center gap-2.5 w-full sm:w-auto justify-end">
+          {/* 状态筛选 */}
+          <select
+            value={statusFilter}
+            onChange={(e) => setStatusFilter(e.target.value)}
+            className="px-3 py-2 rounded-xl border border-slate-200 text-xs font-medium bg-white text-slate-700 focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 cursor-pointer"
+          >
+            <option value="all">全部状态</option>
+            <option value="active">仅已启用 (Active)</option>
+            <option value="disabled">仅已停用 (Disabled)</option>
+          </select>
+
+          {/* 刷新按钮 */}
+          <button
+            onClick={fetchPlugins}
+            disabled={loading}
+            className="p-2 text-slate-500 hover:text-slate-800 hover:bg-slate-100 rounded-xl transition border border-slate-200 disabled:opacity-50"
+            title="刷新数据"
+          >
+            <RefreshCw size={16} className={loading ? 'animate-spin text-blue-600' : ''} />
+          </button>
+        </div>
+      </div>
+
+      {/* 插件列表表格 */}
+      <PluginTable
+        plugins={filteredPlugins}
+        loading={loading}
+        onOpenVersions={handleOpenVersionsDrawer}
+        onOpenPublishVersion={handleOpenPublishVersion}
+        onQuickDispatchUpgrade={handleQuickDispatchUpgrade}
+        onOpenEdit={handleOpenEdit}
+        onDelete={handleDeletePlugin}
+      />
+
+      {/* 发布插件 / 上传版本弹窗 */}
+      <PluginPublishModal
+        isOpen={isPublishModalOpen}
+        initialPlugin={publishTargetPlugin}
+        onClose={() => {
+          setIsPublishModalOpen(false);
+          setPublishTargetPlugin(null);
+        }}
+        onSuccess={() => {
+          fetchPlugins();
+          if (isDrawerOpen && selectedDrawerPluginId) {
+            // 触发抽屉内部刷新
+            setIsDrawerOpen(false);
+            setTimeout(() => setIsDrawerOpen(true), 100);
+          }
+        }}
+      />
+
+      {/* 历史版本管理与回滚抽屉 */}
+      <PluginDetailDrawer
+        isOpen={isDrawerOpen}
+        pluginId={selectedDrawerPluginId}
+        onClose={() => {
+          setIsDrawerOpen(false);
+          setSelectedDrawerPluginId(null);
+        }}
+        onRefreshList={fetchPlugins}
+        onOpenPublishVersion={(detail) => {
+          handleOpenPublishVersion(detail);
+        }}
+      />
+
+      {/* 集群升级指令下发弹窗 */}
+      <PluginUpgradeDispatchModal
+        isOpen={isUpgradeModalOpen}
+        pluginsList={plugins.filter((p) => p.status === 1)}
+        initialTargetPluginName={upgradeTargetPluginName}
+        onClose={() => {
+          setIsUpgradeModalOpen(false);
+          setUpgradeTargetPluginName(null);
+        }}
+      />
+
+      {/* 插件编辑弹窗 */}
+      <PluginEditModal
+        isOpen={isEditModalOpen}
+        plugin={editingPlugin}
+        onClose={() => {
+          setIsEditModalOpen(false);
+          setEditingPlugin(null);
+        }}
+        onSuccess={fetchPlugins}
+      />
+    </div>
+  );
+}

+ 2 - 1
src/components/admin/AdminSidebar.tsx

@@ -7,7 +7,7 @@ import {
   LayoutDashboard, ShoppingBag, LifeBuoy, Settings, LogOut, 
   Activity, CreditCard, Users, ChevronLeft, ChevronRight, 
   Plane, LucideIcon,
-  Menu, X, UserCog, Network, SlidersHorizontal
+  Menu, X, UserCog, Network, SlidersHorizontal, Puzzle
 } from 'lucide-react';
 
 interface MenuItem {
@@ -32,6 +32,7 @@ export default function AdminSidebar() {
     { name: '支付配置', href: '/admin/payments', icon: CreditCard },
     { name: '商品配置', href: '/admin/products', icon: Settings },
     { name: '动态配置', href: '/admin/configurations', icon: SlidersHorizontal },
+    { name: '插件管理', href: '/admin/plugins', icon: Puzzle },
     { name: '系统任务', href: '/admin/tasks', icon: Activity },
     { name: '账号池管理', href: '/admin/accounts', icon: UserCog },
     { name: '代理管理', href: '/admin/proxies', icon: Network },

+ 393 - 0
src/components/admin/plugins/PluginDetailDrawer.tsx

@@ -0,0 +1,393 @@
+// src/components/admin/plugins/PluginDetailDrawer.tsx
+'use client';
+
+import { useState, useEffect, useCallback } from 'react';
+import {
+  X,
+  History,
+  CheckCircle2,
+  Copy,
+  Check,
+  Download,
+  RotateCcw,
+  Trash2,
+  Sparkles,
+  Plus,
+  Loader2,
+  FileCode,
+  Calendar,
+  Layers,
+  ArrowUpRight,
+} from 'lucide-react';
+import { pluginService } from '@/lib/services/pluginService';
+import { PluginDetail, PluginVersionItem } from '@/types';
+
+interface PluginDetailDrawerProps {
+  isOpen: boolean;
+  pluginId: number | null;
+  onClose: () => void;
+  onRefreshList: () => void;
+  onOpenPublishVersion: (detail: PluginDetail) => void;
+}
+
+export default function PluginDetailDrawer({
+  isOpen,
+  pluginId,
+  onClose,
+  onRefreshList,
+  onOpenPublishVersion,
+}: PluginDetailDrawerProps) {
+  const [detail, setDetail] = useState<PluginDetail | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [actionLoading, setActionLoading] = useState<string | null>(null);
+  const [copiedSha, setCopiedSha] = useState<string | null>(null);
+
+  const fetchDetail = useCallback(async () => {
+    if (!pluginId) return;
+    setLoading(true);
+    try {
+      const res = await pluginService.getDetail(pluginId);
+      if (res.code === 0 && res.data) {
+        setDetail(res.data);
+      } else {
+        alert(res.msg || '获取插件详情失败');
+      }
+    } catch (e: any) {
+      console.error(e);
+      alert('获取详情失败: ' + (e.response?.data?.msg || e.message || '未知错误'));
+    } finally {
+      setLoading(false);
+    }
+  }, [pluginId]);
+
+  useEffect(() => {
+    if (isOpen && pluginId) {
+      fetchDetail();
+    } else {
+      setDetail(null);
+    }
+  }, [isOpen, pluginId, fetchDetail]);
+
+  if (!isOpen) return null;
+
+  const handleCopySha = (sha: string) => {
+    navigator.clipboard.writeText(sha);
+    setCopiedSha(sha);
+    setTimeout(() => setCopiedSha(null), 2000);
+  };
+
+  const handleSwitchVersion = async (version: string) => {
+    if (!detail) return;
+    if (
+      !confirm(
+        `确定要将插件【${detail.display_name || detail.name}】的当前生效版本切换为【${version}】吗?\n切换后可通过升级下发命令推送给所有节点。`
+      )
+    ) {
+      return;
+    }
+
+    setActionLoading(`switch-${version}`);
+    try {
+      const res = await pluginService.switchVersion(detail.id, version);
+      if (res.code === 0) {
+        await fetchDetail();
+        onRefreshList();
+      } else {
+        alert(res.msg || '版本切换失败');
+      }
+    } catch (e: any) {
+      console.error(e);
+      alert('版本切换失败: ' + (e.response?.data?.msg || e.message || '未知错误'));
+    } finally {
+      setActionLoading(null);
+    }
+  };
+
+  const handleDeleteVersion = async (version: string) => {
+    if (!detail) return;
+    if (detail.latest_version === version) {
+      alert('该版本为当前生效版本,不可直接删除!请先切换至其他版本生效后再删除。');
+      return;
+    }
+    if (!confirm(`确定要删除历史版本【v${version}】吗?此操作无法撤销。`)) {
+      return;
+    }
+
+    setActionLoading(`delete-${version}`);
+    try {
+      const res = await pluginService.deleteVersion(detail.id, version);
+      if (res.code === 0) {
+        await fetchDetail();
+        onRefreshList();
+      } else {
+        alert(res.msg || '删除版本失败');
+      }
+    } catch (e: any) {
+      console.error(e);
+      alert('删除失败: ' + (e.response?.data?.msg || e.message || '未知错误'));
+    } finally {
+      setActionLoading(null);
+    }
+  };
+
+  return (
+    <div className="fixed inset-0 z-50 overflow-hidden bg-slate-900/50 backdrop-blur-sm animate-fadeIn">
+      {/* Click outside backdrop */}
+      <div className="absolute inset-0" onClick={onClose} />
+
+      <div className="absolute inset-y-0 right-0 max-w-full flex pl-10">
+        <div className="w-screen max-w-2xl bg-white shadow-2xl flex flex-col border-l border-slate-200">
+          {/* Header */}
+          <div className="px-6 py-5 border-b border-slate-100 bg-slate-50/80 flex items-center justify-between">
+            <div className="flex items-center gap-3">
+              <div className="w-10 h-10 rounded-xl bg-blue-50 text-blue-600 flex items-center justify-center">
+                <History size={20} />
+              </div>
+              <div>
+                <h3 className="text-lg font-bold text-slate-900 flex items-center gap-2">
+                  <span>{detail?.display_name || detail?.name || '插件详情'}</span>
+                  {detail && (
+                    <span className="text-xs font-mono font-medium px-2 py-0.5 rounded-md bg-blue-100 text-blue-700">
+                      {detail.name}
+                    </span>
+                  )}
+                </h3>
+                <p className="text-xs text-slate-500 mt-0.5">
+                  全量历史版本记录、代码溯源、校验码及版本一键回滚
+                </p>
+              </div>
+            </div>
+            <button
+              onClick={onClose}
+              className="text-slate-400 hover:text-slate-600 hover:bg-slate-100 p-2 rounded-lg transition"
+            >
+              <X size={18} />
+            </button>
+          </div>
+
+          {/* Body Content */}
+          <div className="flex-1 overflow-y-auto p-6 space-y-6">
+            {loading ? (
+              <div className="py-20 flex flex-col items-center justify-center gap-3 text-slate-400">
+                <Loader2 size={32} className="animate-spin text-blue-600" />
+                <span className="text-sm font-medium">正在读取版本历史...</span>
+              </div>
+            ) : detail ? (
+              <>
+                {/* 插件核心信息卡片 */}
+                <div className="bg-slate-50 rounded-2xl p-5 border border-slate-200/80 space-y-3">
+                  <div className="flex items-start justify-between">
+                    <div>
+                      <div className="text-xs font-bold uppercase tracking-wider text-slate-400">
+                        当前推荐生效版本
+                      </div>
+                      <div className="text-xl font-black text-slate-900 mt-0.5 flex items-center gap-2">
+                        <span className="text-emerald-600 font-mono">v{detail.latest_version}</span>
+                        <span className="text-xs font-normal text-emerald-700 bg-emerald-100 px-2 py-0.5 rounded-full flex items-center gap-1">
+                          <CheckCircle2 size={12} /> Active
+                        </span>
+                      </div>
+                    </div>
+
+                    <div className="flex items-center gap-2">
+                      <button
+                        onClick={() => onOpenPublishVersion(detail)}
+                        className="px-3.5 py-1.5 text-xs font-semibold text-white bg-blue-600 hover:bg-blue-700 rounded-lg shadow-sm flex items-center gap-1.5 transition"
+                      >
+                        <Plus size={14} />
+                        发布新版本
+                      </button>
+                    </div>
+                  </div>
+
+                  <div className="grid grid-cols-2 sm:grid-cols-3 gap-3 pt-3 border-t border-slate-200/60 text-xs">
+                    <div>
+                      <span className="text-slate-400 block">落盘文件名</span>
+                      <span className="font-mono text-slate-700 font-medium">
+                        {detail.filename || `${detail.name}.py`}
+                      </span>
+                    </div>
+                    <div>
+                      <span className="text-slate-400 block">运行状态</span>
+                      <span
+                        className={`font-medium ${
+                          detail.status === 1 ? 'text-emerald-600' : 'text-slate-400'
+                        }`}
+                      >
+                        {detail.status === 1 ? '已启用' : '已停用'}
+                      </span>
+                    </div>
+                    <div>
+                      <span className="text-slate-400 block">历史版本总数</span>
+                      <span className="font-semibold text-slate-800">
+                        {detail.versions?.length || 0} 个版本
+                      </span>
+                    </div>
+                  </div>
+
+                  {detail.description && (
+                    <div className="pt-2 border-t border-slate-200/60 text-xs text-slate-600">
+                      <span className="text-slate-400 font-medium mr-1.5">插件描述:</span>
+                      {detail.description}
+                    </div>
+                  )}
+                </div>
+
+                {/* 历史版本流 */}
+                <div>
+                  <div className="flex items-center justify-between mb-4">
+                    <h4 className="text-sm font-bold text-slate-900 flex items-center gap-2">
+                      <Layers size={16} className="text-blue-600" />
+                      发布历史与版本轨迹 ({detail.versions?.length || 0})
+                    </h4>
+                  </div>
+
+                  {!detail.versions || detail.versions.length === 0 ? (
+                    <div className="p-8 text-center bg-slate-50 rounded-xl border border-dashed border-slate-200 text-slate-400 text-xs">
+                      暂无版本历史记录,请点击上方“发布新版本”上传代码。
+                    </div>
+                  ) : (
+                    <div className="relative pl-6 space-y-4 before:absolute before:left-2 before:top-3 before:bottom-3 before:w-0.5 before:bg-slate-200">
+                      {detail.versions.map((ver) => {
+                        const isCurrentActive = ver.version === detail.latest_version;
+                        const isSwitching = actionLoading === `switch-${ver.version}`;
+                        const isDeleting = actionLoading === `delete-${ver.version}`;
+
+                        return (
+                          <div
+                            key={ver.id || ver.version}
+                            className={`relative bg-white rounded-xl p-4.5 border transition-all ${
+                              isCurrentActive
+                                ? 'border-emerald-300 ring-2 ring-emerald-500/10 shadow-sm bg-emerald-50/20'
+                                : 'border-slate-200 hover:border-slate-300'
+                            }`}
+                          >
+                            {/* Timeline node */}
+                            <div
+                              className={`absolute -left-[27px] top-4 w-3.5 h-3.5 rounded-full border-2 bg-white ${
+                                isCurrentActive
+                                  ? 'border-emerald-500 bg-emerald-500 ring-4 ring-emerald-100'
+                                  : 'border-slate-400'
+                              }`}
+                            />
+
+                            {/* Card Header */}
+                            <div className="flex items-start justify-between gap-3">
+                              <div className="flex items-center gap-2.5">
+                                <span className="text-base font-black font-mono text-slate-900">
+                                  v{ver.version}
+                                </span>
+                                {isCurrentActive && (
+                                  <span className="text-[11px] font-semibold text-emerald-700 bg-emerald-100 px-2 py-0.5 rounded-full">
+                                    当前生效推荐
+                                  </span>
+                                )}
+                              </div>
+
+                              <div className="flex items-center gap-2">
+                                {!isCurrentActive ? (
+                                  <button
+                                    onClick={() => handleSwitchVersion(ver.version)}
+                                    disabled={!!actionLoading}
+                                    className="px-2.5 py-1 text-xs font-semibold text-blue-600 hover:text-white hover:bg-blue-600 active:bg-blue-700 rounded-lg border border-blue-200 transition flex items-center gap-1 disabled:opacity-50"
+                                    title="设为生效版本并可一键回滚"
+                                  >
+                                    {isSwitching ? (
+                                      <Loader2 size={12} className="animate-spin" />
+                                    ) : (
+                                      <RotateCcw size={12} />
+                                    )}
+                                    设为生效
+                                  </button>
+                                ) : (
+                                  <span className="text-xs text-emerald-600 font-medium flex items-center gap-1">
+                                    <Check size={14} /> 运行中
+                                  </span>
+                                )}
+
+                                {!isCurrentActive && (
+                                  <button
+                                    onClick={() => handleDeleteVersion(ver.version)}
+                                    disabled={!!actionLoading}
+                                    className="p-1 text-slate-400 hover:text-rose-600 hover:bg-rose-50 rounded-lg transition"
+                                    title="删除此版本"
+                                  >
+                                    {isDeleting ? (
+                                      <Loader2 size={14} className="animate-spin text-rose-500" />
+                                    ) : (
+                                      <Trash2 size={14} />
+                                    )}
+                                  </button>
+                                )}
+                              </div>
+                            </div>
+
+                            {/* Time & Download */}
+                            <div className="flex flex-wrap items-center gap-x-4 gap-y-1 mt-2 text-xs text-slate-500">
+                              <span className="flex items-center gap-1">
+                                <Calendar size={13} className="text-slate-400" />
+                                {ver.created_at || '刚刚'}
+                              </span>
+
+                              {ver.download_url && (
+                                <a
+                                  href={ver.download_url}
+                                  target="_blank"
+                                  rel="noopener noreferrer"
+                                  className="text-blue-600 hover:underline flex items-center gap-1"
+                                >
+                                  <Download size={13} /> 下载源码包
+                                  <ArrowUpRight size={12} />
+                                </a>
+                              )}
+                            </div>
+
+                            {/* SHA256 */}
+                            {ver.sha256 && (
+                              <div className="mt-2.5 p-2 rounded-lg bg-slate-50 border border-slate-200/70 flex items-center justify-between gap-2">
+                                <div className="text-[11px] font-mono text-slate-600 truncate flex-1">
+                                  <span className="text-slate-400 mr-1 select-none">SHA256:</span>
+                                  {ver.sha256}
+                                </div>
+                                <button
+                                  type="button"
+                                  onClick={() => handleCopySha(ver.sha256)}
+                                  className="p-1 text-slate-400 hover:text-slate-700 rounded transition flex-shrink-0"
+                                  title="复制校验码"
+                                >
+                                  {copiedSha === ver.sha256 ? (
+                                    <Check size={13} className="text-emerald-600" />
+                                  ) : (
+                                    <Copy size={13} />
+                                  )}
+                                </button>
+                              </div>
+                            )}
+
+                            {/* Changelog */}
+                            {ver.changelog && (
+                              <div className="mt-2.5 text-xs text-slate-700 bg-slate-50/70 p-2.5 rounded-lg border border-slate-200/50">
+                                <span className="font-semibold text-slate-800 block mb-0.5">
+                                  更新日志:
+                                </span>
+                                <div className="whitespace-pre-wrap leading-relaxed">
+                                  {ver.changelog}
+                                </div>
+                              </div>
+                            )}
+                          </div>
+                        );
+                      })}
+                    </div>
+                  )}
+                </div>
+              </>
+            ) : (
+              <div className="py-20 text-center text-slate-400 text-sm">暂无数据</div>
+            )}
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}

+ 181 - 0
src/components/admin/plugins/PluginEditModal.tsx

@@ -0,0 +1,181 @@
+// src/components/admin/plugins/PluginEditModal.tsx
+'use client';
+
+import { useState, useEffect } from 'react';
+import { X, Edit2, Loader2, AlertCircle, Check } from 'lucide-react';
+import { pluginService } from '@/lib/services/pluginService';
+import { PluginItem } from '@/types';
+
+interface PluginEditModalProps {
+  isOpen: boolean;
+  plugin: PluginItem | null;
+  onClose: () => void;
+  onSuccess: () => void;
+}
+
+export default function PluginEditModal({
+  isOpen,
+  plugin,
+  onClose,
+  onSuccess,
+}: PluginEditModalProps) {
+  const [displayName, setDisplayName] = useState('');
+  const [description, setDescription] = useState('');
+  const [status, setStatus] = useState(1);
+  const [loading, setLoading] = useState(false);
+  const [errorMsg, setErrorMsg] = useState('');
+
+  useEffect(() => {
+    if (isOpen && plugin) {
+      setDisplayName(plugin.display_name || '');
+      setDescription(plugin.description || '');
+      setStatus(plugin.status ?? 1);
+      setErrorMsg('');
+    }
+  }, [isOpen, plugin]);
+
+  if (!isOpen || !plugin) return null;
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setErrorMsg('');
+    setLoading(true);
+
+    try {
+      const res = await pluginService.update(plugin.id, {
+        display_name: displayName.trim(),
+        description: description.trim(),
+        status,
+      });
+
+      if (res.code === 0 || res.code === undefined) {
+        onSuccess();
+        onClose();
+      } else {
+        throw new Error(res.msg || '更新失败');
+      }
+    } catch (err: any) {
+      console.error(err);
+      setErrorMsg(
+        err.response?.data?.msg ||
+          err.response?.data?.message ||
+          err.message ||
+          '更新失败,请重试'
+      );
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div className="fixed inset-0 z-50 flex items-center justify-center p-4 bg-slate-900/60 backdrop-blur-sm animate-fadeIn">
+      <div className="bg-white rounded-2xl shadow-2xl border border-slate-200 w-full max-w-md overflow-hidden flex flex-col">
+        {/* Header */}
+        <div className="px-6 py-4 border-b border-slate-100 flex items-center justify-between bg-slate-50/80">
+          <div className="flex items-center gap-3">
+            <div className="w-9 h-9 rounded-xl bg-blue-50 text-blue-600 flex items-center justify-center font-bold">
+              <Edit2 size={18} />
+            </div>
+            <div>
+              <h3 className="text-base font-bold text-slate-900">编辑插件信息</h3>
+              <p className="text-xs font-mono text-slate-400">{plugin.name}</p>
+            </div>
+          </div>
+          <button
+            onClick={onClose}
+            className="text-slate-400 hover:text-slate-600 hover:bg-slate-100 p-1.5 rounded-lg transition"
+          >
+            <X size={18} />
+          </button>
+        </div>
+
+        {/* Form Body */}
+        <form onSubmit={handleSubmit} className="p-6 space-y-4">
+          {errorMsg && (
+            <div className="p-3 rounded-xl bg-rose-50 border border-rose-200 text-rose-700 text-xs flex items-start gap-2">
+              <AlertCircle size={16} className="flex-shrink-0 mt-0.5" />
+              <span>{errorMsg}</span>
+            </div>
+          )}
+
+          <div>
+            <label className="block text-xs font-semibold text-slate-700 uppercase tracking-wider mb-1">
+              中文展示名
+            </label>
+            <input
+              type="text"
+              value={displayName}
+              onChange={(e) => setDisplayName(e.target.value)}
+              placeholder="例如: TLSContact欧洲多国签证预约插件"
+              className="w-full px-3 py-2 rounded-xl border border-slate-200 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white transition"
+            />
+          </div>
+
+          <div>
+            <label className="block text-xs font-semibold text-slate-700 uppercase tracking-wider mb-1">
+              功能描述
+            </label>
+            <textarea
+              rows={3}
+              value={description}
+              onChange={(e) => setDescription(e.target.value)}
+              placeholder="功能描述说明"
+              className="w-full px-3 py-2 rounded-xl border border-slate-200 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white transition resize-none"
+            />
+          </div>
+
+          <div>
+            <label className="block text-xs font-semibold text-slate-700 uppercase tracking-wider mb-1">
+              启用状态
+            </label>
+            <div className="grid grid-cols-2 gap-3 pt-1">
+              <button
+                type="button"
+                onClick={() => setStatus(1)}
+                className={`py-2 px-3 rounded-xl border text-xs font-semibold transition flex items-center justify-center gap-1.5 ${
+                  status === 1
+                    ? 'border-emerald-500 bg-emerald-50 text-emerald-700 ring-2 ring-emerald-500/20'
+                    : 'border-slate-200 bg-white text-slate-600 hover:bg-slate-50'
+                }`}
+              >
+                {status === 1 && <Check size={14} />} 启用状态 (Active)
+              </button>
+
+              <button
+                type="button"
+                onClick={() => setStatus(0)}
+                className={`py-2 px-3 rounded-xl border text-xs font-semibold transition flex items-center justify-center gap-1.5 ${
+                  status === 0
+                    ? 'border-slate-500 bg-slate-100 text-slate-800 ring-2 ring-slate-500/20'
+                    : 'border-slate-200 bg-white text-slate-600 hover:bg-slate-50'
+                }`}
+              >
+                {status === 0 && <Check size={14} />} 停用状态 (Disabled)
+              </button>
+            </div>
+          </div>
+        </form>
+
+        {/* Footer */}
+        <div className="px-6 py-4 border-t border-slate-100 bg-slate-50/80 flex items-center justify-end gap-3">
+          <button
+            type="button"
+            onClick={onClose}
+            disabled={loading}
+            className="px-4 py-2 text-xs font-medium text-slate-600 hover:text-slate-800 hover:bg-slate-100 rounded-xl transition"
+          >
+            取消
+          </button>
+          <button
+            type="button"
+            onClick={handleSubmit}
+            disabled={loading}
+            className="px-5 py-2 text-xs font-semibold text-white bg-blue-600 hover:bg-blue-700 rounded-xl shadow-md shadow-blue-500/20 flex items-center gap-1.5 transition disabled:opacity-50"
+          >
+            {loading ? <Loader2 size={14} className="animate-spin" /> : '保存修改'}
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}

+ 435 - 0
src/components/admin/plugins/PluginPublishModal.tsx

@@ -0,0 +1,435 @@
+// src/components/admin/plugins/PluginPublishModal.tsx
+'use client';
+
+import { useState, useEffect } from 'react';
+import {
+  X,
+  Upload,
+  Link as LinkIcon,
+  FileCode,
+  CheckCircle2,
+  AlertCircle,
+  Loader2,
+  Sparkles,
+} from 'lucide-react';
+import { pluginService } from '@/lib/services/pluginService';
+import { PluginItem } from '@/types';
+
+interface PluginPublishModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  onSuccess: () => void;
+  initialPlugin?: PluginItem | null; // 若传入,则为当前插件发布新版本
+}
+
+export default function PluginPublishModal({
+  isOpen,
+  onClose,
+  onSuccess,
+  initialPlugin,
+}: PluginPublishModalProps) {
+  const [sourceType, setSourceType] = useState<'file' | 'url'>('file');
+  const [loading, setLoading] = useState(false);
+  const [errorMsg, setErrorMsg] = useState('');
+
+  // 表单字段
+  const [name, setName] = useState('');
+  const [displayName, setDisplayName] = useState('');
+  const [version, setVersion] = useState('');
+  const [description, setDescription] = useState('');
+  const [changelog, setChangelog] = useState('');
+  const [setAsLatest, setSetAsLatest] = useState(true);
+
+  // 文件与 URL
+  const [selectedFile, setSelectedFile] = useState<File | null>(null);
+  const [downloadUrl, setDownloadUrl] = useState('');
+  const [sha256, setSha256] = useState('');
+
+  const isNewPlugin = !initialPlugin;
+
+  useEffect(() => {
+    if (isOpen) {
+      setErrorMsg('');
+      if (initialPlugin) {
+        setName(initialPlugin.name);
+        setDisplayName(initialPlugin.display_name || '');
+        setDescription(initialPlugin.description || '');
+        setVersion('');
+        setChangelog('');
+        setSetAsLatest(true);
+      } else {
+        setName('');
+        setDisplayName('');
+        setVersion('1.0.0');
+        setDescription('');
+        setChangelog('');
+        setSetAsLatest(true);
+      }
+      setSelectedFile(null);
+      setDownloadUrl('');
+      setSha256('');
+      setSourceType('file');
+    }
+  }, [isOpen, initialPlugin]);
+
+  if (!isOpen) return null;
+
+  const handleFileChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    const file = e.target.files?.[0];
+    if (file) {
+      if (!file.name.endsWith('.py')) {
+        setErrorMsg('请上传以 .py 结尾的 Python 插件代码文件');
+        return;
+      }
+      setSelectedFile(file);
+      setErrorMsg('');
+      // 如果插件名为空,尝试用文件名填补
+      if (!name) {
+        const baseName = file.name.replace(/\.py$/, '');
+        setName(baseName);
+      }
+    }
+  };
+
+  const handleSubmit = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setErrorMsg('');
+
+    const cleanName = name.trim();
+    const cleanVersion = version.trim();
+
+    if (!cleanName) {
+      setErrorMsg('请输入插件唯一英文标识 (name)');
+      return;
+    }
+    if (!cleanVersion) {
+      setErrorMsg('请输入版本号 (如 1.0.0)');
+      return;
+    }
+
+    if (sourceType === 'file') {
+      if (!selectedFile) {
+        setErrorMsg('请选择要上传的 .py 插件文件');
+        return;
+      }
+    } else {
+      if (!downloadUrl.trim()) {
+        setErrorMsg('请输入有效的文件下载地址 (download_url)');
+        return;
+      }
+    }
+
+    setLoading(true);
+    try {
+      if (sourceType === 'file' && selectedFile) {
+        const formData = new FormData();
+        formData.append('name', cleanName);
+        formData.append('version', cleanVersion);
+        if (displayName.trim()) formData.append('display_name', displayName.trim());
+        if (description.trim()) formData.append('description', description.trim());
+        if (changelog.trim()) formData.append('changelog', changelog.trim());
+        formData.append('set_as_latest', String(setAsLatest));
+        formData.append('file', selectedFile);
+
+        const res = await pluginService.publish(formData);
+        if (res.code !== 0 && res.code !== undefined) {
+          throw new Error(res.msg || '发布失败');
+        }
+      } else {
+        const payload = {
+          name: cleanName,
+          version: cleanVersion,
+          display_name: displayName.trim() || undefined,
+          description: description.trim() || undefined,
+          download_url: downloadUrl.trim(),
+          sha256: sha256.trim() || undefined,
+          changelog: changelog.trim() || undefined,
+          set_as_latest: setAsLatest,
+        };
+        const res = await pluginService.publish(payload);
+        if (res.code !== 0 && res.code !== undefined) {
+          throw new Error(res.msg || '发布失败');
+        }
+      }
+
+      onSuccess();
+      onClose();
+    } catch (err: any) {
+      console.error(err);
+      setErrorMsg(
+        err.response?.data?.msg ||
+          err.response?.data?.message ||
+          err.message ||
+          '发布失败,请检查网络或参数'
+      );
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div className="fixed inset-0 z-50 flex items-center justify-center p-4 bg-slate-900/60 backdrop-blur-sm animate-fadeIn">
+      <div className="bg-white rounded-2xl shadow-2xl border border-slate-200 w-full max-w-2xl overflow-hidden flex flex-col max-h-[90vh]">
+        {/* Header */}
+        <div className="px-6 py-5 border-b border-slate-100 flex items-center justify-between bg-slate-50/80">
+          <div className="flex items-center gap-3">
+            <div className="w-10 h-10 rounded-xl bg-blue-600/10 text-blue-600 flex items-center justify-center font-bold">
+              <Sparkles size={20} />
+            </div>
+            <div>
+              <h3 className="text-lg font-bold text-slate-900">
+                {isNewPlugin ? '发布新插件' : `发布新版本: ${initialPlugin.name}`}
+              </h3>
+              <p className="text-xs text-slate-500 mt-0.5">
+                {isNewPlugin
+                  ? '录入插件元数据并上传首发版本代码文件'
+                  : `当前最新版本为 ${initialPlugin.latest_version},上传并迭代新版本`}
+              </p>
+            </div>
+          </div>
+          <button
+            onClick={onClose}
+            className="text-slate-400 hover:text-slate-600 hover:bg-slate-100 p-2 rounded-lg transition"
+          >
+            <X size={18} />
+          </button>
+        </div>
+
+        {/* Content */}
+        <form onSubmit={handleSubmit} className="flex-1 overflow-y-auto p-6 space-y-5">
+          {errorMsg && (
+            <div className="p-3.5 rounded-xl bg-rose-50 border border-rose-200 text-rose-700 text-sm flex items-start gap-2.5">
+              <AlertCircle size={18} className="flex-shrink-0 mt-0.5" />
+              <div className="flex-1">{errorMsg}</div>
+            </div>
+          )}
+
+          {/* 基础信息 */}
+          <div className="grid grid-cols-1 sm:grid-cols-2 gap-4">
+            <div>
+              <label className="block text-xs font-semibold text-slate-700 uppercase tracking-wider mb-1.5">
+                插件唯一英文标识 <span className="text-rose-500">*</span>
+              </label>
+              <input
+                type="text"
+                value={name}
+                onChange={(e) => setName(e.target.value)}
+                placeholder="例如: tls_plugin"
+                disabled={!isNewPlugin}
+                required
+                className="w-full px-3.5 py-2.5 rounded-xl border border-slate-200 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white disabled:bg-slate-100 disabled:text-slate-500 transition"
+              />
+              <p className="text-[11px] text-slate-400 mt-1">代码中调用的模块唯一名称</p>
+            </div>
+
+            <div>
+              <label className="block text-xs font-semibold text-slate-700 uppercase tracking-wider mb-1.5">
+                版本号 (SemVer) <span className="text-rose-500">*</span>
+              </label>
+              <input
+                type="text"
+                value={version}
+                onChange={(e) => setVersion(e.target.value)}
+                placeholder="例如: 1.0.1"
+                required
+                className="w-full px-3.5 py-2.5 rounded-xl border border-slate-200 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white transition"
+              />
+              <p className="text-[11px] text-slate-400 mt-1">请遵循三位版本号规范</p>
+            </div>
+          </div>
+
+          <div className="grid grid-cols-1 sm:grid-cols-2 gap-4">
+            <div>
+              <label className="block text-xs font-semibold text-slate-700 uppercase tracking-wider mb-1.5">
+                中文展示名称
+              </label>
+              <input
+                type="text"
+                value={displayName}
+                onChange={(e) => setDisplayName(e.target.value)}
+                placeholder="例如: TLSContact欧洲多国签证预约插件"
+                className="w-full px-3.5 py-2.5 rounded-xl border border-slate-200 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white transition"
+              />
+            </div>
+
+            <div>
+              <label className="block text-xs font-semibold text-slate-700 uppercase tracking-wider mb-1.5">
+                功能简述
+              </label>
+              <input
+                type="text"
+                value={description}
+                onChange={(e) => setDescription(e.target.value)}
+                placeholder="简述插件的核心机制或适配站点"
+                className="w-full px-3.5 py-2.5 rounded-xl border border-slate-200 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white transition"
+              />
+            </div>
+          </div>
+
+          {/* 代码文件提供方式 Tabs */}
+          <div className="space-y-3 pt-1 border-t border-slate-100">
+            <div className="flex items-center justify-between">
+              <label className="text-xs font-semibold text-slate-700 uppercase tracking-wider">
+                代码包来源 <span className="text-rose-500">*</span>
+              </label>
+              <div className="inline-flex p-0.5 rounded-lg bg-slate-100 border border-slate-200 text-xs font-medium">
+                <button
+                  type="button"
+                  onClick={() => setSourceType('file')}
+                  className={`px-3 py-1 rounded-md transition flex items-center gap-1.5 ${
+                    sourceType === 'file'
+                      ? 'bg-white text-blue-600 shadow-sm font-semibold'
+                      : 'text-slate-600 hover:text-slate-900'
+                  }`}
+                >
+                  <Upload size={13} />
+                  直接上传代码 (.py)
+                </button>
+                <button
+                  type="button"
+                  onClick={() => setSourceType('url')}
+                  className={`px-3 py-1 rounded-md transition flex items-center gap-1.5 ${
+                    sourceType === 'url'
+                      ? 'bg-white text-blue-600 shadow-sm font-semibold'
+                      : 'text-slate-600 hover:text-slate-900'
+                  }`}
+                >
+                  <LinkIcon size={13} />
+                  外部下载 URL
+                </button>
+              </div>
+            </div>
+
+            {sourceType === 'file' ? (
+              <div className="border-2 border-dashed border-slate-200 hover:border-blue-400 rounded-xl p-5 text-center transition bg-slate-50/50">
+                <input
+                  type="file"
+                  id="py-file-input"
+                  accept=".py"
+                  onChange={handleFileChange}
+                  className="hidden"
+                />
+                <label
+                  htmlFor="py-file-input"
+                  className="cursor-pointer flex flex-col items-center justify-center gap-2"
+                >
+                  <div className="w-11 h-11 rounded-full bg-blue-50 text-blue-600 flex items-center justify-center">
+                    <FileCode size={22} />
+                  </div>
+                  <div>
+                    {selectedFile ? (
+                      <div className="space-y-1">
+                        <p className="text-sm font-semibold text-blue-600 flex items-center justify-center gap-1.5">
+                          <CheckCircle2 size={16} /> {selectedFile.name}
+                        </p>
+                        <p className="text-xs text-slate-400">
+                          文件大小: {(selectedFile.size / 1024).toFixed(1)} KB (点击可重新选择)
+                        </p>
+                      </div>
+                    ) : (
+                      <>
+                        <p className="text-sm font-medium text-slate-700">
+                          点击或拖拽上传 Python 文件
+                        </p>
+                        <p className="text-xs text-slate-400 mt-0.5">
+                          仅支持 .py 文件(后端将自动计算 SHA256 并托管存储)
+                        </p>
+                      </>
+                    )}
+                  </div>
+                </label>
+              </div>
+            ) : (
+              <div className="space-y-3 bg-slate-50/70 p-4 rounded-xl border border-slate-200">
+                <div>
+                  <label className="block text-xs font-medium text-slate-700 mb-1">
+                    下载 URL <span className="text-rose-500">*</span>
+                  </label>
+                  <input
+                    type="url"
+                    value={downloadUrl}
+                    onChange={(e) => setDownloadUrl(e.target.value)}
+                    placeholder="https://oss.example.com/plugins/tls_plugin-1.0.1.py"
+                    className="w-full px-3 py-2 rounded-lg border border-slate-200 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white transition"
+                  />
+                </div>
+                <div>
+                  <label className="block text-xs font-medium text-slate-700 mb-1">
+                    文件 SHA256 校验码 (可选)
+                  </label>
+                  <input
+                    type="text"
+                    value={sha256}
+                    onChange={(e) => setSha256(e.target.value)}
+                    placeholder="例如: 5d41402abc4b2a76b9719d911017c592..."
+                    className="w-full px-3 py-2 rounded-lg border border-slate-200 text-sm font-mono text-xs focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white transition"
+                  />
+                  <p className="text-[11px] text-slate-400 mt-1">用于 Coordinate 节点防篡改与完整性校验</p>
+                </div>
+              </div>
+            )}
+          </div>
+
+          {/* 更新日志 */}
+          <div>
+            <label className="block text-xs font-semibold text-slate-700 uppercase tracking-wider mb-1.5">
+              版本更新说明 (Changelog)
+            </label>
+            <textarea
+              rows={3}
+              value={changelog}
+              onChange={(e) => setChangelog(e.target.value)}
+              placeholder="例如: 修复CF验证码重试卡死问题,优化页面加载等待时序"
+              className="w-full px-3.5 py-2.5 rounded-xl border border-slate-200 text-sm focus:outline-none focus:ring-2 focus:ring-blue-500/20 focus:border-blue-500 bg-white transition resize-none"
+            />
+          </div>
+
+          {/* 设为最新版本开关 */}
+          <div className="flex items-center gap-3 p-3.5 bg-blue-50/50 rounded-xl border border-blue-100">
+            <input
+              type="checkbox"
+              id="set-as-latest"
+              checked={setAsLatest}
+              onChange={(e) => setSetAsLatest(e.target.checked)}
+              className="w-4 h-4 text-blue-600 rounded border-slate-300 focus:ring-blue-500"
+            />
+            <label htmlFor="set-as-latest" className="text-xs text-slate-700 cursor-pointer select-none">
+              <span className="font-semibold text-slate-900 block">设为当前生效/推荐版本 (latest_version)</span>
+              勾选后将自动更新主表最新生效版本,下发集群升级时默认拉取此版本
+            </label>
+          </div>
+        </form>
+
+        {/* Footer */}
+        <div className="px-6 py-4 border-t border-slate-100 bg-slate-50/80 flex items-center justify-end gap-3">
+          <button
+            type="button"
+            onClick={onClose}
+            disabled={loading}
+            className="px-4 py-2 text-sm font-medium text-slate-600 hover:text-slate-800 hover:bg-slate-100 rounded-xl transition"
+          >
+            取消
+          </button>
+          <button
+            type="button"
+            onClick={handleSubmit}
+            disabled={loading}
+            className="px-5 py-2 text-sm font-semibold text-white bg-blue-600 hover:bg-blue-700 active:bg-blue-800 rounded-xl shadow-md shadow-blue-500/20 flex items-center gap-2 transition disabled:opacity-50"
+          >
+            {loading ? (
+              <>
+                <Loader2 size={16} className="animate-spin" />
+                正在发布...
+              </>
+            ) : (
+              <>
+                <Upload size={16} />
+                确认发布
+              </>
+            )}
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}

+ 196 - 0
src/components/admin/plugins/PluginTable.tsx

@@ -0,0 +1,196 @@
+// src/components/admin/plugins/PluginTable.tsx
+'use client';
+
+import {
+  History,
+  Plus,
+  Zap,
+  Edit2,
+  Trash2,
+  FileCode,
+  CheckCircle2,
+  XCircle,
+  Calendar,
+  Layers,
+} from 'lucide-react';
+import { PluginItem } from '@/types';
+
+interface PluginTableProps {
+  plugins: PluginItem[];
+  loading: boolean;
+  onOpenVersions: (plugin: PluginItem) => void;
+  onOpenPublishVersion: (plugin: PluginItem) => void;
+  onQuickDispatchUpgrade: (plugin: PluginItem) => void;
+  onOpenEdit: (plugin: PluginItem) => void;
+  onDelete: (plugin: PluginItem) => void;
+}
+
+export default function PluginTable({
+  plugins,
+  loading,
+  onOpenVersions,
+  onOpenPublishVersion,
+  onQuickDispatchUpgrade,
+  onOpenEdit,
+  onDelete,
+}: PluginTableProps) {
+  if (loading) {
+    return (
+      <div className="bg-white rounded-2xl border border-slate-200 p-12 text-center shadow-sm">
+        <div className="inline-block animate-spin rounded-full h-8 w-8 border-4 border-blue-600 border-t-transparent mb-3" />
+        <p className="text-sm font-medium text-slate-500">正在加载插件列表...</p>
+      </div>
+    );
+  }
+
+  if (plugins.length === 0) {
+    return (
+      <div className="bg-white rounded-2xl border border-slate-200 p-12 text-center shadow-sm">
+        <div className="w-12 h-12 rounded-2xl bg-blue-50 text-blue-600 flex items-center justify-center mx-auto mb-3">
+          <Layers size={24} />
+        </div>
+        <h3 className="text-base font-bold text-slate-800">暂无任何插件</h3>
+        <p className="text-xs text-slate-500 mt-1 max-w-sm mx-auto">
+          尚未发布任何自动化插件。点击右上角的“发布新插件”上传首发版本代码。
+        </p>
+      </div>
+    );
+  }
+
+  return (
+    <div className="bg-white rounded-2xl border border-slate-200 shadow-sm overflow-hidden">
+      <div className="overflow-x-auto">
+        <table className="w-full text-left border-collapse">
+          <thead>
+            <tr className="bg-slate-50/80 border-b border-slate-200 text-[11px] font-bold text-slate-500 uppercase tracking-wider">
+              <th className="py-4 px-5">插件名称 / 标识</th>
+              <th className="py-4 px-4">生效版本</th>
+              <th className="py-4 px-4">运行状态</th>
+              <th className="py-4 px-4">功能描述</th>
+              <th className="py-4 px-4">更新时间</th>
+              <th className="py-4 px-5 text-right">操作</th>
+            </tr>
+          </thead>
+          <tbody className="divide-y divide-slate-100 text-sm">
+            {plugins.map((plugin) => (
+              <tr
+                key={plugin.id || plugin.name}
+                className="hover:bg-slate-50/60 transition-colors group"
+              >
+                {/* 插件名称 / 英文标识 */}
+                <td className="py-4 px-5">
+                  <div className="flex items-start gap-3">
+                    <div className="w-9 h-9 rounded-xl bg-blue-50 text-blue-600 flex items-center justify-center flex-shrink-0 mt-0.5 group-hover:bg-blue-600 group-hover:text-white transition">
+                      <FileCode size={18} />
+                    </div>
+                    <div>
+                      <div className="font-bold text-slate-900 flex items-center gap-2">
+                        <span>{plugin.display_name || plugin.name}</span>
+                      </div>
+                      <div className="flex items-center gap-2 mt-0.5">
+                        <span className="text-xs font-mono font-medium px-1.5 py-0.5 rounded bg-slate-100 text-slate-600">
+                          {plugin.name}
+                        </span>
+                        <span className="text-[11px] font-mono text-slate-400">
+                          {plugin.filename || `${plugin.name}.py`}
+                        </span>
+                      </div>
+                    </div>
+                  </div>
+                </td>
+
+                {/* 生效版本 */}
+                <td className="py-4 px-4 whitespace-nowrap">
+                  <span className="inline-flex items-center gap-1 font-mono font-bold text-xs px-2.5 py-1 rounded-lg bg-blue-50 text-blue-700 border border-blue-200/60">
+                    v{plugin.latest_version}
+                  </span>
+                </td>
+
+                {/* 状态 */}
+                <td className="py-4 px-4 whitespace-nowrap">
+                  {plugin.status === 1 ? (
+                    <span className="inline-flex items-center gap-1 text-xs font-medium text-emerald-700 bg-emerald-50 border border-emerald-200/60 px-2.5 py-0.5 rounded-full">
+                      <CheckCircle2 size={12} className="text-emerald-600" />
+                      已启用
+                    </span>
+                  ) : (
+                    <span className="inline-flex items-center gap-1 text-xs font-medium text-slate-500 bg-slate-100 border border-slate-200 px-2.5 py-0.5 rounded-full">
+                      <XCircle size={12} className="text-slate-400" />
+                      已停用
+                    </span>
+                  )}
+                </td>
+
+                {/* 描述 */}
+                <td className="py-4 px-4 max-w-xs">
+                  <p className="text-xs text-slate-600 line-clamp-2" title={plugin.description}>
+                    {plugin.description || <span className="text-slate-400 italic">无描述</span>}
+                  </p>
+                </td>
+
+                {/* 更新时间 */}
+                <td className="py-4 px-4 whitespace-nowrap text-xs text-slate-500">
+                  <div className="flex items-center gap-1">
+                    <Calendar size={13} className="text-slate-400" />
+                    <span>{plugin.updated_at || plugin.created_at || '—'}</span>
+                  </div>
+                </td>
+
+                {/* 操作列 */}
+                <td className="py-4 px-5 whitespace-nowrap text-right">
+                  <div className="inline-flex items-center gap-1">
+                    {/* 版本管理 (抽屉) */}
+                    <button
+                      onClick={() => onOpenVersions(plugin)}
+                      className="px-2.5 py-1.5 text-xs font-semibold text-blue-600 hover:text-blue-700 hover:bg-blue-50 rounded-lg transition flex items-center gap-1"
+                      title="查看全部历史版本及回滚"
+                    >
+                      <History size={14} />
+                      版本管理
+                    </button>
+
+                    {/* 快捷下发升级 */}
+                    <button
+                      onClick={() => onQuickDispatchUpgrade(plugin)}
+                      className="p-1.5 text-purple-600 hover:text-purple-700 hover:bg-purple-50 rounded-lg transition"
+                      title="快捷推送此插件升级给节点"
+                    >
+                      <Zap size={15} />
+                    </button>
+
+                    {/* 发布新版本 */}
+                    <button
+                      onClick={() => onOpenPublishVersion(plugin)}
+                      className="p-1.5 text-emerald-600 hover:text-emerald-700 hover:bg-emerald-50 rounded-lg transition"
+                      title="为此插件上传新版本"
+                    >
+                      <Plus size={15} />
+                    </button>
+
+                    {/* 编辑元数据 */}
+                    <button
+                      onClick={() => onOpenEdit(plugin)}
+                      className="p-1.5 text-slate-500 hover:text-slate-700 hover:bg-slate-100 rounded-lg transition"
+                      title="编辑插件基础信息与启停状态"
+                    >
+                      <Edit2 size={15} />
+                    </button>
+
+                    {/* 删除整套插件 */}
+                    <button
+                      onClick={() => onDelete(plugin)}
+                      className="p-1.5 text-slate-400 hover:text-rose-600 hover:bg-rose-50 rounded-lg transition"
+                      title="删除此插件及其全部版本"
+                    >
+                      <Trash2 size={15} />
+                    </button>
+                  </div>
+                </td>
+              </tr>
+            ))}
+          </tbody>
+        </table>
+      </div>
+    </div>
+  );
+}

+ 362 - 0
src/components/admin/plugins/PluginUpgradeDispatchModal.tsx

@@ -0,0 +1,362 @@
+// src/components/admin/plugins/PluginUpgradeDispatchModal.tsx
+'use client';
+
+import { useState, useEffect } from 'react';
+import {
+  X,
+  Radio,
+  Send,
+  Loader2,
+  CheckCircle2,
+  AlertCircle,
+  Cpu,
+  Layers,
+  Server,
+  Zap,
+} from 'lucide-react';
+import { pluginService } from '@/lib/services/pluginService';
+import { PluginItem } from '@/types';
+
+interface PluginUpgradeDispatchModalProps {
+  isOpen: boolean;
+  onClose: () => void;
+  pluginsList: PluginItem[];
+  initialTargetPluginName?: string | null; // 若从某一行快捷点击
+}
+
+export default function PluginUpgradeDispatchModal({
+  isOpen,
+  onClose,
+  pluginsList,
+  initialTargetPluginName,
+}: PluginUpgradeDispatchModalProps) {
+  const [targetType, setTargetType] = useState<'all' | 'custom'>('all');
+  const [customNodeId, setCustomNodeId] = useState('');
+  const [pluginSelectMode, setPluginSelectMode] = useState<'all' | 'selected'>('all');
+  const [selectedPluginNames, setSelectedPluginNames] = useState<string[]>([]);
+  const [loading, setLoading] = useState(false);
+  const [errorMsg, setErrorMsg] = useState('');
+  const [successMsg, setSuccessMsg] = useState('');
+
+  useEffect(() => {
+    if (isOpen) {
+      setErrorMsg('');
+      setSuccessMsg('');
+      if (initialTargetPluginName) {
+        setPluginSelectMode('selected');
+        setSelectedPluginNames([initialTargetPluginName]);
+      } else {
+        setPluginSelectMode('all');
+        setSelectedPluginNames([]);
+      }
+      setTargetType('all');
+      setCustomNodeId('');
+    }
+  }, [isOpen, initialTargetPluginName]);
+
+  if (!isOpen) return null;
+
+  const handleTogglePlugin = (name: string) => {
+    if (selectedPluginNames.includes(name)) {
+      setSelectedPluginNames(selectedPluginNames.filter((n) => n !== name));
+    } else {
+      setSelectedPluginNames([...selectedPluginNames, name]);
+    }
+  };
+
+  const handleSelectAllPlugins = () => {
+    setSelectedPluginNames(pluginsList.map((p) => p.name));
+  };
+
+  const handleDeselectAllPlugins = () => {
+    setSelectedPluginNames([]);
+  };
+
+  const handleDispatch = async (e: React.FormEvent) => {
+    e.preventDefault();
+    setErrorMsg('');
+    setSuccessMsg('');
+
+    const targetNode = targetType === 'all' ? 'all' : customNodeId.trim();
+    if (targetType === 'custom' && !targetNode) {
+      setErrorMsg('请输入目标节点唯一标识 (如 node01)');
+      return;
+    }
+
+    if (pluginSelectMode === 'selected' && selectedPluginNames.length === 0) {
+      setErrorMsg('请至少勾选一个需要下发升级的目标插件');
+      return;
+    }
+
+    const payloadPlugins = pluginSelectMode === 'all' ? [] : selectedPluginNames;
+
+    setLoading(true);
+    try {
+      const res = await pluginService.dispatchUpgrade({
+        target_node: targetNode,
+        plugins: payloadPlugins,
+      });
+
+      if (res.code === 0 || res.code === undefined) {
+        setSuccessMsg(
+          `升级指令已成功广播!消息已发送至 Redis 中继 (${
+            targetNode === 'all' ? 'vs:channel:upgrade' : `vs:channel:upgrade:${targetNode}`
+          }),目标节点监听到后将自动执行下载并热重载。`
+        );
+        setTimeout(() => {
+          onClose();
+        }, 2200);
+      } else {
+        throw new Error(res.msg || '下发失败');
+      }
+    } catch (err: any) {
+      console.error(err);
+      setErrorMsg(
+        err.response?.data?.msg ||
+          err.response?.data?.message ||
+          err.message ||
+          '下发升级指令失败,请检查网络或后端配置'
+      );
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <div className="fixed inset-0 z-50 flex items-center justify-center p-4 bg-slate-900/60 backdrop-blur-sm animate-fadeIn">
+      <div className="bg-white rounded-2xl shadow-2xl border border-slate-200 w-full max-w-xl overflow-hidden flex flex-col max-h-[90vh]">
+        {/* Header */}
+        <div className="px-6 py-5 border-b border-slate-100 flex items-center justify-between bg-slate-50/80">
+          <div className="flex items-center gap-3">
+            <div className="w-10 h-10 rounded-xl bg-purple-50 text-purple-600 flex items-center justify-center font-bold">
+              <Zap size={20} />
+            </div>
+            <div>
+              <h3 className="text-lg font-bold text-slate-900">下发插件升级与热重载指令</h3>
+              <p className="text-xs text-slate-500 mt-0.5">
+                向 Redis 发布升级事件,Coordinate 节点将实时安全热更代码
+              </p>
+            </div>
+          </div>
+          <button
+            onClick={onClose}
+            className="text-slate-400 hover:text-slate-600 hover:bg-slate-100 p-2 rounded-lg transition"
+          >
+            <X size={18} />
+          </button>
+        </div>
+
+        {/* Form Body */}
+        <form onSubmit={handleDispatch} className="flex-1 overflow-y-auto p-6 space-y-5">
+          {errorMsg && (
+            <div className="p-3.5 rounded-xl bg-rose-50 border border-rose-200 text-rose-700 text-sm flex items-start gap-2.5">
+              <AlertCircle size={18} className="flex-shrink-0 mt-0.5" />
+              <div className="flex-1">{errorMsg}</div>
+            </div>
+          )}
+
+          {successMsg && (
+            <div className="p-3.5 rounded-xl bg-emerald-50 border border-emerald-200 text-emerald-700 text-sm flex items-start gap-2.5">
+              <CheckCircle2 size={18} className="flex-shrink-0 mt-0.5" />
+              <div className="flex-1">{successMsg}</div>
+            </div>
+          )}
+
+          {/* 1. 目标节点范围 */}
+          <div className="space-y-2.5">
+            <label className="block text-xs font-semibold text-slate-700 uppercase tracking-wider">
+              1. 选择目标节点范围 (Target Node)
+            </label>
+
+            <div className="grid grid-cols-2 gap-3">
+              <button
+                type="button"
+                onClick={() => setTargetType('all')}
+                className={`p-3.5 rounded-xl border text-left transition flex flex-col justify-between gap-2 ${
+                  targetType === 'all'
+                    ? 'border-purple-500 bg-purple-50/50 ring-2 ring-purple-500/20'
+                    : 'border-slate-200 hover:border-slate-300 bg-white'
+                }`}
+              >
+                <div className="flex items-center justify-between w-full">
+                  <div className="flex items-center gap-2 font-bold text-sm text-slate-900">
+                    <Server size={16} className="text-purple-600" />
+                    全量集群广播
+                  </div>
+                  {targetType === 'all' && <CheckCircle2 size={16} className="text-purple-600" />}
+                </div>
+                <span className="text-[11px] text-slate-500">
+                  广播给所有在线 Coordinate 节点 (channel: vs:channel:upgrade)
+                </span>
+              </button>
+
+              <button
+                type="button"
+                onClick={() => setTargetType('custom')}
+                className={`p-3.5 rounded-xl border text-left transition flex flex-col justify-between gap-2 ${
+                  targetType === 'custom'
+                    ? 'border-purple-500 bg-purple-50/50 ring-2 ring-purple-500/20'
+                    : 'border-slate-200 hover:border-slate-300 bg-white'
+                }`}
+              >
+                <div className="flex items-center justify-between w-full">
+                  <div className="flex items-center gap-2 font-bold text-sm text-slate-900">
+                    <Cpu size={16} className="text-purple-600" />
+                    指定单个节点
+                  </div>
+                  {targetType === 'custom' && (
+                    <CheckCircle2 size={16} className="text-purple-600" />
+                  )}
+                </div>
+                <span className="text-[11px] text-slate-500">
+                  定向下发给特定 node_id 节点,便于灰度测试
+                </span>
+              </button>
+            </div>
+
+            {targetType === 'custom' && (
+              <div className="pt-2">
+                <input
+                  type="text"
+                  value={customNodeId}
+                  onChange={(e) => setCustomNodeId(e.target.value)}
+                  placeholder="请输入目标 Node ID,例如: node01 或 worker-mac-01"
+                  required
+                  className="w-full px-3.5 py-2 rounded-xl border border-slate-200 text-sm focus:outline-none focus:ring-2 focus:ring-purple-500/20 focus:border-purple-500 bg-white transition"
+                />
+              </div>
+            )}
+          </div>
+
+          {/* 2. 插件范围 */}
+          <div className="space-y-2.5 pt-2 border-t border-slate-100">
+            <div className="flex items-center justify-between">
+              <label className="text-xs font-semibold text-slate-700 uppercase tracking-wider">
+                2. 选择升级插件
+              </label>
+              <div className="inline-flex p-0.5 rounded-lg bg-slate-100 border border-slate-200 text-xs">
+                <button
+                  type="button"
+                  onClick={() => setPluginSelectMode('all')}
+                  className={`px-3 py-1 rounded-md transition ${
+                    pluginSelectMode === 'all'
+                      ? 'bg-white text-purple-700 font-semibold shadow-sm'
+                      : 'text-slate-600 hover:text-slate-900'
+                  }`}
+                >
+                  全量启用插件
+                </button>
+                <button
+                  type="button"
+                  onClick={() => setPluginSelectMode('selected')}
+                  className={`px-3 py-1 rounded-md transition ${
+                    pluginSelectMode === 'selected'
+                      ? 'bg-white text-purple-700 font-semibold shadow-sm'
+                      : 'text-slate-600 hover:text-slate-900'
+                  }`}
+                >
+                  自选插件 ({selectedPluginNames.length})
+                </button>
+              </div>
+            </div>
+
+            {pluginSelectMode === 'all' ? (
+              <div className="p-3.5 bg-slate-50 rounded-xl border border-slate-200 text-xs text-slate-600">
+                🚀 将自动读取系统当前所有<strong>处于启用状态</strong>的插件最新版本元数据,并向节点下发升级清单。
+              </div>
+            ) : (
+              <div className="space-y-2">
+                <div className="flex items-center justify-between text-xs text-slate-500 px-1">
+                  <span>勾选需要升级的目标插件:</span>
+                  <div className="flex gap-2">
+                    <button
+                      type="button"
+                      onClick={handleSelectAllPlugins}
+                      className="text-purple-600 hover:underline"
+                    >
+                      全选
+                    </button>
+                    <span>|</span>
+                    <button
+                      type="button"
+                      onClick={handleDeselectAllPlugins}
+                      className="text-slate-400 hover:underline"
+                    >
+                      清空
+                    </button>
+                  </div>
+                </div>
+
+                <div className="max-h-48 overflow-y-auto space-y-1.5 border border-slate-200 rounded-xl p-2 bg-slate-50/50">
+                  {pluginsList.map((p) => {
+                    const isChecked = selectedPluginNames.includes(p.name);
+                    return (
+                      <label
+                        key={p.name}
+                        onClick={() => handleTogglePlugin(p.name)}
+                        className={`flex items-center justify-between p-2 rounded-lg cursor-pointer transition text-xs select-none ${
+                          isChecked
+                            ? 'bg-purple-100/70 text-purple-900 font-semibold'
+                            : 'hover:bg-slate-100 text-slate-700'
+                        }`}
+                      >
+                        <div className="flex items-center gap-2">
+                          <input
+                            type="checkbox"
+                            checked={isChecked}
+                            onChange={() => {}}
+                            className="w-3.5 h-3.5 text-purple-600 rounded border-slate-300 focus:ring-purple-500"
+                          />
+                          <span>{p.display_name || p.name}</span>
+                          <span className="text-[11px] font-mono text-slate-400">({p.name})</span>
+                        </div>
+                        <span className="font-mono text-purple-700 bg-purple-50 px-1.5 py-0.5 rounded text-[11px]">
+                          v{p.latest_version}
+                        </span>
+                      </label>
+                    );
+                  })}
+                </div>
+              </div>
+            )}
+          </div>
+
+          {/* 机制提示 */}
+          <div className="p-3 bg-amber-50 rounded-xl border border-amber-200/80 text-[11px] text-amber-800 leading-relaxed">
+            <strong>热重载说明:</strong> 节点在收到指令后,会通过 <code>py_compile</code> 校验下载的代码语法,验证通过后安全原子替换本地文件并热重载运行中的插件实例。
+          </div>
+        </form>
+
+        {/* Footer */}
+        <div className="px-6 py-4 border-t border-slate-100 bg-slate-50/80 flex items-center justify-end gap-3">
+          <button
+            type="button"
+            onClick={onClose}
+            disabled={loading}
+            className="px-4 py-2 text-sm font-medium text-slate-600 hover:text-slate-800 hover:bg-slate-100 rounded-xl transition"
+          >
+            取消
+          </button>
+          <button
+            type="button"
+            onClick={handleDispatch}
+            disabled={loading}
+            className="px-5 py-2 text-sm font-semibold text-white bg-purple-600 hover:bg-purple-700 active:bg-purple-800 rounded-xl shadow-md shadow-purple-500/20 flex items-center gap-2 transition disabled:opacity-50"
+          >
+            {loading ? (
+              <>
+                <Loader2 size={16} className="animate-spin" />
+                正在下发广播...
+              </>
+            ) : (
+              <>
+                <Send size={16} />
+                确认立即下发
+              </>
+            )}
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}

+ 101 - 0
src/lib/services/pluginService.ts

@@ -0,0 +1,101 @@
+// src/lib/services/pluginService.ts
+
+import api from '@/lib/api';
+import {
+  PluginItem,
+  PluginDetail,
+  PublishPluginPayload,
+  UpdatePluginPayload,
+  UpgradeDispatchPayload,
+} from '@/types';
+
+export const pluginService = {
+  /**
+   * 获取插件列表 (支持分页与状态过滤)
+   */
+  async getList(params?: { page?: number; page_size?: number; status?: number }) {
+    const res = await api.get('/plugins/list_all', { params });
+    return res.data;
+  },
+
+  /**
+   * 获取插件详情 (含所有历史版本)
+   */
+  async getDetail(pluginId: number): Promise<{ code: number; msg: string; data: PluginDetail }> {
+    const res = await api.get('/plugins/detail', {
+      params: { plugin_id: pluginId },
+    });
+    return res.data;
+  },
+
+  /**
+   * 发布新插件 / 上传新版本
+   * 支持 FormData (含文件上传) 或 JSON Payload
+   */
+  async publish(data: FormData | PublishPluginPayload) {
+    const isFormData = typeof FormData !== 'undefined' && data instanceof FormData;
+    const res = await api.post('/plugins/publish', data, {
+      headers: isFormData
+        ? { 'Content-Type': 'multipart/form-data' }
+        : { 'Content-Type': 'application/json' },
+    });
+    return res.data;
+  },
+
+  /**
+   * 编辑插件基础信息 (展示名称、描述、启用/停用状态)
+   */
+  async update(pluginId: number, data: UpdatePluginPayload) {
+    const res = await api.put('/plugins/update', data, {
+      params: { plugin_id: pluginId },
+    });
+    return res.data;
+  },
+
+  /**
+   * 切换生效版本 / 一键回滚
+   */
+  async switchVersion(pluginId: number, version: string) {
+    const res = await api.post('/plugins/switch-version', {
+      plugin_id: pluginId,
+      version,
+    });
+    return res.data;
+  },
+
+  /**
+   * 删除整套插件及其所有历史版本
+   */
+  async deletePlugin(pluginId: number) {
+    const res = await api.delete('/plugins/delete', {
+      params: { plugin_id: pluginId },
+    });
+    return res.data;
+  },
+
+  /**
+   * 删除指定历史版本
+   */
+  async deleteVersion(pluginId: number, version: string) {
+    const res = await api.delete('/plugins/delete_version', {
+      params: { plugin_id: pluginId, version },
+    });
+    return res.data;
+  },
+
+  /**
+   * 下发插件集群升级命令 (向 Redis 广播热重载通知)
+   */
+  async dispatchUpgrade(payload: UpgradeDispatchPayload) {
+    const res = await api.post('/plugins/upgrade/dispatch', payload);
+    return res.data;
+  },
+
+  /**
+   * 获取全量最新生效插件列表
+   */
+  async getLatest() {
+    const res = await api.get('/plugins/latest');
+    return res.data;
+  },
+};

+ 1 - 0
src/types/index.ts

@@ -11,3 +11,4 @@ export * from './payment';
 export * from './config';
 export * from './slot';
 export * from './card';
+export * from './plugin';

+ 60 - 0
src/types/plugin.ts

@@ -0,0 +1,60 @@
+// src/types/plugin.ts
+
+export interface PluginItem {
+  id: number;
+  name: string;
+  display_name: string;
+  filename: string;
+  latest_version: string;
+  description: string;
+  status: number; // 1: 启用, 0: 停用
+  created_at: string;
+  updated_at: string;
+}
+
+export interface PluginVersionItem {
+  id: number;
+  plugin_id: number;
+  plugin_name: string;
+  version: string;
+  download_url: string;
+  sha256: string;
+  changelog: string;
+  created_at: string;
+}
+
+export interface PluginDetail extends PluginItem {
+  versions: PluginVersionItem[];
+}
+
+export interface PublishPluginPayload {
+  name: string;
+  version: string;
+  display_name?: string;
+  description?: string;
+  download_url?: string;
+  sha256?: string;
+  changelog?: string;
+  set_as_latest?: boolean;
+}
+
+export interface UpdatePluginPayload {
+  display_name?: string;
+  description?: string;
+  status?: number;
+}
+
+export interface SwitchVersionPayload {
+  plugin_id: number;
+  version: string;
+}
+
+export interface UpgradeDispatchPayload {
+  target_node: string; // "all" 或具体节点ID,如 "node01"
+  plugins: string[]; // 插件英文标识列表,[] 表示所有启用插件
+}
+
+export interface PluginListResponse {
+  list: PluginItem[];
+  total: number;
+}