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

package/dist/customer-main.js

@@ -74,6 +74,7 @@ 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] !== '')),
@@ -202,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,

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; }
@@ -323,6 +336,7 @@ dialog::backdrop { background: #30384266; }
         <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="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>
@@ -539,7 +553,50 @@ dialog::backdrop { background: #30384266; }
       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;
+      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');
@@ -626,6 +683,7 @@ dialog::backdrop { background: #30384266; }
         $('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);
@@ -753,7 +811,7 @@ dialog::backdrop { background: #30384266; }
       });
       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();
@@ -767,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;

package/package.json

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