@easyai-canvas/canvas-plugin-sdk 0.1.5 → 0.1.7

package/dist/customer-main.js

@@ -74,13 +74,15 @@ async function studioCatalog() {
                 id: entry.manifest.id, name: entry.manifest.name, release: entry.manifest.release,
                 enabled: entry.enabled, manifest: entry.manifest, uiBundle,
                 config: entry.config, secretConfigured: entry.secretConfigured,
+                studioPlacementOverrides: entry.studioPlacementOverrides,
                 configCheckAvailable: entry.configCheckAvailable,
                 configurationRequired: (entry.manifest.configFields ?? []).some(field => field.required &&
                     !(field.type === 'secret' ? entry.secretConfigured?.[field.key] : entry.config[field.key] !== undefined && entry.config[field.key] !== '')),
                 nodes: entry.manifest.contributes.nodes?.length ?? 0,
                 actions: entry.manifest.contributes.actions?.length ?? 0,
                 package: packaged.downloads[entry.manifest.id] ? { mode: 'download' } : null,
-                buildKey: createHash('sha256').update(JSON.stringify({ revision: catalog.revision, entry })).digest('hex'),
+                buildKey: createHash('sha256').update(JSON.stringify({ instanceId: catalog.instanceId,
+                    entry, bundleDigest: bundle?.digest, cssDigest: bundle?.cssDigest })).digest('hex'),
             };
         }),
     };
@@ -201,11 +203,16 @@ const server = createServer(async (request, response) => {
                 send(response, 200, await studioCatalog());
                 return;
             }
-            const studioPlugin = /^\/studio\/plugins\/([A-Za-z0-9_.-]+)\/(configure|check)$/.exec(path);
+            const studioPlugin = /^\/studio\/plugins\/([A-Za-z0-9_.-]+)\/(configure|check|placements)$/.exec(path);
             if (method === 'POST' && studioPlugin) {
                 if (request.headers.origin && ![`http://localhost:${port}`, `http://127.0.0.1:${port}`, `http://[::1]:${port}`].includes(request.headers.origin))
                     throw new ContractError('本地配置请求来源无效', 403);
-                if (studioPlugin[2] === 'configure') {
+                if (studioPlugin[2] === 'placements') {
+                    const input = await body(request);
+                    const configured = runtime.configureStudioPlacements(studioPlugin[1], input.placementOverrides);
+                    send(response, 200, { placementOverrides: configured.studioPlacementOverrides });
+                }
+                else if (studioPlugin[2] === 'configure') {
                     const input = await body(request);
                     const configured = runtime.configure(studioPlugin[1], {
                         config: object(input.config, 'config'), enabled: input.enabled === true,
@@ -249,7 +256,7 @@ const server = createServer(async (request, response) => {
             }
             if (method === 'POST' && path === '/studio/open') {
                 const input = await body(request);
-                send(response, 200, await studio.openDebugSession(String(input.pluginId ?? '')));
+                send(response, 200, await studio.openDebugSession(typeof input.pluginId === 'string' && input.pluginId ? input.pluginId : undefined));
                 return;
             }
             if (method === 'POST' && path === '/studio/embed-ticket') {

package/dist/protocol/index.d.ts

@@ -181,6 +181,8 @@ export type CatalogEntry = {
     /** Secret values are never returned; only their configured state is exposed. */
     secretConfigured?: Record<string, boolean>;
     configCheckAvailable?: boolean;
+    /** Local Studio preview only; formal installations use their own placement overrides. */
+    studioPlacementOverrides?: PlacementOverrides;
 };
 export type Catalog = {
     protocol: typeof PROTOCOL;

package/dist/runtime/engine.d.ts

@@ -23,6 +23,7 @@ export declare class Runtime {
         config?: Record<string, unknown>;
         expectedVersion?: number;
     }): import("../protocol/index.js").CatalogEntry;
+    configureStudioPlacements(id: string, value: unknown): import("../protocol/index.js").CatalogEntry;
     catalog(): Catalog;
     checkConfig(id: string): Promise<{
         supported: boolean;

package/dist/runtime/engine.js

@@ -4,7 +4,7 @@ import { fork } from 'node:child_process';
 import { RuntimeStore } from './store.js';
 import { acquireInstanceLock } from './instance-lock.js';
 import { fieldsConfig } from './plugin-config.js';
-import { PROTOCOL, ContractError, validateManifest, validateExecution, validateResult, validatePluginRuntimeContext } from '../protocol/index.js';
+import { PROTOCOL, ContractError, object, validateManifest, validateExecution, validateResult, validatePluginRuntimeContext, resolveNodePlacement, resolveResourcePlacement, listPluginActions } from '../protocol/index.js';
 const defaultPlugins = process.env.PLUGIN_BUILTINS === '0'
     ? []
     : (await import('../plugins/catalog.js')).getPlugins();
@@ -60,6 +60,35 @@ export class Runtime {
         this.store.setPlugin(id, { enabled: patch.enabled, config, expectedVersion: patch.expectedVersion });
         return this.catalog().plugins.find(p => p.manifest.id === id);
     }
+    configureStudioPlacements(id, value) {
+        const manifest = this.catalog().plugins.find(entry => entry.manifest.id === id)?.manifest;
+        if (!manifest)
+            throw new ContractError('插件不存在', 404);
+        const overrides = object(value, '画布入口');
+        const allowed = new Map([
+            ...(manifest.contributes.nodes ?? []).filter(node => resolveNodePlacement(node)).map(node => [`node:${node.type}`, 'node']),
+            ...listPluginActions(manifest).filter(action => resolveResourcePlacement(action)).map(action => [`action:${action.id}`, 'resource']),
+        ]);
+        const cleaned = {};
+        for (const [key, raw] of Object.entries(overrides)) {
+            const kind = allowed.get(key);
+            if (!kind)
+                throw new ContractError(`未知画布入口 ${key}`);
+            const item = object(raw, key);
+            for (const field of Object.keys(item))
+                if (!['visible', 'group', 'order'].includes(field))
+                    throw new ContractError(`${key}.${field} 不支持`);
+            if (item.visible !== undefined && typeof item.visible !== 'boolean')
+                throw new ContractError(`${key}.visible 无效`);
+            if (item.group !== undefined && (kind !== 'node' || !['basic', 'storyboard', 'tools'].includes(String(item.group))))
+                throw new ContractError(`${key}.group 无效`);
+            if (item.order !== undefined && (typeof item.order !== 'number' || !Number.isFinite(item.order)))
+                throw new ContractError(`${key}.order 无效`);
+            cleaned[key] = item;
+        }
+        this.store.setStudioPlacements(id, cleaned);
+        return this.catalog().plugins.find(entry => entry.manifest.id === id);
+    }
     catalog() {
         return { protocol: PROTOCOL, revision: this.store.revision, instanceId: this.store.instanceId, plugins: this.plugins.map(p => {
                 const stored = this.store.getPlugin(p.manifest.id);
@@ -73,7 +102,8 @@ export class Runtime {
                 for (const f of manifest.configFields ?? [])
                     if (f.type === 'secret')
                         delete config[f.key];
-                return { ...this.presentations[p.manifest.id], manifest, enabled: stored.enabled, config, configVersion: stored.configVersion, secretConfigured, configCheckAvailable: Boolean(p.checkConfig) };
+                return { ...this.presentations[p.manifest.id], manifest, enabled: stored.enabled, config, configVersion: stored.configVersion, secretConfigured, configCheckAvailable: Boolean(p.checkConfig),
+                    studioPlacementOverrides: this.store.getStudioPlacements(p.manifest.id) };
             }) };
     }
     async checkConfig(id) {

package/dist/runtime/store.d.ts

@@ -1,4 +1,4 @@
-import type { ExecutionRecord, ExecutionRequest } from '../protocol/index.js';
+import type { ExecutionRecord, ExecutionRequest, PlacementOverrides } from '../protocol/index.js';
 export type ExecutionSnapshot = {
     config: Record<string, unknown>;
     release: string;
@@ -14,6 +14,8 @@ export declare class RuntimeStore {
     syncDeployment(digest: string): void;
     get revision(): number;
     get instanceId(): string;
+    getStudioPlacements(id: string): PlacementOverrides;
+    setStudioPlacements(id: string, overrides: PlacementOverrides): void;
     getPlugin(id: string): {
         enabled: boolean;
         config: Record<string, unknown>;

package/dist/runtime/store.js

@@ -44,6 +44,17 @@ export class RuntimeStore {
     }
     get revision() { return this.db.prepare('SELECT revision FROM meta WHERE id = 1').get().revision; }
     get instanceId() { return this.db.prepare("SELECT value FROM settings WHERE key='instance_id'").get().value; }
+    getStudioPlacements(id) {
+        const row = this.db.prepare('SELECT value FROM settings WHERE key = ?').get(`studio_placements:${id}`);
+        return row ? JSON.parse(row.value) : {};
+    }
+    setStudioPlacements(id, overrides) {
+        this.db.transaction(() => {
+            this.db.prepare('INSERT INTO settings(key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value=excluded.value')
+                .run(`studio_placements:${id}`, JSON.stringify(overrides));
+            this.db.prepare('UPDATE meta SET revision=revision+1 WHERE id=1').run();
+        })();
+    }
     getPlugin(id) {
         const row = this.db.prepare('SELECT enabled, config, config_version FROM plugins WHERE id = ?').get(id);
         return row ? { enabled: Boolean(row.enabled), config: JSON.parse(row.config), configVersion: row.config_version } : { enabled: false, config: {}, configVersion: 0 };

package/dist/studio/index.html

@@ -171,6 +171,18 @@ dialog::backdrop { background: #30384266; }
 .plugin-config #config-status { margin: 0; color: var(--quiet); font-size: 12px; line-height: 1.5; }
 #config-fields { display: grid; gap: 14px; }
 .plugin-config small { color: var(--quiet); }
+.placement-list { display: grid; gap: 10px; margin-bottom: 14px; }
+.placement-item { display: grid; gap: 10px; padding: 14px; border: 1px solid var(--line); border-radius: 10px; background: var(--soft); }
+.placement-item > div:first-child { display: flex; justify-content: space-between; gap: 12px; align-items: center; }
+.placement-item strong { font-size: 12px; }
+.placement-item label { color: var(--muted); font-size: 12px; }
+.placement-item .placement-controls { display: grid; grid-template-columns: repeat(2, minmax(0, 1fr)); gap: 10px; }
+.placement-item .placement-controls label { display: grid; gap: 5px; }
+.placement-item select, .placement-item input[type="number"] { min-width: 0; min-height: 36px; padding: 5px 9px; border: 1px solid var(--line-strong); border-radius: 7px; background: #fff; }
+.placement-actions { display: flex; gap: 9px; align-items: center; }
+.placement-actions button { min-height: 36px; padding: 0 12px; border: 1px solid var(--line-strong); border-radius: 8px; background: #fff; font-size: 12px; }
+.placement-actions button[type="submit"] { border-color: var(--accent); background: var(--accent); color: #fff; }
+#placement-status { margin: 10px 0 0; color: var(--quiet); font-size: 12px; }
 .plugin-choice { position: relative; display: grid; grid-template-columns: 18px minmax(0, 1fr); align-items: center; gap: 10px; min-height: 78px; border: 1px solid var(--line); border-radius: 12px; padding: 11px 12px; background: #fff; cursor: pointer; }
 .plugin-choice:hover { border-color: var(--line-strong); background: var(--soft); }
 .plugin-choice:has(input:checked) { border-color: #aab6c1; background: #f9fafb; }
@@ -243,6 +255,7 @@ dialog::backdrop { background: #30384266; }
 }
 @media (max-width: 520px) {
   dialog { height: min(760px, calc(100dvh - 32px)); }
+  .placement-item .placement-controls { grid-template-columns: 1fr; }
   .setup-header { height: 58px; padding: 0 18px; }
   .brand strong { font-size: 18px; }
   .brand { font-size: 12px; }
@@ -316,14 +329,15 @@ dialog::backdrop { background: #30384266; }
   </div>
   <div id="notice" class="notice" role="status" hidden></div>
   <dialog id="panel" aria-labelledby="panel-title">
-    <div class="dialog-head"><div><h2 id="panel-title">插件管理</h2><p>选择插件，查看配置并进入画布调试</p></div><button id="close" type="button" aria-label="关闭管理面板"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><path d="M4.5 4.5 15.5 15.5M15.5 4.5 4.5 15.5"/></svg></button></div>
+    <div class="dialog-head"><div><h2 id="panel-title">插件管理</h2><p>已启用插件会同时出现在调试画布，选择插件可查看配置</p></div><button id="close" type="button" aria-label="关闭管理面板"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" aria-hidden="true"><path d="M4.5 4.5 15.5 15.5M15.5 4.5 4.5 15.5"/></svg></button></div>
     <div class="dialog-body">
       <aside class="plugin-sidebar" aria-labelledby="target-title"><div class="section-heading"><h3 id="target-title">本地插件</h3><span id="plugin-count" class="activity-count">0 个</span></div><p>选择插件后在右侧管理</p><div id="plugin-list" class="plugin-list" role="radiogroup" aria-labelledby="target-title"></div></aside>
       <div class="plugin-detail"><p id="detail-empty" class="detail-empty" hidden>暂无插件。请在本地服务中注册插件。</p><div id="plugin-detail-content" class="plugin-detail-content">
         <div class="detail-head"><div><h3 id="detail-name">插件</h3><code id="detail-id"></code></div><span id="detail-status" class="status-badge" role="status">检查中</span></div>
         <div class="detail-meta"><span id="detail-nodes">0 个节点</span><span id="detail-actions">0 个操作</span><span id="detail-package">插件包不可用</span></div>
-        <div class="plugin-actions"><button id="open-plugin" type="button"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 10h11m-4-4 4 4-4 4M16 4h2v12h-2"/></svg><span>在画布中调试</span></button><button id="download-package" type="button" disabled><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 2.5v10m-3.5-3.5L10 12.5 13.5 9M3.5 14v2.5h13V14"/></svg><span id="download-label">下载插件包</span></button></div><p id="package-note" class="package-note" role="status" aria-live="polite"></p>
-        <div class="configuration-section" aria-labelledby="configuration-title"><h4 id="configuration-title">插件配置</h4><p>配置仅保存在本地开发服务中。</p><div id="no-config" class="no-config" hidden>此插件无需配置，可以直接调试或下载插件包。</div><form id="plugin-config" class="plugin-config" hidden><p id="config-status" role="status" aria-live="polite"></p><div id="config-fields"></div><div class="config-actions"><button type="submit">保存并启用</button><button id="config-check" type="button">检查配置</button></div></form></div>
+        <div class="plugin-actions"><button id="open-plugin" type="button"><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M3 10h11m-4-4 4 4-4 4M16 4h2v12h-2"/></svg><span>返回调试画布</span></button><button id="download-package" type="button" disabled><svg viewBox="0 0 20 20" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M10 2.5v10m-3.5-3.5L10 12.5 13.5 9M3.5 14v2.5h13V14"/></svg><span id="download-label">下载插件包</span></button></div><p id="package-note" class="package-note" role="status" aria-live="polite"></p>
+        <div class="configuration-section" aria-labelledby="placement-title"><h4 id="placement-title">画布入口</h4><p>可覆盖插件声明的默认位置，仅用于当前本地服务的调试画布。</p><form id="placement-form"><div id="placement-list" class="placement-list"></div><div class="placement-actions"><button type="submit">保存入口设置</button><button id="placement-reset" type="button">恢复默认位置</button></div><p id="placement-status" role="status" aria-live="polite"></p></form></div>
+        <div class="configuration-section" aria-labelledby="configuration-title"><h4 id="configuration-title">插件配置</h4><p>配置仅保存在本地开发服务中。</p><div id="no-config" class="no-config" hidden>此插件无需配置，可以在画布中使用或下载插件包。</div><form id="plugin-config" class="plugin-config" hidden><p id="config-status" role="status" aria-live="polite"></p><div id="config-fields"></div><div class="config-actions"><button type="submit">保存并启用</button><button id="config-check" type="button">检查配置</button></div></form></div>
         <div class="secondary-panels"><details><summary>连接与构建 <span id="panel-status" class="status-badge" role="status">正在连接</span></summary><div class="panel-content"><dl class="session-summary"><div><dt>开发服务</dt><dd id="connection">—</dd></div><div><dt>当前构建</dt><dd id="build">—</dd></div><div><dt>调试画布</dt><dd id="project">—</dd></div></dl><span id="active-plugin" class="section-context" hidden></span><div class="sdk-card" hidden><strong>画布插件 SDK</strong><p class="sdk-message" role="status" aria-live="polite"></p><button class="sdk-action" type="button" hidden>升级 SDK</button></div><details class="technical-details"><summary>查看连接详情</summary><dl><dt>连接 ID</dt><dd id="connection-id">—</dd><dt>构建摘要</dt><dd id="build-full">—</dd><dt>项目 ID</dt><dd id="project-id">—</dd></dl></details></div></details><details><summary>最近活动 <span id="activity-count" class="activity-count">0 条</span></summary><div class="panel-content"><div id="log" class="activity-list" role="log" aria-label="调试活动" aria-live="polite"></div></div></details></div>
       </div></div>
     </div>
@@ -535,7 +549,54 @@ dialog::backdrop { background: #30384266; }
       $('dock-expand').addEventListener('click', () => { manuallyCollapsed = false; expandedOverDialog = canvasDialogOpen; renderDock(); });
       const chosen = () => catalog?.plugins.find(item => item.id === selected);
       const panelPlugin = () => catalog?.plugins.find(item => item.id === panelSelected);
-      let configFormKey = '', configFeedback = null;
+      const activePluginId = () => session?.pluginId || preparedSession?.pluginId || selected;
+      const hasNewBuild = () => (session?.plugins || (session ? [{ pluginId: session.pluginId, fingerprint: session.fingerprint }] : []))
+        .some(item => item.active !== false && catalog?.plugins.find(plugin => plugin.id === item.pluginId)?.buildKey !== item.fingerprint) ||
+        Boolean(session && catalog?.plugins.some(plugin => plugin.enabled && !session.plugins?.some(item => item.pluginId === plugin.id && item.active)));
+      let configFormKey = '', configFeedback = null, placementFormKey = '';
+      const placementGroups = { basic: '基础节点', storyboard: '分镜与导演', tools: '工具与应用' };
+      function placementEntries(plugin) {
+        if (!plugin) return [];
+        const manifest = plugin.manifest;
+        const nodes = (manifest.contributes.nodes || []).filter(node => node.placement || node.menu?.group !== 'resources').map(node => ({
+          key: `node:${node.type}`, name: node.name, kind: 'node',
+          group: node.placement ? node.placement.group || 'tools' : node.menu?.group || 'tools',
+          order: node.placement ? node.placement.order ?? 1000 : node.menu?.order ?? 1000,
+        }));
+        const actions = [...(manifest.contributes.actions || [])];
+        for (const source of manifest.contributes.assetSources || []) if (!actions.some(action => action.id === source.id)) actions.push(source);
+        const resources = actions.filter(action => !action.menu || action.menu.group === 'resources' || action.placement).map(action => ({
+          key: `action:${action.id}`, name: action.name, kind: 'resource',
+          order: action.placement ? action.placement.order ?? 1000 : action.menu?.order ?? 1000,
+        }));
+        return [...nodes, ...resources].sort((a, b) => a.order - b.order || a.key.localeCompare(b.key));
+      }
+      function renderPlacements() {
+        const plugin = panelPlugin(), entries = placementEntries(plugin);
+        const form = $('placement-form'); form.hidden = !entries.length;
+        const key = JSON.stringify([plugin?.id, plugin?.manifest, plugin?.studioPlacementOverrides]);
+        if (key === placementFormKey) return;
+        placementFormKey = key;
+        $('placement-list').replaceChildren(); $('placement-status').textContent = '';
+        for (const entry of entries) {
+          const saved = plugin.studioPlacementOverrides?.[entry.key] || {};
+          const card = document.createElement('div'); card.className = 'placement-item'; card.dataset.key = entry.key;
+          card.dataset.group = entry.group || ''; card.dataset.order = String(entry.order);
+          const heading = document.createElement('div'), name = document.createElement('strong'); name.textContent = entry.name;
+          const visibility = document.createElement('label'), checkbox = document.createElement('input');
+          checkbox.type = 'checkbox'; checkbox.className = 'placement-visible'; checkbox.checked = saved.visible !== false;
+          visibility.append(checkbox, ' 显示入口'); heading.append(name, visibility); card.append(heading);
+          const controls = document.createElement('div'); controls.className = 'placement-controls';
+          if (entry.kind === 'node') {
+            const label = document.createElement('label'), select = document.createElement('select'); select.className = 'placement-group';
+            for (const [value, title] of Object.entries(placementGroups)) { const option = document.createElement('option'); option.value = value; option.textContent = title; select.append(option); }
+            select.value = saved.group ?? entry.group; label.append('显示分组', select); controls.append(label);
+          }
+          const label = document.createElement('label'), order = document.createElement('input');
+          order.type = 'number'; order.step = '1'; order.required = true; order.className = 'placement-order'; order.value = String(saved.order ?? entry.order);
+          label.append('排序值', order); controls.append(label); card.append(controls); $('placement-list').append(card);
+        }
+      }
       function renderConfig() {
         const plugin = panelPlugin();
         const form = $('plugin-config');
@@ -599,29 +660,30 @@ dialog::backdrop { background: #30384266; }
       }
       const url = () => {
         const address = new URL('/developer/plugin-debug', catalog.platformOrigin);
-        address.searchParams.set('pluginId', selected);
+        address.searchParams.set('pluginId', activePluginId());
         address.searchParams.set('connectionId', catalog.connectionId);
         if (preparedSession?.sessionId) address.searchParams.set('sessionId', preparedSession.sessionId);
         return address.toString();
       };
       function render() {
         const plugin = chosen();
-        $('plugin-name').textContent = plugin?.name || '插件调试';
+        $('plugin-name').textContent = catalog?.plugins?.length ? `${catalog.plugins.filter(item => item.enabled).length} 个插件 · 调试画布` : '插件调试画布';
         const building = catalog?.devBuild?.state;
-        $('state').textContent = building === 'error' ? '构建失败' : building === 'building' ? '正在构建' : plugin?.configurationRequired ? '待配置' : frameFailed ? '画布加载失败' : busy ? (session ? '正在刷新' : '正在打开画布') : session ? (!session.active ? '会话已失效' : plugin?.buildKey === session.fingerprint ? '已连接' : '发现新构建') : '等待画布';
-        $('dot').className = `dot ${building === 'error' || frameFailed ? 'error' : building === 'building' || plugin?.configurationRequired ? 'warning' : session ? !session.active ? 'error' : plugin?.buildKey === session.fingerprint ? 'ready' : 'warning' : ''}`;
+        $('state').textContent = building === 'error' ? '构建失败' : building === 'building' ? '正在构建' : frameFailed ? '画布加载失败' : busy ? (session ? '正在刷新' : '正在打开画布') : session ? (!session.active ? '会话已失效' : hasNewBuild() ? '发现新构建' : '已连接') : '等待画布';
+        $('dot').className = `dot ${building === 'error' || frameFailed ? 'error' : building === 'building' ? 'warning' : session ? !session.active ? 'error' : hasNewBuild() ? 'warning' : 'ready' : ''}`;
         $('refresh').disabled = !session?.active || busy || frameFailed || Boolean(building && building !== 'ready');
         const stateText = $('state').textContent;
         $('panel-status').textContent = stateText;
         $('panel-status').className = `status-badge ${$('dot').classList.contains('error') ? 'error' : $('dot').classList.contains('ready') ? 'ready' : ''}`;
         $('connection').textContent = connectorStatus?.phase === 'connected' ? '已连接 · 本机' : '未连接';
-        $('active-plugin').textContent = plugin?.name || '';
-        $('build').textContent = building === 'error' ? '构建失败' : building === 'building' ? '构建中' : plugin?.buildKey ? plugin.buildKey.slice(0, 8) : '等待构建';
+        $('active-plugin').textContent = catalog?.plugins.filter(item => item.enabled).map(item => item.name).join('、') || '';
+        $('build').textContent = building === 'error' ? '构建失败' : building === 'building' ? '构建中' : `${catalog?.plugins.filter(item => item.enabled).length || 0} 个插件`;
         $('project').textContent = session?.active ? '私人调试画布' : session ? '会话已失效' : '等待打开';
         $('connection-id').textContent = catalog?.connectionId || '—';
-        $('build-full').textContent = plugin?.buildKey || '—';
+        $('build-full').textContent = catalog?.plugins.filter(item => item.enabled).map(item => `${item.name}: ${item.buildKey}`).join('\n') || '—';
         $('project-id').textContent = session?.projectId || '—';
         renderPluginList();
+        renderPlacements();
         renderConfig();
         const inspected = panelPlugin();
         $('detail-empty').hidden = Boolean(inspected);
@@ -633,7 +695,7 @@ dialog::backdrop { background: #30384266; }
         $('detail-package').textContent = inspected?.package ? '插件包可下载' : '插件包不可用';
         $('detail-status').textContent = inspected?.configurationRequired ? '待配置' : inspected?.enabled ? '已启用' : '已停用';
         $('detail-status').className = `status-badge ${inspected?.configurationRequired ? '' : inspected?.enabled ? 'ready' : 'error'}`;
-        $('open-plugin').disabled = !inspected?.enabled || busy || packageDownloading;
+        $('open-plugin').disabled = busy || packageDownloading;
         $('download-package').disabled = !inspected?.package || packageDownloading;
         $('download-package').setAttribute('aria-busy', String(packageDownloading));
         $('download-label').textContent = packageDownloading ? '正在准备…' : inspected?.package?.mode === 'build' ? '打包并下载' : '下载插件包';
@@ -649,13 +711,13 @@ dialog::backdrop { background: #30384266; }
         $('empty-text').textContent = '正在打开调试画布…';
         canvasDialogOpen = false; expandedOverDialog = false; renderDock(); render();
         try {
-          const response = await fetch('/studio/open', { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ pluginId: selected }) });
+          const response = await fetch('/studio/open', { method: 'POST', headers: { 'content-type': 'application/json' }, body: '{}' });
           const next = await response.json();
           if (!response.ok) throw new Error(next.message || next.error || '调试画布创建失败');
           preparedSession = next;
         } catch (error) { busy = false; frameLoading = false; frameFailed = true; $('empty-text').textContent = error.message; $('retry').hidden = false; show(error.message); log(error.message); render(); return; }
         frame.src = url();
-        log(`打开真实画布：${selected}`);
+        log('打开全部插件的调试画布');
         readyTimer = setTimeout(() => {
           if (!session) {
             busy = false; frameLoading = false; frameFailed = true; $('retry').hidden = false;
@@ -695,7 +757,7 @@ dialog::backdrop { background: #30384266; }
         if (event.origin === window.location.origin && event.data?.type === 'plugin-debug-auth-complete') { void loadConnectionStatus(); return; }
         if (!catalog || event.origin !== catalog.platformOrigin || event.source !== frame.contentWindow) return;
         const data = event.data;
-        if (!data || typeof data !== 'object' || data.protocol !== protocol || data.pluginId !== selected) return;
+        if (!data || typeof data !== 'object' || data.protocol !== protocol || data.pluginId !== activePluginId()) return;
         if (data.type === 'bootstrap.request' && preparedSession?.sessionId === data.sessionId &&
             typeof data.codeChallenge === 'string' && /^[A-Za-z0-9_-]{43,128}$/.test(data.codeChallenge)) {
           void (async () => {
@@ -704,7 +766,7 @@ dialog::backdrop { background: #30384266; }
                 body: JSON.stringify({ debugSessionId: data.sessionId, codeChallenge: data.codeChallenge }) });
               const issued = await response.json();
               if (!response.ok) throw new Error(issued.message || issued.error || '画布登录失败');
-              frame.contentWindow.postMessage({ protocol, type: 'bootstrap.ticket', pluginId: selected,
+              frame.contentWindow.postMessage({ protocol, type: 'bootstrap.ticket', pluginId: activePluginId(),
                 sessionId: data.sessionId, ticket: issued.ticket }, catalog.platformOrigin);
             } catch (error) { show(error.message); log(error.message); }
           })();
@@ -726,6 +788,10 @@ dialog::backdrop { background: #30384266; }
         if (data.type === 'status' && data.status?.sessionId === session.sessionId) { session = data.status; if (!session.active) show('调试会话已失效，请在管理菜单中重新连接。'); render(); return; }
         if (data.type === 'refreshing' && data.requestId === waiting) { busy = true; log('正在保存画布并检查新构建'); render(); }
         if (data.type === 'refreshResult' && data.requestId === waiting) {
+          if (data.status?.sessionId !== session.sessionId) {
+            waiting = null; show('插件列表已更新，正在重新打开调试画布。', false);
+            void connect(); return;
+          }
           session = data.status; waiting = null; busy = Boolean(data.changed); frameLoading = Boolean(data.changed); show(data.changed ? '新构建已启用，正在重新加载画布…' : '当前已经是最新构建。', false); log(data.changed ? '构建已更新，画布正在重载' : '当前构建没有变化');
           if (data.changed) $('empty-text').textContent = '正在加载新构建…';
           if (data.changed) readyTimer = setTimeout(() => {
@@ -740,12 +806,12 @@ dialog::backdrop { background: #30384266; }
       $('refresh').addEventListener('click', () => {
         if (!session || busy) return;
         waiting = crypto.randomUUID(); busy = true;
-        frame.contentWindow.postMessage({ protocol, type: 'refresh', sessionId: session.sessionId, pluginId: selected, requestId: waiting }, catalog.platformOrigin);
+        frame.contentWindow.postMessage({ protocol, type: 'refresh', sessionId: session.sessionId, pluginId: activePluginId(), requestId: waiting }, catalog.platformOrigin);
         render();
       });
       function openPanel(forConfiguration = false) {
         panelSelected = forConfiguration ? catalog?.plugins.find(item => item.configurationRequired)?.id || selected : selected;
-        packageMessage = ''; packageError = false; configFeedback = null; configFormKey = ''; render(); panel.showModal();
+        packageMessage = ''; packageError = false; configFeedback = null; configFormKey = ''; placementFormKey = ''; render(); panel.showModal();
         const firstField = forConfiguration ? $('config-fields').querySelector('input, select') : null;
         (firstField || $('plugin-list').querySelector('input:checked') || $('close')).focus();
         renderDock();
@@ -759,6 +825,41 @@ dialog::backdrop { background: #30384266; }
         if (!event.target.matches('input[name="studio-plugin"]')) return;
         panelSelected = event.target.value; packageMessage = ''; packageError = false; configFeedback = null; render(); document.querySelector('.plugin-detail').scrollTop = 0;
       });
+      $('placement-form').addEventListener('submit', async event => {
+        event.preventDefault();
+        const plugin = panelPlugin(); if (!plugin) return;
+        const placementOverrides = {};
+        for (const card of $('placement-list').children) {
+          const entry = {};
+          if (!card.querySelector('.placement-visible').checked) entry.visible = false;
+          const group = card.querySelector('.placement-group')?.value;
+          if (group && group !== card.dataset.group) entry.group = group;
+          const order = Number(card.querySelector('.placement-order').value);
+          if (!Number.isFinite(order)) { $('placement-status').textContent = '请填写有效的排序值。'; return; }
+          if (order !== Number(card.dataset.order)) entry.order = order;
+          if (Object.keys(entry).length) placementOverrides[card.dataset.key] = entry;
+        }
+        const changed = JSON.stringify(plugin.studioPlacementOverrides || {}) !== JSON.stringify(placementOverrides);
+        try {
+          const response = await fetch(`/studio/plugins/${encodeURIComponent(plugin.id)}/placements`, {
+            method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ placementOverrides }),
+          });
+          const result = await response.json();
+          if (!response.ok) throw new Error(result.message || result.error || '入口设置保存失败');
+          await loadCatalog();
+          const activeHere = session?.active && session.plugins?.some(item => item.pluginId === plugin.id && item.active);
+          $('placement-status').textContent = changed && activeHere ? '已保存，正在刷新调试画布…' : '入口设置已保存。打开调试画布后生效。';
+          if (changed && activeHere) $('refresh').click();
+        } catch (error) { $('placement-status').textContent = error.message || '入口设置保存失败'; }
+      });
+      $('placement-reset').addEventListener('click', () => {
+        for (const card of $('placement-list').children) {
+          card.querySelector('.placement-visible').checked = true;
+          if (card.querySelector('.placement-group')) card.querySelector('.placement-group').value = card.dataset.group;
+          card.querySelector('.placement-order').value = card.dataset.order;
+        }
+        $('placement-form').requestSubmit();
+      });
       $('plugin-config').addEventListener('submit', async event => {
         event.preventDefault();
         const plugin = panelPlugin(); if (!plugin) return;
@@ -789,8 +890,7 @@ dialog::backdrop { background: #30384266; }
         } catch (error) { configFeedback = { pluginId: plugin.id, message: error.message || '配置检查失败' }; $('config-status').textContent = configFeedback.message; }
       });
       $('open-plugin').addEventListener('click', () => {
-        if (!panelPlugin()?.enabled || busy) return;
-        selected = panelSelected; show(''); panel.close(); connect();
+        panel.close();
       });
       $('download-package').addEventListener('click', async () => {
         const plugin = panelPlugin();

package/dist/studio/remote-connector.d.ts

@@ -42,7 +42,7 @@ export declare class RemoteStudioConnector {
     }>;
     private post;
     private renewAccessToken;
-    openDebugSession(pluginId: string): Promise<{
+    openDebugSession(pluginId?: string): Promise<{
         sessionId: string;
         projectId: string;
         connectionId: string;

package/dist/studio/remote-connector.js

@@ -119,7 +119,7 @@ export class RemoteStudioConnector {
         if (!this.ticket || this.phase !== 'connected')
             throw new Error('请先连接画布平台');
         await this.renewAccessToken();
-        return this.post(`/canvas-workflow/plugin-debug-connectors/${this.ticket.connectionId}/open`, { pluginId }, true);
+        return this.post(`/canvas-workflow/plugin-debug-connectors/${this.ticket.connectionId}/open`, pluginId ? { pluginId } : {}, true);
     }
     async createEmbedTicket(debugSessionId, codeChallenge) {
         if (!this.ticket || this.phase !== 'connected')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easyai-canvas/canvas-plugin-sdk",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "EasyAI 画布插件开发工具与运行时",
   "type": "module",
   "engines": {

package/tools/build-plugin-package.mjs

@@ -27,9 +27,11 @@ export async function buildPluginPackage({
       },
     },
   });
-  const plugin = (
-    await import(pathToFileURL(resolve(directory, 'server/plugin.mjs')).href)
-  ).default;
+  const serverModule = resolve(directory, 'server/plugin.mjs');
+  const serverBytes = await readFile(serverModule);
+  const moduleUrl = new URL(pathToFileURL(serverModule).href);
+  moduleUrl.searchParams.set('build', createHash('sha256').update(serverBytes).digest('hex'));
+  const plugin = (await import(moduleUrl.href)).default;
   if (!plugin?.manifest) throw new Error(`插件入口 ${serverEntry} 必须默认导出 definePlugin(...)`);
   await build({
     configFile: false,