juice-email-cli 2.0.6 → 2.1.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juice-email-cli",
-  "version": "2.0.6",
+  "version": "2.1.2",
   "description": "CLI tool to generate email-client-compatible HTML with juice (CSS inlining) + Mustache templating + minification",
   "main": "src/index.js",
   "bin": {
@@ -36,6 +36,8 @@
     "url": "https://github.com/GuoSirius/juice-cli/issues"
   },
   "dependencies": {
+    "@inquirer/prompts": "^5.0.2",
+    "chalk": "^4.1.2",
     "commander": "^11.1.0",
     "html-minifier-terser": "^7.2.0",
     "js-yaml": "^4.1.0",
@@ -50,14 +52,13 @@
     "bin/",
     "src/",
     "defaults/",
+    "edm/",
     "README.md"
   ],
   "devDependencies": {
     "@commitlint/cli": "^21.0.1",
     "@commitlint/config-conventional": "^21.0.1",
-    "chalk": "^4.1.2",
     "husky": "^9.1.7",
-    "@inquirer/prompts": "^5.0.2",
     "inquirer": "^13.4.3",
     "standard-version": "^9.5.0"
   }

package/src/context-menu.js

@@ -10,7 +10,8 @@
  *
  * 菜单结构：
  *   📧 用 juice 生成邮件 HTML
- *     ├── ⚡ 生成（标准 + 压缩）
+ *     ├── ⚡ 生成邮件 HTML（标准 + 压缩）
+ *     ├── 🧩 邮件片段组装（交互选择模板）
  *     └── 📂 在此目录打开 PowerShell
  *
  * 需要以管理员权限运行。
@@ -94,8 +95,10 @@ async function registerContextMenu() {
 
   // 子命令 1：生成（标准 + 压缩）
   const subCmd1 = `JuiceEmail.Generate`;
-  // 子命令 2：在此打开 PowerShell（可选便利项）
-  const subCmd2 = `JuiceEmail.OpenPwsh`;
+  // 子命令 2：片段组装
+  const subCmd2 = `JuiceEmail.Snippet`;
+  // 子命令 3：在此打开 PowerShell（可选便利项）
+  const subCmd3 = `JuiceEmail.OpenPwsh`;
 
   // ── 注册子命令到 CommandStore ─────────────────────────────────────────────
 
@@ -105,18 +108,25 @@ async function registerContextMenu() {
   regAdd(`${SUBCMD_SPACE}\\${subCmd1}`, 'Icon', 'REG_SZ', iconPath);
   regAdd(`${SUBCMD_SPACE}\\${subCmd1}\\command`, '', 'REG_SZ', generateCmd);
 
-  // 子命令 2：在文件目录打开 pwsh（如果安装了 PowerShell 7）
+  // 子命令 2：片段组装
+  const snippetCmd = `"${nodePath}" "${scriptPath}" --snippet "%1"`;
+  regAdd(`${SUBCMD_SPACE}\\${subCmd2}`, '', 'REG_SZ', '🧩 邮件片段组装（交互选择模板）');
+  regAdd(`${SUBCMD_SPACE}\\${subCmd2}`, 'Icon', 'REG_SZ', iconPath);
+  regAdd(`${SUBCMD_SPACE}\\${subCmd2}\\command`, '', 'REG_SZ', snippetCmd);
+
+  // 子命令 3：在文件目录打开 pwsh（如果安装了 PowerShell 7）
   const pwshPath = resolvePwsh();
   if (pwshPath) {
     const pwshCmd = `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath '%W'"`;
-    regAdd(`${SUBCMD_SPACE}\\${subCmd2}`, '', 'REG_SZ', '📂 在此目录打开 PowerShell 7');
-    regAdd(`${SUBCMD_SPACE}\\${subCmd2}`, 'Icon', 'REG_SZ', pwshPath);
-    regAdd(`${SUBCMD_SPACE}\\${subCmd2}\\command`, '', 'REG_SZ', pwshCmd);
+    regAdd(`${SUBCMD_SPACE}\\${subCmd3}`, '', 'REG_SZ', '📂 在此目录打开 PowerShell 7');
+    regAdd(`${SUBCMD_SPACE}\\${subCmd3}`, 'Icon', 'REG_SZ', pwshPath);
+    regAdd(`${SUBCMD_SPACE}\\${subCmd3}\\command`, '', 'REG_SZ', pwshCmd);
   }
 
   // ── 注册父菜单到 SystemFileAssociations ──────────────────────────────────
 
-  const subCommands = pwshPath ? `${subCmd1};${subCmd2}` : subCmd1;
+  let subCommands = `${subCmd1};${subCmd2}`;
+  if (pwshPath) subCommands += `;${subCmd3}`;
 
   for (const root of ROOTS) {
     const parentKey = `${root}\\${PARENT_KEY_NAME}`;
@@ -137,6 +147,7 @@ async function registerContextMenu() {
     `  在 ${chalk.cyan('.html')} / ${chalk.cyan('.htm')} 文件上右键即可看到：\n` +
     `  ${chalk.bold('📧 用 juice 生成邮件 HTML')}\n` +
     `    ├── ⚡ 生成邮件 HTML（标准 + 压缩）\n` +
+    `    ├── 🧩 邮件片段组装（交互选择模板）\n` +
     (pwshPath ? `    └── 📂 在此目录打开 PowerShell 7\n` : '') +
     '\n' +
     chalk.gray('  注意：如菜单未出现，请重启文件资源管理器（explorer.exe）。\n') +
@@ -155,6 +166,7 @@ async function unregisterContextMenu() {
   }
 
   regDelete(`${SUBCMD_SPACE}\\JuiceEmail.Generate`);
+  regDelete(`${SUBCMD_SPACE}\\JuiceEmail.Snippet`);
   regDelete(`${SUBCMD_SPACE}\\JuiceEmail.OpenPwsh`);
 
   console.log(chalk.green('  ✔ 右键菜单已移除。\n'));

package/src/index.js

@@ -261,4 +261,4 @@ function savings(original, minified) {
   return (((orig - mini) / orig) * 100).toFixed(1) + '%';
 }
 
-module.exports = { run, findConfigs, buildConfig, processTemplate };
+module.exports = { run, findConfigs, buildConfig, processTemplate, minifyHtml, deepMerge, collectExtraCss, loadYaml, fmtSize, savings };

package/src/snippet.js

@@ -0,0 +1,524 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const juice = require('juice');
+const Mustache = require('mustache');
+const chalk = require('chalk');
+const {
+  loadYaml,
+  deepMerge,
+  collectExtraCss,
+  minifyHtml,
+  fmtSize,
+  savings,
+} = require('./index');
+
+// ─── EDM 目录解析 ──────────────────────────────────────────────────────────────
+
+function resolveEdmDir() {
+  // 优先：当前工作目录下的 edm/（用户自己的 EDM 资源）
+  const cwdEdm = path.join(process.cwd(), 'edm');
+  if (fs.existsSync(cwdEdm)) return cwdEdm;
+
+  // 回退：npm 全局安装时，包内置的 edm/
+  const pkgEdm = path.resolve(__dirname, '..', 'edm');
+  if (fs.existsSync(pkgEdm)) return pkgEdm;
+
+  throw new Error(
+    `EDM 目录不存在。\n` +
+    `  已检查：${cwdEdm}\n` +
+    `  已检查：${pkgEdm}\n` +
+    `  请在项目根目录创建 edm/ 目录结构，或重新安装 juice-email-cli。`
+  );
+}
+
+function findBrands(edmDir) {
+  const entries = fs.readdirSync(edmDir, { withFileTypes: true });
+  const brands = entries
+    .filter((e) => e.isDirectory())
+    .map((e) => ({ name: e.name, path: path.join(edmDir, e.name) }));
+  if (brands.length === 0) {
+    throw new Error(`EDM 目录下未找到任何品牌子目录：${edmDir}`);
+  }
+  return brands;
+}
+
+function findSnippetFolders(brandDir) {
+  const entries = fs.readdirSync(brandDir, { withFileTypes: true });
+  return entries
+    .filter((e) => e.isDirectory())
+    .map((e) => ({ name: e.name, path: path.join(brandDir, e.name) }));
+}
+
+function findHtmlFiles(dir) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  return entries
+    .filter((e) => e.isFile() && /\.html?$/i.test(e.name))
+    .map((e) => ({ name: e.name, path: path.join(dir, e.name) }));
+}
+
+function findYamlFiles(dir) {
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  return entries
+    .filter((e) => e.isFile() && /\.ya?ml$/i.test(e.name))
+    .map((e) => ({ name: e.name, path: path.join(dir, e.name) }));
+}
+
+/**
+ * 在指定目录下查找本地配置文件
+ * 优先 juice.yaml，其次 juice.yml，都不存在返回 null
+ */
+function findLocalConfig(dir) {
+  const candidates = [
+    path.join(dir, 'juice.yaml'),
+    path.join(dir, 'juice.yml'),
+  ];
+  for (const c of candidates) {
+    if (fs.existsSync(c)) return c;
+  }
+  return null;
+}
+
+/**
+ * 从 edm 子路径中提取品牌名
+ * 例如：edm/elabscience/literature/snippet.html → elabscience
+ * 如果文件不在 edmDir 下，返回 null
+ */
+function getBrand(filePath, edmDir) {
+  const rel = path.relative(edmDir, filePath);
+  if (rel.startsWith('..')) return null;
+  const parts = rel.split(path.sep);
+  return parts[0] || null;
+}
+
+// ─── 配置合并 ─────────────────────────────────────────────────────────────────
+
+const DEFAULT_CONFIG_PATH = path.resolve(__dirname, '..', 'defaults', 'juice.yaml');
+
+/**
+ * 片段模式配置合并
+ *
+ * 优先级（低 → 高）：
+ *   1. CLI 内置默认值（defaults/juice.yaml）
+ *   2. 用户主目录 ~/juice.yaml（如果存在）
+ *   3. 项目配置（片段目录 / 当前目录 / 手动输入 —— 由调用方传入）
+ *   4. -c 命令行指定（最高优先级）
+ */
+function buildSnippetConfig({ priorityConfigPath, cliConfigPath }) {
+  const layers = [];
+
+  // 1. CLI 内置默认（最低优先级）
+  const defaults = loadYaml(DEFAULT_CONFIG_PATH);
+  layers.push({ label: 'CLI 内置默认值', data: defaults });
+
+  // 2. 用户主目录
+  const homePath = path.join(os.homedir(), 'juice.yaml');
+  if (fs.existsSync(homePath)) {
+    layers.push({ label: `用户目录配置 (${homePath})`, data: loadYaml(homePath) });
+  }
+
+  // 3. 项目配置（片段目录 / 当前目录 / 手动输入 —— 三选一）
+  if (priorityConfigPath && fs.existsSync(priorityConfigPath)) {
+    layers.push({ label: `项目配置 (${priorityConfigPath})`, data: loadYaml(priorityConfigPath) });
+  }
+
+  // 4. -c 指定（最高优先级）
+  if (cliConfigPath) {
+    const resolved = path.resolve(cliConfigPath);
+    if (!fs.existsSync(resolved)) {
+      throw new Error(`指定的配置文件不存在：${resolved}`);
+    }
+    layers.push({ label: `CLI 指定配置 (${resolved})`, data: loadYaml(resolved) });
+  }
+
+  const config = deepMerge(...layers.map((l) => l.data));
+  return { config, layers };
+}
+
+// ─── 内容插入 ─────────────────────────────────────────────────────────────────
+
+/**
+ * 将 snippet HTML 插入到模板的 <tbody id="content"> 中。
+ * 使用深度计数算法处理嵌套 <tbody>。
+ */
+function insertIntoContent(templateHtml, snippetHtml) {
+  const openRe = /<tbody[\s>][^>]*\bid\s*=\s*["']content["'][^>]*>/i;
+  const match = openRe.exec(templateHtml);
+  if (!match) {
+    throw new Error('模板中未找到 <tbody id="content"> 元素。模板必须包含一个带 id="content" 的 <tbody> 用于插入片段内容。');
+  }
+
+  const openTagEnd = match.index + match[0].length;
+  let depth = 1;
+  let searchPos = openTagEnd;
+
+  const tbodyOpenRe = /<tbody[\s>]/gi;
+  const tbodyCloseRe = /<\/tbody>/gi;
+
+  while (depth > 0 && searchPos < templateHtml.length) {
+    tbodyOpenRe.lastIndex = searchPos;
+    tbodyCloseRe.lastIndex = searchPos;
+
+    const nextOpen = tbodyOpenRe.exec(templateHtml);
+    const nextClose = tbodyCloseRe.exec(templateHtml);
+
+    if (!nextClose) break;
+
+    if (nextOpen && nextOpen.index < nextClose.index) {
+      depth++;
+      searchPos = nextOpen.index + 1;
+    } else {
+      depth--;
+      if (depth === 0) {
+        return templateHtml.substring(0, openTagEnd) + '\n' + snippetHtml + '\n' + templateHtml.substring(nextClose.index);
+      }
+      searchPos = nextClose.index + 1;
+    }
+  }
+
+  throw new Error('无法找到 id="content" 对应的闭合 </tbody> 标签，模板 HTML 可能存在标签不匹配问题。');
+}
+
+// ─── 输出路径 ─────────────────────────────────────────────────────────────────
+
+function resolveSnippetOutputPaths(snippetPath, cwd) {
+  const name = path.parse(snippetPath).name;
+  return {
+    raw: path.join(cwd, name + '.raw.html'),
+    normal: path.join(cwd, name + '.html'),
+    output: path.join(cwd, name + '.output.html'),
+    minified: path.join(cwd, name + '.minified.html'),
+  };
+}
+
+// ─── 组装流水线 ───────────────────────────────────────────────────────────────
+
+/**
+ * 片段组装流水线：
+ *   1. 未渲染的片段 + 模板 → .raw.html（Mustache 标签保留，无 juice 内联）
+ *   2. Mustache 渲染合并 HTML → .html（已渲染，无 juice 内联）
+ *   3. Juice CSS 内联 → .output.html
+ *   4. 压缩 → .minified.html
+ */
+async function assembleSnippet({ snippetPath, templatePath, config, layers, cwd }) {
+  const templateHtml = fs.readFileSync(templatePath, 'utf8');
+  const snippetRaw = fs.readFileSync(snippetPath, 'utf8');
+  const outPaths = resolveSnippetOutputPaths(snippetPath, cwd);
+  const variables = config.variables || {};
+
+  // 1. 未渲染的片段插入模板 → .raw.html（Mustache 标签保留，无 juice）
+  const rawHtml = insertIntoContent(templateHtml, snippetRaw);
+  fs.writeFileSync(outPaths.raw, rawHtml, 'utf8');
+
+  // 2. Mustache 渲染合并 HTML → .html（已渲染，无 juice 内联）
+  const renderedHtml = Mustache.render(rawHtml, variables);
+  fs.writeFileSync(outPaths.normal, renderedHtml, 'utf8');
+
+  // 3. 收集模板目录的额外 CSS + Juice CSS 内联 → .output.html
+  const templateDir = path.dirname(templatePath);
+  const extraCss = collectExtraCss(templateDir, config);
+  const juiceOpts = Object.assign({}, config.juice || {});
+  delete juiceOpts.extraCssFiles;
+  const processed = juice(renderedHtml, { ...juiceOpts, extraCss });
+  fs.writeFileSync(outPaths.output, processed, 'utf8');
+
+  // 4. 压缩 → .minified.html
+  const minified = await minifyHtml(processed, config.minify);
+  fs.writeFileSync(outPaths.minified, minified, 'utf8');
+
+  // 5. 报告
+  const layerLines = layers
+    .map((l) => `    ${chalk.gray('·')} ${l.label}`)
+    .join('\n');
+
+  console.log(
+    chalk.green('\n✔ 片段组装完成') + '\n' +
+    `  ${chalk.bold('片段：')}  ${chalk.cyan(snippetPath)}\n` +
+    `  ${chalk.bold('模板：')}  ${chalk.cyan(templatePath)}\n` +
+    `  ${chalk.bold('配置层（低→高）：')}\n${layerLines}\n` +
+    `  ${chalk.bold('输出：')}\n` +
+    `    ${chalk.green('·')} 原始组装  ${chalk.cyan(outPaths.raw)}  ${chalk.gray('(' + fmtSize(rawHtml) + ')')}\n` +
+    `    ${chalk.green('·')} 已渲染    ${chalk.cyan(outPaths.normal)}  ${chalk.gray('(' + fmtSize(renderedHtml) + ')')}\n` +
+    `    ${chalk.green('·')} 内联后    ${chalk.cyan(outPaths.output)}  ${chalk.gray('(' + fmtSize(processed) + ')')}\n` +
+    `    ${chalk.green('·')} 压缩版    ${chalk.cyan(outPaths.minified)}  ${chalk.gray('(' + fmtSize(minified) + '，节省 ' + savings(processed, minified) + ')')}`
+  );
+
+  return outPaths;
+}
+
+// ─── 交互式提示 ───────────────────────────────────────────────────────────────
+
+async function promptBrand(brands) {
+  const { select } = await import('@inquirer/prompts');
+  return select({
+    message: '请选择品牌/系列：',
+    choices: brands.map((b) => ({ name: b.name, value: b })),
+  });
+}
+
+async function promptSnippetFolder(folders) {
+  const { select } = await import('@inquirer/prompts');
+  if (folders.length === 0) return null;
+  return select({
+    message: '请选择片段文件夹：',
+    choices: folders.map((f) => ({ name: f.name, value: f })),
+  });
+}
+
+async function promptSnippetFile(htmlFiles) {
+  const { select } = await import('@inquirer/prompts');
+  if (htmlFiles.length === 0) return null;
+  const defaultName = 'snippet.html';
+  const defaultIdx = htmlFiles.findIndex((f) => f.name === defaultName);
+
+  return select({
+    message: '请选择片段 HTML 文件：',
+    choices: htmlFiles.map((f, i) => ({
+      name: f.name + (i === defaultIdx ? ' (默认)' : ''),
+      value: f,
+    })),
+    default: defaultIdx >= 0 ? defaultIdx : 0,
+  });
+}
+
+/**
+ * 交互模式的配置选择提示
+ * 优先 CWD 下的配置文件，不存在则回退到片段目录下的，也可手动输入或跳过
+ */
+async function promptConfigForInteractive(snippetDirYamlFiles) {
+  const { select, input } = await import('@inquirer/prompts');
+
+  // 检查当前工作目录是否有配置文件
+  const cwdCandidates = [
+    { path: path.join(process.cwd(), 'juice.yaml'), name: 'juice.yaml' },
+    { path: path.join(process.cwd(), 'juice.yml'), name: 'juice.yml' },
+  ];
+  const cwdConfig = cwdCandidates.find((c) => fs.existsSync(c.path));
+
+  const choices = [];
+  let defaultIdx = 0;
+
+  if (cwdConfig) {
+    choices.push({
+      name: `📂 当前目录配置 → ${cwdConfig.name}（优先）`,
+      value: { type: 'file', path: cwdConfig.path, name: cwdConfig.name },
+    });
+  }
+
+  // 片段目录下的配置文件
+  const defaultName = 'juice.yaml';
+  for (const f of snippetDirYamlFiles) {
+    const isDefault = f.name === defaultName;
+    choices.push({
+      name: `📄 片段目录配置 → ${f.name}${isDefault ? '（默认）' : ''}`,
+      value: { type: 'file', path: f.path, name: f.name },
+    });
+    if (isDefault && !cwdConfig) {
+      defaultIdx = choices.length - 1;
+    }
+  }
+
+  choices.push(
+    { name: '📁 输入自定义路径...', value: { type: 'custom' } },
+    { name: '⊘ 跳过（不使用项目配置）', value: { type: 'skip' } },
+  );
+
+  const result = await select({
+    message: '请选择配置文件：',
+    choices,
+    default: defaultIdx,
+  });
+
+  if (result.type === 'custom') {
+    const customPath = await input({ message: '请输入配置文件路径：' });
+    return { type: 'file', path: path.resolve(customPath), name: path.basename(customPath) };
+  }
+
+  return result;
+}
+
+async function promptTemplate(templateFiles) {
+  const { select } = await import('@inquirer/prompts');
+  if (templateFiles.length === 0) {
+    throw new Error('品牌目录下未找到模板 HTML 文件。');
+  }
+  const templateRe = /-template\.html?$/i;
+  const defaultIdx = templateFiles.findIndex((f) => templateRe.test(f.name));
+
+  return select({
+    message: '请选择模板 HTML 文件：',
+    choices: templateFiles.map((f, i) => ({
+      name: f.name + (i === defaultIdx ? ' (默认)' : ''),
+      value: f,
+    })),
+    default: defaultIdx >= 0 ? defaultIdx : 0,
+  });
+}
+
+async function promptConfirm(summary) {
+  const { confirm } = await import('@inquirer/prompts');
+  console.log('\n' + chalk.cyan('═══════════════════════════════════════════'));
+  console.log(chalk.bold('  片段组装汇总'));
+  console.log(chalk.cyan('═══════════════════════════════════════════'));
+  console.log(`  品牌：          ${chalk.green(summary.brand)}`);
+  console.log(`  模板 HTML：     ${chalk.green(summary.templateFile)}`);
+  console.log(`  片段文件夹：    ${chalk.green(summary.snippetFolder)}`);
+  console.log(`  片段 HTML：     ${chalk.green(summary.snippetFile)}`);
+  console.log(`  配置 YAML：     ${chalk.green(summary.configFile)}`);
+  console.log(chalk.gray('───────────────────────────────────────────'));
+  console.log(`  输出目录：      ${chalk.cyan(summary.outputDir)}`);
+  console.log(`  输出文件：`);
+  const outPaths = resolveSnippetOutputPaths(summary.snippetPath, summary.outputDir);
+  console.log(`    ${chalk.green('·')} ${path.basename(outPaths.raw)}  ${chalk.gray('(未渲染，无 CSS 内联)')}`);
+  console.log(`    ${chalk.green('·')} ${path.basename(outPaths.normal)}  ${chalk.gray('(已渲染，无 CSS 内联)')}`);
+  console.log(`    ${chalk.green('·')} ${path.basename(outPaths.output)}  ${chalk.gray('(Juice CSS 内联)')}`);
+  console.log(`    ${chalk.green('·')} ${path.basename(outPaths.minified)}  ${chalk.gray('(压缩版)')}`);
+  console.log(chalk.cyan('═══════════════════════════════════════════\n'));
+
+  return confirm({
+    message: '确认执行片段组装？',
+    default: true,
+  });
+}
+
+// ─── 模式入口 ─────────────────────────────────────────────────────────────────
+
+/**
+ * --snippet 模式：指定了片段 HTML
+ *   - 如果同时指定了 -f（模板），直接使用
+ *   - 如果未指定 -f，交互式选择：品牌 → 模板
+ *   - 配置文件：自动检测片段目录下的 juice.yaml / juice.yml，-c 可覆盖
+ *   - 合并顺序：项目默认 → 用户目录 → 片段目录配置 → CLI -c
+ */
+async function runSnippetMode({ snippet, template, config: cliConfigPath }) {
+  const snippetPath = path.resolve(snippet);
+  if (!fs.existsSync(snippetPath)) {
+    console.error(chalk.red(`片段文件不存在：${snippetPath}`));
+    process.exit(1);
+  }
+
+  let templatePath;
+
+  if (template) {
+    templatePath = path.resolve(template);
+    if (!fs.existsSync(templatePath)) {
+      console.error(chalk.red(`模板文件不存在：${templatePath}`));
+      process.exit(1);
+    }
+  } else {
+    // 交互式选择：品牌 → 模板
+    const edmDir = resolveEdmDir();
+    const brands = findBrands(edmDir);
+    const brand = await promptBrand(brands);
+    const templateFiles = findHtmlFiles(brand.path);
+    const chosen = await promptTemplate(templateFiles);
+    templatePath = chosen.path;
+  }
+
+  // 自动检测片段目录下的配置文件（juice.yaml 优先，juice.yml 次之）
+  const snippetDir = path.dirname(snippetPath);
+  const priorityConfigPath = findLocalConfig(snippetDir);
+
+  // 跨品牌检查：片段和模板品牌不一致时给出警告
+  try {
+    const edmDir = resolveEdmDir();
+    const snippetBrand = getBrand(snippetPath, edmDir);
+    const templateBrand = getBrand(templatePath, edmDir);
+    if (snippetBrand && templateBrand && snippetBrand !== templateBrand) {
+      console.warn(chalk.yellow(
+        `\n⚠  片段品牌「${snippetBrand}」与模板品牌「${templateBrand}」不一致，可能导致样式错乱。`
+      ));
+    }
+  } catch (_) {
+    // edm/ 不存在时跳过品牌检查（用户可能使用自定义路径）
+  }
+
+  const { config, layers } = buildSnippetConfig({ priorityConfigPath, cliConfigPath });
+
+  await assembleSnippet({
+    snippetPath,
+    templatePath,
+    config,
+    layers,
+    cwd: process.cwd(),
+  });
+}
+
+/**
+ * 交互模式：未指定 --snippet，未指定 -f
+ *   流程：品牌 → 模板 → 片段文件夹 → 片段 HTML → 配置文件 → 汇总确认 → 执行
+ *   配置文件：优先 CWD，不存在则用片段目录下 YAML，也可手动输入
+ *   合并顺序：项目默认 → 用户目录 → 项目配置（CWD/片段/手动三选一）→ CLI -c
+ */
+async function runInteractiveMode({ config: cliConfigPath }) {
+  const edmDir = resolveEdmDir();
+
+  // 1. 选择品牌
+  const brands = findBrands(edmDir);
+  const brand = await promptBrand(brands);
+
+  // 2. 选择模板
+  const templateFiles = findHtmlFiles(brand.path);
+  const templateChoice = await promptTemplate(templateFiles);
+
+  // 3. 选择片段文件夹
+  const snippetFolders = findSnippetFolders(brand.path);
+  if (snippetFolders.length === 0) {
+    console.log(chalk.yellow(`\n  ⚠  品牌「${brand.name}」下暂无片段系列，无法继续。`));
+    console.log(chalk.gray(`     请在 edm/${brand.name}/ 下创建片段文件夹（含 HTML 和 YAML 文件）。`));
+    return;
+  }
+  const folder = await promptSnippetFolder(snippetFolders);
+  if (!folder) return;
+
+  // 4. 选择片段 HTML
+  const htmlFiles = findHtmlFiles(folder.path);
+  if (htmlFiles.length === 0) {
+    console.log(chalk.yellow(`\n  ⚠  片段系列「${folder.name}」下暂无 HTML 文件。`));
+    return;
+  }
+  const snippetFile = await promptSnippetFile(htmlFiles);
+  if (!snippetFile) return;
+
+  // 5. 选择配置文件（优先 CWD，不存在则用片段目录）
+  const yamlFiles = findYamlFiles(folder.path);
+  const configChoice = await promptConfigForInteractive(yamlFiles);
+
+  let priorityConfigPath = null;
+  let configFileName = '(跳过)';
+  if (configChoice.type === 'file') {
+    priorityConfigPath = configChoice.path;
+    configFileName = configChoice.name;
+  }
+
+  // 6. 汇总确认
+  const confirmed = await promptConfirm({
+    brand: brand.name,
+    templateFile: templateChoice.name,
+    snippetFolder: folder.name,
+    snippetFile: snippetFile.name,
+    configFile: configFileName,
+    snippetPath: snippetFile.path,
+    outputDir: process.cwd(),
+  });
+
+  if (!confirmed) {
+    console.log(chalk.gray('已取消。'));
+    return;
+  }
+
+  // 7. 构建配置并执行
+  const { config, layers } = buildSnippetConfig({ priorityConfigPath, cliConfigPath });
+
+  await assembleSnippet({
+    snippetPath: snippetFile.path,
+    templatePath: templateChoice.path,
+    config,
+    layers,
+    cwd: process.cwd(),
+  });
+}
+
+module.exports = { runSnippetMode, runInteractiveMode };