juice-email-cli 2.3.3 → 2.3.5

package/README.md

@@ -351,34 +351,46 @@ edm/
 
 ## Windows 右键菜单
 
-### 文件右键（.html / .htm）
+### .html / .htm 文件右键
 
 ```
 📧 用 juice 生成邮件 HTML
-  ├── 📄 作为模板，生成邮件 HTML   → juice -f %1（后台执行）
-  ├── 🧩 作为片段，拼接邮件 HTML   → juice -s %1（交互选择模板）
-  ├── 📦 查看资源列表              → juice view
-  ├── 📋 浏览资源库                → juice view -i
+  ├── 📄 作为模板，生成邮件 HTML     → juice -f %1（后台执行）
+  ├── 🧩 作为片段，拼接邮件 HTML     → juice -s %1（交互选择模板）
+  ├── 📋 查看可用资源                → juice view
+  ├── 📦 拷贝全部资源                → juice init --all
+  ├── 📥 选择资源拷贝                → juice init
   └── 📂 打开 PowerShell           ← 仅已安装 pwsh 时出现
 ```
 
-### 文件右键（.yaml / .yml）
+### .yaml / .yml 文件右键
 
 ```
 📧 用 juice 生成邮件 HTML
-  ├── ⚙️ 作为配置，拼接邮件 HTML   → juice -c %1（交互选择品牌/模板/片段）
-  ├── 📦 查看资源列表              → juice view
-  ├── 📋 浏览资源库                → juice view -i
+  ├── ⚙️ 作为配置，拼接邮件 HTML     → juice -c %1（交互选择品牌/模板/片段）
+  ├── 📋 查看可用资源
+  ├── 📦 拷贝全部资源
+  ├── 📥 选择资源拷贝
   └── 📂 打开 PowerShell
 ```
 
-### 文件夹 / 空白处右键
+### 文件夹右键
 
 ```
-📧 juice 邮件工具
-  ├── 📥 从资源库拷贝到此处         → juice init
-  ├── 📦 查看资源列表              → juice view
-  ├── 📋 浏览资源库                → juice view -i
+📧 用 juice 生成邮件 HTML
+  ├── 📋 查看可用资源
+  ├── 📦 拷贝全部资源
+  ├── 📥 选择资源拷贝
+  └── 📂 在此打开终端
+```
+
+### 空白处右键
+
+```
+📧 用 juice 生成邮件 HTML
+  ├── 📋 查看可用资源
+  ├── 📦 拷贝全部资源
+  ├── 📥 选择资源拷贝
   └── 📂 在此打开终端
 ```
 

package/bin/juice.js

@@ -67,11 +67,13 @@ program
     juice --install          （当前用户，无需管理员）
     juice --uninstall         （卸载右键菜单）
 
-  菜单结构（所有文件类型统一）：
+  菜单结构：
     📧 用 juice 生成邮件 HTML
-      ├── 📄 作为模板，生成邮件 HTML  →  juice -f %1（后台执行）
-      ├── 🧩 作为片段，拼接邮件 HTML  →  juice -s %1（交互选择模板）
-      ├── ⚙️ 作为配置，拼接邮件 HTML  →  juice -c %1（交互选择品牌/模板/片段）
+      ├── 📄 作为模板，生成邮件 HTML  →  juice -f（后台执行）
+      ├── 🧩 作为片段，拼接邮件 HTML  →  juice -s（交互选择模板）
+      ├── 📋 查看可用资源              →  juice view
+      ├── 📦 拷贝全部资源              →  juice init --all
+      ├── 📥 选择资源拷贝              →  juice init
       └── 📂 打开 PowerShell          （仅已安装 pwsh 时出现）
 
 更多信息：https://gitee.com/siriussupreme/juice-cli
@@ -103,6 +105,7 @@ program
   .option('-t, --template <file-path>', '仅拷贝模板 HTML 文件')
   .option('-s, --snippet <file-path>', '仅拷贝片段 HTML 文件')
   .option('-c, --config <file-path>', '仅拷贝配置 YAML 文件')
+  .option('--all [target]', '拷贝整个 EDM 资源目录到当前或指定目录')
   .action(async (initPath, options) => {
     const { runInitMode } = require('../src/init');
     await runInitMode({
@@ -110,6 +113,7 @@ program
       template: options.template || null,
       snippet: options.snippet || null,
       config: options.config || null,
+      all: options.all !== undefined ? (options.all || true) : null,
     });
   });
 

package/package.json

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

@@ -6,20 +6,30 @@
  * 使用 ExtendedSubCommandsKey 实现级联菜单（参考 WinRAR 和 Windows Defender 的实现）。
  * 子命令存储在 Classes 根下的共享容器中，各文件类型父菜单通过 ExtendedSubCommandsKey 引用。
  *
- * 与旧版 SubCommands + CommandStore 方案的区别：
- *   - 不依赖 CommandStore（HKCU CommandStore 在某些 Windows 版本下不被正确解析）
- *   - ExtendedSubCommandsKey 指向 Classes 根下的相对路径，子命令内联存储
- *
- * 菜单结构（按文件类型区分）：
+ * 菜单结构：
  *   .html / .htm：
  *     📧 用 juice 生成邮件 HTML
  *       ├── 📄 作为模板，生成邮件 HTML   → juice -f（后台执行）
  *       ├── 🧩 作为片段，拼接邮件 HTML   → juice -s（交互选择模板）
+ *       ├── 📋 查看可用资源              → juice view
+ *       ├── 📦 拷贝全部资源              → juice init --all
+ *       ├── 📥 选择资源拷贝              → juice init
  *       └── 📂 打开 PowerShell        （可选）
  *
  *   .yaml / .yml：
  *     📧 用 juice 生成邮件 HTML
- *       └── ⚙️ 作为配置，拼接邮件 HTML   → juice -c（交互选择品牌/模板/片段）
+ *       ├── ⚙️ 作为配置，拼接邮件 HTML   → juice -c（交互选择品牌/模板/片段）
+ *       ├── 📋 查看可用资源
+ *       ├── 📦 拷贝全部资源
+ *       ├── 📥 选择资源拷贝
+ *       └── 📂 打开 PowerShell        （可选）
+ *
+ *   文件夹 / 空白处：
+ *     📧 用 juice 生成邮件 HTML
+ *       ├── 📋 查看可用资源
+ *       ├── 📦 拷贝全部资源
+ *       ├── 📥 选择资源拷贝
+ *       └── 📂 在此打开终端           （可选）
  */
 
 const { spawnSync } = require('child_process');
@@ -103,7 +113,6 @@ const SUBCMDS = {
   snippet:   'JuiceEmail.Snippet',
   config:    'JuiceEmail.WithConfig',
   viewEdm:   'JuiceEmail.ViewEdm',
-  viewEdmInt:'JuiceEmail.ViewEdmInteractive',
   initEdm:   'JuiceEmail.InitEdm',
   pwsh:      'JuiceEmail.OpenPwsh',
 };
@@ -118,7 +127,6 @@ const SUB_CMDS_CONTAINER_BG   = 'JuiceEmail.SubCommands.Bg';
 
 // ─── 旧版残留清理 ─────────────────────────────────────────────────────────────
 
-// 旧版 HKLM 父菜单路径（v1 使用 HKCR/HKLM，需管理员权限写入）
 const LEGACY_HKLM_ROOTS = [
   'HKEY_LOCAL_MACHINE\\Software\\Classes\\SystemFileAssociations\\.html\\shell',
   'HKEY_LOCAL_MACHINE\\Software\\Classes\\SystemFileAssociations\\.htm\\shell',
@@ -126,14 +134,9 @@ const LEGACY_HKLM_ROOTS = [
   'HKEY_LOCAL_MACHINE\\Software\\Classes\\SystemFileAssociations\\.yml\\shell',
 ];
 
-// 旧版 CommandStore 子命令路径（v1-v2.1.12 使用 SubCommands + CommandStore 方案）
 const LEGACY_HKCU_CMDSTORE = 'HKEY_CURRENT_USER\\Software\\Microsoft\\Windows\\CurrentVersion\\Explorer\\CommandStore\\shell';
 const LEGACY_HKLM_CMDSTORE = 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Explorer\\CommandStore\\shell';
 
-/**
- * 清理旧版本残留在 HKLM 的父菜单（v1 使用 HKCR/HKLM，需要管理员权限）
- * 没有管理员权限时静默失败，不影响后续 HKCU 写入
- */
 function cleanLegacyHklmParents() {
   if (!isWindows) return;
   for (const root of LEGACY_HKLM_ROOTS) {
@@ -141,28 +144,24 @@ function cleanLegacyHklmParents() {
   }
 }
 
-/**
- * 清理旧版本 CommandStore 子命令残留（HKCU + HKLM）
- */
 function cleanLegacyCommandStore() {
   if (!isWindows) return;
   for (const name of Object.values(SUBCMDS)) {
     regDelete(`${LEGACY_HKCU_CMDSTORE}\\${name}`);
     regDelete(`${LEGACY_HKLM_CMDSTORE}\\${name}`);
   }
+  // Also clean up old Dir CommandStore entries from v2.3.x SubCommands attempt
+  for (const name of ['JuiceEmailDir.View', 'JuiceEmailDir.CopyAll', 'JuiceEmailDir.CopyPick', 'JuiceEmailDir.Pwsh']) {
+    regDelete(`${LEGACY_HKCU_CMDSTORE}\\${name}`);
+    regDelete(`${LEGACY_HKLM_CMDSTORE}\\${name}`);
+  }
 }
 
 // ─── PowerShell 包装 ──────────────────────────────────────────────────────────
 
-/**
- * 为交互式命令包一层 PowerShell：
- * - 成功：窗口自动关闭
- * - 失败：窗口保持开启，显示重新执行的命令
- */
 function wrapInteractive(nodePath, scriptPath, cliArgs) {
   const node = nodePath.replace(/'/g, "''");
   const script = scriptPath.replace(/'/g, "''");
-  // %1 由 Windows Explorer 在 CreateProcess 前展开为实际文件路径
   const ps = [
     `& '${node}' '${script}' ${cliArgs}`,
     `if ($LASTEXITCODE) {`,
@@ -200,115 +199,105 @@ function resolvePwsh() {
 /**
  * 向指定容器注册子命令
  * @param {string} containerPath - 容器完整注册表路径
- * @param {'html'|'yaml'} kind - 子命令集合类型
+ * @param {'html'|'yaml'|'dir'|'bg'} kind - 子命令集合类型
  */
 function registerSubCommands(containerPath, kind, nodePath, scriptPath, iconPath, pwshPath) {
+  const node = nodePath.replace(/'/g, "''");
+  const script = scriptPath.replace(/'/g, "''");
+
+  // Shared resource commands (added to all containers)
+  function regResourceCmds(dirPrefix) {
+    const cd = dirPrefix || '';
+
+    // 📋 查看可用资源
+    const vKey = `${containerPath}\\shell\\JuiceEmail.ViewRes`;
+    regAdd(vKey, 'MUIVerb', 'REG_SZ', '📋 查看可用资源');
+    regAdd(vKey, 'Icon', 'REG_SZ', iconPath);
+    const vPs = `${cd}& '${node}' '${script}' view; Write-Host ''; Read-Host 'Press Enter to close'`;
+    regAdd(`${vKey}\\command`, '', 'REG_SZ', `powershell.exe -Command "${vPs}"`);
+
+    // 📦 拷贝全部资源
+    const aKey = `${containerPath}\\shell\\JuiceEmail.CopyAll`;
+    regAdd(aKey, 'MUIVerb', 'REG_SZ', '📦 拷贝全部资源');
+    regAdd(aKey, 'Icon', 'REG_SZ', iconPath);
+    const aPs = `${cd}& '${node}' '${script}' init --all .; Write-Host ''; Read-Host 'Press Enter to close'`;
+    regAdd(`${aKey}\\command`, '', 'REG_SZ', `powershell.exe -Command "${aPs}"`);
+
+    // 📥 选择资源拷贝
+    const pKey = `${containerPath}\\shell\\JuiceEmail.CopyPick`;
+    regAdd(pKey, 'MUIVerb', 'REG_SZ', '📥 选择资源拷贝');
+    regAdd(pKey, 'Icon', 'REG_SZ', iconPath);
+    const pPs = `${cd}& '${node}' '${script}' init; Write-Host ''; Read-Host 'Press Enter to close'`;
+    regAdd(`${pKey}\\command`, '', 'REG_SZ', `powershell.exe -Command "${pPs}"`);
+  }
+
   if (kind === 'html') {
-    // HTML：作为模板生成
     const genKey = `${containerPath}\\shell\\${SUBCMDS.generate}`;
     regAdd(genKey, 'MUIVerb', 'REG_SZ', '📄 作为模板，生成邮件 HTML');
     regAdd(genKey, 'Icon', 'REG_SZ', iconPath);
     regAdd(`${genKey}\\command`, '', 'REG_SZ', `"${nodePath}" "${scriptPath}" -f %1`);
 
-    // HTML：作为片段拼接
     const snipKey = `${containerPath}\\shell\\${SUBCMDS.snippet}`;
     regAdd(snipKey, 'MUIVerb', 'REG_SZ', '🧩 作为片段，拼接邮件 HTML');
     regAdd(snipKey, 'Icon', 'REG_SZ', iconPath);
     regAdd(`${snipKey}\\command`, '', 'REG_SZ', wrapInteractive(nodePath, scriptPath, '-s %1'));
-  } else {
-    // YAML：作为配置拼接
+
+    regResourceCmds(`Set-Location (Split-Path '%1'); `);
+
+    if (pwshPath) {
+      const pwshKey = `${containerPath}\\shell\\${SUBCMDS.pwsh}`;
+      regAdd(pwshKey, 'MUIVerb', 'REG_SZ', '📂 打开 PowerShell');
+      regAdd(pwshKey, 'Icon', 'REG_SZ', pwshPath);
+      regAdd(`${pwshKey}\\command`, '', 'REG_SZ',
+        `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath (Split-Path '%1')"`);
+    }
+  } else if (kind === 'yaml') {
     const cfgKey = `${containerPath}\\shell\\${SUBCMDS.config}`;
     regAdd(cfgKey, 'MUIVerb', 'REG_SZ', '⚙️ 作为配置，拼接邮件 HTML');
     regAdd(cfgKey, 'Icon', 'REG_SZ', 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', wrapWithPause(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}`;
-    regAdd(pwshKey, 'MUIVerb', 'REG_SZ', '📂 打开 PowerShell');
-    regAdd(pwshKey, 'Icon', 'REG_SZ', pwshPath);
-    regAdd(`${pwshKey}\\command`, '', 'REG_SZ',
-      `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath (Split-Path '%1')"`);
-  }
-}
 
-// ─── 非交互命令包装（始终暂停以便用户查看输出）─────────────────────────────────
+    regResourceCmds(`Set-Location (Split-Path '%1'); `);
 
-function wrapWithPause(nodePath, scriptPath, cliArgs) {
-  const node = nodePath.replace(/'/g, "''");
-  const script = scriptPath.replace(/'/g, "''");
-  const ps = [
-    `& '${node}' '${script}' ${cliArgs}`,
-    `Write-Host ''`,
-    `Read-Host 'Press Enter to close'`,
-  ].join('; ');
-  return `powershell.exe -Command "${ps}"`;
-}
-
-// ─── Directory / Background 菜单注册 ──────────────────────────────────────────
-
-/**
- * Register individual shell commands for Directory and Directory\Background.
- * ExtendedSubCommandsKey doesn't work reliably for non-file-type associations,
- * so we register each item as a standalone shell verb.
- */
-function registerDirBgMenus(nodePath, scriptPath, iconPath, pwshPath) {
-  const roots = [
-    `${HKCU_SHELL}\\Directory\\shell`,
-    `${HKCU_SHELL}\\Directory\\Background\\shell`,
-  ];
-
-  // First, clean up old keys from all previous versions to prevent stale entries
-  for (const root of roots) {
-    // Old parent key (ExtendedSubCommandsKey approach, v2.x commit 3fc761e)
-    regDelete(`${root}\\${PARENT_KEY_NAME}`);
-    // Old individual entries from any prior version
-    regDelete(`${root}\\JuiceEmail.Init`);
-    regDelete(`${root}\\JuiceEmail.View`);
-    regDelete(`${root}\\JuiceEmail.Browse`);
-    regDelete(`${root}\\JuiceEmail.Pwsh`);
-  }
+    if (pwshPath) {
+      const pwshKey = `${containerPath}\\shell\\${SUBCMDS.pwsh}`;
+      regAdd(pwshKey, 'MUIVerb', 'REG_SZ', '📂 打开 PowerShell');
+      regAdd(pwshKey, 'Icon', 'REG_SZ', pwshPath);
+      regAdd(`${pwshKey}\\command`, '', 'REG_SZ',
+        `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath (Split-Path '%1')"`);
+    }
+  } else if (kind === 'dir' || kind === 'bg') {
+    // Directory / Background: cd to the target directory first
+    const dirRef = kind === 'dir' ? '%1' : '%V';
+    const cd = `Set-Location '${dirRef}'; `;
+
+    // 📋 查看可用资源
+    const vKey = `${containerPath}\\shell\\JuiceEmail.ViewRes`;
+    regAdd(vKey, 'MUIVerb', 'REG_SZ', '📋 查看可用资源');
+    regAdd(vKey, 'Icon', 'REG_SZ', iconPath);
+    const vPs = `${cd}& '${node}' '${script}' view; Write-Host ''; Read-Host 'Press Enter to close'`;
+    regAdd(`${vKey}\\command`, '', 'REG_SZ', `powershell.exe -Command "${vPs}"`);
+
+    // 📦 拷贝全部资源
+    const aKey = `${containerPath}\\shell\\JuiceEmail.CopyAll`;
+    regAdd(aKey, 'MUIVerb', 'REG_SZ', '📦 拷贝全部资源');
+    regAdd(aKey, 'Icon', 'REG_SZ', iconPath);
+    const aPs = `${cd}& '${node}' '${script}' init --all .; Write-Host ''; Read-Host 'Press Enter to close'`;
+    regAdd(`${aKey}\\command`, '', 'REG_SZ', `powershell.exe -Command "${aPs}"`);
+
+    // 📥 选择资源拷贝
+    const pKey = `${containerPath}\\shell\\JuiceEmail.CopyPick`;
+    regAdd(pKey, 'MUIVerb', 'REG_SZ', '📥 选择资源拷贝');
+    regAdd(pKey, 'Icon', 'REG_SZ', iconPath);
+    const pPs = `${cd}& '${node}' '${script}' init; Write-Host ''; Read-Host 'Press Enter to close'`;
+    regAdd(`${pKey}\\command`, '', 'REG_SZ', `powershell.exe -Command "${pPs}"`);
 
-  for (const root of roots) {
-    // 📥 从资源库拷贝到此处
-    const initKey = `${root}\\JuiceEmail.Init`;
-    regAdd(initKey, 'MUIVerb', 'REG_SZ', '📥 从资源库拷贝到此处');
-    regAdd(initKey, 'Icon', 'REG_SZ', iconPath);
-    regAdd(`${initKey}\\command`, '', 'REG_SZ', wrapInteractive(nodePath, scriptPath, 'init'));
-
-    // 📦 查看资源列表
-    const viewKey = `${root}\\JuiceEmail.View`;
-    regAdd(viewKey, 'MUIVerb', 'REG_SZ', '📦 查看资源列表');
-    regAdd(viewKey, 'Icon', 'REG_SZ', iconPath);
-    regAdd(`${viewKey}\\command`, '', 'REG_SZ', wrapWithPause(nodePath, scriptPath, 'view'));
-
-    // 📋 浏览资源库
-    const browseKey = `${root}\\JuiceEmail.Browse`;
-    regAdd(browseKey, 'MUIVerb', 'REG_SZ', '📋 浏览资源库');
-    regAdd(browseKey, 'Icon', 'REG_SZ', iconPath);
-    regAdd(`${browseKey}\\command`, '', 'REG_SZ', wrapInteractive(nodePath, scriptPath, 'view -i'));
-
-    // 📂 在此打开终端
     if (pwshPath) {
-      const pwshKey = `${root}\\JuiceEmail.Pwsh`;
+      const pwshKey = `${containerPath}\\shell\\JuiceEmail.Pwsh`;
       regAdd(pwshKey, 'MUIVerb', 'REG_SZ', '📂 在此打开终端');
       regAdd(pwshKey, 'Icon', 'REG_SZ', pwshPath);
       regAdd(`${pwshKey}\\command`, '', 'REG_SZ',
-        `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath '%V'"`);
+        `"${pwshPath}" -NoExit -Command "Set-Location -LiteralPath '${dirRef}'"`);
     }
   }
 }
@@ -323,7 +312,7 @@ async function registerContextMenu() {
 
   console.log(chalk.cyan('\n  注册 juice 右键菜单（当前用户，无需管理员权限）...\n'));
 
-  // 清理所有旧版残留，避免新旧方案冲突
+  // 清理所有旧版残留
   cleanLegacyHklmParents();
   cleanLegacyCommandStore();
 
@@ -334,22 +323,27 @@ 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}`);
+  // Clean up old individual Dir/Bg entries from v2.3.x
+  for (const root of [`${HKCU_SHELL}\\Directory\\shell`, `${HKCU_SHELL}\\Directory\\Background\\shell`]) {
+    regDelete(`${root}\\${PARENT_KEY_NAME}`);
+    for (const suffix of ['Init', 'View', 'Browse', 'Pwsh']) {
+      regDelete(`${root}\\JuiceEmail.${suffix}`);
+    }
+  }
 
-  // HTML 容器：generate + snippet + pwsh
+  // HTML 容器
   console.log(chalk.gray('  注册 .html 文件菜单...'));
-  const htmlContainer = `${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_HTML}`;
-  registerSubCommands(htmlContainer, 'html', nodePath, scriptPath, iconPath, pwshPath);
+  registerSubCommands(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_HTML}`, 'html', nodePath, scriptPath, iconPath, pwshPath);
 
-  // YAML 容器：config + pwsh
+  // YAML 容器
   console.log(chalk.gray('  注册 .yaml 文件菜单...'));
-  const yamlContainer = `${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_YAML}`;
-  registerSubCommands(yamlContainer, 'yaml', nodePath, scriptPath, iconPath, pwshPath);
+  registerSubCommands(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_YAML}`, 'yaml', nodePath, scriptPath, iconPath, pwshPath);
 
   // .html / .htm → 引用 HTML 容器
   for (const root of HTML_ROOTS) {
@@ -367,9 +361,22 @@ async function registerContextMenu() {
     regAdd(parentKey, 'ExtendedSubCommandsKey', 'REG_SZ', SUB_CMDS_CONTAINER_YAML);
   }
 
-  // Directory / Background → 独立容器
+  // Directory / Background → 各自独立容器
   console.log(chalk.gray('  注册文件夹/空白处菜单...'));
-  registerDirBgMenus(nodePath, scriptPath, iconPath, pwshPath);
+  registerSubCommands(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_DIR}`, 'dir', nodePath, scriptPath, iconPath, pwshPath);
+  registerSubCommands(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_BG}`, 'bg', nodePath, scriptPath, iconPath, pwshPath);
+
+  // Directory → 引用 Dir 容器
+  const dirParent = `${HKCU_SHELL}\\Directory\\shell\\${PARENT_KEY_NAME}`;
+  ok = regAdd(dirParent, 'MUIVerb', 'REG_SZ', '📧 用 juice 生成邮件 HTML') && ok;
+  regAdd(dirParent, 'Icon', 'REG_SZ', iconPath);
+  regAdd(dirParent, 'ExtendedSubCommandsKey', 'REG_SZ', SUB_CMDS_CONTAINER_DIR);
+
+  // Directory\Background → 引用 Bg 容器
+  const bgParent = `${HKCU_SHELL}\\Directory\\Background\\shell\\${PARENT_KEY_NAME}`;
+  ok = regAdd(bgParent, 'MUIVerb', 'REG_SZ', '📧 用 juice 生成邮件 HTML') && ok;
+  regAdd(bgParent, 'Icon', 'REG_SZ', iconPath);
+  regAdd(bgParent, 'ExtendedSubCommandsKey', 'REG_SZ', SUB_CMDS_CONTAINER_BG);
 
   if (!ok) {
     console.log(chalk.yellow('  ⚠  部分注册表项写入失败，右键菜单可能不完整。\n'));
@@ -382,20 +389,23 @@ async function registerContextMenu() {
     `    ${chalk.bold('📧 用 juice 生成邮件 HTML')}\n` +
     `      ├── 📄 作为模板，生成邮件 HTML  →  juice -f（后台执行）\n` +
     `      ├── 🧩 作为片段，拼接邮件 HTML  →  juice -s（交互选择模板）\n` +
-    `      ├── 📦 查看资源列表              →  juice view\n` +
-    `      ├── 📋 浏览资源库                →  juice view -i\n` +
+    `      ├── 📋 查看可用资源              →  juice view\n` +
+    `      ├── 📦 拷贝全部资源              →  juice init --all\n` +
+    `      ├── 📥 选择资源拷贝              →  juice init\n` +
     (pwshPath ? `      └── 📂 打开 PowerShell\n` : '') +
     `\n  ${chalk.bold('.yaml / .yml')} 文件右键：\n` +
     `    ${chalk.bold('📧 用 juice 生成邮件 HTML')}\n` +
     `      ├── ⚙️ 作为配置，拼接邮件 HTML  →  juice -c（交互选择品牌/模板/片段）\n` +
-    `      ├── 📦 查看资源列表              →  juice view\n` +
-    `      ├── 📋 浏览资源库                →  juice view -i\n` +
+    `      ├── 📋 查看可用资源\n` +
+    `      ├── 📦 拷贝全部资源\n` +
+    `      ├── 📥 选择资源拷贝\n` +
     (pwshPath ? `      └── 📂 打开 PowerShell\n` : '') +
     `\n  ${chalk.bold('文件夹 / 空白处')} 右键：\n` +
-    `      📥 从资源库拷贝到此处         →  juice init\n` +
-    `      📦 查看资源列表              →  juice view\n` +
-    `      📋 浏览资源库                →  juice view -i\n` +
-    (pwshPath ? `      📂 在此打开终端\n` : '') +
+    `    ${chalk.bold('📧 用 juice 生成邮件 HTML')}\n` +
+    `      ├── 📋 查看可用资源\n` +
+    `      ├── 📦 拷贝全部资源\n` +
+    `      ├── 📥 选择资源拷贝\n` +
+    (pwshPath ? `      └── 📂 在此打开终端\n` : '') +
     '\n' +
     chalk.gray('  注意：如菜单未出现，请重启文件资源管理器（explorer.exe）。\n')
   );
@@ -413,40 +423,32 @@ async function unregisterContextMenu() {
 
   let removed = 0;
 
-  // 清理 HKCU 父菜单（文件类型）
+  // 清理文件类型父菜单
   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++;
   }
 
-  // 清理 Directory / Background 独立菜单项 + 旧版父键
-  const dirBgRoots = [
-    `${HKCU_SHELL}\\Directory\\shell`,
-    `${HKCU_SHELL}\\Directory\\Background\\shell`,
-  ];
-  const dirBgKeys = ['JuiceEmail.Init', 'JuiceEmail.View', 'JuiceEmail.Browse', 'JuiceEmail.Pwsh',
-                      PARENT_KEY_NAME];  // PARENT_KEY_NAME = 'JuiceEmail' (old ExtendedSubCommandsKey parent)
-  for (const root of dirBgRoots) {
-    for (const key of dirBgKeys) {
-      if (regDelete(`${root}\\${key}`)) removed++;
+  // 清理旧版 Dir/Bg 独立条目 (v2.3.x individual entries)
+  for (const root of [`${HKCU_SHELL}\\Directory\\shell`, `${HKCU_SHELL}\\Directory\\Background\\shell`]) {
+    for (const suffix of ['Init', 'View', 'Browse', 'Pwsh']) {
+      if (regDelete(`${root}\\JuiceEmail.${suffix}`)) removed++;
     }
   }
 
-  // 清理所有子命令容器（含旧版 Dir/Bg 容器）
-  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++;
-  if (regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_DIR}`)) removed++;
-  if (regDelete(`${HKCU_SHELL}\\${SUB_CMDS_CONTAINER_BG}`)) removed++;
-
-  // 清理旧版共享容器（v2.1.14 之前只有一个容器）
+  // 清理所有容器（含旧版残留）
+  for (const container of [SUB_CMDS_CONTAINER_HTML, SUB_CMDS_CONTAINER_YAML, SUB_CMDS_CONTAINER_DIR, SUB_CMDS_CONTAINER_BG]) {
+    if (regDelete(`${HKCU_SHELL}\\${container}`)) removed++;
+  }
+  // 旧版共享容器 (v2.1.14)
   regDelete(`${HKCU_SHELL}\\JuiceEmail.SubCommands`);
 
-  // 清理旧版残留（HKLM 父菜单 + CommandStore）
+  // 旧版残留（HKLM 父菜单 + CommandStore）
   cleanLegacyHklmParents();
   cleanLegacyCommandStore();
 

package/src/init.js

@@ -71,8 +71,7 @@ function deriveDefaultName(filePath) {
 async function directCopy(srcPath, cwd) {
   const resolved = path.resolve(srcPath);
   if (!fs.existsSync(resolved)) {
-    console.error(chalk.red(`\n  ✘ 文件不存在：${resolved}\n`));
-    process.exit(1);
+    throw new Error(`文件不存在：${resolved}`);
   }
 
   const destName = await promptOutputName(
@@ -231,9 +230,110 @@ async function interactiveInit(edmDir, cwd) {
 
 // ─── Main Entry ──────────────────────────────────────────────────────────────
 
-async function runInitMode({ initPath, template, snippet, config }) {
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function dirSize(dir) {
+  let size = 0;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const p = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      size += dirSize(p);
+    } else {
+      size += fs.statSync(p).size;
+    }
+  }
+  return size;
+}
+
+function countFiles(dir) {
+  let count = 0;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    if (entry.isDirectory()) {
+      count += countFiles(path.join(dir, entry.name));
+    } else {
+      count++;
+    }
+  }
+  return count;
+}
+
+function findNextEdmVersion(targetDir) {
+  let v = 1;
+  while (true) {
+    const candidate = path.join(targetDir, 'edm-v' + v);
+    if (!fs.existsSync(candidate)) return candidate;
+    v++;
+  }
+}
+
+async function runInitMode({ initPath, template, snippet, config, all }) {
   const cwd = process.cwd();
 
+  // --all: copy entire EDM directory
+  if (all) {
+    let edmDir;
+    try {
+      edmDir = resolveEdmDir();
+    } catch (err) {
+      console.error(chalk.red(`\n  ✘ ${err.message}\n`));
+      process.exit(1);
+    }
+    const target = all === true ? cwd : path.resolve(all);
+    const destDir = path.join(target, 'edm');
+
+    // Prevent deleting the source when target overlaps
+    if (path.resolve(edmDir) === path.resolve(destDir)) {
+      console.log(chalk.yellow('目标目录与 EDM 资源库相同，无需拷贝。\n'));
+      return;
+    }
+    console.log(chalk.cyan(`\n  拷贝 EDM 资源库...`));
+    console.log(chalk.gray(`  源：${edmDir}`));
+    console.log(chalk.gray(`  目标：${destDir}`));
+
+    if (fs.existsSync(destDir)) {
+      const { select } = await import('@inquirer/prompts');
+      const vName = findNextEdmVersion(target);
+      const action = await select({
+        message: `目录 ${destDir} 已存在：`,
+        choices: [
+          { name: '覆盖', value: 'overwrite' },
+          { name: `自动版本号（${path.basename(vName)}）`, value: 'version' },
+          { name: '取消', value: 'cancel' },
+        ],
+      });
+      if (action === 'cancel') {
+        console.log(chalk.gray('已取消。\n'));
+        return;
+      }
+      if (action === 'version') {
+        copyDir(edmDir, vName);
+        const edmSize = dirSize(vName);
+        const fileCount = countFiles(vName);
+        console.log(chalk.green(`\n✔ 已拷贝 EDM 资源库 → ${path.basename(vName)}（${fileCount} 个文件，${fmtBytes(edmSize)}）\n`));
+        return;
+      }
+      // overwrite: remove and replace
+      fs.rmSync(destDir, { recursive: true, force: true });
+    }
+
+    copyDir(edmDir, destDir);
+    const edmSize = dirSize(destDir);
+    const fileCount = countFiles(destDir);
+    console.log(chalk.green(`\n✔ 已拷贝 EDM 资源库（${fileCount} 个文件，${fmtBytes(edmSize)}）\n`));
+    return;
+  }
+
   // Direct copy modes
   if (template) {
     await directCopy(template, cwd);

package/src/view.js

@@ -12,6 +12,27 @@ function fmtBytes(b) {
   return b < 1024 ? `${b} B` : `${(b / 1024).toFixed(1)} KB`;
 }
 
+/**
+ * Copy src to dest, auto-versioning (-v1, -v2, ...) if dest exists.
+ * Returns the actual destination path used.
+ */
+function copyFileSafe(srcPath, destPath) {
+  if (!fs.existsSync(destPath)) {
+    fs.copyFileSync(srcPath, destPath);
+    return destPath;
+  }
+  const parsed = path.parse(destPath);
+  let v = 1;
+  while (true) {
+    const alt = path.join(parsed.dir, parsed.name + '-v' + v + parsed.ext);
+    if (!fs.existsSync(alt)) {
+      fs.copyFileSync(srcPath, alt);
+      return alt;
+    }
+    v++;
+  }
+}
+
 // ─── Path Parser ──────────────────────────────────────────────────────────────
 
 /**
@@ -327,13 +348,17 @@ async function showCheckbox(title, choices) {
  * Trigger copy via the init module.
  */
 async function copyResource(type, resourcePath, cwd) {
-  const { runInitMode } = require('./init');
-  if (type === 'template') {
-    await runInitMode({ template: resourcePath });
-  } else if (type === 'snippet') {
-    await runInitMode({ snippet: resourcePath });
-  } else if (type === 'config') {
-    await runInitMode({ config: resourcePath });
+  try {
+    const { runInitMode } = require('./init');
+    if (type === 'template') {
+      await runInitMode({ template: resourcePath });
+    } else if (type === 'snippet') {
+      await runInitMode({ snippet: resourcePath });
+    } else if (type === 'config') {
+      await runInitMode({ config: resourcePath });
+    }
+  } catch (err) {
+    console.error(chalk.red(`  ✘ 拷贝失败：${err.message}`));
   }
 }
 
@@ -551,7 +576,7 @@ async function interactiveBrowse(edmDir, startParsed) {
       if (versions.length > 0) {
         const tplPath = versions[0].templatePath;
         copyItems.push({
-          name: '📋 模板 HTML',
+          name: `📋 模板 HTML（${versions[0].meta.name || versions[0].name}）`,
           value: 'template',
           description: path.basename(tplPath),
           checked: true,
@@ -588,7 +613,9 @@ async function interactiveBrowse(edmDir, startParsed) {
         });
 
         if (selected.length > 0) {
-          const defaultBaseName = `${current.brand}-${current.series}-${current.variant}`;
+          // Include template version in default name for clarity
+          const versionName = versions.length > 0 ? versions[0].name : 'template';
+          const defaultBaseName = `${current.brand}-${versionName}-${current.series}-${current.variant}`;
           const { promptOutputName: pn } = require('./snippet');
           const outputBaseName = await pn(defaultBaseName, process.cwd());
           const cwd = process.cwd();
@@ -596,28 +623,22 @@ async function interactiveBrowse(edmDir, startParsed) {
 
           console.log(chalk.green('\n✔ 已拷贝：'));
           if (selected.includes('template') && versions.length > 0) {
-            const tplPath = versions[0].templatePath;
-            const dest = path.join(cwd, outputBaseName + path.extname(tplPath));
-            fs.copyFileSync(tplPath, dest);
-            console.log(`   ${chalk.cyan('·')} ${cwdRel(dest)}  ${chalk.gray('(模板, ' + fmtBytes(fs.statSync(dest).size) + ')')}`);
+            const src = versions[0].templatePath;
+            const dest = path.join(cwd, outputBaseName + path.extname(src));
+            const actual = copyFileSafe(src, dest);
+            console.log(`   ${chalk.cyan('·')} ${cwdRel(actual)}  ${chalk.gray('(模板, ' + fmtBytes(fs.statSync(actual).size) + ')')}`);
           }
           if (selected.includes('snippet') && fs.existsSync(snipPath)) {
             const dest = path.join(cwd, outputBaseName + '-snippet' + path.extname(snipPath));
-            fs.copyFileSync(snipPath, dest);
-            console.log(`   ${chalk.cyan('·')} ${cwdRel(dest)}  ${chalk.gray('(片段, ' + fmtBytes(fs.statSync(dest).size) + ')')}`);
+            const actual = copyFileSafe(snipPath, dest);
+            console.log(`   ${chalk.cyan('·')} ${cwdRel(actual)}  ${chalk.gray('(片段, ' + fmtBytes(fs.statSync(actual).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 = path.join(cwd, 'juice.yaml');
-            if (fs.existsSync(dest)) {
-              const alt = path.join(cwd, 'juice-v1.yaml');
-              fs.copyFileSync(cfgPath, alt);
-              console.log(`   ${chalk.cyan('·')} ${cwdRel(alt)}  ${chalk.gray('(配置, ' + fmtBytes(fs.statSync(alt).size) + ')')}`);
-            } else {
-              fs.copyFileSync(cfgPath, dest);
-              console.log(`   ${chalk.cyan('·')} ${cwdRel(dest)}  ${chalk.gray('(配置, ' + fmtBytes(fs.statSync(dest).size) + ')')}`);
-            }
+            const actual = copyFileSafe(cfgPath, dest);
+            console.log(`   ${chalk.cyan('·')} ${cwdRel(actual)}  ${chalk.gray('(配置, ' + fmtBytes(fs.statSync(actual).size) + ')')}`);
           }
           console.log();
         }