@chuchen3d/wallpaper-plugin-sdk 0.0.0-stage → 1.1.0

package/src/templates/vue-component.js

@@ -0,0 +1,213 @@
+/**
+ * Vue 组件模板生成器
+ */
+
+/** 生成 Vue 组件模板 */
+export function generateVueComponentTemplate(componentName, manifest) {
+  const entry = manifest.entry || `${componentName}.vue`
+  const params = manifest.params || {}
+
+  // 生成参数读取辅助函数
+  const paramHelpers = Object.entries(params).map(([key, def]) => {
+    return `/** ${def.label || key} */
+function get${toPascalCase(key)}() {
+  return props.paramValues?.['${key}'] ?? ${JSON.stringify(def.default)}
+}`
+  }).join('\n\n')
+
+  // 生成参数面板 HTML（用于 dev-preview.js）
+  const paramPanelHTML = Object.entries(params).map(([key, def]) => {
+    if (def.type === 'number') {
+      return `    <label>${def.label || key}: <input type="range" id="param-${key}" min="${def.min ?? 0}" max="${def.max ?? 100}" step="${def.step ?? 1}" value="${def.default}"> <span id="val-${key}">${def.default}</span></label>`
+    }
+    if (def.type === 'toggle') {
+      return `    <label>${def.label || key}: <input type="checkbox" id="param-${key}" ${def.default ? 'checked' : ''}></label>`
+    }
+    if (def.type === 'color') {
+      return `    <label>${def.label || key}: <input type="color" id="param-${key}" value="${def.default}"></label>`
+    }
+    if (def.type === 'select') {
+      const options = (def.options || []).map(opt => `<option value="${opt.value}">${opt.label}</option>`).join('')
+      return `    <label>${def.label || key}: <select id="param-${key}">${options}</select></label>`
+    }
+    return ''
+  }).filter(Boolean).join('\n')
+
+  return `<template>
+  <canvas ref="canvasRef" class="wallpaper-canvas"></canvas>
+</template>
+
+<script setup>
+/**
+ * ════════════════════════════════════════════════════════════
+ * 🎨 ${manifest.name || componentName} — 逸然3D壁纸插件
+ * ════════════════════════════════════════════════════════════
+ *
+ * 作者: ${manifest.author?.name || '开发者'}
+ * 描述: ${manifest.description || '一款精美的壁纸插件'}
+ *
+ * 开发指南:
+ *   1. 在 <template> 中只需保留 <canvas> 元素（必须含 class="wallpaper-canvas"，否则截图面板找不到画布）
+ *   2. 在 init() 中创建你的动画/渲染逻辑（Three.js 用户记得开 preserveDrawingBuffer: true）
+ *   3. 在 animate() 中实现帧动画
+ *   4. 在 onUnmounted() 中清理资源
+ *   5. 使用 getParam() 读取用户调整的参数值
+ */
+
+import { ref, onMounted, onUnmounted } from 'vue'
+
+const props = defineProps({
+  /** 父容器引用（用于尺寸获取和事件绑定） */
+  containerRef: { type: Object, default: null },
+  /** 参数值对象（从宿主参数面板或 manifest.json 读取） */
+  paramValues: { type: Object, default: () => ({}) },
+  /** 性能策略（fpsLimit、pixelRatioCap、mouseInteraction） */
+  performancePolicy: { type: Object, default: () => ({}) },
+})
+
+const canvasRef = ref(null)
+
+// ===== 参数读取辅助函数 =====
+${paramHelpers}
+
+/** 安全获取参数值（带默认值回退） */
+function getParam(key, defaultValue) {
+  const val = props.paramValues?.[key]
+  return val !== undefined ? val : defaultValue
+}
+
+// ===== 核心变量 =====
+let animationId = null
+let lastFrameTime = 0
+
+// ===== 生命周期 =====
+onMounted(() => {
+  init()
+})
+
+onUnmounted(() => {
+  // 取消动画帧
+  if (animationId) {
+    cancelAnimationFrame(animationId)
+  }
+
+  // 移除事件监听
+  if (props.containerRef) {
+    props.containerRef.removeEventListener('mousemove', onMouseMove)
+  }
+  window.removeEventListener('resize', onResize)
+})
+
+// ===== 初始化 =====
+function init() {
+  const canvas = canvasRef.value
+  const container = props.containerRef || canvas.parentElement
+
+  if (!canvas || !container) {
+    console.warn('[${componentName}] Canvas 或容器未找到')
+    return
+  }
+
+  // 获取 Canvas 2D 上下文（如需 Three.js 可改为 WebGL）
+  const ctx = canvas.getContext('2d')
+
+  // ★ 如改用 Three.js，请按下面写法（preserveDrawingBuffer: true 是截图面板能正常工作的关键）：
+  // import * as THREE from 'three'
+  // const renderer = new THREE.WebGLRenderer({ canvas, preserveDrawingBuffer: true, antialias: true, alpha: true })
+  // const scene = new THREE.Scene()
+  // const camera = new THREE.PerspectiveCamera(45, container.clientWidth / container.clientHeight, 0.1, 100)
+  // camera.position.z = 5
+  // // ... 建场景、几何体、材质 ...
+
+  // 设置 Canvas 尺寸（统一走外部 onResize，保证 onUnmounted 的 removeEventListener 能匹配）
+  onResize()
+
+  // 绑定事件
+  if (container) {
+    container.addEventListener('mousemove', onMouseMove)
+  }
+  window.addEventListener('resize', onResize)
+
+  // 开始动画循环
+  animate()
+}
+
+// ===== 动画循环 =====
+function animate(timestamp) {
+  animationId = requestAnimationFrame(animate)
+
+  // FPS 限制（性能模式下可能为 30 或 15，暂停时为 0）
+  const fpsLimit = props.performancePolicy?.fpsLimit || 60
+  if (fpsLimit > 0 && fpsLimit < 60) {
+    if (!lastFrameTime) lastFrameTime = timestamp
+    const intervalMs = 1000 / fpsLimit
+    if (timestamp - lastFrameTime < intervalMs) return
+    lastFrameTime = timestamp
+  } else if (fpsLimit === 0) {
+    return // 暂停渲染
+  }
+
+  // 读取参数
+  const opacity = getOpacity()
+  const speed = getSpeed()
+
+  // ★ 在此编写你的渲染逻辑 ★
+  // 示例：绘制一个渐变背景
+  const canvas = canvasRef.value
+  if (!canvas) return
+  const ctx = canvas.getContext('2d')
+  const width = canvas.width
+  const height = canvas.height
+
+  // 清除画布
+  ctx.clearRect(0, 0, width, height)
+
+  // 示例：绘制动态粒子（可根据参数调整）
+  const particleCount = getParam('particleCount', 50)
+  for (let i = 0; i < particleCount; i++) {
+    const x = (Math.sin(timestamp * 0.001 * speed + i) * 0.5 + 0.5) * width
+    const y = (Math.cos(timestamp * 0.001 * speed + i * 0.7) * 0.5 + 0.5) * height
+    const size = 2 + Math.sin(timestamp * 0.002 + i) * 1
+
+    ctx.beginPath()
+    ctx.arc(x, y, size, 0, Math.PI * 2)
+    ctx.fillStyle = \`rgba(255, 255, 255, \${opacity * 0.6})\`
+    ctx.fill()
+  }
+}
+
+// ===== 事件处理 =====
+function onMouseMove(event) {
+  const rect = event.currentTarget.getBoundingClientRect()
+  // 可在这里处理鼠标交互
+  // targetMouseX = ((event.clientX - rect.left) / rect.width) * 2 - 1
+  // targetMouseY = -((event.clientY - rect.top) / rect.height) * 2 + 1
+}
+
+function onResize() {
+  // ★ 注意：直接用 props.containerRef（不要取 .parentElement —— 在主窗口预览模式下
+  //   parentElement 是包含参数面板的整个 preview-section，尺寸是错的）
+  const container = props.containerRef || canvasRef.value?.parentElement || window
+  const width = container.clientWidth || window.innerWidth
+  const height = container.clientHeight || window.innerHeight
+  if (canvasRef.value) {
+    canvasRef.value.width = width
+    canvasRef.value.height = height
+  }
+}
+</script>
+
+<style scoped>
+.wallpaper-canvas {
+  width: 100%;
+  height: 100%;
+  display: block;
+}
+</style>
+`
+}
+
+/** 工具函数：kebab-case → PascalCase */
+function toPascalCase(str) {
+  return str.replace(/(?:^|-)(\w)/g, (_, c) => c.toUpperCase())
+}

package/src/utils/colors.js

@@ -0,0 +1,31 @@
+/**
+ * 终端颜色工具（chalk 封装）
+ */
+
+import chalk from 'chalk'
+
+export const colors = {
+  success: (msg) => chalk.green(`✅ ${msg}`),
+  error: (msg) => chalk.red(`❌ ${msg}`),
+  warn: (msg) => chalk.yellow(`⚠️  ${msg}`),
+  info: (msg) => chalk.cyan(`ℹ️  ${msg}`),
+  title: (msg) => chalk.bold.white(msg),
+  subtitle: (msg) => chalk.gray(msg),
+  highlight: (msg) => chalk.magenta(msg),
+  file: (msg) => chalk.cyan(msg),
+  code: (msg) => chalk.yellow(`\`${msg}\``),
+}
+
+/** 打印分隔线 */
+export function printSeparator() {
+  console.log(chalk.gray('─'.repeat(50)))
+}
+
+/** 打印标题头 */
+export function printHeader(title, version = '1.0.0') {
+  console.log('')
+  console.log('╔══════════════════════════════════════╗')
+  console.log(`║  🧩 初尘3D壁纸 插件 SDK v${version.padEnd(10)}     ║`)
+  console.log('╚══════════════════════════════════════╝')
+  console.log('')
+}

package/src/utils/packager.js

@@ -0,0 +1,210 @@
+/**
+ * 打包核心逻辑（ZIP 生成 + 文件过滤）
+ */
+
+import fs from 'fs'
+import path from 'path'
+import JSZip from 'jszip'
+
+/** 打包文件过滤规则 */
+const PACK_EXCLUDE = [
+  'node_modules',
+  '.git',
+  '.gitignore',
+  'package.json',
+  'package-lock.json',
+  'yarn.lock',
+  'pnpm-lock.yaml',
+  'vite.config.js',
+  'index.html',
+  'dev-preview.js',
+  'README.md',
+  'ICON_GUIDE.md',
+  '.DS_Store',
+  'Thumbs.db',
+]
+
+/** 判断是否应排除 */
+function shouldExclude(filePath) {
+  const basename = path.basename(filePath)
+  return PACK_EXCLUDE.some(pattern => {
+    if (pattern.startsWith('.')) {
+      // 隐藏文件/目录
+      return basename === pattern || filePath.includes(`/${pattern}/`) || filePath.endsWith(`/${pattern}`)
+    }
+    return basename === pattern
+  })
+}
+
+/** 打包项目为 .yizirwp ZIP */
+export async function packProject(projectDir, outputName, manifest, options = {}) {
+  const zip = new JSZip()
+  let fileCount = 0
+
+  // 1. 添加 manifest.json
+  zip.file('manifest.json', JSON.stringify(manifest, null, 2))
+  fileCount++
+
+  // 2. 添加入口 .vue 文件
+  if (manifest.entry) {
+    const entryPath = path.resolve(projectDir, manifest.entry)
+    if (fs.existsSync(entryPath)) {
+      const content = fs.readFileSync(entryPath)
+      zip.file(manifest.entry, content)
+      fileCount++
+    }
+  }
+
+  // 3. 添加 manifest.files 中声明的其他文件（排除入口，避免重复）
+  if (Array.isArray(manifest.files)) {
+    for (const file of manifest.files) {
+      if (file === manifest.entry) continue
+      if (file === 'manifest.json') continue
+
+      const filePath = path.resolve(projectDir, file)
+      if (fs.existsSync(filePath) && !shouldExclude(file)) {
+        const stat = fs.statSync(filePath)
+        if (stat.isDirectory()) {
+          // 目录：递归添加所有文件
+          await addDirectoryToZip(zip, filePath, file)
+          fileCount += countFilesInDir(filePath)
+        } else {
+          const content = fs.readFileSync(filePath)
+          zip.file(file, content)
+          fileCount++
+        }
+      }
+    }
+  }
+
+  // 4. 检查并添加 thumbnail
+  const thumbnailPatterns = ['thumbnail.png', 'thumbnail.jpg', 'thumbnail.svg']
+  for (const thumb of thumbnailPatterns) {
+    const thumbPath = path.resolve(projectDir, thumb)
+    if (fs.existsSync(thumbPath)) {
+      zip.file(thumb, fs.readFileSync(thumbPath))
+      fileCount++
+      break
+    }
+  }
+
+  // 5. 添加预览视频/GIF（options.preview 或自动检测 preview.{mp4,webm,mov,gif}）
+  const previewPath = options.preview || autoDetectPreview(projectDir)
+  if (previewPath) {
+    const previewName = path.basename(previewPath)
+    zip.file(`preview/${previewName}`, fs.readFileSync(previewPath))
+    fileCount++
+  }
+
+  // 6. 生成 ZIP（原本是第 5 步）
+  const buffer = await zip.generateAsync({ type: 'nodebuffer', compression: 'DEFLATE' })
+
+  // 7. 写入输出文件（原本是第 6 步）
+  const outputPath = outputName || `${manifest.id}-${manifest.version}.yizirwp`
+  fs.writeFileSync(outputPath, buffer)
+
+  const fileSize = (buffer.length / 1024).toFixed(1)
+
+  return { outputPath, fileSize: `${fileSize} KB`, fileCount }
+}
+
+/**
+ * 从 dist 目录打包已构建的插件
+ *
+ * @param {string} projectDir — 插件项目根目录
+ * @param {string} outputName — 输出文件名（.yizirwp）
+ * @param {Object} builtManifest — 已重写的 manifest 对象（entry=index.js）
+ * @returns {Promise<{ outputPath: string, fileSize: string, fileCount: number }>}
+ */
+export async function packFromDist(projectDir, outputName, builtManifest, options = {}) {
+  const zip = new JSZip()
+  let fileCount = 0
+
+  const distDir = path.resolve(projectDir, 'dist')
+
+  // 1. 添加已重写的 manifest.json
+  zip.file('manifest.json', JSON.stringify(builtManifest, null, 2))
+  fileCount++
+
+  // 2. 添加构建产物 index.js
+  const indexJsPath = path.resolve(distDir, 'index.js')
+  if (!fs.existsSync(indexJsPath)) {
+    throw new Error('构建产物 dist/index.js 不存在')
+  }
+  zip.file('index.js', fs.readFileSync(indexJsPath))
+  fileCount++
+
+  // 3. 添加缩略图（如果项目根目录存在）
+  const thumbnailPatterns = ['thumbnail.png', 'thumbnail.jpg', 'thumbnail.svg']
+  for (const thumb of thumbnailPatterns) {
+    const thumbPath = path.resolve(projectDir, thumb)
+    if (fs.existsSync(thumbPath)) {
+      zip.file(thumb, fs.readFileSync(thumbPath))
+      fileCount++
+      break
+    }
+  }
+
+  // 4. 添加预览（options.preview 或自动检测 preview.{mp4,webm,mov,gif}）
+  const previewPath = options.preview || autoDetectPreview(projectDir)
+  if (previewPath) {
+    const previewName = path.basename(previewPath)
+    zip.file(`preview/${previewName}`, fs.readFileSync(previewPath))
+    fileCount++
+  }
+
+  // 5. 生成 ZIP（原本是第 4 步）
+  const buffer = await zip.generateAsync({ type: 'nodebuffer', compression: 'DEFLATE' })
+
+  // 6. 写入输出文件（原本是第 5 步）
+  const outputPath = outputName || `${builtManifest.id}-${builtManifest.version}.yizirwp`
+  fs.writeFileSync(outputPath, buffer)
+
+  const fileSize = (buffer.length / 1024).toFixed(1)
+
+  return { outputPath, fileSize: `${fileSize} KB`, fileCount }
+}
+
+/** 递归添加目录到 ZIP */
+async function addDirectoryToZip(zip, dirPath, prefix) {
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true })
+  for (const entry of entries) {
+    if (entry.name.startsWith('.') || entry.name === 'node_modules') continue
+
+    const fullPath = path.join(dirPath, entry.name)
+    const relativePath = `${prefix}/${entry.name}`
+
+    if (entry.isDirectory()) {
+      await addDirectoryToZip(zip, fullPath, relativePath)
+    } else {
+      zip.file(relativePath, fs.readFileSync(fullPath))
+    }
+  }
+}
+
+/** 统计目录中的文件数 */
+function countFilesInDir(dirPath) {
+  let count = 0
+  const entries = fs.readdirSync(dirPath, { withFileTypes: true })
+  for (const entry of entries) {
+    if (entry.name.startsWith('.') || entry.name === 'node_modules') continue
+
+    const fullPath = path.join(dirPath, entry.name)
+    if (entry.isDirectory()) {
+      count += countFilesInDir(fullPath)
+    } else {
+      count++
+    }
+  }
+  return count
+}
+
+/** 自动检测项目根目录的预览文件（mp4 / webm / mov / gif） */
+function autoDetectPreview(projectDir) {
+  const patterns = ['preview.mp4', 'preview.webm', 'preview.mov', 'preview.gif']
+  for (const p of patterns) {
+    const full = path.resolve(projectDir, p)
+    if (fs.existsSync(full)) return full
+  }
+  return null
+}

package/src/utils/paramsConverter.js

@@ -0,0 +1,44 @@
+/**
+ * 参数格式转换器
+ *
+ * 将 SDK 扁平格式（manifest.params = { key: { type, default, ... } }）
+ * 转换为应用侧期望的格式（{ defaults: {...}, definitions: [...] }）。
+ */
+
+/**
+ * 转换参数格式
+ *
+ * @param {Object<string, {type: string, default: *, label?: string, min?: number, max?: number, step?: number, options?: *, tier?: string}>} sdkParams
+ * @returns {{ defaults: Object<string, *>, definitions: Array<Object> }}
+ */
+export function convertParamsToAppFormat(sdkParams) {
+  if (!sdkParams || typeof sdkParams !== 'object' || Array.isArray(sdkParams)) {
+    return { defaults: {}, definitions: [] }
+  }
+
+  const defaults = {}
+  const definitions = []
+
+  for (const [key, def] of Object.entries(sdkParams)) {
+    if (!def || typeof def !== 'object') continue
+
+    defaults[key] = def.default
+
+    const definition = {
+      key,
+      type: def.type,
+      label: def.label || key,
+      default: def.default,
+    }
+
+    if (def.min !== undefined) definition.min = def.min
+    if (def.max !== undefined) definition.max = def.max
+    if (def.step !== undefined) definition.step = def.step
+    if (def.options !== undefined) definition.options = def.options
+    if (def.tier !== undefined) definition.tier = def.tier
+
+    definitions.push(definition)
+  }
+
+  return { defaults, definitions }
+}

package/src/utils/validator.js

@@ -0,0 +1,119 @@
+/**
+ * manifest.json 校验工具
+ */
+
+import fs from 'fs'
+import path from 'path'
+
+/** 校验 manifest.json 格式 */
+export function validateManifest(manifest, projectDir) {
+  const errors = []
+  const warnings = []
+
+  // 必需字段
+  const required = ['id', 'name', 'version', 'author', 'entry', 'files']
+  for (const field of required) {
+    if (!(field in manifest)) {
+      errors.push(`缺少必需字段: "${field}"`)
+    }
+  }
+
+  // ID 格式（kebab-case）
+  if (manifest.id && !/^[a-z0-9]([a-z0-9-]*[a-z0-9])?$/.test(manifest.id)) {
+    errors.push(`ID 格式错误: "${manifest.id}"（仅允许小写字母、数字、连字符）`)
+  }
+
+  // 版本号（语义化）
+  if (manifest.version && !/^\d+\.\d+\.\d+/.test(manifest.version)) {
+    errors.push(`版本号格式错误: "${manifest.version}"（应为语义化版本如 1.0.0）`)
+  }
+
+  // 入口文件是否存在
+  if (manifest.entry && projectDir) {
+    const entryPath = path.resolve(projectDir, manifest.entry)
+    if (!fs.existsSync(entryPath)) {
+      errors.push(`入口文件不存在: "${manifest.entry}"`)
+    }
+  }
+
+  // files 中声明的文件是否都存在
+  if (Array.isArray(manifest.files) && projectDir) {
+    for (const file of manifest.files) {
+      if (!fs.existsSync(path.resolve(projectDir, file))) {
+        errors.push(`声明的文件不存在: "${file}"`)
+      }
+    }
+  } else if (!Array.isArray(manifest.files)) {
+    errors.push('"files" 必须是数组类型')
+  }
+
+  // 推荐字段
+  const recommended = ['description', 'tags', 'category', 'params']
+  for (const field of recommended) {
+    if (!(field in manifest)) {
+      warnings.push(`建议提供字段: "${field}"`)
+    }
+  }
+
+  // 商业字段校验（可选）
+  if ('isPremium' in manifest && typeof manifest.isPremium !== 'boolean') {
+    errors.push('"isPremium" 必须是布尔值')
+  }
+  if ('price' in manifest) {
+    if (typeof manifest.price !== 'number' || manifest.price < 0) {
+      errors.push('"price" 必须是非负数字')
+    }
+  }
+  if ('originalPrice' in manifest) {
+    if (typeof manifest.originalPrice !== 'number' || manifest.originalPrice < 0) {
+      errors.push('"originalPrice" 必须是非负数字')
+    }
+  }
+  if ('tier' in manifest) {
+    const validTiers = ['free', 'monthly', 'yearly', 'lifetime']
+    if (!validTiers.includes(manifest.tier)) {
+      errors.push(`"tier" 必须是 ${validTiers.join('/')} 之一，当前值: "${manifest.tier}"`)
+    }
+  }
+
+  // ★ 真隔离重构（2026-10-08）：沙箱运行时字段校验
+  // network.domains → 宿主沙箱 CSP connect-src 唯一放行依据，宁拒勿放
+  if ('network' in manifest) {
+    if (manifest.network === null || typeof manifest.network !== 'object' || Array.isArray(manifest.network)) {
+      errors.push('"network" 必须是对象，形如 { "domains": ["https://example.com"] }')
+    } else if ('domains' in manifest.network) {
+      const domains = manifest.network.domains
+      if (!Array.isArray(domains)) {
+        errors.push('"network.domains" 必须是字符串数组')
+      } else {
+        for (const d of domains) {
+          const host = typeof d === 'string'
+            ? d.replace(/^https?:\/\//, '').replace(/\/.*$/, '')
+            : ''
+          if (!/^([a-z0-9-]+\.)+[a-z]{2,}(:\d+)?$/i.test(host)) {
+            errors.push(`"network.domains" 含非法域名: ${JSON.stringify(d)}（仅支持 https 域名，如 "https://api.example.com"）`)
+          }
+        }
+        if (domains.length > 8) {
+          errors.push('"network.domains" 最多声明 8 个域名')
+        }
+      }
+    }
+  }
+  if ('apiVersion' in manifest) {
+    if (!Number.isInteger(manifest.apiVersion) || manifest.apiVersion < 1) {
+      errors.push('"apiVersion" 必须是不小于 1 的整数（当前沙箱 API 大版本为 1）')
+    }
+  }
+
+  // 预览文件提示（warning）：项目根存在 preview.* 但 manifest 未声明
+  if (projectDir) {
+    const previewPatterns = ['preview.mp4', 'preview.webm', 'preview.mov', 'preview.gif']
+    const foundPreview = previewPatterns.find(p => fs.existsSync(path.resolve(projectDir, p)))
+    if (foundPreview && !('preview' in manifest)) {
+      warnings.push(`检测到预览文件 ${foundPreview}，但 manifest 未声明 "preview" 字段（不影响打包，仅提示）`)
+    }
+  }
+
+  return { valid: errors.length === 0, errors, warnings }
+}

package/src/utils/viteBuilder.js

@@ -0,0 +1,79 @@
+/**
+ * Vite 构建器
+ *
+ * 使用 Vite 的 JavaScript API 将 Vue SFC 插件编译为自包含的 IIFE JS bundle。
+ */
+
+import fs from 'fs'
+import path from 'path'
+import { build } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { generatePluginEntry } from '../templates/plugin-entry.js'
+
+/**
+ * 构建 Vue SFC 插件为 IIFE bundle
+ *
+ * @param {Object} options
+ * @param {string} options.projectDir — 插件项目根目录（含 manifest.json 和 .vue 入口）
+ * @param {Object} options.manifest — 已解析的 manifest 对象
+ * @returns {Promise<{ outputDir: string, entryFileName: string }>}
+ */
+export async function buildPlugin({ projectDir, manifest }) {
+  const entryFileName = manifest.entry
+  const entryFullPath = path.resolve(projectDir, entryFileName)
+
+  if (!fs.existsSync(entryFullPath)) {
+    throw new Error(`入口文件不存在: ${entryFileName}`)
+  }
+
+  // 生成临时入口文件（.js 包装器，import 真正的 .vue 组件）
+  const tempEntryPath = path.resolve(projectDir, '.yiziran-plugin-entry.js')
+  const entryCode = generatePluginEntry(`./${entryFileName}`)
+  fs.writeFileSync(tempEntryPath, entryCode)
+
+  try {
+    await build({
+      configFile: false,
+      logLevel: 'warn',
+      root: projectDir,
+      plugins: [vue()],
+      define: {
+        'process.env.NODE_ENV': JSON.stringify('production'),
+        'process.env': '{}',
+      },
+      build: {
+        lib: {
+          entry: tempEntryPath,
+          name: 'YiziranPlugin',
+          formats: ['iife'],
+          fileName: () => 'index.js',
+        },
+        outDir: path.resolve(projectDir, 'dist'),
+        emptyOutDir: true,
+        minify: false,
+        sourcemap: false,
+        rollupOptions: {
+          // ★ 真隔离重构（2026-10-08）：产物自包含 —— vue/three 全部打进 IIFE。
+          //   旧方案 external 到宿主 window.__YIZIRAN_VUE__/__YIZIRAN_THREE__ 依赖
+          //   同上下文执行，沙箱（opaque origin iframe）内不可达，已废除。
+          //   代价：包 +约 700KB 未压缩（zip 后 +150~250KB）。
+          external: [],
+        },
+      },
+      resolve: {
+        alias: {
+          vue: 'vue/dist/vue.esm-bundler.js',
+        },
+      },
+    })
+
+    return {
+      outputDir: path.resolve(projectDir, 'dist'),
+      entryFileName: 'index.js',
+    }
+  } finally {
+    if (fs.existsSync(tempEntryPath)) {
+      fs.unlinkSync(tempEntryPath)
+    }
+  }
+}