juice-email-cli 2.1.9 → 2.1.10

package/README.md

@@ -105,8 +105,8 @@ juice
 | `--snippet <path>` | `-s` | 片段 HTML 文件路径：插入到模板 `<tbody id="content">` |
 | `--config <path>` | `-c` | 配置文件路径，不指定时自动查找 |
 | `--name <name>` | `-n` | 片段模式输出文件名（不含扩展名） |
-| `--install` | | 注册 Windows 右键菜单（需管理员权限） |
-| `--uninstall` | | 取消 Windows 右键菜单注册（需管理员权限） |
+| `--install` | | 注册 Windows 右键菜单（当前用户，无需管理员） |
+| `--uninstall` | | 取消 Windows 右键菜单注册 |
 | `--version` | `-v` | 查看版本号 |
 | `--help` | `-h` | 查看帮助 |
 
@@ -312,15 +312,22 @@ edm/
 
 ## Windows 右键菜单
 
-注册后，在 `.html` / `.htm` 文件上右键可看到级联子菜单：
+注册后，在 `.html` / `.htm` / `.yaml` / `.yml` 文件上右键可看到统一子菜单（所有文件类型共享）：
 
 ```
 📧 用 juice 生成邮件 HTML
-  ├── ⚡ 生成邮件 HTML（标准 + 压缩）    →  juice -f
-  ├── 🧩 邮件片段组装（交互选择模板）    →  juice -s
-  └── 📂 在此目录打开 PowerShell 7      ← 仅在已安装 pwsh 时出现
+  ├── 📄 作为模板，生成邮件 HTML   → juice -f %1（后台执行）
+  ├── 🧩 作为片段，拼接邮件 HTML   → juice -s %1（交互选择模板）
+  ├── ⚙️ 作为配置，拼接邮件 HTML   → juice -c %1（交互选择品牌/模板/片段）
+  └── 📂 打开 PowerShell           ← 仅已安装 pwsh 时出现
 ```
 
+| 子命令 | 说明 |
+|--------|------|
+| 📄 作为模板，生成邮件 HTML | 将文件当模板处理，CSS 内联 + 变量替换 + 压缩 |
+| 🧩 作为片段，拼接邮件 HTML | 将文件当片段，打开终端选择模板后拼接输出 |
+| ⚙️ 作为配置，拼接邮件 HTML | 将文件当配置，打开终端选择品牌/模板/片段 |
+
 ```bash
 juice --install    # 注册（当前用户，无需管理员）
 juice --uninstall   # 卸载

package/bin/juice.js

@@ -63,10 +63,17 @@ program
   右键菜单
 ════════════════════════════════════════════════════════════════
 
-  在 .html/.htm 文件上右键即可使用：
-    juice --install          （当前用户，注册右键菜单）
+  注册后，在 .html / .htm / .yaml / .yml 文件上右键即可看到：
+    juice --install          （当前用户，无需管理员）
     juice --uninstall         （卸载右键菜单）
 
+  菜单结构（所有文件类型统一）：
+    📧 用 juice 生成邮件 HTML
+      ├── 📄 作为模板，生成邮件 HTML  →  juice -f %1（后台执行）
+      ├── 🧩 作为片段，拼接邮件 HTML  →  juice -s %1（交互选择模板）
+      ├── ⚙️ 作为配置，拼接邮件 HTML  →  juice -c %1（交互选择品牌/模板/片段）
+      └── 📂 打开 PowerShell          （仅已安装 pwsh 时出现）
+
 更多信息：https://gitee.com/siriussupreme/juice-cli
 `)
   .action(async (options) => {

package/edm/elabscience/elabscience-template.html

@@ -1524,7 +1524,7 @@
 
                         <tr>
                           <td>Quality Control</td>
-                          <td colspan="2">Sterilized by 0.1 μm filtration, Endotoxin Content < 3 EU/mL.</td>
+                          <td colspan="2">Sterilized by 0.1 μm filtration, Endotoxin Content &lt; 3 EU/mL.</td>
                         </tr>
                       </tbody>
                     </table>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juice-email-cli",
-  "version": "2.1.9",
+  "version": "2.1.10",
   "description": "CLI tool to generate email-client-compatible HTML with juice (CSS inlining) + Mustache templating + minification",
   "main": "src/index.js",
   "bin": {
@@ -8,7 +8,7 @@
   },
   "scripts": {
     "start": "node bin/juice.js",
-    "test": "node bin/juice.js --help",
+    "test": "node test/smoke.js",
     "postinstall": "node bin/juice.js --install",
     "preuninstall": "node bin/juice.js --uninstall",
     "prepare": "husky install",
@@ -46,7 +46,7 @@
     "ora": "^5.4.1"
   },
   "engines": {
-    "node": ">=14.0.0"
+    "node": ">=16.0.0"
   },
   "files": [
     "bin/",
@@ -60,7 +60,6 @@
     "@commitlint/cli": "^21.0.1",
     "@commitlint/config-conventional": "^21.0.1",
     "husky": "^9.1.7",
-    "inquirer": "^13.4.3",
     "standard-version": "^9.5.0"
   }
 }

package/src/context-menu.js

@@ -5,16 +5,13 @@
  *
  * 使用 HKEY_CURRENT_USER，无需管理员权限，仅对当前用户生效。
  *
- * 菜单结构：
- *   .html / .htm：
+ * 菜单结构（所有文件类型统一）：
+ *   .html / .htm / .yaml / .yml：
  *     📧 用 juice 生成邮件 HTML
- *       ├── ⚡ 生成邮件 HTML（标准 + 压缩）       → juice -f
- *       ├── 🧩 邮件片段组装（交互选择模板）       → juice -s
- *       └── 📂 在此目录打开 PowerShell 7         （可选）
- *
- *   .yaml / .yml：
- *     📧 用 juice 生成邮件 HTML
- *       └── 📋 交互式生成邮件（使用此配置）       → juice -c
+ *       ├── 📄 作为模板，生成邮件 HTML   → juice -f（后台执行）
+ *       ├── 🧩 作为片段，拼接邮件 HTML   → juice -s（交互选择模板）
+ *       ├── ⚙️ 作为配置，拼接邮件 HTML   → juice -c（交互选择品牌/模板/片段）
+ *       └── 📂 打开 PowerShell        （可选）
  */
 
 const { execSync } = require('child_process');
@@ -102,15 +99,30 @@ const SUBCMDS = {
   pwsh:     'JuiceEmail.OpenPwsh',
 };
 
-// 旧版本可能残留的子命令名（升级时清理）
-const LEGACY_SUBCMDS = [
-  'JuiceEmail.Generate',
-  'JuiceEmail.Snippet',
-  'JuiceEmail.OpenPwsh',
-];
-
 const PARENT_KEY_NAME = 'JuiceEmail';
 
+/**
+ * 为交互式命令包一层 PowerShell：
+ * - 成功：窗口自动关闭
+ * - 失败：窗口保持开启，显示重新执行的命令
+ */
+function wrapInteractive(nodePath, scriptPath, cliArgs) {
+  const node = nodePath.replace(/'/g, "''");
+  const script = scriptPath.replace(/'/g, "''");
+  // %1 由 Windows 在 CreateProcess 前展开为实际文件路径
+  const ps = [
+    `& '${node}' '${script}' ${cliArgs}`,
+    `if ($LASTEXITCODE) {`,
+    `  Write-Host ''`,
+    `  Write-Host '[Failed] Exit code:' $LASTEXITCODE`,
+    `  Write-Host '[Re-run] juice ${cliArgs}'`,
+    `  Write-Host ''`,
+    `  Read-Host 'Press Enter to close'`,
+    `}`,
+  ].join('; ');
+  return `powershell.exe -Command "${ps}"`;
+}
+
 // ─── 注册 ─────────────────────────────────────────────────────────────────────
 
 async function registerContextMenu() {
@@ -122,21 +134,21 @@ async function registerContextMenu() {
 
   let ok = true;
 
-  // ── 子命令 1：普通模式 - juice 生成 ──────────────────────────────────────
+  // ── 子命令 1：普通模式 - juice 生成（非交互，不需终端）─────────────────
   const generateCmd = `"${nodePath}" "${scriptPath}" -f %1`;
-  ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.generate}`, '', 'REG_SZ', '⚡ 生成邮件 HTML（标准 + 压缩）') && ok;
+  ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.generate}`, '', 'REG_SZ', '📄 作为模板，生成邮件 HTML') && ok;
   regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.generate}`, 'Icon', 'REG_SZ', iconPath);
   regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.generate}\\command`, '', 'REG_SZ', generateCmd);
 
-  // ── 子命令 2：片段模式 - 片段组装 ────────────────────────────────────────
-  const snippetCmd = `"${nodePath}" "${scriptPath}" -s %1`;
-  ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.snippet}`, '', 'REG_SZ', '🧩 邮件片段组装（交互选择模板）') && ok;
+  // ── 子命令 2：片段模式 - 片段组装（交互，需要终端）────────────────────────
+  const snippetCmd = wrapInteractive(nodePath, scriptPath, '-s %1');
+  ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.snippet}`, '', 'REG_SZ', '🧩 作为片段，拼接邮件 HTML') && ok;
   regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.snippet}`, 'Icon', 'REG_SZ', iconPath);
   regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.snippet}\\command`, '', 'REG_SZ', snippetCmd);
 
-  // ── 子命令 3：配置文件模式 - 交互式生成 ──────────────────────────────────
-  const configCmd = `"${nodePath}" "${scriptPath}" -c %1`;
-  ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.config}`, '', 'REG_SZ', '📋 交互式生成邮件（使用此配置）') && ok;
+  // ── 子命令 3：配置文件模式 - 交互式生成（交互，需要终端）──────────────────
+  const configCmd = wrapInteractive(nodePath, scriptPath, '-c %1');
+  ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.config}`, '', 'REG_SZ', '⚙️ 作为配置，拼接邮件 HTML') && ok;
   regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.config}`, 'Icon', 'REG_SZ', iconPath);
   regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.config}\\command`, '', 'REG_SZ', configCmd);
 
@@ -144,29 +156,30 @@ async function registerContextMenu() {
   const pwshPath = resolvePwsh();
   if (pwshPath) {
     const pwshCmd = `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath (Split-Path '%1')"`;
-    ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.pwsh}`, '', 'REG_SZ', '📂 在此目录打开 PowerShell 7') && ok;
+    ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.pwsh}`, '', 'REG_SZ', '📂 打开 PowerShell') && ok;
     regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.pwsh}`, 'Icon', 'REG_SZ', pwshPath);
     regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.pwsh}\\command`, '', 'REG_SZ', pwshCmd);
   }
 
-  // ── 注册 HTML 父菜单（二级子菜单）────────────────────────────────────────
-  const htmlSubs = pwshPath
-    ? `${SUBCMDS.generate};${SUBCMDS.snippet};${SUBCMDS.pwsh}`
-    : `${SUBCMDS.generate};${SUBCMDS.snippet}`;
+  // ── 所有文件类型共用同一套子命令 ────────────────────────────────────────
+  const allSubs = pwshPath
+    ? `${SUBCMDS.generate};${SUBCMDS.snippet};${SUBCMDS.config};${SUBCMDS.pwsh}`
+    : `${SUBCMDS.generate};${SUBCMDS.snippet};${SUBCMDS.config}`;
 
+  // .html / .htm
   for (const root of HTML_ROOTS) {
     const parentKey = `${root}\\${PARENT_KEY_NAME}`;
     ok = regAdd(parentKey, 'MUIVerb', 'REG_SZ', '📧 用 juice 生成邮件 HTML') && ok;
     regAdd(parentKey, 'Icon', 'REG_SZ', iconPath);
-    regAdd(parentKey, 'SubCommands', 'REG_SZ', htmlSubs);
+    regAdd(parentKey, 'SubCommands', 'REG_SZ', allSubs);
   }
 
-  // ── 注册 YAML 父菜单（二级子菜单）────────────────────────────────────────
+  // .yaml / .yml（与 .html 共享同一套子命令）
   for (const root of YAML_ROOTS) {
     const parentKey = `${root}\\${PARENT_KEY_NAME}`;
     ok = regAdd(parentKey, 'MUIVerb', 'REG_SZ', '📧 用 juice 生成邮件 HTML') && ok;
     regAdd(parentKey, 'Icon', 'REG_SZ', iconPath);
-    regAdd(parentKey, 'SubCommands', 'REG_SZ', SUBCMDS.config);
+    regAdd(parentKey, 'SubCommands', 'REG_SZ', allSubs);
   }
 
   // ── 输出 ──────────────────────────────────────────────────────────────────
@@ -177,13 +190,12 @@ async function registerContextMenu() {
   console.log(
     '\n' +
     chalk.green('  ✔ 右键菜单注册完成！') + '\n\n' +
-    `  ${chalk.bold('.html / .htm')} 文件右键：\n` +
+    `  ${chalk.bold('.html / .htm / .yaml / .yml')} 文件右键：\n` +
     `    ${chalk.bold('📧 用 juice 生成邮件 HTML')}\n` +
-    `      ├── ⚡ 生成邮件 HTML（标准 + 压缩）  →  juice -f\n` +
-    `      ├── 🧩 邮件片段组装（交互选择模板） →  juice -s\n` +
-    (pwshPath ? `      └── 📂 在此目录打开 PowerShell 7\n` : '') +
-    `\n  ${chalk.bold('.yaml / .yml')} 文件右键：\n` +
-    `    └── 📧 交互式生成邮件（使用此配置） →  juice -c\n` +
+    `      ├── 📄 作为模板，生成邮件 HTML  →  juice -f（后台执行）\n` +
+    `      ├── 🧩 作为片段，拼接邮件 HTML  →  juice -s（交互选择模板）\n` +
+    `      ├── ⚙️ 作为配置，拼接邮件 HTML  →  juice -c（交互选择品牌/模板/片段）\n` +
+    (pwshPath ? `      └── 📂 打开 PowerShell\n` : '') +
     '\n' +
     chalk.gray('  注意：如菜单未出现，请重启文件资源管理器（explorer.exe）。\n')
   );
@@ -206,9 +218,8 @@ async function unregisterContextMenu() {
     if (regDelete(`${root}\\${PARENT_KEY_NAME}`)) removed++;
   }
 
-  // 清理子命令（当前版本 + 旧版本残留）
-  const allSubcmds = [...new Set([...Object.values(SUBCMDS), ...LEGACY_SUBCMDS])];
-  for (const name of allSubcmds) {
+  // 清理子命令
+  for (const name of Object.values(SUBCMDS)) {
     regDelete(`${SUBCMD_SPACE}\\${name}`);
   }
 

package/src/index.js

@@ -33,6 +33,10 @@ const HOME_CANDIDATES = [
   path.join(os.homedir(), 'juice.yml'),
 ];
 
+function resolveHomeConfig() {
+  return HOME_CANDIDATES.find((c) => fs.existsSync(c)) || null;
+}
+
 // ─── 配置文件查找 ─────────────────────────────────────────────────────────────
 
 /**
@@ -73,7 +77,7 @@ function findConfigs(configPath, inputFile) {
     }
   }
 
-  return { highPriorityPath, homePath: HOME_CANDIDATES[0] };
+  return { highPriorityPath, homePath: resolveHomeConfig() };
 }
 
 // ─── 配置文件加载 ─────────────────────────────────────────────────────────────
@@ -121,14 +125,13 @@ function deepMerge(base, ...overrides) {
  *   CLI 内置默认值  <  用户目录 ~/juice.yaml  <  优先配置（-c/输入目录）
  */
 function buildConfig(highPriorityPath, homePath) {
-  const homeExists = fs.existsSync(homePath);
   const layers = [];
 
   // 1. CLI 内置默认值（最低优先级）
   layers.push({ label: 'CLI 内置默认值', data: CODE_DEFAULTS });
 
   // 2. 用户目录配置（如果有）
-  if (homeExists) {
+  if (homePath) {
     layers.push({ label: `用户目录配置 (${homePath})`, data: loadYaml(homePath) });
   }
 
@@ -148,11 +151,15 @@ function processTemplate(inputFile, config) {
 
   // 1. Mustache 变量替换（根据 rawHtml 配置决定是否转义 HTML）
   const originalEscape = Mustache.escape;
-  if (config.rawHtml) {
-    Mustache.escape = (text) => text;
+  let htmlWithVars;
+  try {
+    if (config.rawHtml) {
+      Mustache.escape = (text) => text;
+    }
+    htmlWithVars = Mustache.render(htmlRaw, config.variables || {});
+  } finally {
+    Mustache.escape = originalEscape;
   }
-  const htmlWithVars = Mustache.render(htmlRaw, config.variables || {});
-  Mustache.escape = originalEscape;
 
   // 2. 收集 extraCssFiles
   const basePath = path.dirname(path.resolve(inputFile));
@@ -228,10 +235,16 @@ async function run({ file, config: configPath }) {
 
     // 5. 写出标准版
     spinner.text = '写出 .output.html ...';
+    if (fs.existsSync(outPaths.normal)) {
+      spinner.warn(chalk.yellow(`目标文件已存在，将覆盖：${outPaths.normal}`));
+    }
     fs.writeFileSync(outPaths.normal, resultHtml, encoding);
 
     // 6. 压缩并写出
     spinner.text = '写出 .minified.html ...';
+    if (fs.existsSync(outPaths.minified)) {
+      spinner.warn(chalk.yellow(`目标文件已存在，将覆盖：${outPaths.minified}`));
+    }
     const minified = await minifyHtml(resultHtml, config.minify);
     fs.writeFileSync(outPaths.minified, minified, encoding);
 
@@ -266,4 +279,4 @@ function savings(original, minified) {
   return (((orig - mini) / orig) * 100).toFixed(1) + '%';
 }
 
-module.exports = { run, findConfigs, buildConfig, processTemplate, minifyHtml, deepMerge, collectExtraCss, loadYaml, fmtSize, savings };
+module.exports = { run, findConfigs, buildConfig, processTemplate, minifyHtml, deepMerge, collectExtraCss, loadYaml, fmtSize, savings, DEFAULT_CONFIG_PATH, resolveHomeConfig };

package/src/snippet.js

@@ -13,6 +13,7 @@ const {
   minifyHtml,
   fmtSize,
   savings,
+  DEFAULT_CONFIG_PATH,
 } = require('./index');
 
 // ─── EDM 目录解析 ──────────────────────────────────────────────────────────────
@@ -95,8 +96,6 @@ function getBrand(filePath, edmDir) {
 
 // ─── 配置合并 ─────────────────────────────────────────────────────────────────
 
-const DEFAULT_CONFIG_PATH = path.resolve(__dirname, '..', 'defaults', 'juice.yaml');
-
 /**
  * 片段模式配置合并
  *
@@ -114,8 +113,12 @@ function buildSnippetConfig({ priorityConfigPath, cliConfigPath }) {
   layers.push({ label: 'CLI 内置默认值', data: defaults });
 
   // 2. 用户主目录
-  const homePath = path.join(os.homedir(), 'juice.yaml');
-  if (fs.existsSync(homePath)) {
+  const homeCandidates = [
+    path.join(os.homedir(), 'juice.yaml'),
+    path.join(os.homedir(), 'juice.yml'),
+  ];
+  const homePath = homeCandidates.find((c) => fs.existsSync(c));
+  if (homePath) {
     layers.push({ label: `用户目录配置 (${homePath})`, data: loadYaml(homePath) });
   }
 
@@ -246,7 +249,7 @@ function resolveSnippetOutputPaths(outputBaseName, cwd) {
  *   3. Juice CSS 内联 → .output.html
  *   4. 压缩 → .minified.html
  */
-async function assembleSnippet({ snippetPath, templatePath, config, layers, cwd, outputBaseName }) {
+async function assembleSnippet({ snippetPath, templatePath, config, cwd, outputBaseName }) {
   const templateHtml = fs.readFileSync(templatePath, 'utf8');
   const snippetRaw = fs.readFileSync(snippetPath, 'utf8');
   const outPaths = resolveSnippetOutputPaths(outputBaseName, cwd);
@@ -258,11 +261,15 @@ async function assembleSnippet({ snippetPath, templatePath, config, layers, cwd,
 
   // 2. Mustache 渲染合并 HTML → .html（已渲染，无 juice 内联）
   const originalEscape = Mustache.escape;
-  if (config.rawHtml) {
-    Mustache.escape = (text) => text;
+  let renderedHtml;
+  try {
+    if (config.rawHtml) {
+      Mustache.escape = (text) => text;
+    }
+    renderedHtml = Mustache.render(rawMarkup, variables);
+  } finally {
+    Mustache.escape = originalEscape;
   }
-  const renderedHtml = Mustache.render(rawMarkup, variables);
-  Mustache.escape = originalEscape;
   fs.writeFileSync(outPaths.normal, renderedHtml, 'utf8');
 
   // 3. 收集模板目录的额外 CSS + Juice CSS 内联 → .output.html
@@ -278,6 +285,7 @@ async function assembleSnippet({ snippetPath, templatePath, config, layers, cwd,
   fs.writeFileSync(outPaths.minified, minified, 'utf8');
 
   // 5. 报告
+  const layers = config._layers || [];
   const layerLines = layers
     .map((l) => `    ${chalk.gray('·')} ${l.label}`)
     .join('\n');
@@ -585,6 +593,7 @@ async function runSnippetMode({ snippet, template, config: cliConfigPath, output
   }
 
   const { config, layers } = buildSnippetConfig({ priorityConfigPath, cliConfigPath });
+  config._layers = layers;
 
   // 确定输出文件名
   const defaultBaseName = outputName || path.parse(templatePath).name;
@@ -621,7 +630,6 @@ async function runSnippetMode({ snippet, template, config: cliConfigPath, output
     snippetPath,
     templatePath,
     config,
-    layers,
     cwd: process.cwd(),
     outputBaseName,
   });
@@ -697,12 +705,12 @@ async function runInteractiveMode({ config: cliConfigPath }) {
 
   // 8. 构建配置并执行
   const { config, layers } = buildSnippetConfig({ priorityConfigPath, cliConfigPath });
+  config._layers = layers;
 
   await assembleSnippet({
     snippetPath: snippetFile.path,
     templatePath: templateChoice.path,
     config,
-    layers,
     cwd: process.cwd(),
     outputBaseName,
   });