feat(*): 插件中心与模型协议 - 完善声明式协议运行时并增加功能开放控制

This commit is contained in:
ddCat
2026-08-23 23:19:27 +08:00
parent 7cc6021f6e
commit 919037e5d9
106 changed files with 8817 additions and 500 deletions

View File

@@ -1,14 +1,18 @@
import { App, Button, Input, Modal, Select, Switch, Typography } from "antd";
import { CalendarDays, CheckCircle2, Clock3, ExternalLink, FolderOpen, PlugZap, Search, Settings2, ShieldCheck, SlidersHorizontal } from "lucide-react";
import { AudioLines, CalendarDays, CheckCircle2, Clock3, CloudUpload, ExternalLink, Film, FolderOpen, Image as ImageIcon, MessageSquareText, PlugZap, RefreshCw, Search, Settings2, ShieldCheck, SlidersHorizontal } from "lucide-react";
import { useEffect, useMemo, useState } from "react";
import { useNavigate } from "react-router";
import { listRegisteredPlugins } from "@/lib/plugins/plugin-registry";
import "@/lib/plugins/builtin";
import { EAGLE_PLUGIN_ID } from "@/lib/plugins/builtin/eagle";
import type { PluginManifest, RegisteredPlugin } from "@/lib/plugins/plugin-types";
import { getEagleLibrary, type EagleFolder } from "@/services/api/eagle";
import { fetchPlugins, setPluginEnabled, uploadPlugin, type BackendPlugin } from "@/services/api/plugins";
import { usePluginStore } from "@/stores/use-plugin-store";
import { useUserStore } from "@/stores/use-user-store";
import { PluginDetailsModal, UploadPluginModal } from "./plugin-documentation-modals";
import "./plugins.css";
const categoryLabels: Record<string, string> = {
@@ -18,6 +22,7 @@ const categoryLabels: Record<string, string> = {
"ai-capability": "AI 能力",
"import-export": "导入导出",
agent: "智能体",
protocol: "请求协议",
};
const surfaceLabels: Record<string, string> = {
@@ -40,15 +45,29 @@ const permissionLabels: Record<string, string> = {
const pluginDateFormatter = new Intl.DateTimeFormat("zh-CN", { year: "numeric", month: "short", day: "numeric" });
const protocolSectionMeta = [
{ key: "text", label: "文本协议", description: "对话、推理与流式响应", icon: MessageSquareText },
{ key: "image", label: "图片协议", description: "生成、编辑与参考图", icon: ImageIcon },
{ key: "video", label: "视频协议", description: "创建任务、轮询与媒体结果", icon: Film },
{ key: "audio", label: "音频协议", description: "语音与异步音频任务", icon: AudioLines },
] as const;
export default function PluginsPage() {
const { message } = App.useApp();
const navigate = useNavigate();
const user = useUserStore((state) => state.user);
const features = useUserStore((state) => state.features);
const installations = usePluginStore((state) => state.installations);
const ensurePlugin = usePluginStore((state) => state.ensurePlugin);
const setEnabled = usePluginStore((state) => state.setEnabled);
const updateConfig = usePluginStore((state) => state.updateConfig);
const registeredPlugins = useMemo(() => listRegisteredPlugins(), []);
const builtinPlugins = useMemo(() => listRegisteredPlugins(), []);
const [backendPlugins, setBackendPlugins] = useState<BackendPlugin[]>([]);
const [backendPluginsLoading, setBackendPluginsLoading] = useState(false);
const [settingsPluginId, setSettingsPluginId] = useState<string | null>(null);
const [detailsPluginId, setDetailsPluginId] = useState<string | null>(null);
const [detailsRestoreFocus, setDetailsRestoreFocus] = useState(false);
const [uploadModalOpen, setUploadModalOpen] = useState(false);
const [search, setSearch] = useState("");
const [categoryFilter, setCategoryFilter] = useState("all");
const [statusFilter, setStatusFilter] = useState<"all" | "enabled" | "disabled">("all");
@@ -61,8 +80,28 @@ export default function PluginsPage() {
const [eagleFoldersError, setEagleFoldersError] = useState("");
useEffect(() => {
for (const plugin of registeredPlugins) ensurePlugin(plugin.manifest);
}, [ensurePlugin, registeredPlugins]);
for (const plugin of builtinPlugins) ensurePlugin(plugin.manifest);
}, [builtinPlugins, ensurePlugin]);
const reloadBackendPlugins = async () => {
setBackendPluginsLoading(true);
try {
setBackendPlugins(await fetchPlugins());
} catch (error) {
message.error(error instanceof Error ? error.message : "读取插件中心失败");
setBackendPlugins([]);
} finally {
setBackendPluginsLoading(false);
}
};
useEffect(() => {
void reloadBackendPlugins();
}, []);
const remotePlugins = useMemo(() => backendPlugins.map(toRegisteredPlugin), [backendPlugins]);
const registeredPlugins = useMemo(() => [...builtinPlugins, ...remotePlugins], [builtinPlugins, remotePlugins]);
const backendPluginById = useMemo(() => new Map(backendPlugins.map((plugin) => [plugin.manifest.id, plugin])), [backendPlugins]);
const eagle = installations.find((item) => item.manifest.id === EAGLE_PLUGIN_ID);
@@ -75,29 +114,86 @@ export default function PluginsPage() {
setEagleGeneratedFolderId(typeof folderId === "string" ? folderId : "");
}, [eagle?.config.baseUrl, eagle?.config.autoUploadGenerated, eagle?.config.generatedFolderId]);
const categoryOptions = useMemo(() => [
{ value: "all", label: "全部分类" },
...Array.from(new Set(registeredPlugins.map((plugin) => plugin.manifest.category))).map((category) => ({ value: category, label: categoryLabels[category] ?? category })),
], [registeredPlugins]);
const filteredPlugins = useMemo(() => {
const normalizedSearch = search.trim().toLocaleLowerCase();
return registeredPlugins.filter((plugin) => {
const isSystemPlugin = plugin.source !== "uploaded";
if (user?.role !== "admin" && !features.systemPluginsVisibleToUsers && isSystemPlugin) return false;
const installation = installations.find((item) => item.manifest.id === plugin.manifest.id);
const enabled = plugin.manifest.kind === "protocol" ? backendPluginById.get(plugin.manifest.id)?.status === "enabled" : Boolean(installation?.enabled);
const manifest = plugin.manifest;
const searchableText = [manifest.name, manifest.description, manifest.author, manifest.id, categoryLabels[manifest.category]].filter(Boolean).join(" ").toLocaleLowerCase();
if (normalizedSearch && !searchableText.includes(normalizedSearch)) return false;
if (categoryFilter !== "all" && manifest.category !== categoryFilter) return false;
if (categoryFilter !== "all") {
const matchesCapability = manifest.kind === "protocol" && manifest.protocol?.categories.includes(categoryFilter as "text" | "image" | "video" | "audio");
const matchesApp = categoryFilter === "other" && manifest.kind !== "protocol";
if (!matchesCapability && !matchesApp) return false;
}
if (trustFilter === "trusted" && !manifest.trusted) return false;
if (statusFilter === "enabled" && !installation?.enabled) return false;
if (statusFilter === "disabled" && installation?.enabled) return false;
if (statusFilter === "enabled" && !enabled) return false;
if (statusFilter === "disabled" && enabled) return false;
return true;
});
}, [categoryFilter, installations, registeredPlugins, search, statusFilter, trustFilter]);
}, [backendPluginById, categoryFilter, features.systemPluginsVisibleToUsers, installations, registeredPlugins, search, statusFilter, trustFilter, user?.role]);
const pluginSections = useMemo(
() => [
...protocolSectionMeta.map((section) => ({ ...section, plugins: filteredPlugins.filter((plugin) => plugin.manifest.kind === "protocol" && plugin.manifest.protocol?.categories.includes(section.key)) })),
{ key: "other", label: "应用插件", description: "画布、素材与工作流扩展", icon: PlugZap, plugins: filteredPlugins.filter((plugin) => plugin.manifest.kind !== "protocol") },
],
[filteredPlugins],
);
const categoryCounts = useMemo(() => {
const visiblePlugins = registeredPlugins.filter((plugin) => user?.role === "admin" || features.systemPluginsVisibleToUsers || plugin.source === "uploaded");
const counts: Record<string, number> = { all: visiblePlugins.length, text: 0, image: 0, video: 0, audio: 0, other: 0 };
for (const plugin of visiblePlugins) {
if (plugin.manifest.kind !== "protocol") {
counts.other += 1;
continue;
}
for (const capability of plugin.manifest.protocol?.categories || []) {
counts[capability] = (counts[capability] || 0) + 1;
}
}
return counts;
}, [features.systemPluginsVisibleToUsers, registeredPlugins, user?.role]);
const settingsPlugin = settingsPluginId ? registeredPlugins.find((plugin) => plugin.manifest.id === settingsPluginId) : undefined;
const settingsInstallation = settingsPlugin ? installations.find((item) => item.manifest.id === settingsPlugin.manifest.id) : undefined;
const settingsEnabled = Boolean(settingsInstallation?.enabled);
const settingsEnabled = settingsPlugin?.manifest.kind === "protocol" ? backendPluginById.get(settingsPlugin.manifest.id)?.status === "enabled" : Boolean(settingsInstallation?.enabled);
const detailsPlugin = detailsPluginId ? registeredPlugins.find((plugin) => plugin.manifest.id === detailsPluginId) : undefined;
const hasPluginConfiguration = (plugin: RegisteredPlugin) => Boolean(plugin.manifest.configuration?.fields.length);
const canConfigurePlugin = (plugin: RegisteredPlugin) => hasPluginConfiguration(plugin) && user?.role === "admin";
const isPluginEnabled = (plugin: RegisteredPlugin, installation = installations.find((item) => item.manifest.id === plugin.manifest.id)) =>
plugin.manifest.kind === "protocol" ? backendPluginById.get(plugin.manifest.id)?.status === "enabled" : Boolean(installation?.enabled);
const togglePlugin = async (plugin: RegisteredPlugin, enabled: boolean) => {
if (plugin.manifest.kind !== "protocol") {
setEnabled(plugin.manifest.id, enabled);
return;
}
try {
const next = await setPluginEnabled(plugin.manifest.id, enabled);
setBackendPlugins((items) => items.map((item) => (item.manifest.id === next.manifest.id ? next : item)));
message.success(`${plugin.manifest.name}${enabled ? "已启用" : "已停用"}`);
} catch (error) {
message.error(error instanceof Error ? error.message : "更新插件状态失败");
}
};
const handleUpload = async (file: File) => {
try {
const plugin = await uploadPlugin(file);
setBackendPlugins((items) => [...items.filter((item) => item.manifest.id !== plugin.manifest.id), plugin]);
setUploadModalOpen(false);
message.success("插件已安装并立即生效");
} catch (error) {
message.error(error instanceof Error ? error.message : "安装插件失败");
}
};
const loadEagleFolders = async (url = eagleBaseUrl) => {
setEagleFoldersLoading(true);
@@ -126,173 +222,329 @@ export default function PluginsPage() {
return (
<main className="app-workspace-page plugins-page flex h-full min-h-0 flex-col text-foreground">
<div className="app-workspace-scroll min-h-0 flex-1 overflow-y-auto">
<div className="plugins-page-content">
<div className="plugins-toolbar" aria-label="插件筛选">
<Input
className="plugins-search"
prefix={<Search className="size-4 text-foreground/38" aria-hidden="true" />}
value={search}
allowClear
placeholder="搜索插件名称、描述或作者"
onChange={(event) => setSearch(event.target.value)}
/>
<Select className="plugins-filter" value={categoryFilter} options={categoryOptions} onChange={setCategoryFilter} aria-label="按分类筛选" />
<Select
className="plugins-filter"
value={statusFilter}
options={[{ value: "all", label: "全部状态" }, { value: "enabled", label: "已启用" }, { value: "disabled", label: "未启用" }]}
onChange={(value) => setStatusFilter(value as "all" | "enabled" | "disabled")}
aria-label="按状态筛选"
/>
<Select
className="plugins-filter"
value={trustFilter}
options={[{ value: "all", label: "全部来源" }, { value: "trusted", label: "可信插件" }]}
onChange={(value) => setTrustFilter(value as "all" | "trusted")}
aria-label="按来源筛选"
/>
<span className="plugins-filter-icon" aria-hidden="true"><SlidersHorizontal className="size-4" /></span>
</div>
{filteredPlugins.length ? (
<div className="plugins-grid">
{filteredPlugins.map((plugin) => {
const installation = installations.find((item) => item.manifest.id === plugin.manifest.id);
const enabled = Boolean(installation?.enabled);
const trusted = Boolean(plugin.manifest.trusted);
<div className="plugins-page-layout">
<aside className="plugins-sidebar" aria-label="插件分类">
<div className="plugins-sidebar-heading">
<span className="plugins-sidebar-kicker">PLUGIN CENTER</span>
<h1>插件中心</h1>
<p>统一管理能力插件与模型请求协议。</p>
</div>
<nav className="plugins-sidebar-nav">
<button type="button" className={`plugins-sidebar-item${categoryFilter === "all" ? " is-active" : ""}`} aria-current={categoryFilter === "all" ? "page" : undefined} onClick={() => setCategoryFilter("all")}>
<span className="plugins-sidebar-item-label">
<PlugZap className="size-4" />
全部插件
</span>
<span>{categoryCounts.all}</span>
</button>
{protocolSectionMeta.map((section) => {
const SectionIcon = section.icon;
return (
<section key={plugin.manifest.id} className={`plugin-card library-card-surface${trusted ? " is-trusted" : ""}`}>
<div className="plugin-card-main">
<div className="plugin-card-heading">
<span className={`plugin-icon-tile${trusted ? " is-trusted" : ""}`} aria-hidden="true">
<PlugZap className="size-5" />
</span>
<div className="min-w-0 flex-1">
<div className="plugin-card-title-row">
<h3>{plugin.manifest.name}</h3>
<span className="plugin-version">v{plugin.manifest.version}</span>
</div>
<div className="plugin-card-labels">
{trusted ? <span className="plugin-trust-label"><ShieldCheck className="size-3.5" />可信插件</span> : null}
<span className="plugin-category-label">{categoryLabels[plugin.manifest.category] ?? plugin.manifest.category}</span>
</div>
</div>
</div>
<p className="plugin-card-description">{plugin.manifest.description}</p>
<div className="plugin-card-meta">
<span><CalendarDays className="size-3.5" />发布 {formatPluginDate(plugin.manifest.publishedAt)}</span>
<span><Clock3 className="size-3.5" />更新 {formatPluginDate(plugin.manifest.updatedAt)}</span>
</div>
<div className="plugin-card-tags">
{plugin.manifest.surfaces.map((surface) => <span key={surface}>{surfaceLabels[surface] ?? surface}</span>)}
<span>{plugin.manifest.permissions.length} 项能力</span>
</div>
</div>
<div className="plugin-card-actions">
<span role="status" className={`settings-channel-status ${enabled ? "is-ready" : ""}`}>
<i aria-hidden="true" />
{enabled ? "已启用" : "未启用"}
</span>
<Switch checked={enabled} aria-label={`${plugin.manifest.name}${enabled ? "停用" : "启用"}`} onChange={(checked) => setEnabled(plugin.manifest.id, checked)} />
<Button
className="plugin-settings-button"
icon={<Settings2 className="size-4" />}
aria-expanded={settingsPluginId === plugin.manifest.id}
aria-haspopup="dialog"
onClick={() => setSettingsPluginId(plugin.manifest.id)}
>
设置
</Button>
</div>
{installation?.lastError ? <Typography.Text type="danger" className="plugin-error" role="alert">{installation.lastError}</Typography.Text> : null}
</section>
<button
key={section.key}
type="button"
className={`plugins-sidebar-item${categoryFilter === section.key ? " is-active" : ""}`}
aria-current={categoryFilter === section.key ? "page" : undefined}
onClick={() => setCategoryFilter(section.key)}
>
<span className="plugins-sidebar-item-label">
<SectionIcon className="size-4" />
{section.label}
</span>
<span>{categoryCounts[section.key] || 0}</span>
</button>
);
})}
</div>
) : (
<div className="plugins-empty-state">
<SlidersHorizontal className="size-7" aria-hidden="true" />
<h3>没有匹配的插件</h3>
<p>试试清空搜索词,或放宽筛选条件。</p>
<Button onClick={() => { setSearch(""); setCategoryFilter("all"); setStatusFilter("all"); setTrustFilter("all"); }}>清除筛选</Button>
</div>
)}
<Modal
className="workspace-modal workspace-modal-wide plugin-settings-modal"
title={settingsPlugin ? `${settingsPlugin.manifest.name} 设置` : null}
open={Boolean(settingsPlugin)}
centered
footer={null}
destroyOnHidden
onCancel={() => setSettingsPluginId(null)}
styles={{ body: { maxHeight: "min(72vh, 760px)", overflowY: "auto", overscrollBehavior: "contain" } }}
>
{settingsPlugin ? (
<div className="plugin-settings-panel plugin-settings-modal-panel">
<div className="plugin-settings-heading">
<div>
<p>只展示这个插件实际支持的配置项。</p>
</div>
{settingsPlugin.manifest.trusted ? <span className="plugin-trust-label"><ShieldCheck className="size-3.5" />可信插件</span> : <span className="plugin-category-label">第三方插件</span>}
<button type="button" className={`plugins-sidebar-item${categoryFilter === "other" ? " is-active" : ""}`} aria-current={categoryFilter === "other" ? "page" : undefined} onClick={() => setCategoryFilter("other")}>
<span className="plugins-sidebar-item-label">
<PlugZap className="size-4" />
应用插件
</span>
<span>{categoryCounts.other}</span>
</button>
</nav>
</aside>
<div className="plugins-page-content">
<div className="plugins-toolbar" aria-label="插件筛选">
<Input
className="plugins-search"
prefix={<Search className="size-4 text-foreground/38" aria-hidden="true" />}
value={search}
allowClear
placeholder="搜索插件名称、描述或作者"
onChange={(event) => setSearch(event.target.value)}
/>
<Select
className="plugins-filter"
value={statusFilter}
options={[
{ value: "all", label: "全部状态" },
{ value: "enabled", label: "已启用" },
{ value: "disabled", label: "未启用" },
]}
onChange={(value) => setStatusFilter(value as "all" | "enabled" | "disabled")}
aria-label="按状态筛选"
/>
<Select
className="plugins-filter"
value={trustFilter}
options={[
{ value: "all", label: "全部来源" },
{ value: "trusted", label: "可信插件" },
]}
onChange={(value) => setTrustFilter(value as "all" | "trusted")}
aria-label="按来源筛选"
/>
<span className="plugins-filter-icon" aria-hidden="true">
<SlidersHorizontal className="size-4" />
</span>
{user?.role === "admin" ? (
<div className="plugins-toolbar-actions">
<Button icon={<RefreshCw className="size-4" />} loading={backendPluginsLoading} onClick={() => void reloadBackendPlugins()}>
刷新插件
</Button>
<Button type="primary" icon={<CloudUpload className="size-4" />} onClick={() => setUploadModalOpen(true)}>
上传插件
</Button>
</div>
) : null}
</div>
{settingsPlugin.manifest.id === EAGLE_PLUGIN_ID ? (
<>
<div className="plugin-settings-fields">
<div className="min-w-0">
<label htmlFor="eagle-base-url">Eagle 本地 API 地址</label>
<Input id="eagle-base-url" aria-label="Eagle 本地 API 地址" value={eagleBaseUrl} onChange={(event) => setEagleBaseUrl(event.target.value)} placeholder="http://localhost:41595" />
<p>Eagle 必须在本机运行;影策通过插件直接读取和写入 Eagle 原始文件。</p>
</div>
<div className="min-w-0">
<div className="plugin-setting-label-row">
<label htmlFor="eagle-auto-upload-generated">自动归档生成结果</label>
<Switch id="eagle-auto-upload-generated" checked={eagleAutoUploadGenerated} onChange={setEagleAutoUploadGenerated} aria-label="自动归档生成结果到 Eagle" />
{filteredPlugins.length ? (
<div className="plugins-sections">
{pluginSections.map((section) => {
if (!section.plugins.length) return null;
const SectionIcon = section.icon;
return (
<section key={section.key} className="plugin-section">
<header className="plugin-section-heading">
<span className="plugin-section-icon">
<SectionIcon className="size-4" />
</span>
<div>
<h2>{section.label}</h2>
<p>{section.description}</p>
</div>
<p>图片、视频和音频生成成功后,自动写入 Eagle;影策本地素材仍会保留。</p>
</div>
<div className="min-w-0">
<div className="plugin-setting-label-row">
<label htmlFor="eagle-generated-folder">生成结果写入文件夹</label>
<Button type="link" size="small" loading={eagleFoldersLoading} onClick={() => void loadEagleFolders()}>读取文件夹</Button>
</div>
<Select
id="eagle-generated-folder"
aria-label="生成结果写入文件夹"
showSearch
allowClear
value={eagleGeneratedFolderId || undefined}
placeholder="Eagle 根目录"
optionFilterProp="label"
options={[{ value: "__root__", label: "Eagle 根目录" }, ...eagleFolderOptions(eagleFolders)]}
onChange={(value) => setEagleGeneratedFolderId(value === "__root__" || !value ? "" : value)}
/>
<p>{eagleFoldersError || "默认写入 Eagle 根目录;选择文件夹后按 Eagle 原始目录归档。"}</p>
</div>
</div>
<div className="plugin-settings-actions">
<Button type="primary" icon={<CheckCircle2 className="size-4" />} onClick={saveEagleConfig}>保存配置</Button>
<Button icon={<FolderOpen className="size-4" />} disabled={!settingsEnabled} onClick={() => navigate("/plugins/eagle")}>打开 Eagle 素材库</Button>
<Button icon={<ExternalLink className="size-4" />} href="https://api.eagle.cool/" target="_blank">查看 API</Button>
</div>
</>
) : (
<div className="plugin-settings-empty">该插件暂无可编辑设置项。当前接入位置和权限会根据插件清单自动生效。</div>
)}
<span className="plugin-section-count">{section.plugins.length}</span>
</header>
<div className="plugins-grid">
{section.plugins.map((plugin) => {
const installation = installations.find((item) => item.manifest.id === plugin.manifest.id);
const remote = backendPluginById.get(plugin.manifest.id);
const enabled = isPluginEnabled(plugin, installation);
const trusted = Boolean(plugin.manifest.trusted);
const isSystemPlugin = plugin.source !== "uploaded";
const canConfigure = canConfigurePlugin(plugin);
return (
<section key={plugin.manifest.id} className={`plugin-card library-card-surface${trusted ? " is-trusted" : ""}`}>
<button
type="button"
className="plugin-card-main"
aria-label={`查看${plugin.manifest.name}文档`}
onClick={(event) => {
const openedByKeyboard = event.detail === 0;
setDetailsRestoreFocus(openedByKeyboard);
setDetailsPluginId(plugin.manifest.id);
if (!openedByKeyboard) event.currentTarget.blur();
}}
>
<div className="plugin-card-heading">
<span className={`plugin-icon-tile${trusted ? " is-trusted" : ""}`} aria-hidden="true">
<PlugZap className="size-5" />
</span>
<div className="min-w-0 flex-1">
<div className="plugin-card-title-row">
<h3>{plugin.manifest.name}</h3>
<span className="plugin-version">v{plugin.manifest.version}</span>
</div>
<div className="plugin-card-labels">
<span className={`plugin-source-label${isSystemPlugin ? " is-system" : ""}`}>
{isSystemPlugin ? "系统插件" : "用户插件"}
</span>
{trusted ? (
<span className="plugin-trust-label">
<ShieldCheck className="size-3.5" />
可信插件
</span>
) : null}
<span className="plugin-category-label">{categoryLabels[plugin.manifest.category] ?? plugin.manifest.category}</span>
</div>
</div>
</div>
<div className="plugin-permissions">
<div><span>接入位置</span>{settingsPlugin.manifest.surfaces.map((surface) => surfaceLabels[surface] ?? surface).join("、")}</div>
<div><span>插件能力</span>{settingsPlugin.manifest.permissions.map((permission) => permissionLabels[permission] ?? permission).join("、")}</div>
</div>
<p className="plugin-card-description">{plugin.manifest.description}</p>
<div className="plugin-card-meta">
<span>
<CalendarDays className="size-3.5" />
发布 {formatPluginDate(plugin.manifest.publishedAt)}
</span>
<span>
<Clock3 className="size-3.5" />
更新 {formatPluginDate(plugin.manifest.updatedAt)}
</span>
</div>
<div className="plugin-card-tags">
{plugin.manifest.surfaces.map((surface) => (
<span key={surface}>{surfaceLabels[surface] ?? surface}</span>
))}
{plugin.manifest.protocol?.categories.map((capability) => (
<span key={capability}>{capabilityLabel(capability)}</span>
))}
{plugin.manifest.protocol?.poll ? <span>异步轮询</span> : null}
<span>{plugin.manifest.permissions.length} 项能力</span>
</div>
</button>
<div className="plugin-card-actions">
<span role="status" className={`settings-channel-status ${enabled ? "is-ready" : ""}`}>
<i aria-hidden="true" />
{enabled ? "已启用" : "未启用"}
</span>
<Switch disabled={user?.role !== "admin"} checked={enabled} aria-label={`${plugin.manifest.name}${enabled ? "停用" : "启用"}`} onChange={(checked) => void togglePlugin(plugin, checked)} />
{canConfigure ? (
<Button
className="plugin-settings-button"
icon={<Settings2 className="size-4" />}
aria-expanded={settingsPluginId === plugin.manifest.id}
aria-haspopup="dialog"
onClick={() => setSettingsPluginId(plugin.manifest.id)}
>
设置
</Button>
) : null}
</div>
{installation?.lastError || remote?.error ? (
<Typography.Text type="danger" className="plugin-error" role="alert">
{installation?.lastError || remote?.error}
</Typography.Text>
) : null}
</section>
);
})}
</div>
</section>
);
})}
</div>
) : null}
</Modal>
) : (
<div className="plugins-empty-state">
<SlidersHorizontal className="size-7" aria-hidden="true" />
<h3>没有匹配的插件</h3>
<p>试试清空搜索词,或放宽筛选条件。</p>
<Button
onClick={() => {
setSearch("");
setCategoryFilter("all");
setStatusFilter("all");
setTrustFilter("all");
}}
>
清除筛选
</Button>
</div>
)}
<UploadPluginModal open={uploadModalOpen} onClose={() => setUploadModalOpen(false)} onUpload={(file) => void handleUpload(file)} />
<Modal
className="workspace-modal workspace-modal-wide plugin-settings-modal"
title={settingsPlugin ? `${settingsPlugin.manifest.name} 设置` : null}
open={Boolean(settingsPlugin)}
centered
footer={null}
destroyOnHidden
onCancel={() => setSettingsPluginId(null)}
styles={{ body: { maxHeight: "min(72vh, 760px)", overflowY: "auto", overscrollBehavior: "contain" } }}
>
{settingsPlugin ? (
<div className="plugin-settings-panel plugin-settings-modal-panel">
<div className="plugin-settings-heading">
<div>
<p>只展示这个插件实际支持的配置项。</p>
</div>
{settingsPlugin.manifest.trusted ? (
<span className="plugin-trust-label">
<ShieldCheck className="size-3.5" />
可信插件
</span>
) : (
<span className="plugin-category-label">第三方插件</span>
)}
</div>
{settingsPlugin.manifest.id === EAGLE_PLUGIN_ID ? (
<>
<div className="plugin-settings-fields">
<div className="min-w-0">
<label htmlFor="eagle-base-url">Eagle 本地 API 地址</label>
<Input id="eagle-base-url" aria-label="Eagle 本地 API 地址" value={eagleBaseUrl} onChange={(event) => setEagleBaseUrl(event.target.value)} placeholder="http://localhost:41595" />
<p>Eagle 必须在本机运行;影策通过插件直接读取和写入 Eagle 原始文件。</p>
</div>
<div className="min-w-0">
<div className="plugin-setting-label-row">
<label htmlFor="eagle-auto-upload-generated">自动归档生成结果</label>
<Switch id="eagle-auto-upload-generated" checked={eagleAutoUploadGenerated} onChange={setEagleAutoUploadGenerated} aria-label="自动归档生成结果到 Eagle" />
</div>
<p>图片、视频和音频生成成功后,自动写入 Eagle;影策本地素材仍会保留。</p>
</div>
<div className="min-w-0">
<div className="plugin-setting-label-row">
<label htmlFor="eagle-generated-folder">生成结果写入文件夹</label>
<Button type="link" size="small" loading={eagleFoldersLoading} onClick={() => void loadEagleFolders()}>
读取文件夹
</Button>
</div>
<Select
id="eagle-generated-folder"
aria-label="生成结果写入文件夹"
showSearch
allowClear
value={eagleGeneratedFolderId || undefined}
placeholder="Eagle 根目录"
optionFilterProp="label"
options={[{ value: "__root__", label: "Eagle 根目录" }, ...eagleFolderOptions(eagleFolders)]}
onChange={(value) => setEagleGeneratedFolderId(value === "__root__" || !value ? "" : value)}
/>
<p>{eagleFoldersError || "默认写入 Eagle 根目录;选择文件夹后按 Eagle 原始目录归档。"}</p>
</div>
</div>
<div className="plugin-settings-actions">
<Button type="primary" icon={<CheckCircle2 className="size-4" />} onClick={saveEagleConfig}>
保存配置
</Button>
<Button icon={<FolderOpen className="size-4" />} disabled={!settingsEnabled} onClick={() => navigate("/plugins/eagle")}>
打开 Eagle 素材库
</Button>
<Button icon={<ExternalLink className="size-4" />} href="https://api.eagle.cool/" target="_blank">
查看 API
</Button>
</div>
</>
) : (
<div className="plugin-settings-empty">
{settingsPlugin.manifest.kind === "protocol"
? `协议能力:${settingsPlugin.manifest.protocol?.categories.map(capabilityLabel).join("、") || "未声明"};可用场景:${settingsPlugin.manifest.protocol?.scopes.join("、") || "未声明"}。`
: "该插件暂无可编辑设置项。当前接入位置和权限会根据插件清单自动生效。"}
</div>
)}
<div className="plugin-permissions">
<div>
<span>接入位置</span>
{settingsPlugin.manifest.surfaces.map((surface) => surfaceLabels[surface] ?? surface).join("、")}
</div>
<div>
<span>插件能力</span>
{settingsPlugin.manifest.permissions.map((permission) => permissionLabels[permission] ?? permission).join("、")}
</div>
</div>
</div>
) : null}
</Modal>
<PluginDetailsModal plugin={detailsPlugin} restoreFocus={detailsRestoreFocus} onClose={() => setDetailsPluginId(null)} />
</div>
</div>
</div>
</main>
@@ -305,6 +557,30 @@ function formatPluginDate(value?: string) {
return Number.isFinite(timestamp) ? pluginDateFormatter.format(timestamp) : "未记录";
}
function toRegisteredPlugin(plugin: BackendPlugin): RegisteredPlugin {
const manifest: PluginManifest = {
id: plugin.manifest.id,
name: plugin.manifest.name,
version: plugin.manifest.version,
publishedAt: plugin.installedAt,
updatedAt: plugin.updatedAt,
apiVersion: plugin.manifest.apiVersion,
category: "protocol",
description: plugin.manifest.description || "模型请求协议适配插件",
author: plugin.manifest.author,
surfaces: ["hybrid"],
permissions: ["generation.run"],
trusted: plugin.manifest.trusted,
kind: "protocol",
protocol: plugin.manifest.protocol,
};
return { manifest, source: plugin.source };
}
function capabilityLabel(value: string) {
return ({ text: "文本", image: "图片", video: "视频", audio: "音频" } as Record<string, string>)[value] || value;
}
function eagleFolderOptions(folders: EagleFolder[]) {
const byId = new Map(folders.map((folder) => [folder.id, folder]));
const pathFor = (folder: EagleFolder) => {
@@ -318,7 +594,5 @@ function eagleFolderOptions(folders: EagleFolder[]) {
}
return path.join(" / ");
};
return folders
.map((folder) => ({ value: folder.id, label: pathFor(folder) }))
.sort((left, right) => left.label.localeCompare(right.label, "zh-CN"));
return folders.map((folder) => ({ value: folder.id, label: pathFor(folder) })).sort((left, right) => left.label.localeCompare(right.label, "zh-CN"));
}

View File

@@ -0,0 +1,167 @@
# 上传请求协议插件
当前上传入口只安装**声明式请求协议插件**。它把影策统一的文本、图片、视频或音频请求转换为上游 HTTP API,并解析上游响应。素材源、画布节点、工作流、Agent 工具和 UI 扩展仍由应用代码注册,不能通过这里上传 JSON 安装。
## 1. 准备清单
上传文件必须是 UTF-8 JSON,大小不超过 512 KiB。插件 ID 使用小写 kebab-case;请求路径必须是相对路径;清单不得包含域名、Cookie 或 API Key。
```json
{
"apiVersion": "v1",
"metadata": {
"id": "acme-video",
"name": "Acme Video API",
"version": "1.0.0",
"vendor": "Acme",
"description": "Acme 视频生成协议适配",
"categories": ["video"],
"scopes": [
"admin.system-channel",
"user.custom-channel",
"canvas",
"creation",
"agent"
],
"contentType": "application/json",
"parameters": [
{
"name": "model",
"type": "string",
"required": true,
"mapping": "model",
"description": "上游模型名"
},
{
"name": "prompt",
"type": "string",
"required": true,
"mapping": "input.prompt",
"description": "视频描述"
},
{
"name": "duration",
"type": "integer",
"mapping": "input.seconds",
"description": "生成时长,单位为秒"
}
],
"documentation": "# Acme Video API\n\n在这里写完整的 Markdown 接入文档。"
},
"create": {
"method": "POST",
"path": "/v1/videos",
"fields": {
"model": "request.model",
"input.prompt": "request.prompt",
"input.seconds": "request.duration"
}
},
"poll": {
"method": "GET",
"path": "/v1/videos/{{taskId}}"
},
"response": {
"taskIdPaths": ["id", "task_id"],
"statusPaths": ["status", "data.status"],
"messagePaths": ["error.message", "message"],
"resultUrlPaths": ["url", "video.url", "data.0.url"],
"resultKind": "video"
}
}
```
`fields` 左侧是上游请求字段路径,右侧是影策请求字段。同步协议只需要 `create` 和 `response`;异步协议再声明 `poll`。清单不会执行 JavaScript,也不能使用 `host:` 执行器。
### 同步文本响应
文本模型不一定需要创建任务后轮询。如果上游在创建请求中直接返回正文,可以只声明 `create` 和 `response`,例如:
```json
{
"create": {
"method": "POST",
"path": "/v1/chat/completions",
"fields": {
"model": "request.model",
"messages": "request.messages"
}
},
"response": {
"textPaths": ["choices.0.message.content"],
"reasoningPaths": ["choices.0.message.reasoning_content"]
}
}
```
- `response.textPaths` 按顺序尝试读取文本正文,支持对象路径和数组下标。
- `response.reasoningPaths` 是可选的,用于读取推理内容;没有该字段时不会影响正文解析。
- 如果没有声明 `statusPaths`,但解析到了文本或媒体结果,宿主会将本次响应视为成功。
- `agentResponse` 只负责 Agent 工具请求的响应解析,与普通文本请求的 `response` 相互独立。
## 2. 编写接入文档
`metadata.documentation` 是插件详情页展示的 Markdown 正文,不是可选简介。至少写清楚:
- 接口与鉴权:创建、查询和取消接口的 Method、Path、Header 与 Content-Type。
- 模型与参数:可用模型名、类型、必填性、默认值、可选值及字段映射。
- 素材限制:数量、格式、大小、时长,以及 URL 可访问性要求。
- 请求与响应:提交成功、处理中、完成和失败的真实示例。
- 轮询与下载:状态值、建议间隔、超时和结果 URL 有效期。
- 错误处理:HTTP 状态、上游错误字段、内容审核和额度限制。
文档中的路径、模型名和响应字段必须与清单实现一致。详情页支持标题、表格、列表、引用、链接和代码块,并按 GitHub Flavored Markdown 预览。
## 3. 上传前检查
| 检查项 | 要求 |
| --- | --- |
| 标识 | `apiVersion` 为 `v1`,ID 为 kebab-case,名称和版本不为空 |
| 能力 | 至少声明一个 `category` 和一个 `scope` |
| 请求 | Method 受支持,Path 为相对路径,字段映射来自 `request.*` |
| 响应 | 任务 ID、状态、错误和结果地址路径与真实响应一致 |
| 文档 | `metadata.documentation` 完整,并与实现同步 |
| 安全 | 不包含域名、密钥、Cookie、个人数据或 `host:` 执行器 |
上传、启用和停用属于管理员写操作。校验失败时插件不会安装;已安装协议停用后,模型配置入口不再提供该协议。
## 4. Agent 工具请求协议
如果协议同时服务于画布 Agent,请额外声明 `agent` 和 `agentResponse`。`agent.fields` 的右侧可以访问:
- `request.model`
- `request.extra.agent.chatCompletion.*`
- `request.extra.agent.responses.*`
这样同一个插件可以由字段映射决定第三方的消息、工具定义和工具选择,不需要在前端为某个模型写死 URL 或请求格式。示例:
```json
{
"agent": {
"method": "POST",
"path": "/v1/chat/completions",
"fields": {
"model": "request.model",
"messages": "request.extra.agent.chatCompletion.messages",
"tools": "request.extra.agent.chatCompletion.tools",
"tool_choice": "request.extra.agent.chatCompletion.tool_choice"
}
},
"agentResponse": {
"textPaths": ["choices.0.message.content"],
"reasoningPaths": ["choices.0.message.reasoning_content"],
"toolCallsPath": "choices.0.message.tool_calls",
"toolCallIdPaths": ["id"],
"toolCallNamePaths": ["function.name"],
"toolCallArgumentsPaths": ["function.arguments"]
}
}
```
`agentResponse` 的路径支持对象和数组下标(例如 `choices.0.message.content`)。第三方返回的 `tool_calls[].function.arguments` 可以是 JSON 字符串,也可以是 JSON 对象;宿主会统一转换为 Agent 合同要求的字符串。Agent 请求仍由后端统一负责鉴权、私网/本机上游校验、超时、日志和计费;插件只负责字段映射与结果解析。
## 5. 运行边界
声明式插件是请求协议运行时:它负责第三方 HTTP 方法、相对路径、请求字段映射、同步/异步响应解析、轮询状态、任务 ID、错误消息和结果地址。系统渠道和用户自建渠道只要选择了明确的协议,都会经过后端协议运行时,不依赖前端为某个模型硬编码请求格式。
宿主负责鉴权、Base URL 版本归一化、私网/本机上游安全校验、出站请求、超时、并发、计费、轮询生命周期、结果下载和任务恢复。内置的 multipart、签名鉴权、特殊媒体下载等协议仍由宿主内置 adapter 承担;上传的第三方插件必须使用声明式字段映射,不能上传可执行代码。

View File

@@ -0,0 +1,92 @@
import { Modal, Upload } from "antd";
import { CloudUpload, FileText, ShieldCheck } from "lucide-react";
import type { RegisteredPlugin } from "@/lib/plugins/plugin-types";
import pluginDevelopmentGuideMarkdown from "./plugin-development-guide.md?raw";
import { getPluginDocumentation } from "./plugin-documentation";
import { PluginMarkdown } from "./plugin-markdown";
type UploadPluginModalProps = {
open: boolean;
onClose: () => void;
onUpload: (file: File) => void;
};
export function UploadPluginModal({ open, onClose, onUpload }: UploadPluginModalProps) {
return (
<Modal
className="workspace-modal workspace-modal-wide plugin-upload-modal"
title="上传插件"
open={open}
centered
footer={null}
destroyOnHidden
onCancel={onClose}
styles={{ body: { maxHeight: "min(82vh, 900px)", overflowY: "auto", overscrollBehavior: "contain" } }}
>
<div className="plugin-upload-layout">
<section className="plugin-upload-guide">
<PluginMarkdown source={pluginDevelopmentGuideMarkdown} />
</section>
<aside className="plugin-upload-panel">
<div className="plugin-upload-panel-heading">
<span className="plugin-upload-panel-icon"><CloudUpload className="size-5" /></span>
<div>
<h2>安装插件包</h2>
<p>选择符合清单规范的 JSON 文件,安装后会立即进入插件中心。</p>
</div>
</div>
<Upload.Dragger
className="plugin-upload-dropzone"
accept=".json,application/json"
maxCount={1}
showUploadList={false}
beforeUpload={(file) => {
onUpload(file);
return false;
}}
>
<CloudUpload className="plugin-upload-dropzone-icon" />
<p className="ant-upload-text">点击选择插件文件</p>
<p className="ant-upload-hint">仅支持 JSON 清单,大小不超过 512 KiB</p>
</Upload.Dragger>
<div className="plugin-upload-notice">
<ShieldCheck className="size-4" />
<span>上传前请确认插件来源可信。协议插件不会在浏览器执行任意脚本,密钥也不会从清单读取。</span>
</div>
</aside>
</div>
</Modal>
);
}
type PluginDetailsModalProps = {
plugin?: RegisteredPlugin;
restoreFocus: boolean;
onClose: () => void;
};
export function PluginDetailsModal({ plugin, restoreFocus, onClose }: PluginDetailsModalProps) {
return (
<Modal
className="workspace-modal workspace-modal-wide plugin-details-modal"
title={plugin ? (
<div className="plugin-details-title">
<FileText className="size-4" />
<span>{plugin.manifest.name}</span>
<span className="plugin-version">v{plugin.manifest.version}</span>
</div>
) : null}
open={Boolean(plugin)}
centered
footer={null}
destroyOnHidden
focusTriggerAfterClose={restoreFocus}
onCancel={onClose}
styles={{ body: { maxHeight: "min(78vh, 820px)", overflowY: "auto", overscrollBehavior: "contain" } }}
>
{plugin ? <PluginMarkdown className="plugin-details-document" source={getPluginDocumentation(plugin.manifest)} /> : null}
</Modal>
);
}

View File

@@ -0,0 +1,35 @@
import type { PluginManifest } from "@/lib/plugins/plugin-types";
const permissionLabels: Record<string, string> = {
"canvas.read": "读取画布",
"canvas.write": "修改画布",
"asset.read": "读取素材",
"asset.search": "搜索素材",
"asset.import": "导入素材",
"asset.upload": "上传素材",
"generation.run": "调用生成",
"external.open": "打开外部详情",
};
export function getPluginDocumentation(manifest: PluginManifest) {
const documentation = manifest.protocol?.documentation?.trim();
if (documentation) return documentation;
if (manifest.documentation?.trim()) return manifest.documentation.trim();
const capabilities = manifest.permissions.map((permission) => permissionLabels[permission] || permission);
return [
`# ${manifest.name}`,
"",
manifest.description || "该插件没有提供简介。",
"",
"## 插件信息",
"",
`- 作者:${manifest.author || "未声明"}`,
`- 版本:${manifest.version}`,
`- 能力:${capabilities.join("、") || "未声明"}`,
"",
manifest.kind === "protocol"
? "> 此请求协议没有提供接入文档。请联系插件作者补充 `metadata.documentation`,不要仅凭清单字段推测上游接口。"
: "> 该插件当前没有单独的使用文档。",
].join("\n");
}

View File

@@ -0,0 +1,27 @@
import ReactMarkdown from "react-markdown";
import remarkGfm from "remark-gfm";
type PluginMarkdownProps = {
source: string;
className?: string;
};
export function PluginMarkdown({ source, className = "" }: PluginMarkdownProps) {
return (
<div className={`plugin-markdown ${className}`.trim()}>
<ReactMarkdown
remarkPlugins={[remarkGfm]}
components={{
a: ({ children, href }) => <a href={href} target="_blank" rel="noreferrer">{children}</a>,
table: ({ children }) => (
<div className="plugin-markdown-table-wrap">
<table>{children}</table>
</div>
),
}}
>
{source}
</ReactMarkdown>
</div>
);
}

View File

@@ -1,10 +1,5 @@
.plugins-page {
--plugins-card-radius: var(--r-xl);
}
.plugins-page-content {
width: min(100%, 1440px);
margin: 0 auto;
--plugins-card-radius: var(--r-md);
}
.plugin-trust-label {
@@ -16,16 +11,140 @@
}
.plugins-page-content {
width: auto;
min-width: 0;
margin: 0;
padding: var(--space-5) var(--space-6) var(--space-8);
}
.plugins-page-layout {
display: grid;
width: 100%;
min-height: 100%;
margin: 0;
grid-template-columns: 208px minmax(0, 1fr);
align-items: start;
}
.plugins-sidebar {
position: sticky;
top: 0;
min-width: 0;
min-height: calc(100vh - 72px);
border-right: 1px solid var(--workspace-border);
padding: var(--space-6) var(--space-3) var(--space-8) var(--space-5);
}
.plugins-sidebar-heading {
padding: 0 var(--space-2) var(--space-4);
}
.plugins-sidebar-kicker {
color: var(--workspace-accent);
font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
font-size: 10px;
font-weight: 700;
letter-spacing: 0.08em;
}
.plugins-sidebar-heading h1 {
margin-top: var(--space-2);
color: var(--foreground);
font-size: var(--fs-title);
font-weight: 700;
line-height: 1.3;
}
.plugins-sidebar-heading p {
margin-top: var(--space-2);
color: color-mix(in srgb, var(--foreground) 44%, transparent);
font-size: var(--fs-label);
line-height: 1.55;
}
.plugins-sidebar-nav {
display: grid;
gap: var(--space-1);
}
.plugins-sidebar-item {
display: flex;
width: 100%;
min-height: 36px;
align-items: center;
justify-content: space-between;
gap: var(--space-2);
border: 1px solid transparent;
border-radius: var(--r-sm);
background: transparent;
padding: 0 var(--space-2);
color: color-mix(in srgb, var(--foreground) 53%, transparent);
font-size: var(--fs-caption);
text-align: left;
cursor: pointer;
transition:
background-color var(--motion-state) ease-out,
color var(--motion-state) ease-out;
}
.plugins-sidebar-item:hover {
background: color-mix(in srgb, var(--foreground) 6%, transparent);
color: var(--foreground);
}
.plugins-sidebar-item:focus-visible {
background: color-mix(in srgb, var(--foreground) 6%, transparent);
color: var(--foreground);
outline: 2px solid color-mix(in srgb, var(--foreground) 58%, transparent);
outline-offset: 2px;
}
.plugins-sidebar-item.is-active {
border-color: color-mix(in srgb, var(--foreground) 11%, transparent);
background: color-mix(in srgb, var(--foreground) 7%, transparent);
color: var(--foreground);
font-weight: 600;
box-shadow: none;
}
.plugins-sidebar-item > span:last-child {
min-width: 22px;
border-radius: var(--r-sm);
background: transparent;
padding: 2px 5px;
color: color-mix(in srgb, var(--foreground) 36%, transparent);
font-size: var(--fs-label);
font-variant-numeric: tabular-nums;
text-align: right;
}
.plugins-sidebar-item.is-active > span:last-child {
color: color-mix(in srgb, var(--foreground) 62%, transparent);
background: transparent;
}
.plugins-sidebar-item-label {
display: inline-flex;
min-width: 0;
align-items: center;
gap: var(--space-2);
}
.plugins-toolbar {
display: grid;
grid-template-columns: minmax(240px, 1fr) repeat(3, minmax(132px, 0.24fr)) auto;
grid-template-columns: minmax(260px, 1fr) repeat(2, minmax(128px, 0.24fr)) auto auto;
align-items: center;
gap: var(--space-2);
}
.plugins-toolbar-actions {
display: flex;
align-items: center;
justify-content: flex-end;
gap: var(--space-2);
white-space: nowrap;
}
.plugins-search,
.plugins-filter {
min-width: 0;
@@ -56,32 +175,120 @@
color: color-mix(in srgb, var(--foreground) 48%, transparent);
}
.plugins-sections {
display: grid;
gap: var(--space-8);
margin-top: var(--space-8);
}
.plugin-section {
min-width: 0;
}
.plugin-section-heading {
display: flex;
min-width: 0;
align-items: center;
gap: var(--space-3);
padding-bottom: var(--space-3);
border-bottom: 1px solid var(--workspace-border);
}
.plugin-section-icon {
display: grid;
width: 34px;
height: 34px;
flex: 0 0 auto;
place-items: center;
border: 1px solid var(--workspace-border);
border-radius: var(--r-md);
background: color-mix(in srgb, var(--foreground) 5%, transparent);
color: color-mix(in srgb, var(--foreground) 68%, transparent);
}
.plugin-section-heading > div {
min-width: 0;
}
.plugin-section-heading h2 {
color: var(--foreground);
font-size: var(--fs-body-lg);
font-weight: 700;
line-height: 1.35;
}
.plugin-section-heading p {
margin-top: var(--space-half);
color: color-mix(in srgb, var(--foreground) 46%, transparent);
font-size: var(--fs-label);
line-height: 1.45;
}
.plugin-section-count {
display: inline-grid;
min-width: 28px;
height: 24px;
margin-left: auto;
place-items: center;
border-radius: var(--r-full);
background: color-mix(in srgb, var(--foreground) 7%, transparent);
color: color-mix(in srgb, var(--foreground) 56%, transparent);
font-size: var(--fs-label);
font-variant-numeric: tabular-nums;
}
.plugins-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
align-items: stretch;
gap: var(--space-4);
margin-top: var(--space-5);
gap: var(--space-3);
margin-top: var(--space-3);
}
.plugin-card {
display: flex;
min-width: 0;
min-height: 286px;
min-height: 232px;
flex-direction: column;
padding: var(--space-4);
padding: var(--space-3);
border-radius: var(--plugins-card-radius);
transition: transform var(--motion-state) var(--motion-ease-out), background-color var(--motion-state) ease-out;
transition: background-color var(--motion-state) ease-out;
}
.plugin-card:hover,
.plugin-card:focus-within {
transform: translateY(var(--library-hover-offset));
transform: none;
}
.plugin-card:focus-within {
box-shadow: none;
}
.plugin-card-main {
appearance: none;
display: block;
width: 100%;
min-width: 0;
flex: 1 1 auto;
border: 0;
background: transparent;
padding: 0;
color: inherit;
font: inherit;
text-align: left;
cursor: pointer;
box-shadow: none;
}
.plugin-card-main:focus-visible {
border-radius: var(--r-md);
outline: 1px solid color-mix(in srgb, var(--foreground) 38%, transparent);
outline-offset: -1px;
}
.plugin-card-main:focus:not(:focus-visible) {
outline: none;
box-shadow: none;
}
.plugin-card-heading {
@@ -93,26 +300,27 @@
.plugin-icon-tile {
display: grid;
width: 48px;
height: 48px;
width: 42px;
height: 42px;
flex: 0 0 auto;
place-items: center;
border-radius: var(--r-lg);
border-radius: var(--r-md);
background: color-mix(in srgb, var(--foreground) 7%, transparent);
color: color-mix(in srgb, var(--foreground) 65%, transparent);
transition: background-color var(--motion-state) ease-out, color var(--motion-state) ease-out, transform var(--motion-state) var(--motion-ease-out);
transition:
background-color var(--motion-state) ease-out,
color var(--motion-state) ease-out;
}
.plugin-card:hover .plugin-icon-tile,
.plugin-card:focus-within .plugin-icon-tile {
transform: translateY(-2px);
background: color-mix(in srgb, var(--foreground) 10%, transparent);
color: var(--foreground);
}
.plugin-icon-tile.is-trusted {
background: color-mix(in srgb, var(--status-success) 14%, transparent);
color: var(--status-success);
background: color-mix(in srgb, var(--foreground) 7%, transparent);
color: color-mix(in srgb, var(--foreground) 65%, transparent);
}
.plugin-card-title-row {
@@ -155,6 +363,7 @@
}
.plugin-category-label,
.plugin-source-label,
.plugin-card-tags span {
display: inline-flex;
align-items: center;
@@ -167,14 +376,25 @@
line-height: 1.4;
}
.plugin-source-label {
background: color-mix(in srgb, var(--foreground) 7%, transparent);
color: color-mix(in srgb, var(--foreground) 58%, transparent);
font-weight: 600;
}
.plugin-source-label.is-system {
background: color-mix(in srgb, var(--foreground) 7%, transparent);
color: color-mix(in srgb, var(--foreground) 58%, transparent);
}
.plugin-trust-label {
font-size: var(--fs-micro);
}
.plugin-card-description {
display: -webkit-box;
min-height: 3.2em;
margin-top: var(--space-4);
min-height: 2.9em;
margin-top: var(--space-3);
overflow: hidden;
color: color-mix(in srgb, var(--foreground) 52%, transparent);
font-size: var(--fs-caption);
@@ -185,7 +405,7 @@
.plugin-card-meta {
gap: var(--space-3);
margin-top: var(--space-4);
margin-top: var(--space-3);
color: color-mix(in srgb, var(--foreground) 43%, transparent);
font-size: var(--fs-label);
}
@@ -207,8 +427,8 @@
min-width: 0;
align-items: center;
gap: var(--space-2);
margin-top: var(--space-5);
padding-top: var(--space-3);
margin-top: var(--space-3);
padding-top: var(--space-2);
border-top: 1px solid color-mix(in srgb, var(--workspace-border) 72%, transparent);
}
@@ -216,10 +436,291 @@
margin-right: auto;
}
.plugin-card-actions .ant-switch {
flex: 0 0 auto;
}
.plugin-settings-button {
flex: 0 0 auto;
}
.plugin-details-title {
display: flex;
min-width: 0;
align-items: center;
gap: var(--space-2);
}
.plugin-details-title > span:nth-child(2) {
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.workspace-modal.plugin-details-modal {
width: min(1240px, calc(100vw - var(--space-4))) !important;
}
.workspace-modal.plugin-upload-modal {
width: min(1480px, calc(100vw - var(--space-4))) !important;
}
.plugin-upload-layout {
display: grid;
min-width: 0;
grid-template-columns: minmax(0, 1.55fr) minmax(300px, 0.65fr);
gap: var(--space-6);
}
.plugin-upload-guide {
min-width: 0;
max-height: min(75vh, 780px);
overflow: auto;
padding-right: var(--space-4);
border-right: 1px solid var(--workspace-border);
}
.plugin-upload-guide .plugin-markdown-table-wrap {
margin-block: var(--space-3);
}
.plugin-upload-guide .plugin-markdown table {
min-width: 560px;
}
.plugin-upload-panel {
display: flex;
min-width: 0;
flex-direction: column;
align-self: start;
gap: var(--space-4);
padding: var(--space-4);
border: 1px solid var(--workspace-border);
border-radius: var(--r-lg);
background: color-mix(in srgb, var(--foreground) 3%, var(--workspace-surface-strong));
}
.plugin-upload-panel-heading {
display: flex;
align-items: flex-start;
gap: var(--space-3);
}
.plugin-upload-panel-heading h2 {
color: var(--foreground);
font-size: var(--fs-body-lg);
font-weight: 700;
}
.plugin-upload-panel-heading p {
margin-top: var(--space-1);
color: color-mix(in srgb, var(--foreground) 50%, transparent);
font-size: var(--fs-label);
line-height: 1.55;
}
.plugin-upload-panel-icon {
display: grid;
width: 38px;
height: 38px;
flex: 0 0 auto;
place-items: center;
border-radius: var(--r-md);
background: color-mix(in srgb, var(--workspace-accent) 13%, transparent);
color: var(--workspace-accent);
}
.plugin-upload-dropzone.ant-upload-wrapper .ant-upload-drag {
min-height: 250px;
border-color: color-mix(in srgb, var(--workspace-accent) 32%, var(--workspace-border));
border-radius: var(--r-md);
background: color-mix(in srgb, var(--workspace-accent) 4%, transparent);
}
.plugin-upload-dropzone.ant-upload-wrapper .ant-upload-drag:hover {
border-color: var(--workspace-accent);
}
.plugin-upload-dropzone-icon {
width: 30px;
height: 30px;
margin-bottom: var(--space-3);
color: var(--workspace-accent);
}
.plugin-upload-dropzone .ant-upload-text {
color: var(--foreground);
font-size: var(--fs-body);
font-weight: 650;
}
.plugin-upload-dropzone .ant-upload-hint {
color: color-mix(in srgb, var(--foreground) 45%, transparent);
font-size: var(--fs-label);
}
.plugin-upload-notice {
display: flex;
align-items: flex-start;
gap: var(--space-2);
color: color-mix(in srgb, var(--foreground) 49%, transparent);
font-size: var(--fs-label);
line-height: 1.55;
}
.plugin-upload-notice svg {
flex: 0 0 auto;
margin-top: 2px;
color: var(--status-success);
}
.plugin-markdown {
max-width: none;
color: color-mix(in srgb, var(--foreground) 72%, transparent);
font-size: var(--fs-caption);
line-height: 1.7;
}
.plugin-details-document {
width: 100%;
padding: var(--space-2) 0 var(--space-6);
}
.plugin-details-document > p,
.plugin-details-document > ul,
.plugin-details-document > ol,
.plugin-details-document > blockquote {
max-width: 88ch;
}
.plugin-markdown h1,
.plugin-markdown h2,
.plugin-markdown h3 {
color: var(--foreground);
font-weight: 700;
line-height: 1.35;
}
.plugin-markdown h1 {
margin: 0 0 var(--space-3);
font-size: var(--fs-title);
}
.plugin-markdown h2 {
margin: var(--space-6) 0 var(--space-3);
padding-top: var(--space-4);
border-top: 1px solid var(--workspace-border);
font-size: var(--fs-body-lg);
}
.plugin-markdown h3 {
margin: var(--space-4) 0 var(--space-2);
font-size: var(--fs-body);
}
.plugin-markdown p {
margin: var(--space-2) 0;
}
.plugin-markdown ul {
margin: var(--space-2) 0;
padding-left: var(--space-5);
}
.plugin-markdown ol {
margin: var(--space-2) 0;
padding-left: var(--space-5);
}
.plugin-markdown a {
color: var(--workspace-accent);
text-decoration: underline;
text-underline-offset: 2px;
}
.plugin-markdown li + li {
margin-top: var(--space-1);
}
.plugin-markdown strong {
color: var(--foreground);
font-weight: 650;
}
.plugin-markdown code {
border-radius: var(--r-sm);
background: color-mix(in srgb, var(--foreground) 7%, transparent);
padding: 2px 5px;
color: color-mix(in srgb, var(--workspace-accent) 78%, var(--foreground));
font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
font-size: 0.92em;
}
.plugin-markdown pre {
overflow-x: auto;
margin: var(--space-3) 0;
border: 1px solid var(--workspace-border);
border-radius: var(--r-md);
background: color-mix(in srgb, var(--foreground) 5%, var(--workspace-surface-strong));
padding: var(--space-3);
}
.plugin-markdown pre code {
display: block;
padding: 0;
background: transparent;
color: var(--foreground);
line-height: 1.6;
white-space: pre;
}
.plugin-markdown-table-wrap {
overflow-x: auto;
margin: var(--space-3) 0;
border: 1px solid var(--workspace-border);
border-radius: var(--r-md);
}
.plugin-markdown table {
width: 100%;
min-width: 620px;
border-collapse: collapse;
font-size: var(--fs-label);
}
.plugin-markdown th,
.plugin-markdown td {
padding: var(--space-2) var(--space-3);
border-bottom: 1px solid var(--workspace-border);
text-align: left;
vertical-align: top;
}
.plugin-markdown th {
background: color-mix(in srgb, var(--foreground) 5%, transparent);
color: var(--foreground);
font-weight: 650;
white-space: nowrap;
}
.plugin-markdown tr:last-child td {
border-bottom: 0;
}
.plugin-markdown blockquote {
margin: var(--space-3) 0;
border-left: 3px solid var(--workspace-accent);
background: color-mix(in srgb, var(--workspace-accent) 7%, transparent);
padding: var(--space-2) var(--space-3);
color: color-mix(in srgb, var(--foreground) 64%, transparent);
}
.plugin-markdown hr {
margin: var(--space-5) 0;
border: 0;
border-top: 1px solid var(--workspace-border);
}
.plugin-settings-panel {
margin-top: var(--space-4);
padding-top: var(--space-4);
@@ -342,8 +843,45 @@
}
@media (max-width: 900px) {
.plugins-page-layout {
display: block;
}
.plugins-sidebar {
position: static;
min-height: 0;
border-right: 0;
border-bottom: 1px solid var(--workspace-border);
padding: var(--space-4) var(--space-4) 0;
}
.plugins-sidebar-heading {
display: flex;
align-items: baseline;
gap: var(--space-2);
padding: 0 var(--space-1) var(--space-3);
}
.plugins-sidebar-heading p {
margin-top: 0;
}
.plugins-sidebar-nav {
display: flex;
gap: var(--space-1);
overflow-x: auto;
padding-bottom: var(--space-3);
}
.plugins-sidebar-item {
width: auto;
flex: 0 0 auto;
padding-inline: var(--space-3);
white-space: nowrap;
}
.plugins-toolbar {
grid-template-columns: minmax(0, 1fr) repeat(3, minmax(120px, 1fr));
grid-template-columns: minmax(0, 1fr) repeat(2, minmax(120px, 1fr));
}
.plugins-search {
@@ -353,6 +891,23 @@
.plugins-filter-icon {
display: none;
}
.plugins-toolbar-actions {
grid-column: 1 / -1;
justify-content: flex-start;
}
.plugin-upload-layout {
grid-template-columns: 1fr;
}
.plugin-upload-guide {
max-height: 48vh;
padding-right: 0;
padding-bottom: var(--space-4);
border-right: 0;
border-bottom: 1px solid var(--workspace-border);
}
}
@media (max-width: 640px) {
@@ -360,6 +915,14 @@
padding-inline: var(--space-4);
}
.plugins-sidebar-heading {
display: block;
}
.plugins-sidebar-heading p {
margin-top: var(--space-1);
}
.plugins-toolbar {
grid-template-columns: repeat(2, minmax(0, 1fr));
}
@@ -372,9 +935,51 @@
grid-template-columns: 1fr;
}
.plugins-sections {
gap: var(--space-6);
margin-top: var(--space-6);
}
.plugin-section-heading {
gap: var(--space-2);
}
.plugin-card {
min-height: 0;
}
.plugin-card-actions {
flex-wrap: wrap;
}
.plugin-upload-panel {
padding: var(--space-3);
}
.plugin-upload-dropzone.ant-upload-wrapper .ant-upload-drag {
min-height: 210px;
}
.plugin-card-actions .settings-channel-status {
width: 100%;
margin-right: 0;
}
.plugin-settings-button {
flex: 1 1 0;
}
.plugins-toolbar-actions {
width: 100%;
}
.plugins-toolbar-actions > * {
flex: 1 1 0;
}
.plugins-toolbar-actions .ant-btn {
width: 100%;
}
}
@media (prefers-reduced-motion: reduce) {