juice-email-cli 2.2.2 → 2.3.1

package/bin/juice.js

@@ -75,7 +75,46 @@ program
       └── 📂 打开 PowerShell          （仅已安装 pwsh 时出现）
 
 更多信息：https://gitee.com/siriussupreme/juice-cli
-`)
+`);
+
+// ─── Subcommand: juice view ─────────────────────────────────────────────
+program
+  .command('view [path]')
+  .description('查看 EDM 资源：品牌、模板、系列、片段变体')
+  .option('-i, --interactive', '交互式浏览，可上下翻层级')
+  .option('--templates', '列出所有模板')
+  .option('--series', '列出所有系列')
+  .option('--snippets', '列出所有片段')
+  .action(async (viewPath, options) => {
+    const { runViewMode } = require('../src/view');
+    await runViewMode({
+      viewPath: viewPath || null,
+      interactive: !!options.interactive,
+      scope: options.templates ? 'templates'
+        : (options.series ? 'series'
+        : (options.snippets ? 'snippets' : null)),
+    });
+  });
+
+// ─── Subcommand: juice init ─────────────────────────────────────────────
+program
+  .command('init [path]')
+  .description('从 EDM 资源拷贝模板/片段/配置到当前目录')
+  .option('-t, --template <file-path>', '仅拷贝模板 HTML 文件')
+  .option('-s, --snippet <file-path>', '仅拷贝片段 HTML 文件')
+  .option('-c, --config <file-path>', '仅拷贝配置 YAML 文件')
+  .action(async (initPath, options) => {
+    const { runInitMode } = require('../src/init');
+    await runInitMode({
+      initPath: initPath || null,
+      template: options.template || null,
+      snippet: options.snippet || null,
+      config: options.config || null,
+    });
+  });
+
+// ─── Default action (backward compatible) ───────────────────────────────
+program
   .action(async (options) => {
     // 注册/卸载右键菜单
     if (options.install) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juice-email-cli",
-  "version": "2.2.2",
+  "version": "2.3.1",
   "description": "CLI tool to generate email-client-compatible HTML with juice (CSS inlining) + Mustache templating + minification",
   "main": "src/index.js",
   "bin": {

package/src/context-menu.js

@@ -56,19 +56,28 @@ function regAdd(key, valueName, type, data) {
   if (type) args.push('/t', type);
   if (data !== undefined) args.push('/d', data);
 
-  const result = spawnSync('reg', args, { stdio: 'pipe' });
-  if (result.status !== 0) {
-    const msg = (result.stderr || '').toString().trim();
-    console.warn(chalk.yellow(`  ⚠  reg add 失败\n     键：${key}\n     原因：${msg}`));
+  try {
+    const result = spawnSync('reg', args, { stdio: 'pipe', timeout: 10000 });
+    if (result.status !== 0) {
+      const msg = (result.stderr || '').toString().trim();
+      console.warn(chalk.yellow(`  ⚠  reg add 失败\n     键：${key}\n     原因：${msg}`));
+      return false;
+    }
+    return true;
+  } catch (e) {
+    console.warn(chalk.yellow(`  ⚠  reg add 超时：${key}`));
     return false;
   }
-  return true;
 }
 
 function regDelete(key) {
   if (!isWindows) return false;
-  const result = spawnSync('reg', ['delete', key, '/f'], { stdio: 'pipe' });
-  return result.status === 0;
+  try {
+    const result = spawnSync('reg', ['delete', key, '/f'], { stdio: 'pipe', timeout: 10000 });
+    return result.status === 0;
+  } catch (_) {
+    return false;
+  }
 }
 
 // ─── 菜单结构常量 ─────────────────────────────────────────────────────────────
@@ -90,10 +99,13 @@ const YAML_ROOTS = [
 
 // 子命令名称常量
 const SUBCMDS = {
-  generate: 'JuiceEmail.Generate',
-  snippet:  'JuiceEmail.Snippet',
-  config:   'JuiceEmail.WithConfig',
-  pwsh:     'JuiceEmail.OpenPwsh',
+  generate:  'JuiceEmail.Generate',
+  snippet:   'JuiceEmail.Snippet',
+  config:    'JuiceEmail.WithConfig',
+  viewEdm:   'JuiceEmail.ViewEdm',
+  viewEdmInt:'JuiceEmail.ViewEdmInteractive',
+  initEdm:   'JuiceEmail.InitEdm',
+  pwsh:      'JuiceEmail.OpenPwsh',
 };
 
 const PARENT_KEY_NAME = 'JuiceEmail';
@@ -101,6 +113,8 @@ const PARENT_KEY_NAME = 'JuiceEmail';
 // ExtendedSubCommandsKey 指向的容器路径（相对于 HKCU\Software\Classes）
 const SUB_CMDS_CONTAINER_HTML = 'JuiceEmail.SubCommands';
 const SUB_CMDS_CONTAINER_YAML = 'JuiceEmail.SubCommands.Yaml';
+const SUB_CMDS_CONTAINER_DIR  = 'JuiceEmail.SubCommands.Dir';
+const SUB_CMDS_CONTAINER_BG   = 'JuiceEmail.SubCommands.Bg';
 
 // ─── 旧版残留清理 ─────────────────────────────────────────────────────────────
 
@@ -209,6 +223,19 @@ function registerSubCommands(containerPath, kind, nodePath, scriptPath, iconPath
     regAdd(`${cfgKey}\\command`, '', 'REG_SZ', wrapInteractive(nodePath, scriptPath, '-c %1'));
   }
 
+  // Common items for file-type containers (html + yaml)
+  if (kind === 'html' || kind === 'yaml') {
+    const viewKey = `${containerPath}\\shell\\${SUBCMDS.viewEdm}`;
+    regAdd(viewKey, 'MUIVerb', 'REG_SZ', '📦 查看资源列表');
+    regAdd(viewKey, 'Icon', 'REG_SZ', iconPath);
+    regAdd(`${viewKey}\\command`, '', 'REG_SZ', wrapInteractive(nodePath, scriptPath, 'view'));
+
+    const viewIntKey = `${containerPath}\\shell\\${SUBCMDS.viewEdmInt}`;
+    regAdd(viewIntKey, 'MUIVerb', 'REG_SZ', '📋 浏览资源库');
+    regAdd(viewIntKey, 'Icon', 'REG_SZ', iconPath);
+    regAdd(`${viewIntKey}\\command`, '', 'REG_SZ', wrapInteractive(nodePath, scriptPath, 'view -i'));
+  }
+
   // pwsh — 始终显示（可选）
   if (pwshPath) {
     const pwshKey = `${containerPath}\\shell\\${SUBCMDS.pwsh}`;
@@ -219,6 +246,54 @@ function registerSubCommands(containerPath, kind, nodePath, scriptPath, iconPath
   }
 }
 
+// ─── Directory / Background 菜单注册 ──────────────────────────────────────────
+
+function registerDirBgMenus(nodePath, scriptPath, iconPath, pwshPath) {
+  // Register directory container subcommands
+  const dirContainer = `${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_DIR}`;
+  const bgContainer = `${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_BG}`;
+
+  for (const containerPath of [dirContainer, bgContainer]) {
+    // 📥 从资源库拷贝到此处
+    const initKey = `${containerPath}\\shell\\${SUBCMDS.initEdm}`;
+    regAdd(initKey, 'MUIVerb', 'REG_SZ', '📥 从资源库拷贝到此处');
+    regAdd(initKey, 'Icon', 'REG_SZ', iconPath);
+    regAdd(`${initKey}\\command`, '', 'REG_SZ', wrapInteractive(nodePath, scriptPath, 'init'));
+
+    // 📦 查看资源列表
+    const viewKey = `${containerPath}\\shell\\${SUBCMDS.viewEdm}`;
+    regAdd(viewKey, 'MUIVerb', 'REG_SZ', '📦 查看资源列表');
+    regAdd(viewKey, 'Icon', 'REG_SZ', iconPath);
+    regAdd(`${viewKey}\\command`, '', 'REG_SZ', wrapInteractive(nodePath, scriptPath, 'view'));
+
+    // 📋 浏览资源库
+    const viewIntKey = `${containerPath}\\shell\\${SUBCMDS.viewEdmInt}`;
+    regAdd(viewIntKey, 'MUIVerb', 'REG_SZ', '📋 浏览资源库');
+    regAdd(viewIntKey, 'Icon', 'REG_SZ', iconPath);
+    regAdd(`${viewIntKey}\\command`, '', 'REG_SZ', wrapInteractive(nodePath, scriptPath, 'view -i'));
+
+    // 📂 在此打开终端
+    if (pwshPath) {
+      const pwshKey = `${containerPath}\\shell\\${SUBCMDS.pwsh}`;
+      regAdd(pwshKey, 'MUIVerb', 'REG_SZ', '📂 在此打开终端');
+      regAdd(pwshKey, 'Icon', 'REG_SZ', pwshPath);
+      regAdd(`${pwshKey}\\command`, '', 'REG_SZ',
+        `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath '%1'"`);
+    }
+  }
+
+  // Parent keys: Directory and Directory\Background
+  const dirParent = `${HKCU_SHELL}\\Directory\\shell\\${PARENT_KEY_NAME}`;
+  regAdd(dirParent, 'MUIVerb', 'REG_SZ', '📧 juice 邮件工具');
+  regAdd(dirParent, 'Icon', 'REG_SZ', iconPath);
+  regAdd(dirParent, 'ExtendedSubCommandsKey', 'REG_SZ', SUB_CMDS_CONTAINER_DIR);
+
+  const bgParent = `${HKCU_SHELL}\\Directory\\Background\\shell\\${PARENT_KEY_NAME}`;
+  regAdd(bgParent, 'MUIVerb', 'REG_SZ', '📧 juice 邮件工具');
+  regAdd(bgParent, 'Icon', 'REG_SZ', iconPath);
+  regAdd(bgParent, 'ExtendedSubCommandsKey', 'REG_SZ', SUB_CMDS_CONTAINER_BG);
+}
+
 // ─── 注册 ─────────────────────────────────────────────────────────────────────
 
 async function registerContextMenu() {
@@ -241,14 +316,19 @@ async function registerContextMenu() {
   let ok = true;
 
   // 先删除旧容器再重建，避免注册残留旧子命令（如旧版 HTML 容器的 WithConfig）
+  console.log(chalk.gray('  清理旧版菜单...'));
   regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_HTML}`);
   regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_YAML}`);
+  regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_DIR}`);
+  regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_BG}`);
 
   // HTML 容器：generate + snippet + pwsh
+  console.log(chalk.gray('  注册 .html 文件菜单...'));
   const htmlContainer = `${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_HTML}`;
   registerSubCommands(htmlContainer, 'html', nodePath, scriptPath, iconPath, pwshPath);
 
   // YAML 容器：config + pwsh
+  console.log(chalk.gray('  注册 .yaml 文件菜单...'));
   const yamlContainer = `${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_YAML}`;
   registerSubCommands(yamlContainer, 'yaml', nodePath, scriptPath, iconPath, pwshPath);
 
@@ -268,6 +348,10 @@ async function registerContextMenu() {
     regAdd(parentKey, 'ExtendedSubCommandsKey', 'REG_SZ', SUB_CMDS_CONTAINER_YAML);
   }
 
+  // Directory / Background → 独立容器
+  console.log(chalk.gray('  注册文件夹/空白处菜单...'));
+  registerDirBgMenus(nodePath, scriptPath, iconPath, pwshPath);
+
   if (!ok) {
     console.log(chalk.yellow('  ⚠  部分注册表项写入失败，右键菜单可能不完整。\n'));
   }
@@ -279,13 +363,21 @@ async function registerContextMenu() {
     `    ${chalk.bold('📧 用 juice 生成邮件 HTML')}\n` +
     `      ├── 📄 作为模板，生成邮件 HTML  →  juice -f（后台执行）\n` +
     `      ├── 🧩 作为片段，拼接邮件 HTML  →  juice -s（交互选择模板）\n` +
+    `      ├── 📦 查看资源列表              →  juice view\n` +
+    `      ├── 📋 浏览资源库                →  juice view -i\n` +
     (pwshPath ? `      └── 📂 打开 PowerShell\n` : '') +
     `\n  ${chalk.bold('.yaml / .yml')} 文件右键：\n` +
     `    ${chalk.bold('📧 用 juice 生成邮件 HTML')}\n` +
-    (pwshPath
-      ? `      ├── ⚙️ 作为配置，拼接邮件 HTML  →  juice -c（交互选择品牌/模板/片段）\n` +
-        `      └── 📂 打开 PowerShell\n`
-      : `      └── ⚙️ 作为配置，拼接邮件 HTML  →  juice -c（交互选择品牌/模板/片段）\n`) +
+    `      ├── ⚙️ 作为配置，拼接邮件 HTML  →  juice -c（交互选择品牌/模板/片段）\n` +
+    `      ├── 📦 查看资源列表              →  juice view\n` +
+    `      ├── 📋 浏览资源库                →  juice view -i\n` +
+    (pwshPath ? `      └── 📂 打开 PowerShell\n` : '') +
+    `\n  ${chalk.bold('文件夹 / 空白处')} 右键：\n` +
+    `    ${chalk.bold('📧 juice 邮件工具')}\n` +
+    `      ├── 📥 从资源库拷贝到此处         →  juice init\n` +
+    `      ├── 📦 查看资源列表              →  juice view\n` +
+    `      ├── 📋 浏览资源库                →  juice view -i\n` +
+    (pwshPath ? `      └── 📂 在此打开终端\n` : '') +
     '\n' +
     chalk.gray('  注意：如菜单未出现，请重启文件资源管理器（explorer.exe）。\n')
   );
@@ -303,15 +395,22 @@ async function unregisterContextMenu() {
 
   let removed = 0;
 
-  // 清理 HKCU 父菜单（4 个文件类型）
-  const allRoots = [...HTML_ROOTS, ...YAML_ROOTS];
+  // 清理 HKCU 父菜单（4 个文件类型 + Directory + Background）
+  const allRoots = [
+    ...HTML_ROOTS,
+    ...YAML_ROOTS,
+    `${HKCU_SHELL}\\Directory\\shell`,
+    `${HKCU_SHELL}\\Directory\\Background\\shell`,
+  ];
   for (const root of allRoots) {
     if (regDelete(`${root}\\${PARENT_KEY_NAME}`)) removed++;
   }
 
-  // 清理两个子命令容器
+  // 清理所有子命令容器
   if (regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_HTML}`)) removed++;
   if (regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_YAML}`)) removed++;
+  if (regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_DIR}`)) removed++;
+  if (regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_BG}`)) removed++;
 
   // 清理旧版共享容器（v2.1.14 之前只有一个容器）
   regDelete(`${HKCU_SHELL}\\JuiceEmail.SubCommands`);

package/src/init.js

@@ -0,0 +1,346 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const chalk = require('chalk');
+const {
+  resolveEdmDir, loadMeta, findBrands, findTemplateVersions,
+  findSeriesDirs, findSnippetVariants, findConfigs,
+  promptBrand, promptTemplateVersion, promptSeries, promptSnippetVariant,
+  promptOutputName, checkOutputConflicts, findNextVersion,
+} = require('./snippet');
+
+function fmtBytes(b) {
+  return b < 1024 ? `${b} B` : `${(b / 1024).toFixed(1)} KB`;
+}
+
+// ─── Helpers ─────────────────────────────────────────────────────────────────
+
+function formatName(meta, dirName) {
+  const display = meta.name || dirName;
+  return display !== dirName
+    ? chalk.bold.cyan(display) + ' ' + chalk.gray(`(${dirName})`)
+    : chalk.bold.cyan(dirName);
+}
+
+/**
+ * Copy a single file to CWD with an optional custom name.
+ * Returns the destination path.
+ */
+function copyFileToCwd(srcPath, cwd, destName) {
+  const dest = path.join(cwd, destName || path.basename(srcPath));
+  if (fs.existsSync(dest)) {
+    // Find a non-conflicting name
+    const parsed = path.parse(dest);
+    let v = 1;
+    while (true) {
+      const candidate = path.join(cwd, parsed.name + '-v' + v + parsed.ext);
+      if (!fs.existsSync(candidate)) {
+        const altName = parsed.name + '-v' + v + parsed.ext;
+        const altPath = path.join(cwd, altName);
+        console.log(chalk.yellow(`  ⚠  ${destName || path.basename(srcPath)} 已存在，使用：${altName}`));
+        fs.copyFileSync(srcPath, altPath);
+        return altPath;
+      }
+      v++;
+    }
+  }
+  fs.copyFileSync(srcPath, dest);
+  return dest;
+}
+
+// ─── Direct Copy (--template / --snippet / --config) ─────────────────────────
+
+/**
+ * Derive a human-friendly default name from an EDM file path.
+ * e.g. edm/elabscience/templates/standard/template.html → elabscience-standard
+ *      edm/elabscience/series/literature/default/snippet.html → elabscience-literature-default-snippet
+ */
+function deriveDefaultName(filePath) {
+  const normalized = filePath.replace(/\\/g, '/');
+  // Try to match edm/<brand>/templates/<version>/...
+  const tplMatch = normalized.match(/edm\/([^/]+)\/templates\/([^/]+)/);
+  if (tplMatch) return `${tplMatch[1]}-${tplMatch[2]}`;
+  // Try to match edm/<brand>/series/<series>/<variant>/...
+  const snipMatch = normalized.match(/edm\/([^/]+)\/series\/([^/]+)\/([^/]+)/);
+  if (snipMatch) return `${snipMatch[1]}-${snipMatch[2]}-${snipMatch[3]}`;
+  // Fallback: source file basename
+  return path.parse(filePath).name;
+}
+
+async function directCopy(srcPath, cwd) {
+  const resolved = path.resolve(srcPath);
+  if (!fs.existsSync(resolved)) {
+    console.error(chalk.red(`\n  ✘ 文件不存在：${resolved}\n`));
+    process.exit(1);
+  }
+
+  const destName = await promptOutputName(
+    deriveDefaultName(resolved),
+    cwd
+  );
+
+  const dest = path.join(cwd, destName + path.extname(resolved));
+  fs.copyFileSync(resolved, dest);
+  const stat = fs.statSync(dest);
+
+  console.log(chalk.green('\n✔ 已拷贝：'));
+  console.log(`   ${chalk.cyan('·')} ./${path.relative(cwd, dest)}  ${chalk.gray('(' + fmtBytes(stat.size) + ')')}`);
+  console.log();
+}
+
+// ─── Interactive Init ────────────────────────────────────────────────────────
+
+async function interactiveInit(edmDir, cwd) {
+  const brands = findBrands(edmDir);
+  const brand = await promptBrand(brands);
+  const versions = findTemplateVersions(brand.path);
+  const version = await promptTemplateVersion(versions);
+
+  // Series selection
+  const allSeries = findSeriesDirs(brand.path);
+  let series = null;
+  let variant = null;
+
+  if (allSeries.length > 0) {
+    const { select } = await import('@inquirer/prompts');
+    const seriesChoices = [
+      { name: '[跳过] 仅使用模板', value: null },
+      ...allSeries.map(s => {
+        const meta = s.meta;
+        const display = meta.name
+          ? formatName(meta, s.name)
+          : chalk.bold.cyan(s.name);
+        return {
+          name: display,
+          value: s,
+          description: meta.description || undefined,
+        };
+      }),
+    ];
+    series = await select({
+      message: '选择片段系列（可选）：',
+      choices: seriesChoices,
+    });
+
+    if (series) {
+      const variants = findSnippetVariants(series.path);
+      if (variants.length > 0) {
+        variant = await promptSnippetVariant(variants);
+      }
+    }
+  }
+
+  // Multi-select what to copy
+  const copyItems = [];
+  copyItems.push({
+    name: '📋 模板 HTML',
+    value: 'template',
+    description: path.basename(version.templatePath),
+    checked: true,
+  });
+
+  if (variant) {
+    const snipPath = path.join(variant.path, 'snippet.html');
+    if (fs.existsSync(snipPath)) {
+      copyItems.push({
+        name: '🧩 片段 HTML',
+        value: 'snippet',
+        description: path.basename(snipPath),
+        checked: true,
+      });
+    }
+
+    const configs = findConfigs(variant.path);
+    if (configs.length > 0) {
+      copyItems.push({
+        name: '⚙️ 配置文件',
+        value: 'config',
+        description: configs.map(c => c.name).join(', '),
+        checked: true,
+      });
+    }
+  }
+
+  const { checkbox } = await import('@inquirer/prompts');
+  const selected = await checkbox({
+    message: '选择要拷贝的内容：',
+    choices: copyItems,
+  });
+
+  if (selected.length === 0) {
+    console.log(chalk.gray('未选择任何内容，已取消。\n'));
+    return;
+  }
+
+  // Output name
+  const defaultBaseName = variant
+    ? `${brand.name}-${version.name}-${series.name}-${variant.name}`
+    : `${brand.name}-${version.name}`;
+  const outputBaseName = await promptOutputName(defaultBaseName, cwd);
+
+  // Copy files
+  console.log(chalk.green('\n✔ 已拷贝：'));
+  const cwdRel = (p) => './' + path.relative(cwd, p);
+
+  if (selected.includes('template')) {
+    const destName = outputBaseName + path.extname(version.templatePath);
+    const dest = copyFileToCwd(version.templatePath, cwd, destName);
+    console.log(`   ${chalk.cyan('·')} ${cwdRel(dest)}  ${chalk.gray('(模板, ' + fmtBytes(fs.statSync(dest).size) + ')')}`);
+  }
+
+  if (selected.includes('snippet') && variant) {
+    const snipPath = path.join(variant.path, 'snippet.html');
+    const destName = outputBaseName + '-snippet' + path.extname(snipPath);
+    const dest = copyFileToCwd(snipPath, cwd, destName);
+    console.log(`   ${chalk.cyan('·')} ${cwdRel(dest)}  ${chalk.gray('(片段, ' + fmtBytes(fs.statSync(dest).size) + ')')}`);
+  }
+
+  if (selected.includes('config') && variant) {
+    const configs = findConfigs(variant.path);
+    let cfgPath;
+    if (configs.length === 1) {
+      cfgPath = configs[0].path;
+    } else {
+      // Use optimal config
+      const optimal = configs.find(c => c.isOptimal);
+      cfgPath = optimal ? optimal.path : configs[0].path;
+    }
+    const dest = copyFileToCwd(cfgPath, cwd, 'juice.yaml');
+    console.log(`   ${chalk.cyan('·')} ${cwdRel(dest)}  ${chalk.gray('(配置, ' + fmtBytes(fs.statSync(dest).size) + ')')}`);
+  }
+
+  // Summary
+  console.log();
+  if (selected.includes('snippet') && selected.includes('template')) {
+    const snipFile = outputBaseName + '-snippet' + path.extname(path.join(variant.path, 'snippet.html'));
+    const tplFile = outputBaseName + path.extname(version.templatePath);
+    console.log(
+      '  ' + chalk.dim('💡 下一步：') + '\n' +
+      '     ' + chalk.cyan(`juice -s ${snipFile} -f ${tplFile}`) +
+      (selected.includes('config') ? chalk.cyan(' -c juice.yaml') : '') + '\n'
+    );
+  } else if (selected.includes('template')) {
+    const tplFile = outputBaseName + path.extname(version.templatePath);
+    console.log(
+      '  ' + chalk.dim('💡 下一步：') + '\n' +
+      '     ' + chalk.cyan(`juice -f ${tplFile}`) + '\n'
+    );
+  }
+}
+
+// ─── Main Entry ──────────────────────────────────────────────────────────────
+
+async function runInitMode({ initPath, template, snippet, config }) {
+  const cwd = process.cwd();
+
+  // Direct copy modes
+  if (template) {
+    await directCopy(template, cwd);
+    return;
+  }
+  if (snippet) {
+    await directCopy(snippet, cwd);
+    return;
+  }
+  if (config) {
+    await directCopy(config, cwd);
+    return;
+  }
+
+  // Path-based from EDM
+  if (initPath) {
+    const { parseViewPath } = require('./view');
+    let edmDir;
+    try {
+      edmDir = resolveEdmDir();
+    } catch (err) {
+      console.error(chalk.red(`\n  ✘ ${err.message}\n`));
+      process.exit(1);
+    }
+
+    let parsed;
+    try {
+      parsed = parseViewPath(initPath, edmDir);
+    } catch (err) {
+      console.error(chalk.red(`\n  ✘ ${err.message}\n`));
+      process.exit(1);
+    }
+
+    if (parsed.type === 'template') {
+      await directCopy(parsed.versionData.templatePath, cwd);
+    } else if (parsed.type === 'variant') {
+      // Multi-select copy
+      const snipPath = path.join(parsed.variantData.path, 'snippet.html');
+      const configs = findConfigs(parsed.variantData.path);
+      const brandDir = path.join(edmDir, parsed.brand);
+      const versions = findTemplateVersions(brandDir);
+      const version = versions[0]; // default to first version
+      const tplPath = version.templatePath;
+
+      const copyItems = [
+        { name: '📋 模板 HTML', value: 'template', description: path.basename(tplPath), checked: true },
+      ];
+      if (fs.existsSync(snipPath)) {
+        copyItems.push({ name: '🧩 片段 HTML', value: 'snippet', description: path.basename(snipPath), checked: true });
+      }
+      if (configs.length > 0) {
+        copyItems.push({ name: '⚙️ 配置文件', value: 'config', description: configs.map(c => c.name).join(', '), checked: true });
+      }
+
+      const { checkbox } = await import('@inquirer/prompts');
+      const selected = await checkbox({
+        message: '选择要拷贝的内容：',
+        choices: copyItems,
+      });
+
+      if (selected.length === 0) {
+        console.log(chalk.gray('未选择任何内容，已取消。\n'));
+        return;
+      }
+
+      const defaultBaseName = `${parsed.brand}-${parsed.seriesData ? parsed.series : 'series'}-${parsed.variant}`;
+      const outputBaseName = await promptOutputName(defaultBaseName, cwd);
+
+      console.log(chalk.green('\n✔ 已拷贝：'));
+      const cwdRel = (p) => './' + path.relative(cwd, p);
+
+      if (selected.includes('template')) {
+        const destName = outputBaseName + path.extname(tplPath);
+        const dest = copyFileToCwd(tplPath, cwd, destName);
+        console.log(`   ${chalk.cyan('·')} ${cwdRel(dest)}  ${chalk.gray('(模板, ' + fmtBytes(fs.statSync(dest).size) + ')')}`);
+      }
+      if (selected.includes('snippet') && fs.existsSync(snipPath)) {
+        const destName = outputBaseName + '-snippet' + path.extname(snipPath);
+        const dest = copyFileToCwd(snipPath, cwd, destName);
+        console.log(`   ${chalk.cyan('·')} ${cwdRel(dest)}  ${chalk.gray('(片段, ' + fmtBytes(fs.statSync(dest).size) + ')')}`);
+      }
+      if (selected.includes('config') && configs.length > 0) {
+        const optimal = configs.find(c => c.isOptimal);
+        const cfgPath = optimal ? optimal.path : configs[0].path;
+        const dest = copyFileToCwd(cfgPath, cwd, 'juice.yaml');
+        console.log(`   ${chalk.cyan('·')} ${cwdRel(dest)}  ${chalk.gray('(配置, ' + fmtBytes(fs.statSync(dest).size) + ')')}`);
+      }
+      console.log();
+    } else {
+      console.error(chalk.red(
+        `\n  ✘ 无法从「${initPath}」初始化。\n` +
+        `  请指定：<brand>/templates/<version> 或 <brand>/<series>/<variant>\n`
+      ));
+      process.exit(1);
+    }
+    return;
+  }
+
+  // No arguments: interactive mode
+  let edmDir;
+  try {
+    edmDir = resolveEdmDir();
+  } catch (err) {
+    console.error(chalk.red(`\n  ✘ ${err.message}\n`));
+    process.exit(1);
+  }
+  await interactiveInit(edmDir, cwd);
+}
+
+module.exports = { runInitMode };

package/src/snippet.js

@@ -881,4 +881,39 @@ async function runInteractiveMode({ config: cliConfigPath }) {
   });
 }
 
-module.exports = { runSnippetMode, runInteractiveMode };
+module.exports = {
+  runSnippetMode,
+  runInteractiveMode,
+  // EDM resolution & scanning
+  resolveEdmDir,
+  loadMeta,
+  findBrands,
+  findTemplateVersions,
+  findSeriesDirs,
+  findSnippetVariants,
+  findConfigs,
+  findHtmlFiles,
+  findYamlFiles,
+  findLocalConfig,
+  getBrand,
+  filterSeries,
+  // config
+  buildSnippetConfig,
+  // content
+  insertIntoContent,
+  reindentHtml,
+  resolveSnippetOutputPaths,
+  assembleSnippet,
+  // prompts
+  promptBrand,
+  promptTemplateVersion,
+  promptSeries,
+  promptSnippetVariant,
+  promptConfig,
+  promptConfirm,
+  promptOutputName,
+  // output helpers
+  checkOutputConflicts,
+  findNextVersion,
+  copyTemplateToCwd,
+};