feat(plugin-sdk): add TypeScript SDK for Infinite Canvas plugins with automatic JSX and build support

web/src/lib/canvas/plugin-loader.ts

@@ -56,17 +56,17 @@ function withCacheBust(url: string) {
 }
 
 // 从 URL 安装(或覆盖更新)一个插件,成功后立即启用
-export async function installPluginFromUrl(url: string) {
+export async function installPluginFromUrl(url: string, opts?: { official?: boolean }) {
     const source = await fetchPluginSource(url);
     const plugin = await evaluatePluginSource(source);
     deactivatePlugin(plugin.id); // 覆盖旧版本
-    usePluginStore.getState().upsert({ id: plugin.id, name: plugin.name || plugin.id, version: plugin.version || "0.0.0", description: plugin.description, url, source, enabled: true });
+    usePluginStore.getState().upsert({ id: plugin.id, name: plugin.name || plugin.id, version: plugin.version || "0.0.0", description: plugin.description, url, source, enabled: true, official: opts?.official });
     activatePlugin(plugin);
     return plugin;
 }
 
 export async function updatePlugin(record: InstalledPlugin) {
-    return installPluginFromUrl(record.url);
+    return installPluginFromUrl(record.url, { official: record.official });
 }
 
 export async function setPluginEnabled(record: InstalledPlugin, enabled: boolean) {

web/src/lib/canvas/plugin-registry.ts

@@ -0,0 +1,32 @@
+import { PLUGIN_REGISTRY_URL } from "@/constant/env";
+
+// 官方插件清单里的一条(entry 已解析成绝对 URL)
+export type OfficialPluginEntry = {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    icon?: string;
+    url: string;
+};
+
+type RawEntry = { id?: string; name?: string; version?: string; description?: string; icon?: string; entry?: string; url?: string };
+type RawManifest = { plugins?: RawEntry[] };
+
+// 拉取官方插件清单;entry(相对文件名)按清单地址解析成绝对 URL,再走既有 URL 安装流程
+export async function fetchOfficialPlugins(registryUrl: string = PLUGIN_REGISTRY_URL): Promise<OfficialPluginEntry[]> {
+    const response = await fetch(registryUrl, { headers: { accept: "application/json" } });
+    if (!response.ok) throw new Error(`获取官方插件列表失败 (HTTP ${response.status})`);
+    const data = (await response.json()) as RawManifest;
+    const list = Array.isArray(data?.plugins) ? data.plugins : [];
+    return list
+        .filter((item): item is RawEntry & { id: string } => Boolean(item && item.id && (item.entry || item.url)))
+        .map((item) => ({
+            id: item.id,
+            name: item.name || item.id,
+            version: item.version || "0.0.0",
+            description: item.description,
+            icon: item.icon,
+            url: item.url ? item.url : new URL(item.entry as string, registryUrl).toString(),
+        }));
+}