shaomang/mtnode-aio/plugin-dev

<kind 目录>/                       例：music3/
  main-<name>.js     主进程宿主：安装编排 / 起停后端 / 生成 / 控制台窗 / IPC / 报错上报
  preload-<name>.js  控制台窗的能力桥（contextBridge.exposeInMainWorld）
  ui/index.html      控制台界面（无框架原生）
  ui/ui.js  ui/ui.css
  [可选] tray-main.js / preload-tray.js  托盘常驻（llama / tts 有）
  [可选] <name>-workflows.js             后端工作流适配（h3）
<name>-pack/         随包脚手架：app/ scripts/ requirements.txt manifest.json start_backend.cmd README.md

画布节点（renderer/app-nodes.js）
  → window.api.<kind>Generate(...)                     preload.js 白名单桥
    → ipcMain.handle("<kind>:generate")                宿主 main-*.js
      → 全局音视频互斥锁 media-gen-global-lock.js
      → spawn 后端 / HTTP 调后端（detached 单例，通常不随 MTNode 退出）
      → 落盘到应用资产目录（素材 / 资产），返回 { ok, path }
    ← 渲染层刷节点状态
失败 → reportErr(code, message, { phase, nodeId }) → plugin-error-repair.js
     → 主窗口弹报告 → 「🤖 自动修复」→ 按 skills/<id>-install 的【自我修复】模式开会话 → 成功自动 restart()

"files": [
   "<kind>/**",              // 例："music3/**"（宿主 + ui + preload）
  "plugins/**",              // 已在
  "mtnode-agent-skills/**", "guides/**", "skills/**"   // 已在（技能 / 指南 / 安装技能）
],
"extraResources": [
  { "from": "<xxx>-pack", "to": "<xxx>-pack",
    "filter": ["app/**","scripts/**","requirements.txt","README.md","start_backend.cmd",".gitignore","manifest.json"] }
]

/* main-<name>.js 的 register<Name>Ipc 里注册一次宿主 */
pluginErrors.registerPluginHost({
  id: PLUGIN_ID,                     // 与 catalog id 一致
  name: "插件中文名",                 // 报告标题
  skillName: "<id>-install",         // 修复会话要用的安装技能（skills/<id>-install/SKILL.md）
  getInstallDir: () => loadConfig().installDir || "",   // 修复会话的可写工作区
  tailConsole: (n) => consoleTail(n),                   // 日志尾部（没有日志就留空，只有窗口插件会这样）
  selfRepair: (o) => selfRepairFromConsole(o || {}),
  restart: async () => { await stopBackend(); return startBackend(); },
});
/* 每个失败出口（安装 / 起后端 / 生成 / 卸载）都补一行，包在 try/catch 里，绝不能被报告拖住 */
reportErr(code, message, { phase: "install", nodeId: nid });

"use strict";
/**
 * <中文名> 插件主进程：
 * - 安装目录 / 脚手架 / 安装编排
 * - 后端单例（detached，<随 MTNode 退出 | 不随 MTNode 退出>）
 * - 全局生成锁、GPU 监视、控制台窗
 */
const { BrowserWindow, ipcMain, dialog, screen, app } = require("electron");
const path = require("path");
const fs = require("fs");
const { spawn } = require("child_process");
const { fetchRemoteManifest, downloadRuntimeTo, verGt } = require("../plugins/runtime-feed.js");
const { tryAcquireLock, releaseLock, busyMessage } = require("../media-gen-global-lock.js");
const pluginErrors = require("../plugin-error-repair.js");
const PLUGIN_ID = "<plugin-id>";                 // 与 catalog.default.json 的 id 一致
const DEFAULT_PORT = 7900;
let getDataDir = null, getMainWin = null, appRoot = null, consoleWin = null, backendProc = null;
function join(...a) { return path.join(...a); }
function mk(p) { fs.mkdirSync(p, { recursive: true }); return p; }
function configPath() { return join(getDataDir(), "app-plugins", PLUGIN_ID, "config.json"); }
function loadConfig() { try { return JSON.parse(fs.readFileSync(configPath(), "utf8")); } catch { return {}; } }
function saveConfig(patch) { mk(path.dirname(configPath())); /* 原子写：tmp + rename */ }
/** 安装目录护栏：只允许用户选定的普通目录，拒绝应用目录 / exe 同目录 */
function isSafeInstallDir(dir) { /* 见 docs/fact-library.md §一 / §六 的口径 */ }
/** 后端单例：detached，退出前先把 pid 记进 config，下次启动用 probe 探活接管 */
async function startBackend() { /* probe → 未起则 spawn(chcp 包里的 start_backend.cmd) → 轮询 /health */ }
async function stopBackend() { /* 只停本插件记录的那个 pid */ }
function uiEntry() { return join(appRoot, "<kind>", "ui", "index.html"); }
function consoleTail(n) { /* 读自己的 console.log 尾部 */ }
function openConsoleWindow() {
  if (consoleWin && !consoleWin.isDestroyed()) { consoleWin.show(); consoleWin.focus(); return { ok: true, open: true }; }
  consoleWin = new BrowserWindow({
    width: 420, height: 640, frame: true, title: "<中文名> · 插件测试中",
    webPreferences: { contextIsolation: true, nodeIntegration: false, sandbox: false,
      preload: join(__dirname, "preload-<name>.js") },
  });
  consoleWin.loadFile(uiEntry());
  consoleWin.on("closed", () => { consoleWin = null; notifyConsoleChanged(false); });
  notifyConsoleChanged(true);
  return { ok: true, open: true };
}
function notifyConsoleChanged(open) { /* webContents.send("<kind>:consoleChanged", { open }) 给主窗口 */ }
function reportErr(code, message, extra) {
  try { pluginErrors.reportPluginError(PLUGIN_ID, Object.assign({ code: String(code || ""), message: String(message || "") }, extra || {})); } catch {}
}
async function generate(params) {
  const lock = tryAcquireLock("<kind>", params.nodeId);      // 全局音视频互斥
  if (!lock.ok) return { ok: false, error: "busy_media", message: busyMessage(lock) };
  try { /* 调后端 → 落资产目录 → { ok: true, path } */ }
  catch (e) { reportErr(String(e && e.code) || "generate_failed", String(e && e.message || e), { phase: "generate", nodeId: params.nodeId }); return { ok: false, error: "generate_failed" }; }
  finally { releaseLock("<kind>", params.nodeId); }
}