juice-email-cli 2.0.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,339 @@
+# juice-email-cli
+
+> 一个用于生成符合各大邮件平台标准的 HTML 邮件命令行工具，基于 [juice](https://github.com/Automattic/juice) 实现 CSS 内联，支持 Mustache 模板变量替换，同时输出标准版与压缩版两份文件。
+
+---
+
+## 功能特性
+
+- ✅ **CSS 内联** —— 将 `<style>` 中的样式全部内联为 `style=""` 属性，兼容 Gmail / Outlook / Apple Mail 等
+- ✅ **Mustache 模板变量** —— 支持 `{{变量名}}` 语法，通过配置文件批量替换
+- ✅ **Mustache 列表循环** —— 支持 `{{#items}}...{{/items}}` 遍历数组，支持嵌套循环
+- ✅ **三层配置合并** —— CLI 默认 < 用户目录 < 优先配置，三者层层合并
+- ✅ **双文件输出** —— 同时生成标准版 `.output.html` 和压缩版 `.minified.html`
+- ✅ **响应式保留** —— `@media`、`@font-face`、`@keyframes` 均不丢失
+- ✅ **Windows 右键菜单（自定义图标）** —— 子菜单层级，一键注册/卸载，支持自定义图标
+
+---
+
+## 安装
+
+```bash
+# 全局安装
+npm install -g juice-email-cli
+
+# 安装时自动注册 Windows 右键菜单（无管理员权限时静默跳过）
+```
+
+> **提示**：安装时如未注册右键菜单，安装完成后以**管理员身份**运行：
+> ```bash
+> juice --install
+> ```
+
+```bash
+# 本地克隆安装
+git clone https://github.com/GuoSirius/juice-cli.git
+cd juice-cli
+npm install       # 自动注册右键菜单
+npm link          # 链接到全局
+```
+
+---
+
+## 使用方法
+
+```bash
+# 最简用法（自动查找配置文件）
+juice -f my-email.html
+
+# 指定配置文件
+juice -c project.yaml -f my-email.html
+```
+
+生成两个文件（与输入文件同目录）：
+
+| 文件 | 说明 |
+|------|------|
+| `my-email.output.html` | CSS 内联 + 变量替换标准版 |
+| `my-email.minified.html` | 在标准版基础上压缩的精简版 |
+
+### 参数说明
+
+| 参数 | 简写 | 说明 |
+|------|------|------|
+| `--file <path>` | `-f` | 输入 HTML 模板文件路径（必填） |
+| `--config <path>` | `-c` | 配置文件路径，不指定时自动查找输入文件同级目录 |
+| `--install` | | 注册 Windows 右键菜单（需管理员权限） |
+| `--uninstall` | | 取消 Windows 右键菜单注册（需管理员权限） |
+| `--version` | `-v` | 查看版本号 |
+| `--help` | `-h` | 查看帮助 |
+
+---
+
+## 配置文件优先级
+
+```
+优先级 低 ──────────────────────────────────────────────── 高
+
+  CLI 内置默认值  <  用户主目录 ~/juice.yaml  <  优先配置（互斥）
+```
+
+**优先配置（-c 和输入文件同级目录互斥，只生效一个）：**
+
+| 来源 | 说明 |
+|------|------|
+| `-c <path>` | 命令行指定，最优先 |
+| 输入文件同目录 `juice.yaml` | 随模板文件走，适合项目级配置 |
+
+**合并规则：**
+- 用户主目录配置（如果存在）**始终参与合并**
+- 优先配置覆盖用户主目录配置中的同名字段
+- CLI 内置默认值兜底所有未配置字段
+
+**示例：**
+
+```bash
+# 指定配置文件（与用户目录合并）
+juice -c project.yaml -f email.html
+
+# 使用输入文件同级目录配置（与用户目录合并）
+# → email.html 同目录下有 juice.yaml
+juice -f email.html
+
+# 无优先配置时，仅使用用户目录配置
+juice -f email.html
+```
+
+---
+
+## 配置文件示例
+
+用户配置文件（`~/juice.yaml` 或项目目录 `juice.yaml`）只需填写需要覆盖的字段，其余自动继承：
+
+```yaml
+variables:
+  brandName: "我的品牌"
+  brandColor: "#ff6600"
+  logoUrl: "https://cdn.example.com/logo.png"
+  ctaText: "立即订购"
+  ctaUrl: "https://example.com/buy"
+  companyName: "My Company"
+  currentYear: "2026"
+
+  # 列表数据示例
+  products:
+    - name: "产品 A"
+      price: "¥99.00"
+      tag: "热销"
+    - name: "产品 B"
+      price: "¥199.00"
+    - name: "产品 C"
+      price: "¥299.00"
+
+  features:
+    - title: "特性一"
+      items:
+        - "优势 A"
+        - "优势 B"
+    - title: "特性二"
+      items:
+        - "优势 C"
+        - "优势 D"
+
+# juice 选项（全部可选，均有内置默认值）
+# juice:
+#   removeStyleTags: true
+#   preserveMediaQueries: true
+#   preservePseudos: true           # 保留 hover 等伪类
+#   preservedSelectors:             # 保留的选择器（不会被内联）
+#     - "a:hover"
+#   extraCssFiles:
+#     - email-reset.css
+
+# 输出后缀（可选）
+# output:
+#   normalSuffix: ".output.html"
+#   minifiedSuffix: ".minified.html"
+```
+
+完整默认配置见 [`defaults/juice.yaml`](./defaults/juice.yaml)。
+
+---
+
+## 模板语法
+
+使用 [Mustache](https://mustache.github.io/) 语法：
+
+```html
+<h1>你好，{{recipientName}}！</h1>
+<a href="{{ctaUrl}}" style="background-color: {{brandColor}};">{{ctaText}}</a>
+```
+
+### Mustache 列表循环
+
+支持 `{{#items}}...{{/items}}` 语法遍历数组数据：
+
+```yaml
+# juice.yaml - 配置列表数据
+variables:
+  products:
+    - name: "产品 A"
+      price: "¥99.00"
+      tag: "热销"
+    - name: "产品 B"
+      price: "¥199.00"
+    - name: "产品 C"
+      price: "¥299.00"
+```
+
+```html
+<!-- HTML 模板 -->
+{{#products}}
+<div class="product-item">
+  <h3>{{name}}</h3>
+  <p class="price">{{price}}</p>
+  {{#tag}}<span class="tag">{{tag}}</span>{{/tag}}
+</div>
+{{/products}}
+
+<!-- 空列表备选内容 -->
+{{^products}}
+<p>暂无商品</p>
+{{/products}}
+
+<!-- 嵌套循环示例 -->
+{{#features}}
+<div class="feature-column">
+  <h4>{{title}}</h4>
+  <ul>
+    {{#items}}
+    <li>{{.}}</li>
+    {{/items}}
+  </ul>
+</div>
+{{/features}}
+```
+
+| 语法 | 说明 | 示例 |
+|------|------|------|
+| `{{#list}}{{/list}}` | 循环遍历 | `{{#products}}{{name}}{{/products}}` |
+| `{{^list}}{{/list}}` | 反向（空列表时显示） | `{{^products}}暂无{{/products}}` |
+| `{{.}}` | 当前元素 | `{{#.}}{{.}}{{/}}` |
+| `{{#var}}{{/var}}` | 条件渲染（仅当有值时显示） | `{{#tag}}{{tag}}{{/tag}}` |
+
+---
+
+## Windows 右键菜单（自定义图标）
+
+注册后，在 `.html` / `.htm` 文件上右键可看到级联子菜单（带自定义图标）：
+
+```
+📧 用 juice 生成邮件 HTML
+  ├── ⚡ 生成邮件 HTML（标准 + 压缩）
+  └── 📂 在此目录打开 PowerShell 7   ← 仅在系统已安装 pwsh 时出现
+```
+
+```bash
+# 以管理员身份运行 PowerShell，然后：
+juice --install
+
+# 卸载：
+juice --uninstall
+```
+
+> **注意**：注册/卸载需要 **管理员权限**，请右键"以管理员身份运行"命令行。
+> 注册成功后如菜单未立即出现，重启文件资源管理器（`explorer.exe`）即可。
+
+> **图标说明**：自定义图标位于 `icons/juice-icon.ico`，支持 16x16 到 256x256 多种尺寸。
+
+---
+
+## 目录结构
+
+```
+juice-cli/
+├── bin/
+│   └── juice.js               # CLI 入口
+├── src/
+│   ├── index.js               # 核心逻辑（配置合并、模板处理、双输出）
+│   └── context-menu.js        # Windows 右键菜单注册（自定义图标）
+├── defaults/
+│   └── juice.yaml             # CLI 内置默认配置（最低优先级基准）
+├── examples/
+│   ├── juice.yaml             # 用户配置示例（含列表数据）
+│   ├── template.html           # HTML 邮件模板示例（含列表循环）
+│   └── *.css                   # 附加样式文件
+├── icons/
+│   └── juice-icon.ico          # 右键菜单自定义图标
+├── scripts/
+│   ├── generate-icon.js        # 图标生成脚本
+│   └── release.js              # 发布脚本
+├── .husky/
+│   └── commit-msg              # Git hooks - 提交信息校验
+├── .commitlintrc.json          # Commitlint 配置
+├── .versionrc                  # Standard-version 配置
+├── .npmrc                      # npm 发布配置
+├── CHANGELOG.md                # 变更日志（自动生成）
+├── LICENSE                     # MIT
+├── README.md
+└── package.json
+```
+
+---
+
+## 发布说明
+
+本项目使用自动化发布流程，包含以下功能：
+
+### 提交信息规范
+
+使用 [Conventional Commits](https://www.conventionalcommits.org/) 规范：
+
+```
+<type>(<scope>): <subject>
+
+feat: 添加新功能
+fix: 修复 bug
+docs: 更新文档
+style: 代码格式调整
+refactor: 重构代码
+perf: 性能优化
+test: 添加测试
+build: 构建系统变更
+ci: CI/CD 配置变更
+chore: 其他变更
+revert: 回退提交
+```
+
+### 自动化发布
+
+```bash
+# 执行一键发布（自动引导整个流程）
+npm run release
+
+# 预览发布（不实际执行）
+npm run release:dry
+```
+
+**发布流程：**
+1. 检测未提交的文件，询问是否提交
+2. 选择版本更新类型（Major / Minor / Patch）
+3. 确认版本号
+4. 自动更新版本号、生成 CHANGELOG、打 tag
+5. 推送到远程仓库
+6. 发布到 npm
+
+### 配置文件
+
+| 文件 | 说明 |
+|------|------|
+| `.commitlintrc.json` | 提交信息校验规则 |
+| `.versionrc` | 版本更新和 CHANGELOG 生成规则 |
+| `.npmrc` | npm 发布配置 |
+| `.husky/commit-msg` | Git hooks 配置 |
+
+---
+
+## License
+
+MIT

package/bin/juice.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+'use strict';
+
+const { program } = require('commander');
+const path = require('path');
+const pkg = require('../package.json');
+const { run } = require('../src/index');
+
+program
+  .name('juice')
+  .description('生成符合各大邮件平台的内联 CSS HTML 邮件（同时输出标准版 + 压缩版）')
+  .version(pkg.version, '-v, --version')
+  .option('-f, --file <path>', '输入 HTML 模板文件路径')
+  .option('-c, --config <path>', '配置文件路径（不指定时自动查找输入文件同级目录）')
+  .option('--install',   '注册 Windows 右键菜单（需管理员权限）')
+  .option('--uninstall', '取消 Windows 右键菜单注册（需管理员权限）')
+  .addHelpText('before', `
+╔════════════════════════════════════════════════════════════════╗
+║  juice-email-cli v${pkg.version}                                     ║
+║  HTML 邮件生成工具 - CSS 内联 + 模板变量 + 压缩                  ║
+╚════════════════════════════════════════════════════════════════╝
+`)
+  .addHelpText('after', `
+配置加载顺序（优先级从低到高）：
+  1. CLI 内置默认值（defaults/juice.yaml）
+  2. 用户主目录 ~/juice.yaml（如果存在）
+  3. 优先配置（-c 指定 或 输入文件同级目录，二者互斥）
+
+使用示例：
+  juice -f my-email.html
+  juice -c project.yaml -f emails/welcome.html
+  juice --install          （管理员权限，注册右键菜单）
+  juice --uninstall         （管理员权限，卸载右键菜单）
+
+输出文件（与输入文件同目录）：
+  <name>.output.html     CSS 内联 + 变量替换后的标准版
+  <name>.minified.html   在标准版基础上压缩的精简版
+
+更多信息：https://gitee.com/siriussupreme/juice-cli
+`)
+  .action(async (options) => {
+    // 注册/卸载右键菜单
+    if (options.install) {
+      const { registerContextMenu } = require('../src/context-menu');
+      await registerContextMenu();
+      return;
+    }
+    if (options.uninstall) {
+      const { unregisterContextMenu } = require('../src/context-menu');
+      await unregisterContextMenu();
+      return;
+    }
+
+    // 支持右键菜单直接传文件路径（位置参数）
+    let inputFile = options.file;
+    if (!inputFile && program.args.length > 0) {
+      inputFile = program.args[0];
+    }
+
+    if (!inputFile) {
+      program.help();
+      process.exit(1);
+    }
+
+    await run({
+      file: inputFile,
+      config: options.config,
+    });
+  });
+
+program.allowUnknownOption(false);
+program.parse(process.argv);

package/defaults/juice.yaml

@@ -0,0 +1,149 @@
+# juice-email-cli 内置默认配置
+#
+# 配置加载顺序（优先级从低到高）：
+#   1. CLI 内置默认值（defaults/juice.yaml）
+#   2. 用户主目录 ~/juice.yaml（如果存在）
+#   3. 优先配置文件（-c 指定 或 输入文件同级目录，二者互斥，只生效一个）
+#
+# 合并方式：深度合并，后面的覆盖前面的
+#
+# 用户配置文件（~/juice.yaml 或项目 juice.yaml）只需填写需要覆盖的字段即可。
+
+# ─── juice CSS 内联选项 ───────────────────────────────────────────────────────
+juice:
+  # 处理完成后移除 <style> 标签（推荐 true，提高 Gmail/Outlook 等邮件客户端兼容性）
+  # 设为 true 时，内联完成后会删除所有 <style> 标签（除非通过 preservedSelectors 保留特定选择器）
+  removeStyleTags: true
+
+  # 保留 @media 媒体查询到独立 <style> 块（响应式邮件必须开启）
+  preserveMediaQueries: true
+
+  # 保留 @font-face 声明（自定义字体支持）
+  preserveFontFaces: true
+
+  # 保留 @keyframes 动画（部分邮件客户端支持）
+  preserveKeyFrames: true
+
+  # 将 style 属性中的样式转换为 table 系列元素的 HTML 属性（align、bgcolor、valign 等）
+  # 开启后对 Outlook 2003-2019（使用 Word 渲染引擎）的兼容性更好
+  # 注意：仅对 <table>、<tr>、<td>、<th> 等表格元素生效
+  applyAttributesTableElements: true
+
+  # 是否处理 HTML 文档中的 <style> 标签（通常保持 true）
+  # 设为 true 时，<style> 标签内的 CSS 会被解析并内联到对应元素
+  # 设为 false 时，<style> 标签的 CSS 不会被处理（适用于已内联或使用外部 CSS 的场景）
+  applyStyleTags: true
+
+  # 保留 CSS 中的 !important 声明
+  preserveImportant: false
+
+  # 解析 CSS 变量（如 var(--brand-color)）并替换为具体值
+  # 设为 true 时，CSS 变量会被解析并内联到对应的 style 属性中
+  resolveCSSVariables: true
+
+  # 为 <img> 元素应用 width 属性（基于 CSS 样式中的宽度值）
+  # 设为 true 时，图片的 CSS 宽度会同时添加为 HTML width 属性
+  applyWidthAttributes: true
+
+  # 为 <img> 元素应用 height 属性（基于 CSS 样式中的高度值）
+  # 设为 true 时，图片的 CSS 高度会同时添加为 HTML height 属性
+  applyHeightAttributes: true
+
+  # 将 ::before 和 ::after 伪元素转换为 <span> 标签插入 DOM
+  # 设为 true 时，伪元素内容将作为可见的 DOM 元素呈现，而非仅保留样式
+  inlinePseudoElements: true
+
+  # 移除 <style> 标签时，是否保留伪类选择器规则（:hover、:active、:focus 等）
+  # 设为 true 时，juice.ignoredPseudos 中的伪类规则会保留在 <style> 标签内，其他样式正常内联
+  # 设为 false 时，所有伪类规则都会被移除
+  preservePseudos: true
+
+  # 保留的 CSS 选择器列表（支持子字符串匹配）
+  # 当 removeStyleTags 为 true 时，这些选择器的规则会保留在 <style> 标签内，不会被内联
+  #
+  # 用途：保留邮件客户端特定的样式（如 Gmail/Outlook 兼容性修复）
+  # 匹配方式：子字符串包含即匹配
+  # 示例：
+  #   - '.gmail-'    → 匹配 '.gmail-desktop'、'.gmail-mobile' 等 Gmail 相关样式
+  #   - '#outlook-'  → 匹配 '#outlook-wrapper'、'#outlook-footer' 等 Outlook 相关样式
+  #   - 'conditional' → 匹配包含 'conditional' 的选择器（如条件注释包裹的选择器）
+  #
+  # 注意：这是简化写法，实际由 juice 库的子字符串匹配逻辑处理
+  preservedSelectors:
+    - ".gmail-"
+    - "#outlook-"
+    - ":hover"
+
+  # 将保留的额外 CSS（媒体查询、@font-face、@keyframes）插入到文档的位置
+  # 仅当 preserveMediaQueries/preserveFontFaces/preserveKeyFrames 为 true 时生效
+  # - true: 自动选择位置（优先 <head>，其次 <body>，最后文档末尾）
+  # - CSS 选择器字符串: 插入到匹配元素的内部末尾，如 '#email-container'
+  insertPreservedExtraCss: true
+
+  # 额外附加的外部 CSS 文件（相对于 HTML 模板所在目录）
+  # extraCssFiles: []
+
+# ─── 模板变量（Mustache 语法：{{变量名}}）────────────────────────────────────
+variables:
+  brandName: ""
+  brandColor: "#0066cc"
+  logoUrl: ""
+  websiteUrl: ""
+  recipientName: "用户"
+  subject: ""
+  previewText: ""
+  ctaText: "立即查看"
+  ctaUrl: ""
+  companyName: ""
+  companyAddress: ""
+  unsubscribeUrl: ""
+  currentYear: "2026"
+
+# ─── 输出选项 ─────────────────────────────────────────────────────────────────
+output:
+  # 普通输出文件后缀
+  normalSuffix: ".output.html"
+  # 压缩输出文件后缀
+  minifiedSuffix: ".minified.html"
+  # 文件编码
+  encoding: "utf8"
+
+# ─── 压缩选项（html-minifier-terser）────────────────────────────────────────
+# ⚠️ 邮件 HTML 压缩注意事项：
+#   1. 必须保持 removeConditionalComments: false，保护 Outlook 条件注释
+#   2. 不要移除属性引号，确保兼容性
+#   3. 不要移除空属性，某些属性是必需的
+#   4. 不要移除空元素，Outlook 对此支持不佳
+minify:
+  # 折叠多余空白
+  collapseWhitespace: true
+
+  # 保守折叠：始终保留至少 1 个空格（避免单词连在一起）
+  conservativeCollapse: true
+
+  # 移除 HTML 注释（注意：不会移除条件注释）
+  removeComments: true
+
+  # 保留条件注释（不要改为 true，会删除 <!--[if mso]> 等 Outlook MSO 兼容代码）
+  removeConditionalComments: false
+
+  # 压缩内联 CSS（style 属性）
+  minifyCSS: true
+
+  # 压缩内联 JS（邮件中通常无 JS，保持 false）
+  minifyJS: false
+
+  # 移除空属性（设为 false 确保兼容性）
+  removeEmptyAttributes: false
+
+  # 规范化布尔属性（设为 false 确保兼容性）
+  collapseBooleanAttributes: false
+
+  # 移除冗余属性（当属性值与默认值相同时）
+  removeRedundantAttributes: true
+
+  # 使用短的 doctype
+  useShortDoctype: true
+
+  # 保留行尾换行（配合 collapseWhitespace 使用）
+  preserveLineBreaks: false

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "juice-email-cli",
+  "version": "2.0.5",
+  "description": "CLI tool to generate email-client-compatible HTML with juice (CSS inlining) + Mustache templating + minification",
+  "main": "src/index.js",
+  "bin": {
+    "juice": "bin/juice.js"
+  },
+  "scripts": {
+    "start": "node bin/juice.js",
+    "test": "node bin/juice.js --help",
+    "postinstall": "node bin/juice.js --install",
+    "preuninstall": "node bin/juice.js --uninstall",
+    "prepare": "husky install",
+    "release": "node scripts/release.mjs",
+    "release:dry": "standard-version --dry-run"
+  },
+  "keywords": [
+    "email",
+    "html",
+    "css-inline",
+    "juice",
+    "email-template",
+    "mustache",
+    "minify",
+    "html-email"
+  ],
+  "author": "",
+  "license": "MIT",
+  "homepage": "https://github.com/GuoSirius/juice-cli",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/GuoSirius/juice-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/GuoSirius/juice-cli/issues"
+  },
+  "dependencies": {
+    "commander": "^11.1.0",
+    "html-minifier-terser": "^7.2.0",
+    "js-yaml": "^4.1.0",
+    "juice": "^10.0.0",
+    "mustache": "^4.2.0",
+    "ora": "^5.4.1"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "defaults/",
+    "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

@@ -0,0 +1,182 @@
+'use strict';
+
+/**
+ * Windows 右键菜单注册 / 取消注册
+ *
+ * 风格参考 PowerShell 7 的右键菜单实现：
+ *   - 使用 MUIVerb（菜单显示文字）+ Icon 键
+ *   - 通过 ExtendedSubCommandsKey 实现子菜单（"用 juice 处理" → 子项）
+ *   - 注册到 SystemFileAssociations，兼容任意关联方式打开的 .html/.htm
+ *
+ * 菜单结构：
+ *   📧 用 juice 生成邮件 HTML
+ *     ├── ⚡ 生成（标准 + 压缩）
+ *     └── 📂 在此目录打开 PowerShell
+ *
+ * 需要以管理员权限运行。
+ */
+
+const { execSync } = require('child_process');
+const path = require('path');
+const chalk = require('chalk');
+
+// ─── 路径工具 ─────────────────────────────────────────────────────────────────
+
+function getNodePath() {
+  return process.execPath;
+}
+
+function getJuiceScript() {
+  return path.resolve(__dirname, '..', 'bin', 'juice.js');
+}
+
+function getIconPath() {
+  return path.resolve(__dirname, '..', 'icons', 'juice-icon.ico');
+}
+
+// ─── 注册表操作封装 ───────────────────────────────────────────────────────────
+
+/**
+ * 执行 reg add，失败时打印警告而不中断
+ */
+function regAdd(key, valueName, type, data) {
+  const vFlag = valueName === '' ? '/ve' : `/v "${valueName}"`;
+  const tFlag = type ? `/t ${type}` : '';
+  const dFlag = data !== undefined ? `/d "${escapeRegData(data)}"` : '';
+  const cmd = `reg add "${key}" ${vFlag} ${tFlag} ${dFlag} /f`.replace(/\s+/g, ' ').trim();
+  try {
+    execSync(cmd, { stdio: 'pipe' });
+  } catch (e) {
+    const msg = e.stderr ? e.stderr.toString().trim() : e.message;
+    console.warn(chalk.yellow(`  ⚠  reg add 失败（可能需要管理员权限）\n     键：${key}\n     原因：${msg}`));
+  }
+}
+
+/**
+ * 执行 reg delete，键不存在时静默忽略
+ */
+function regDelete(key) {
+  try {
+    execSync(`reg delete "${key}" /f`, { stdio: 'pipe' });
+  } catch (_) {}
+}
+
+/**
+ * 转义注册表数据中的特殊字符（反斜杠和双引号）
+ */
+function escapeRegData(str) {
+  // reg.exe 中反斜杠需要双写，双引号需要转义
+  return str.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+}
+
+// ─── 菜单结构常量 ─────────────────────────────────────────────────────────────
+
+// 根键：SystemFileAssociations 对 .html/.htm 通用
+const ROOTS = [
+  'HKEY_CLASSES_ROOT\\SystemFileAssociations\\.html\\shell',
+  'HKEY_CLASSES_ROOT\\SystemFileAssociations\\.htm\\shell',
+];
+
+// 父菜单键名（与 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'));
+
+  const nodePath = getNodePath();
+  const scriptPath = getJuiceScript();
+  const iconPath = getIconPath();
+
+  // 子命令 1：生成（标准 + 压缩）
+  const subCmd1 = `JuiceEmail.Generate`;
+  // 子命令 2：在此打开 PowerShell（可选便利项）
+  const subCmd2 = `JuiceEmail.OpenPwsh`;
+
+  // ── 注册子命令到 CommandStore ─────────────────────────────────────────────
+
+  // 子命令 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：在文件目录打开 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);
+  }
+
+  // ── 注册父菜单到 SystemFileAssociations ──────────────────────────────────
+
+  const subCommands = pwshPath ? `${subCmd1};${subCmd2}` : subCmd1;
+
+  for (const root of ROOTS) {
+    const parentKey = `${root}\\${PARENT_KEY_NAME}`;
+
+    // MUIVerb：菜单显示文字
+    regAdd(parentKey, 'MUIVerb', 'REG_SZ', '📧 用 juice 生成邮件 HTML');
+    // Icon：使用自定义图标
+    regAdd(parentKey, 'Icon', 'REG_SZ', iconPath);
+    // SubCommands：引用 CommandStore 中的子命令（分号分隔）
+    regAdd(parentKey, 'SubCommands', 'REG_SZ', subCommands);
+    // Extended：取消注释可让菜单仅在按住 Shift 时显示（默认不加）
+    // regAdd(parentKey, 'Extended', 'REG_SZ', '');
+  }
+
+  console.log(
+    '\n' +
+    chalk.green('  ✔ 右键菜单注册完成！') + '\n\n' +
+    `  在 ${chalk.cyan('.html')} / ${chalk.cyan('.htm')} 文件上右键即可看到：\n` +
+    `  ${chalk.bold('📧 用 juice 生成邮件 HTML')}\n` +
+    `    ├── ⚡ 生成邮件 HTML（标准 + 压缩）\n` +
+    (pwshPath ? `    └── 📂 在此目录打开 PowerShell 7\n` : '') +
+    '\n' +
+    chalk.gray('  注意：如菜单未出现，请重启文件资源管理器（explorer.exe）。\n') +
+    chalk.gray('  安装时自动注册失败？请以管理员身份重新运行：\n') +
+    chalk.cyan('    juice --register\n')
+  );
+}
+
+// ─── 取消注册 ─────────────────────────────────────────────────────────────────
+
+async function unregisterContextMenu() {
+  console.log(chalk.cyan('\n  取消注册 juice 右键菜单...\n'));
+
+  for (const root of ROOTS) {
+    regDelete(`${root}\\${PARENT_KEY_NAME}`);
+  }
+
+  regDelete(`${SUBCMD_SPACE}\\JuiceEmail.Generate`);
+  regDelete(`${SUBCMD_SPACE}\\JuiceEmail.OpenPwsh`);
+
+  console.log(chalk.green('  ✔ 右键菜单已移除。\n'));
+}
+
+// ─── 工具：查找 PowerShell 7 ─────────────────────────────────────────────────
+
+function resolvePwsh() {
+  const candidates = [
+    'C:\\Program Files\\PowerShell\\7\\pwsh.exe',
+    'C:\\Program Files (x86)\\PowerShell\\7\\pwsh.exe',
+    path.join(process.env['LOCALAPPDATA'] || '', 'Microsoft', 'PowerShell', 'pwsh.exe'),
+  ];
+  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;
+  } catch (_) {}
+  return null;
+}
+
+module.exports = { registerContextMenu, unregisterContextMenu };

package/src/index.js

@@ -0,0 +1,264 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const yaml = require('js-yaml');
+const juice = require('juice');
+const Mustache = require('mustache');
+const chalk = require('chalk');
+const ora = require('ora');
+const { minify: htmlMinify } = require('html-minifier-terser');
+
+// ─── 从 defaults/juice.yaml 加载默认配置 ─────────────────────────────────────
+
+const DEFAULT_CONFIG_PATH = path.resolve(__dirname, '..', 'defaults', 'juice.yaml');
+
+function loadDefaultConfig() {
+  try {
+    const content = fs.readFileSync(DEFAULT_CONFIG_PATH, 'utf8');
+    return yaml.load(content) || {};
+  } catch (e) {
+    // 如果 defaults/juice.yaml 不存在，使用内置最小配置
+    console.warn(chalk.yellow(`  ⚠  无法加载默认配置 ${DEFAULT_CONFIG_PATH}，使用内置默认值\n`));
+    return {};
+  }
+}
+
+const CODE_DEFAULTS = loadDefaultConfig();
+
+// 用户主目录候选（支持 yaml/yml）
+const HOME_CANDIDATES = [
+  path.join(os.homedir(), 'juice.yaml'),
+  path.join(os.homedir(), 'juice.yml'),
+];
+
+// ─── 配置文件查找 ─────────────────────────────────────────────────────────────
+
+/**
+ * 查找用户配置文件
+ *
+ * 配置加载顺序（优先级从低到高）：
+ *   1. CLI 内置默认值（defaults/juice.yaml）
+ *   2. 用户主目录 ~/juice.yaml（如果存在）
+ *   3. 优先配置文件（-c 指定 或 输入文件同级目录，二者互斥）
+ *
+ * 返回：
+ *   - highPriorityPath: 高优先级配置路径（-c 指定 或 输入文件同级目录，二者互斥）
+ *   - homePath: 用户主目录配置路径（可能不存在）
+ */
+function findConfigs(configPath, inputFile) {
+  let highPriorityPath = null;
+
+  // 1. 优先使用 -c 指定的配置文件
+  if (configPath) {
+    const resolved = path.resolve(configPath);
+    if (!fs.existsSync(resolved)) {
+      throw new Error(`指定的配置文件不存在：${resolved}`);
+    }
+    highPriorityPath = resolved;
+  }
+  // 2. 否则使用输入文件同级目录下的配置（互斥）
+  else if (inputFile) {
+    const inputDir = path.dirname(path.resolve(inputFile));
+    const fileCandidates = [
+      path.join(inputDir, 'juice.yaml'),
+      path.join(inputDir, 'juice.yml'),
+    ];
+    for (const c of fileCandidates) {
+      if (fs.existsSync(c)) {
+        highPriorityPath = c;
+        break;
+      }
+    }
+  }
+
+  return { highPriorityPath, homePath: HOME_CANDIDATES[0] };
+}
+
+// ─── 配置文件加载 ─────────────────────────────────────────────────────────────
+
+function loadYaml(filePath) {
+  if (!filePath || !fs.existsSync(filePath)) return {};
+  try {
+    return yaml.load(fs.readFileSync(filePath, 'utf8')) || {};
+  } catch (e) {
+    throw new Error(`配置文件解析失败（${filePath}）：${e.message}`);
+  }
+}
+
+/**
+ * 深度合并（后面的覆盖前面的），仅对普通对象递归，数组/基本类型直接覆盖
+ */
+function deepMerge(base, ...overrides) {
+  let result = Object.assign({}, base);
+  for (const src of overrides) {
+    if (!src || typeof src !== 'object' || Array.isArray(src)) continue;
+    for (const key of Object.keys(src)) {
+      const sv = src[key];
+      const rv = result[key];
+      if (
+        sv !== null &&
+        typeof sv === 'object' &&
+        !Array.isArray(sv) &&
+        rv !== null &&
+        typeof rv === 'object' &&
+        !Array.isArray(rv)
+      ) {
+        result[key] = deepMerge(rv, sv);
+      } else {
+        result[key] = sv;
+      }
+    }
+  }
+  return result;
+}
+
+/**
+ * 配置合并，返回最终生效配置
+ *
+ * 合并顺序（优先级从低到高）：
+ *   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) {
+    layers.push({ label: `用户目录配置 (${homePath})`, data: loadYaml(homePath) });
+  }
+
+  // 3. 优先配置（最高优先级，-c 指定 或 输入文件同级目录，互斥）
+  if (highPriorityPath) {
+    layers.push({ label: `优先配置 (${highPriorityPath})`, data: loadYaml(highPriorityPath) });
+  }
+
+  const config = deepMerge(...layers.map((l) => l.data));
+  return { config, layers };
+}
+
+// ─── HTML 模板处理 ────────────────────────────────────────────────────────────
+
+function processTemplate(inputFile, config) {
+  const htmlRaw = fs.readFileSync(inputFile, 'utf8');
+
+  // 1. Mustache 变量替换
+  const htmlWithVars = Mustache.render(htmlRaw, config.variables || {});
+
+  // 2. 收集 extraCssFiles
+  const basePath = path.dirname(path.resolve(inputFile));
+  const extraCss = collectExtraCss(basePath, config);
+
+  // 3. juice CSS 内联
+  const juiceOpts = Object.assign({}, config.juice || {});
+  delete juiceOpts.extraCssFiles;
+
+  return juice(htmlWithVars, { ...juiceOpts, extraCss });
+}
+
+function collectExtraCss(basePath, config) {
+  const extraFiles = (config.juice && config.juice.extraCssFiles) || [];
+  if (!extraFiles.length) return '';
+  return extraFiles
+    .map((f) => {
+      const full = path.isAbsolute(f) ? f : path.join(basePath, f);
+      if (!fs.existsSync(full)) {
+        process.stderr.write(chalk.yellow(`  ⚠  extraCssFiles 文件不存在，已跳过：${full}\n`));
+        return '';
+      }
+      return fs.readFileSync(full, 'utf8');
+    })
+    .join('\n');
+}
+
+// ─── 压缩 ─────────────────────────────────────────────────────────────────────
+
+async function minifyHtml(html, minifyConfig) {
+  return htmlMinify(html, {
+    removeConditionalComments: false,
+    ...(minifyConfig || {}),
+  });
+}
+
+// ─── 输出路径 ─────────────────────────────────────────────────────────────────
+
+function resolveOutputPaths(inputFile, config) {
+  const parsed = path.parse(path.resolve(inputFile));
+  const ns = (config.output && config.output.normalSuffix) || '.output.html';
+  const ms = (config.output && config.output.minifiedSuffix) || '.minified.html';
+  return {
+    normal: path.join(parsed.dir, parsed.name + ns),
+    minified: path.join(parsed.dir, parsed.name + ms),
+  };
+}
+
+// ─── 主入口 ───────────────────────────────────────────────────────────────────
+
+async function run({ file, config: configPath }) {
+  const spinner = ora({ text: '正在处理...', color: 'cyan' }).start();
+
+  try {
+    // 1. 输入文件
+    const inputFile = path.resolve(file);
+    if (!fs.existsSync(inputFile)) {
+      spinner.fail(chalk.red(`输入文件不存在：${inputFile}`));
+      process.exit(1);
+    }
+
+    // 2. 查找配置（-c 和输入文件同级目录互斥）+ 合并
+    const { highPriorityPath, homePath } = findConfigs(configPath, inputFile);
+    const { config, layers } = buildConfig(highPriorityPath, homePath);
+    const encoding = (config.output && config.output.encoding) || 'utf8';
+
+    // 3. CSS 内联
+    spinner.text = `CSS 内联处理：${path.basename(inputFile)}`;
+    const resultHtml = processTemplate(inputFile, config);
+
+    // 4. 输出路径
+    const outPaths = resolveOutputPaths(inputFile, config);
+
+    // 5. 写出标准版
+    spinner.text = '写出 .output.html ...';
+    fs.writeFileSync(outPaths.normal, resultHtml, encoding);
+
+    // 6. 压缩并写出
+    spinner.text = '写出 .minified.html ...';
+    const minified = await minifyHtml(resultHtml, config.minify);
+    fs.writeFileSync(outPaths.minified, minified, encoding);
+
+    // 7. 汇报
+    const layerLines = layers
+      .map((l) => `    ${chalk.gray('·')} ${l.label}`)
+      .join('\n');
+
+    spinner.succeed(
+      chalk.green('✔ 处理完成') + '\n' +
+      `  ${chalk.bold('输入：')}  ${chalk.cyan(inputFile)}\n` +
+      `  ${chalk.bold('配置层（低→高）：')}\n${layerLines}\n` +
+      `  ${chalk.bold('输出：')}\n` +
+      `    ${chalk.green('·')} 标准版  ${chalk.cyan(outPaths.normal)}  ${chalk.gray('(' + fmtSize(resultHtml) + ')')}\n` +
+      `    ${chalk.green('·')} 压缩版  ${chalk.cyan(outPaths.minified)}  ${chalk.gray('(' + fmtSize(minified) + '，节省 ' + savings(resultHtml, minified) + ')')}`
+    );
+  } catch (err) {
+    spinner.fail(chalk.red(`处理失败：${err.message}`));
+    if (process.env.DEBUG) console.error(err);
+    process.exit(1);
+  }
+}
+
+function fmtSize(str) {
+  const b = Buffer.byteLength(str, 'utf8');
+  return b < 1024 ? `${b} B` : `${(b / 1024).toFixed(1)} KB`;
+}
+
+function savings(original, minified) {
+  const orig = Buffer.byteLength(original, 'utf8');
+  const mini = Buffer.byteLength(minified, 'utf8');
+  return (((orig - mini) / orig) * 100).toFixed(1) + '%';
+}
+
+module.exports = { run, findConfigs, buildConfig, processTemplate };