juice-email-cli 2.1.8 → 2.1.9

package/README.md

@@ -322,12 +322,11 @@ edm/
 ```
 
 ```bash
-# 以管理员身份运行
-juice --install    # 注册
+juice --install    # 注册（当前用户，无需管理员）
 juice --uninstall   # 卸载
 ```
 
-> **注意**：注册/卸载需要**管理员权限**。注册成功后如菜单未立即出现，重启文件资源管理器（`explorer.exe`）即可。
+> **注意**：注册到当前用户（HKCU），无需管理员权限。注册成功后如菜单未立即出现，重启文件资源管理器（`explorer.exe`）即可。
 
 ---
 

package/bin/juice.js

@@ -14,8 +14,8 @@ program
   .option('-s, --snippet <path>', '片段 HTML 文件路径：将片段内容插入模板 <tbody id="content"> 中')
   .option('-c, --config <path>', '配置文件路径')
   .option('-n, --name <name>', '片段模式输出文件名（不含扩展名）')
-  .option('--install',   '注册 Windows 右键菜单（需管理员权限）')
-  .option('--uninstall', '取消 Windows 右键菜单注册（需管理员权限）')
+  .option('--install',   '注册 Windows 右键菜单（当前用户，无需管理员）')
+  .option('--uninstall', '取消 Windows 右键菜单注册')
   .addHelpText('before', `
 ╔════════════════════════════════════════════════════════════════╗
 ║  juice-email-cli v${pkg.version}                                     ║
@@ -64,8 +64,8 @@ program
 ════════════════════════════════════════════════════════════════
 
   在 .html/.htm 文件上右键即可使用：
-    juice --install          （管理员权限，注册右键菜单）
-    juice --uninstall         （管理员权限，卸载右键菜单）
+    juice --install          （当前用户，注册右键菜单）
+    juice --uninstall         （卸载右键菜单）
 
 更多信息：https://gitee.com/siriussupreme/juice-cli
 `)

package/edm/elabscience/literature/snippet.html

@@ -65,7 +65,7 @@
           <td rowspan="2" style="padding-right: 12px;" class="image-box align-middle">
             <img src="{{information.image}}" />
           </td>
-          <td style="padding-bottoms: 24px;" class="h-0">
+          <td class="h-0 {{#information.link}}pb-24{{/information.link}}">
             <p>{{information.content}}</p>
           </td>
         </tr>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juice-email-cli",
-  "version": "2.1.8",
+  "version": "2.1.9",
   "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

@@ -3,18 +3,18 @@
 /**
  * Windows 右键菜单注册 / 取消注册
  *
- * 风格参考 PowerShell 7 的右键菜单实现：
- *   - 使用 MUIVerb（菜单显示文字）+ Icon 键
- *   - 通过 ExtendedSubCommandsKey 实现子菜单（"用 juice 处理" → 子项）
- *   - 注册到 SystemFileAssociations，兼容任意关联方式打开的 .html/.htm
+ * 使用 HKEY_CURRENT_USER，无需管理员权限，仅对当前用户生效。
  *
  * 菜单结构：
- *   📧 用 juice 生成邮件 HTML
- *     ├── ⚡ 生成邮件 HTML（标准 + 压缩）
- *     ├── 🧩 邮件片段组装（交互选择模板）
- *     └── 📂 在此目录打开 PowerShell
+ *   .html / .htm：
+ *     📧 用 juice 生成邮件 HTML
+ *       ├── ⚡ 生成邮件 HTML（标准 + 压缩）       → juice -f
+ *       ├── 🧩 邮件片段组装（交互选择模板）       → juice -s
+ *       └── 📂 在此目录打开 PowerShell 7         （可选）
  *
- * 需要以管理员权限运行。
+ *   .yaml / .yml：
+ *     📧 用 juice 生成邮件 HTML
+ *       └── 📋 交互式生成邮件（使用此配置）       → juice -c
  */
 
 const { execSync } = require('child_process');
@@ -47,108 +47,143 @@ function regAdd(key, valueName, type, data) {
   const cmd = `reg add "${key}" ${vFlag} ${tFlag} ${dFlag} /f`.replace(/\s+/g, ' ').trim();
   try {
     execSync(cmd, { stdio: 'pipe' });
+    return true;
   } catch (e) {
     const msg = e.stderr ? e.stderr.toString().trim() : e.message;
-    console.warn(chalk.yellow(`  ⚠  reg add 失败（可能需要管理员权限）\n     键：${key}\n     原因：${msg}`));
+    console.warn(chalk.yellow(`  ⚠  reg add 失败\n     键：${key}\n     原因：${msg}`));
+    return false;
   }
 }
 
 /**
- * 执行 reg delete，键不存在时静默忽略
+ * 执行 reg delete，键不存在时静默忽略，返回是否实际删除了
  */
 function regDelete(key) {
   try {
     execSync(`reg delete "${key}" /f`, { stdio: 'pipe' });
-  } catch (_) {}
+    return true;
+  } catch (_) {
+    return false;
+  }
 }
 
 /**
- * 转义注册表数据中的特殊字符（反斜杠和双引号）
+ * 转义注册表数据中的特殊字符
  */
 function escapeRegData(str) {
-  // reg.exe 中反斜杠需要双写，双引号需要转义
-  return str.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+  return str.replace(/\\/g, '\\\\').replace(/"/g, '\\"').replace(/%/g, '%%');
 }
 
 // ─── 菜单结构常量 ─────────────────────────────────────────────────────────────
 
-// 根键：SystemFileAssociations 对 .html/.htm 通用
-const ROOTS = [
-  'HKEY_CLASSES_ROOT\\SystemFileAssociations\\.html\\shell',
-  'HKEY_CLASSES_ROOT\\SystemFileAssociations\\.htm\\shell',
+// 使用 HKCU，无需管理员权限
+const HKCU_SHELL = 'HKEY_CURRENT_USER\\Software\\Classes';
+
+// HTML 文件右键
+const HTML_ROOTS = [
+  `${HKCU_SHELL}\\SystemFileAssociations\\.html\\shell`,
+  `${HKCU_SHELL}\\SystemFileAssociations\\.htm\\shell`,
+];
+
+// YAML 文件右键
+const YAML_ROOTS = [
+  `${HKCU_SHELL}\\SystemFileAssociations\\.yaml\\shell`,
+  `${HKCU_SHELL}\\SystemFileAssociations\\.yml\\shell`,
+];
+
+// CommandStore 子命令注册空间
+const SUBCMD_SPACE = 'HKEY_CURRENT_USER\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\CommandStore\\shell';
+
+// 子命令名称常量（register / unregister 共用，避免硬编码不一致）
+const SUBCMDS = {
+  generate: 'JuiceEmail.Generate',
+  snippet:  'JuiceEmail.Snippet',
+  config:   'JuiceEmail.WithConfig',
+  pwsh:     'JuiceEmail.OpenPwsh',
+};
+
+// 旧版本可能残留的子命令名（升级时清理）
+const LEGACY_SUBCMDS = [
+  'JuiceEmail.Generate',
+  'JuiceEmail.Snippet',
+  'JuiceEmail.OpenPwsh',
 ];
 
-// 父菜单键名（与 PowerShell 7 风格保持一致：不含特殊字符的英文键名）
 const PARENT_KEY_NAME = 'JuiceEmail';
-// 子命令注册表空间（SubCommands 引用的命令存放在 shell\JuiceEmail.SubCommands 下）
-// PowerShell 7 的做法：在 shell 同级放一个专用 SubCommands 键
-const SUBCMD_SPACE = 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\CommandStore\\shell';
 
 // ─── 注册 ─────────────────────────────────────────────────────────────────────
 
 async function registerContextMenu() {
-  console.log(chalk.cyan('\n  注册 juice 右键菜单（PowerShell 7 风格）...\n'));
+  console.log(chalk.cyan('\n  注册 juice 右键菜单（当前用户，无需管理员权限）...\n'));
 
   const nodePath = getNodePath();
   const scriptPath = getJuiceScript();
   const iconPath = getIconPath();
 
-  // 子命令 1：生成（标准 + 压缩）
-  const subCmd1 = `JuiceEmail.Generate`;
-  // 子命令 2：片段组装
-  const subCmd2 = `JuiceEmail.Snippet`;
-  // 子命令 3：在此打开 PowerShell（可选便利项）
-  const subCmd3 = `JuiceEmail.OpenPwsh`;
+  let ok = true;
 
-  // ── 注册子命令到 CommandStore ─────────────────────────────────────────────
+  // ── 子命令 1：普通模式 - juice 生成 ──────────────────────────────────────
+  const generateCmd = `"${nodePath}" "${scriptPath}" -f %1`;
+  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);
 
-  // 子命令 1：普通模式 - juice 生成
-  const generateCmd = `"${nodePath}" "${scriptPath}" -f "%1"`;
-  regAdd(`${SUBCMD_SPACE}\\${subCmd1}`, '', 'REG_SZ', '⚡ 生成邮件 HTML（标准 + 压缩）');
-  regAdd(`${SUBCMD_SPACE}\\${subCmd1}`, 'Icon', 'REG_SZ', iconPath);
-  regAdd(`${SUBCMD_SPACE}\\${subCmd1}\\command`, '', 'REG_SZ', generateCmd);
+  // ── 子命令 2：片段模式 - 片段组装 ────────────────────────────────────────
+  const snippetCmd = `"${nodePath}" "${scriptPath}" -s %1`;
+  ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.snippet}`, '', 'REG_SZ', '🧩 邮件片段组装（交互选择模板）') && ok;
+  regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.snippet}`, 'Icon', 'REG_SZ', iconPath);
+  regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.snippet}\\command`, '', 'REG_SZ', snippetCmd);
 
-  // 子命令 2：片段模式 - 片段组装（交互选择模板）
-  const snippetCmd = `"${nodePath}" "${scriptPath}" -s "%1"`;
-  regAdd(`${SUBCMD_SPACE}\\${subCmd2}`, '', 'REG_SZ', '🧩 邮件片段组装（交互选择模板）');
-  regAdd(`${SUBCMD_SPACE}\\${subCmd2}`, 'Icon', 'REG_SZ', iconPath);
-  regAdd(`${SUBCMD_SPACE}\\${subCmd2}\\command`, '', 'REG_SZ', snippetCmd);
+  // ── 子命令 3：配置文件模式 - 交互式生成 ──────────────────────────────────
+  const configCmd = `"${nodePath}" "${scriptPath}" -c %1`;
+  ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.config}`, '', 'REG_SZ', '📋 交互式生成邮件（使用此配置）') && ok;
+  regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.config}`, 'Icon', 'REG_SZ', iconPath);
+  regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.config}\\command`, '', 'REG_SZ', configCmd);
 
-  // 子命令 3：在文件目录打开 pwsh（如果安装了 PowerShell 7）
+  // ── 子命令 4：在文件目录打开 pwsh（可选）──────────────────────────────────
   const pwshPath = resolvePwsh();
   if (pwshPath) {
-    const pwshCmd = `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath '%W'"`;
-    regAdd(`${SUBCMD_SPACE}\\${subCmd3}`, '', 'REG_SZ', '📂 在此目录打开 PowerShell 7');
-    regAdd(`${SUBCMD_SPACE}\\${subCmd3}`, 'Icon', 'REG_SZ', pwshPath);
-    regAdd(`${SUBCMD_SPACE}\\${subCmd3}\\command`, '', 'REG_SZ', pwshCmd);
+    const pwshCmd = `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath (Split-Path '%1')"`;
+    ok = regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.pwsh}`, '', 'REG_SZ', '📂 在此目录打开 PowerShell 7') && ok;
+    regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.pwsh}`, 'Icon', 'REG_SZ', pwshPath);
+    regAdd(`${SUBCMD_SPACE}\\${SUBCMDS.pwsh}\\command`, '', 'REG_SZ', pwshCmd);
   }
 
-  // ── 注册父菜单到 SystemFileAssociations ──────────────────────────────────
+  // ── 注册 HTML 父菜单（二级子菜单）────────────────────────────────────────
+  const htmlSubs = pwshPath
+    ? `${SUBCMDS.generate};${SUBCMDS.snippet};${SUBCMDS.pwsh}`
+    : `${SUBCMDS.generate};${SUBCMDS.snippet}`;
 
-  let subCommands = `${subCmd1};${subCmd2}`;
-  if (pwshPath) subCommands += `;${subCmd3}`;
-
-  for (const root of ROOTS) {
+  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);
+  }
 
-    // MUIVerb：菜单显示文字
-    regAdd(parentKey, 'MUIVerb', 'REG_SZ', '📧 用 juice 生成邮件 HTML');
-    // Icon：使用自定义图标
+  // ── 注册 YAML 父菜单（二级子菜单）────────────────────────────────────────
+  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);
-    // SubCommands：引用 CommandStore 中的子命令（分号分隔）
-    regAdd(parentKey, 'SubCommands', 'REG_SZ', subCommands);
-    // Extended：取消注释可让菜单仅在按住 Shift 时显示（默认不加）
-    // regAdd(parentKey, 'Extended', 'REG_SZ', '');
+    regAdd(parentKey, 'SubCommands', 'REG_SZ', SUBCMDS.config);
+  }
+
+  // ── 输出 ──────────────────────────────────────────────────────────────────
+  if (!ok) {
+    console.log(chalk.yellow('  ⚠  部分注册表项写入失败，右键菜单可能不完整。\n'));
   }
 
   console.log(
     '\n' +
     chalk.green('  ✔ 右键菜单注册完成！') + '\n\n' +
-    `  在 ${chalk.cyan('.html')} / ${chalk.cyan('.htm')} 文件上右键即可看到：\n` +
-    `  ${chalk.bold('📧 用 juice 生成邮件 HTML')}\n` +
-    `    ├── ⚡ 生成邮件 HTML（标准 + 压缩）  →  juice -f\n` +
-    `    ├── 🧩 邮件片段组装（交互选择模板） →  juice -s\n` +
-    (pwshPath ? `    └── 📂 在此目录打开 PowerShell 7\n` : '') +
+    `  ${chalk.bold('.html / .htm')} 文件右键：\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` +
     '\n' +
     chalk.gray('  注意：如菜单未出现，请重启文件资源管理器（explorer.exe）。\n')
   );
@@ -159,15 +194,29 @@ async function registerContextMenu() {
 async function unregisterContextMenu() {
   console.log(chalk.cyan('\n  取消注册 juice 右键菜单...\n'));
 
-  for (const root of ROOTS) {
-    regDelete(`${root}\\${PARENT_KEY_NAME}`);
+  let removed = 0;
+
+  // 清理 HTML 父菜单
+  for (const root of HTML_ROOTS) {
+    if (regDelete(`${root}\\${PARENT_KEY_NAME}`)) removed++;
   }
 
-  regDelete(`${SUBCMD_SPACE}\\JuiceEmail.Generate`);
-  regDelete(`${SUBCMD_SPACE}\\JuiceEmail.Snippet`);
-  regDelete(`${SUBCMD_SPACE}\\JuiceEmail.OpenPwsh`);
+  // 清理 YAML 父菜单
+  for (const root of YAML_ROOTS) {
+    if (regDelete(`${root}\\${PARENT_KEY_NAME}`)) removed++;
+  }
+
+  // 清理子命令（当前版本 + 旧版本残留）
+  const allSubcmds = [...new Set([...Object.values(SUBCMDS), ...LEGACY_SUBCMDS])];
+  for (const name of allSubcmds) {
+    regDelete(`${SUBCMD_SPACE}\\${name}`);
+  }
 
-  console.log(chalk.green('  ✔ 右键菜单已移除。\n'));
+  if (removed > 0) {
+    console.log(chalk.green(`  ✔ 已移除 ${removed} 个右键菜单项。\n`));
+  } else {
+    console.log(chalk.gray('  ℹ  未找到已注册的右键菜单，无需卸载。\n'));
+  }
 }
 
 // ─── 工具：查找 PowerShell 7 ─────────────────────────────────────────────────
@@ -181,7 +230,6 @@ function resolvePwsh() {
   for (const p of candidates) {
     if (require('fs').existsSync(p)) return p;
   }
-  // 尝试 where.exe
   try {
     const result = execSync('where pwsh', { stdio: 'pipe' }).toString().trim().split('\n')[0].trim();
     if (result && require('fs').existsSync(result)) return result;

package/src/snippet.js

@@ -479,6 +479,32 @@ async function promptOutputName(defaultBaseName, cwd) {
   return baseName;
 }
 
+/**
+ * 无片段可用时，将模板拷贝到当前目录作为快捷副本
+ */
+async function copyTemplateToCwd(templatePath) {
+  const { confirm } = await import('@inquirer/prompts');
+
+  const templateName = path.parse(templatePath).name;
+  console.log(chalk.cyan(`\n  可将模板「${path.basename(templatePath)}」拷贝到当前目录作为快捷副本。`));
+
+  const proceed = await confirm({
+    message: '是否拷贝模板到当前目录？',
+    default: true,
+  });
+
+  if (!proceed) {
+    console.log(chalk.gray('已取消。'));
+    return;
+  }
+
+  const baseName = await promptOutputName(templateName, process.cwd());
+  const destPath = path.join(process.cwd(), baseName + '.html');
+
+  fs.copyFileSync(templatePath, destPath);
+  console.log(chalk.green(`\n✔ 模板已拷贝到：${destPath}`));
+}
+
 async function promptConfirm(summary) {
   const { confirm } = await import('@inquirer/prompts');
   const outPaths = resolveSnippetOutputPaths(summary.outputBaseName, summary.outputDir);
@@ -621,8 +647,8 @@ async function runInteractiveMode({ config: cliConfigPath }) {
   // 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 文件）。`));
+    console.log(chalk.yellow(`\n  ⚠  品牌「${brand.name}」下暂无片段系列。`));
+    await copyTemplateToCwd(templateChoice.path);
     return;
   }
   const folder = await promptSnippetFolder(snippetFolders);