@flun/mailer 2.1.24 → 2.1.25

package/CHANGELOG.md

@@ -1,4 +1,10 @@
 # 变更日志
+## [2.1.25] - 2026-10-25 08:24
+
+### 优化
+- 项目标点已改为以英文标点为主;
+- 行宽改为以 123 为主,部分超宽表格改为了列表;
+
 ## [2.1.24] - 2026-10-06 14:37
 ### 修复
 - 修复了" lib\mime-node\index.js" 中'key' 声明方式错误的问题;
@@ -7,8 +13,4 @@
 ## [2.1.23] - 2026-09-29 19:29
 ### 更改
 - 加固了拷贝文件的一些逻辑;
-- 升级了依赖;
-
-## [2.1.22] - 2026-07-22 21:48
-### 优化:
-- 对 'README.md' 中一些描述做了一些优化;
+- 升级了依赖;

package/LICENSE

@@ -1,3 +1,22 @@
+ISC 许可证 (ISC License)
+
+Copyright (c) 2026, flun <open@flun.top>
+
+特此免费授予任何获得本软件及相关文档文件("软件")副本的人,不受限制地处理本软件的权利,
+包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售本软件副本的权利,
+并允许向其提供本软件的人这样做,但须满足以下条件:
+
+上述版权声明和本许可声明应包含在本软件的所有副本或重要部分中;
+
+本软件按"原样"提供,不作任何形式的明示或暗示的保证,
+包括但不限于适销性、特定用途的适用性和不侵权的保证;
+在任何情况下,作者或版权持有人均不对因本软件或本软件的使用或其它交易而产生的
+任何索赔、损害或其它责任负责,无论是合同之诉、侵权之诉还是其它行为之诉;
+
+---
+
+英文原文 (English Version)
+
 ISC License
 
 Copyright (c) 2026, flun <open@flun.top>

package/Mail.js

@@ -13,7 +13,7 @@ const transporter = createTransport({
     // 步骤2:填写SMTP服务器的账号和密码
     auth: {
         user: 'your-email@example.com',       // 您的邮箱地址
-        pass: 'your-password-or-app-password' // 您的邮箱密码或授权码(Gmail需要应用专用密码，QQ邮箱需要授权码)
+        pass: 'your-password-or-app-password' // 您的邮箱密码或授权码(Gmail需要应用专用密码,QQ邮箱需要授权码)
     }
 });
 
@@ -23,7 +23,7 @@ transporter.sendMail({
     to: 'recipient@example.com',        // 收件人
     subject: '测试邮件',                 // 邮件主题
     text: '这是一封测试邮件(text)',       // 纯文本内容
-    html: '<b>这是一封测试邮件(html)</b>' // HTML内容（可选;注:html内容优先级高于纯文本内容)
+    html: '<b>这是一封测试邮件(html)</b>' // HTML内容(可选;注:html内容优先级高于纯文本内容)
 }, (error, info) => {
     if (error) console.error('发送失败:', error);
     else console.log('发送成功:', info.response);

package/README.md

@@ -1,7 +1,9 @@
 # @flun/mailer - 轻量级邮件发送库
 
 一个简单易用的 Node.js 邮件发送库,支持多种邮件服务商,无需依赖外部邮件测试服务;
-### 本包以 ESM 模块系统编写->未来趋势;只要你的 Node.js 版本大于22.12,可保留CJS `require()` 语法调用,否则请使用 `import` 语法;
+### 本包以 ESM 模块系统编写
+
+-> 未来趋势;只要你的 Node.js 版本大于22.12,可保留CJS `require()` 语法调用,否则请使用 `import` 语法;
 
 ## 项目运行导图
 
@@ -24,7 +26,8 @@ graph TD
 
 ### 允许安装脚本执行
 
-本包在安装时可能触发某些依赖包的自动脚本（如 `postinstall` 等）;如果你的 npm 全局配置或项目配置禁止了脚本执行（例如设置了 `ignore-scripts=true`）,可能会导致安装不完整或运行时异常;
+本包在安装时可能触发某些依赖包的自动脚本(如 `postinstall` 等);如果你的 npm 全局配置或项目配置禁止了脚本执行(例如设置了 
+`ignore-scripts=true`),可能会导致安装不完整或运行时异常;
 
 推荐在项目根目录的 `package.json` 中添加 `allowScripts` 字段,显式放行本包及其依赖的脚本:
 
@@ -32,12 +35,13 @@ graph TD
 {
   "allowScripts": {
     "@flun/mailer": true
-    // 如果依赖的其它包（如 bcrypt、electron-winstaller 等）也有脚本,请按需添加,格式相同
+    // 如果依赖的其它包(如 bcrypt、electron-winstaller 等)也有脚本,请按需添加,格式相同
   }
 }
 ```
 
-> 如果你信任所有安装包,也可以直接在项目 `.npmrc` 中设置 `allow-scripts = false`（表示关闭脚本拦截,所有脚本均允许执行）,或删除 `ignore-scripts` 字段;
+> 如果你信任所有安装包,也可以直接在项目 `.npmrc` 中设置 `allow-scripts = false`(表示关闭脚本拦截,所有脚本均允许执行),
+  或删除 `ignore-scripts` 字段;
 
 ---
 
@@ -49,12 +53,12 @@ npm i @flun/mailer
 
 ## 优势
 
-- **安全性**：不依赖外部服务,数据完全可控
-- **真实性**：使用真实邮箱测试,结果更准确
-- **灵活性**：支持各种邮件服务商（Gmail、Outlook、QQ邮箱等）
-- **简单性**：安装时在项目根目录动态创建邮件示例,配置更直接,无需理解复杂的测试服务概念
-- **配置验证**：发送前可验证配置,确保必要的配置项已填写
-- **清晰的错误提示**：指导用户正确使用
+- **安全性**:不依赖外部服务,数据完全可控
+- **真实性**:使用真实邮箱测试,结果更准确
+- **灵活性**:支持各种邮件服务商(Gmail、Outlook、QQ邮箱等)
+- **简单性**:安装时在项目根目录动态创建邮件示例,配置更直接,无需理解复杂的测试服务概念
+- **配置验证**:发送前可验证配置,确保必要的配置项已填写
+- **清晰的错误提示**:指导用户正确使用
 
 ## 快速开始
 
@@ -89,7 +93,7 @@ transporter.sendMail({
     to: 'recipient@example.com',    // 收件人
     subject: '测试邮件',             // 邮件主题
     text: '这是一封测试邮件(text)',         // 纯文本内容
-    html: '<b>这是一封测试邮件(html)</b>'   // HTML内容（可选;注:html内容优先级高于纯文本内容)
+    html: '<b>这是一封测试邮件(html)</b>'   // HTML内容(可选;注:html内容优先级高于纯文本内容)
 }, (error, info) => {
     if (error)  console.error('发送失败:', error);
     else console.log('发送成功:', info.response);
@@ -229,8 +233,8 @@ async function sendEmail() {
 sendEmail();
 ```
 ---
-：#其它使用示例:
-## 1. SMTP 连接池（高并发场景）
+:#其它使用示例:
+## 1. SMTP 连接池(高并发场景)
 
 ```javascript
 import { createTransport } from '@flun/mailer';
@@ -282,7 +286,7 @@ async function sendBulkEmails() {
 sendBulkEmails();
 ```
 
-## 2. Sendmail 传输（Linux/Unix 系统）
+## 2. Sendmail 传输(Linux/Unix 系统)
 
 ```javascript
 import { createTransport } from '@flun/mailer';
@@ -298,8 +302,8 @@ const mailOptions = {
   from: '"系统" <system@server.com>',
   to: 'admin@example.com',
   subject: '服务器报警',
-  text: 'CPU使用率超过90%,请及时处理！',
-  html: '<h1>服务器报警</h1><p>CPU使用率超过90%,请及时处理！</p>'
+  text: 'CPU使用率超过90%,请及时处理!',
+  html: '<h1>服务器报警</h1><p>CPU使用率超过90%,请及时处理!</p>'
 };
 
 // 3. 发送邮件
@@ -313,7 +317,7 @@ transporter.sendMail(mailOptions, (error, info) => {
 });
 ```
 
-## 3. 流传输（用于测试和开发）
+## 3. 流传输(用于测试和开发)
 
 ```javascript
 import { createTransport } from '@flun/mailer';
@@ -341,7 +345,7 @@ const mailOptions = {
   ]
 };
 
-// 3. 发送邮件（实际上只是生成邮件源码）
+// 3. 发送邮件(实际上只是生成邮件源码)
 transporter.sendMail(mailOptions, (error, info) => {
   if (error) {
     console.log('生成邮件失败:', error);
@@ -349,14 +353,14 @@ transporter.sendMail(mailOptions, (error, info) => {
     console.log('邮件源码:');
     console.log(info.message.toString());
 
-    // 可选：保存到文件
+    // 可选:保存到文件
     fs.writeFileSync('debug-email.eml', info.message.toString());
     console.log('邮件已保存到 debug-email.eml');
   }
 });
 ```
 
-## 4. JSON 传输（用于调试）
+## 4. JSON 传输(用于调试)
 
 ```javascript
 import { createTransport } from '@flun/mailer';
@@ -380,18 +384,18 @@ transporter.sendMail(mailOptions, (error, info) => {
   if (error) {
     console.log('错误:', error);
   } else {
-    console.log('邮件信息（JSON格式）:');
+    console.log('邮件信息(JSON格式):');
     console.log(JSON.stringify(info.message, null, 2));
 
-    // info.message 包含：
-    // - envelope: 信封信息（发件人、收件人）
+    // info.message 包含:
+    // - envelope: 信封信息(发件人、收件人)
     // - messageId: 邮件ID
     // - response: 响应信息
   }
 });
 ```
 
-## 5. SES 传输（AWS 亚马逊服务）
+## 5. SES 传输(AWS 亚马逊服务)
 
 ```javascript
 import { createTransport } from '@flun/mailer';
@@ -466,22 +470,22 @@ transporter.sendMail(mailOptions)
   });
 ```
 
-每个示例都包含了：
+每个示例都包含了:
 1. **配置传输器** - 创建特定类型的邮件传输器
 2. **设置邮件内容** - 定义发件人、收件人、主题、内容等
 3. **发送邮件** - 执行发送操作并处理结果
 
-对于生产环境,推荐使用 SMTP 或 SES；对于开发和测试,可以使用流传输或 JSON 传输;
+对于生产环境,推荐使用 SMTP 或 SES;对于开发和测试,可以使用流传输或 JSON 传输;
 
 ---
 ## 错误处理
 
-库提供了详细的错误信息,帮助您快速定位问题：
+库提供了详细的错误信息,帮助您快速定位问题:
 
-- **配置错误**：如缺少必要参数、无效的端口号等
-- **连接错误**：如无法连接到SMTP服务器
-- **认证错误**：如用户名或密码错误
-- **发送错误**：如收件人地址无效、邮件被拒绝等
+- **配置错误**:如缺少必要参数、无效的端口号等
+- **连接错误**:如无法连接到SMTP服务器
+- **认证错误**:如用户名或密码错误
+- **发送错误**:如收件人地址无效、邮件被拒绝等
 
 ## 注意事项
 

package/copy-files.js

@@ -16,11 +16,11 @@ const __filename = fileURLToPath(import.meta.url), __dirname = path.dirname(__fi
 const copyFile = () => {
     console.log(`🔍 检查 ${fileName} 文件...`), console.log(`📁 项目根目录:${targetDir}`);
     try {
-        // 目标目录不是 Node 项目 || 包自身的 npm install（开发调试）→ 跳过
+        // 目标目录不是 Node 项目 || 包自身的 npm install(开发调试)→ 跳过
         if (!fs.existsSync(path.join(targetDir, 'package.json'))) return true;
         if (targetDir === path.resolve(__dirname, '..')) return true;
         if (fs.existsSync(targetFile)) return true;  // 目标文件已存在 → 直接返回
-        console.log(`⚠️ 在项目根目录未找到 ${fileName} 文件，正在创建...`);
+        console.log(`⚠️ 在项目根目录未找到 ${fileName} 文件,正在创建...`);
 
         fs.copyFileSync(sourceFile, targetFile);     // 复制源文件到项目根目录
         console.log(`✓ 已创建 ${fileName} 示例文件:${targetFile}`), console.log(`💡 请编辑 ${fileName} 文件,配置您的邮箱`);

package/index.d.ts

@@ -34,7 +34,8 @@ import {
     PK, regexs, resetRegex, dnsLookup, dnsResolve, format, isIP, netConnect, fsReadStream, osHostname, nmfetch,
     getLogger, resolveHostname, newURL, parseConnectionUrl, parseDataURI, callbackPromise, resolveStream, resolveContent,
     assign, encodeXText, initSmtpConstructor, getSocket, cleanup, createSmtpConnection, setupConnectionHandlers,
-    performSmtpAuthentication, createAuthConfig, prepareMessageForSending, handleSendResult, verifySmtp
+    performSmtpAuthentica
+ *tion, createAuthConfig, prepareMessageForSending, handleSendResult, verifySmtp
 } from './lib/shared.js';
 import { SmtpTransport } from './lib/smtp-transport.js';
 import { StreamTransport } from './lib/stream-transport.js';
@@ -150,7 +151,8 @@ declare module './lib/mailer/mail-message.js' {
  * detectMimeType();   // 根据文件名检测MIME类型;
  * foldLines();        // 折叠长行,适用于折叠头行(afterSpace=false)和流文本(afterSpace=true);
  * ```
- * >查看定义:@see {@link isPlainText}、{@link hasLongerLines}、{@link encodeWord}、{@link encodeWords}、{@link buildHeaderValue}、
+ * >查看定义:@see {@link isPlainText}、{@link hasLongerLines}、
+ *{@link encodeWord}、{@link encodeWords}、{@link buildHeaderValue}、
  * {@link parseHeaderValue}、{@link detectExtension}、{@link detectMimeType}、{@link foldLines}
  */
 declare module './lib/mime-funcs/index.js' {
@@ -406,11 +408,11 @@ declare module './lib/ses-transport.js' {
  * // 文件导出内容
  * const PK={};                 // package.json 包对象(含 name,,version,,homepage);
  * const regexs={};             // 常用正则表达式集合;
- * resetRegex();                // 重置正则表达式（清除 lastIndex）;
+ * resetRegex();                // 重置正则表达式(清除 lastIndex);
  * dnsLookup();                 // dns.lookup 的引用;
  * dnsResolve();                // dns.resolve 的引用;
  * format();                    // util.format 的引用;
- * isIP();                      // 检查字符串是否为 IP 地址（v4 或 v6）;
+ * isIP();                      // 检查字符串是否为 IP 地址(v4 或 v6);
  * netConnect();                // net.connect 的引用;
  * fsReadStream();              // fs.createReadStream 的引用;
  * osHostname();                // os.hostname 的引用;
@@ -420,11 +422,11 @@ declare module './lib/ses-transport.js' {
  * newURL();                    // 安全地创建 URL 对象;
  * parseConnectionUrl();        // 解析连接 URL 为配置对象;
  * parseDataURI();              // 解析 Data URI 字符串;
- * callbackPromise();           // 创建 Promise 回调包装器（resolve, reject）;
+ * callbackPromise();           // 创建 Promise 回调包装器(resolve, reject);
  * resolveStream();             // 将可读流完整读取到 Buffer 中;
  * resolveContent();            // 解析字符串或 Buffer 值的内容;
- * assign();                    // 合并对象属性（深度合并 tls 与 auth）;
- * encodeXText();               // XText 编码（SMTP 扩展）;
+ * assign();                    // 合并对象属性(深度合并 tls 与 auth);
+ * encodeXText();               // XText 编码(SMTP 扩展);
  * initSmtpConstructor();       // 初始化 SMTP 传输对象的公共构造函数逻辑;
  * getSocket();                 // 获取代理套接字的占位函数;
  * cleanup();                   // 用于清理状态对象;
@@ -441,7 +443,8 @@ declare module './lib/ses-transport.js' {
  * {@link resolveHostname}、{@link newURL}、{@link parseConnectionUrl}、{@link parseDataURI}、{@link callbackPromise}、
  * {@link resolveStream}、{@link resolveContent}、{@link assign}、{@link encodeXText}、{@link initSmtpConstructor}、
  * {@link getSocket}、{@link cleanup}、{@link createSmtpConnection}、{@link setupConnectionHandlers}、
- * {@link performSmtpAuthentication}、{@link createAuthConfig}、 {@link prepareMessageForSending}、{@link handleSendResult}、
+ * {@link performSmtpAuthentication}、{@link createAuthConfig}、
+ * {@link prepareMessageForSending}、{@link handleSendResult}、
  * {@link verifySmtp}
  */
 declare module './lib/shared.js' {
@@ -485,7 +488,7 @@ declare module './lib/xoauth2.js' {
 }
 
 /**
- * 邮件发送模块 主要功能：
+ * 邮件发送模块 主要功能:
  * ```js
  * createTransport();   // 创建邮件传输器
  * validateConfig();    // 验证配置
@@ -515,7 +518,7 @@ declare module './lib/xoauth2.js' {
  *      to: 'xyz@189.cn',          // 收件人
  *      subject: '测试邮件',        // 邮件主题
  *      text: '纯文本测试',         // 纯文本内容
- *      html: '<b>html格式测试</b>' // HTML内容（可选;注:html内容优先级高于纯文本内容）
+ *      html: '<b>html格式测试</b>' // HTML内容(可选;注:html内容优先级高于纯文本内容)
  *  }, (error, info) => {
  *      if (error) console.error('发送失败:', error);
  *      else console.log('发送成功:', info.response);
@@ -533,7 +536,7 @@ declare module './index.js' {
     /**
      * 创建邮件传输器
      *
-     * 根据配置自动选择合适的传输器类型：
+     * 根据配置自动选择合适的传输器类型:
      * - 启用连接池: pool=true -> SmtpPool
      * - 启用sendmail: sendmail=true或字符串 -> SendmailTransport
      * - 启用流传输: streamTransport=true -> StreamTransport
@@ -593,7 +596,7 @@ declare module './index.js' {
 
     /**
      * 传输器配置类型
-     * 可以是：连接URL字符串、已封装好的传输器实例、或具体的传输器配置对象
+     * 可以是:连接URL字符串、已封装好的传输器实例、或具体的传输器配置对象
      */
     export type TransportConfig = string | Transporter | SpecificTransportConfig;
 
@@ -635,7 +638,7 @@ declare module './index.js' {
          */
         sendMail(mail: MailData, callback: (err: Error | null, info: SentMessageInfo) => void): void;
         /**
-         * 发送邮件（Promise 形式）
+         * 发送邮件(Promise 形式)
          * @param mail 邮件内容
          */
         sendMail(mail: MailData): Promise<SentMessageInfo>;
@@ -659,7 +662,7 @@ declare module './index.js' {
      * 具体的传输器配置对象
      */
     export interface SpecificTransportConfig {
-        /** 连接URL（优先级高于其他配置） */
+        /** 连接URL(优先级高于其他配置) */
         url?: string;
         /** SMTP服务器地址 */
         host?: string;
@@ -688,7 +691,7 @@ declare module './index.js' {
         maxConnections?: number;
         /** 单个连接最大消息数 */
         maxMessages?: number;
-        /** 使用 sendmail 发送（布尔值或sendmail路径） */
+        /** 使用 sendmail 发送(布尔值或sendmail路径) */
         sendmail?: boolean | string;
         /** 使用流传输器输出 */
         streamTransport?: boolean;
@@ -698,7 +701,7 @@ declare module './index.js' {
         SES?: {
             [key: string]: any;
         };
-        /** 自定义传输器发送方法（若直接提供传输器实例则无需配置） */
+        /** 自定义传输器发送方法(若直接提供传输器实例则无需配置) */
         send?: (mail: MailMessage, callback: (err: Error | null, info: SentMessageInfo) => void) => void;
         /** 其他扩展字段 */
         [key: string]: any;
@@ -708,9 +711,9 @@ declare module './index.js' {
      * 邮件数据对象,描述邮件内容及收件人信息
      */
     export interface MailData {
-        /** 发件人地址（格式："名称 <地址>" 或纯地址） */
+        /** 发件人地址(格式:"名称 <地址>" 或纯地址) */
         from?: string;
-        /** 收件人地址（字符串或数组） */
+        /** 收件人地址(字符串或数组) */
         to?: string | string[];
         /** 抄送 */
         cc?: string | string[];
@@ -720,7 +723,7 @@ declare module './index.js' {
         subject?: string;
         /** 纯文本内容 */
         text?: string;
-        /** HTML内容（优先级高于纯文本） */
+        /** HTML内容(优先级高于纯文本) */
         html?: string;
         /** 附件列表 */
         attachments?: Attachment[];
@@ -735,7 +738,7 @@ declare module './index.js' {
     }
 
     /**
-     * 内部使用的邮件消息对象（传递给底层传输器）
+     * 内部使用的邮件消息对象(传递给底层传输器)
      */
     export interface MailMessage {
         /** 信封信息 */
@@ -745,7 +748,7 @@ declare module './index.js' {
         };
         /** 原始邮件数据 */
         data?: string | Buffer | object;
-        /** 消息内容（可能为字符串或Buffer） */
+        /** 消息内容(可能为字符串或Buffer) */
         message?: string | Buffer;
         /** 其他传输器需要的元数据 */
         [key: string]: any;
@@ -757,13 +760,13 @@ declare module './index.js' {
     export interface Attachment {
         /** 文件名 */
         filename?: string;
-        /** 内容（支持字符串、Buffer、流） */
+        /** 内容(支持字符串、Buffer、流) */
         content?: string | Buffer | NodeJS.ReadableStream;
         /** 文件路径 */
         path?: string;
         /** MIME类型 */
         contentType?: string;
-        /** 内嵌ID（用于html内嵌图片） */
+        /** 内嵌ID(用于html内嵌图片) */
         cid?: string;
         /** 编码 */
         encoding?: string;
@@ -805,7 +808,7 @@ declare module './index.js' {
     }
 
     /**
-     * 日志记录器接口（传输器内部使用）
+     * 日志记录器接口(传输器内部使用)
      */
     export interface Logger {
         info(...args: any[]): void;

package/index.js

@@ -1,15 +1,15 @@
 /**
  * mailer 主模块
  *
- * 模块依赖说明：
- * - Mailer: 核心邮件发送器，负责管理传输器和邮件发送流程
- * - SmtpPool: SMTP连接池传输器，支持连接复用和并发发送
- * - SmtpTransport: 标准SMTP传输器，用于通过SMTP服务器发送邮件
- * - SendmailTransport: 本地sendmail传输器，使用系统sendmail命令发送
- * - StreamTransport: 流传输器，将邮件输出为流格式，主要用于测试
- * - JsonTransport: JSON传输器，将邮件转换为JSON格式输出，用于调试
- * - SesTransport: Amazon SES传输器，通过AWS Simple Email Service发送邮件
- * - shared: 共享工具函数模块，包含URL解析,正则常量等通用功能
+ * 模块依赖说明:
+ * - Mailer: 核心邮件发送器,负责管理传输器和邮件发送流程
+ * - SmtpPool: SMTP连接池传输器,支持连接复用和并发发送
+ * - SmtpTransport: 标准SMTP传输器,用于通过SMTP服务器发送邮件
+ * - SendmailTransport: 本地sendmail传输器,使用系统sendmail命令发送
+ * - StreamTransport: 流传输器,将邮件输出为流格式,主要用于测试
+ * - JsonTransport: JSON传输器,将邮件转换为JSON格式输出,用于调试
+ * - SesTransport: Amazon SES传输器,通过AWS Simple Email Service发送邮件
+ * - shared: 共享工具函数模块,包含URL解析,正则常量等通用功能
  */
 import { Mailer } from './lib/mailer/index.js';
 import { SmtpPool } from './lib/smtp-pool/index.js';
@@ -59,9 +59,9 @@ const createTransport = (transporter, defaults) => {
         }
         const { host, service, auth, port, secure, tls, pool, maxConnections, maxMessages, sendmail, SES } = config;
 
-        // 如果是字符串（URL格式）
+        // 如果是字符串(URL格式)
         if (typeof config === 'string' && !regexs.TRANSPORTER_PROTOCOL.test(config))
-            errors.push('URL格式不正确，应以 smtp://, smtps:// 或 direct:// 开头');
+            errors.push('URL格式不正确,应以 smtp://, smtps:// 或 direct:// 开头');
         // 否则,如果是配置对象
         else if (typeof config === 'object') {
             // 检查传输器类型
@@ -71,34 +71,39 @@ const createTransport = (transporter, defaults) => {
                 );
 
             if (!hasTransportType && typeof config.send !== 'function') {
-                // 默认为SMTP传输器，验证SMTP相关配置
+                // 默认为SMTP传输器,验证SMTP相关配置
                 if (!host && !service) errors.push('必须指定 host 或 service');
 
                 if (auth) {
                     if (!auth.user) errors.push('认证配置中缺少 user 字段');
-                    if (!auth.pass && !auth.oauth2 && !auth.xoauth2) warnings.push('(pass,oauth2,xoauth2)都无配置,将尝试无密码连接');
+                    if (!auth.pass && !auth.oauth2 && !auth.xoauth2)
+                        warnings.push('(pass,oauth2,xoauth2)都无配置,将尝试无密码连接');
                 }
                 // 非25端口通常需要认证
-                else if (port !== 25) warnings.push('未提供认证信息，某些邮件服务器可能拒绝连接');
+                else if (port !== 25) warnings.push('未提供认证信息,某些邮件服务器可能拒绝连接');
 
                 if (port && (port < 1 || port > 65535)) errors.push('端口号应在 1-65535 范围内');
                 // 检查TLS/SSL配置
                 if (secure !== undefined && typeof secure !== 'boolean') errors.push('secure 字段应为布尔值');
-                if (tls !== undefined && typeof tls !== 'object' && typeof tls !== 'boolean') errors.push('tls 字段应为对象或布尔值');
+                if (tls !== undefined && typeof tls !== 'object' && typeof tls !== 'boolean')
+                    errors.push('tls 字段应为对象或布尔值');
             }
 
             // 验证池配置
             if (pool && typeof pool !== 'boolean') errors.push('pool 字段应为布尔值');
-            if (maxConnections && (typeof maxConnections !== 'number' || maxConnections < 1)) errors.push('maxConnections 应为大于0的数字');
-            if (maxMessages && (typeof maxMessages !== 'number' || maxMessages < 1)) errors.push('maxMessages 应为大于0的数字');
+            if (maxConnections && (typeof maxConnections !== 'number' || maxConnections < 1))
+                errors.push('maxConnections 应为大于0的数字');
+            if (maxMessages && (typeof maxMessages !== 'number' || maxMessages < 1))
+                errors.push('maxMessages 应为大于0的数字');
 
             // 验证Sendmail配置
-            if (sendmail && sendmail !== true && typeof sendmail !== 'string') errors.push('sendmail 字段应为布尔值或字符串路径');
+            if (sendmail && sendmail !== true && typeof sendmail !== 'string')
+                errors.push('sendmail 字段应为布尔值或字符串路径');
 
             // 验证SES配置
             if (SES) {
                 if (typeof SES !== 'object') errors.push('SES 配置应为对象');
-                else if (SES.ses && SES.aws) warnings.push('检测到旧版SES配置，建议使用新版AWS SDK');
+                else if (SES.ses && SES.aws) warnings.push('检测到旧版SES配置,建议使用新版AWS SDK');
             }
         }
         else errors.push('配置应为字符串或对象');

package/lib/addressparser.js

@@ -9,7 +9,7 @@ class Tokenizer {
     constructor(str = '') {
         this.str = str.toString(), this.operatorExpecting = '', this.node = null, this.escaped = false, this.list = [];
 
-        // 操作符映射：开始操作符到期望的结束操作符(引号,注释,邮件地址,地址分隔符,组定义开始,组定义结束)
+        // 操作符映射:开始操作符到期望的结束操作符(引号,注释,邮件地址,地址分隔符,组定义开始,组定义结束)
         this.operators = { '"': '"', '(': ')', '<': '>', ',': '', ':': ';', ';': '' };
     }
 
@@ -35,9 +35,9 @@ class Tokenizer {
     }
 
     /**
-     * 处理单个字符，识别操作符或文本内容
+     * 处理单个字符,识别操作符或文本内容
      * @param {String} chr 当前字符
-     * @param {String} nextChr 下一个字符（用于前瞻）
+     * @param {String} nextChr 下一个字符(用于前瞻)
      */
     #processChar(chr, nextChr) {
         const { escaped, operatorExpecting: oExpecting, operators } = this;
@@ -47,7 +47,7 @@ class Tokenizer {
         // 检查是否是新的开始操作符
         else if (!escaped && !oExpecting && chr in operators) return this.#addOperatorToken(chr, nextChr, operators[chr]);
 
-        // 检查转义字符（在引号或注释中）
+        // 检查转义字符(在引号或注释中)
         else if (!escaped && ['"', "'"].includes(oExpecting) && chr === '\\') return this.escaped = true;
         this.#addTextChar(chr), this.escaped = false;  // 处理文本字符并重置转义标志
     }
@@ -55,12 +55,12 @@ class Tokenizer {
     /**
      * 添加操作符令牌到列表
      * @param {String} chr 操作符字符
-     * @param {String} nextChr 下一个字符（用于设置noBreak标志）
+     * @param {String} nextChr 下一个字符(用于设置noBreak标志)
      * @param {String} newExpecting 新的期望操作符
      */
     #addOperatorToken(chr, nextChr, newExpecting = '') {
         const node = { type: 'operator', value: chr };
-        // 如果下一个字符不是空白或分隔符，设置noBreak标志
+        // 如果下一个字符不是空白或分隔符,设置noBreak标志
         if (nextChr && ![' ', '\t', '\r', '\n', ',', ';'].includes(nextChr)) node.noBreak = true;
         this.list.push(node), this.node = null, this.escaped = false, this.operatorExpecting = newExpecting;
     }
@@ -70,15 +70,17 @@ class Tokenizer {
      * @param {String} chr 文本字符
      */
     #addTextChar(chr) {
-        if (!this.node) this.node = { type: 'text', value: '' }, this.list.push(this.node); // 如果没有当前文本节点,则创建一个新的
+        if (!this.node)
+            this.node = { type: 'text', value: '' }, this.list.push(this.node); // 如果没有当前文本节点,则创建一个新的
 
         const processedChr = chr === '\n' ? ' ' : chr; // 规范化空白字符
-        if (chr.charCodeAt(0) >= 0x21 || [' ', '\t'].includes(chr)) this.node.value += processedChr;// 如果是可见字符或空格,则添加
+        if (chr.charCodeAt(0) >= 0x21 || [' ', '\t'].includes(chr))
+            this.node.value += processedChr; // 如果是可见字符或空格,则添加
     }
 }
 
 /**
- * 如果文本数据为空但存在注释数据，则用注释数据替换文本数据
+ * 如果文本数据为空但存在注释数据,则用注释数据替换文本数据
  * @param {Object} data 包含文本和注释数据的对象
  * @return {Object} 处理后的数据对象
  */
@@ -127,7 +129,7 @@ const _replaceTextWithComment = data => {
         let isGroup = false, state = 'text';
         const data = { address: [], comment: [], group: [], text: [] };
 
-        // 解析令牌，分类到地址、注释、组或文本
+        // 解析令牌,分类到地址、注释、组或文本
         for (let i = 0; i < tokens.length; i++) {
             const token = tokens[i], prevToken = i ? tokens[i - 1] : null;
             if (token.type === 'operator')
@@ -150,24 +152,26 @@ const _replaceTextWithComment = data => {
                 // 清理地址令牌中的多余字符(如未引用的名称中的"<")
                 if (state === 'address') token.value = token.value.replace(regexs.ADDRESS_CLEAN, '');
 
-                // 如果前一个令牌设置了noBreak，则附加到最后一个元素,否则创建新的元素
+                // 如果前一个令牌设置了noBreak,则附加到最后一个元素,否则创建新的元素
                 const dLen = data[state].length;
                 prevToken?.noBreak && dLen ? data[state][dLen - 1] += token.value : data[state].push(token.value);
             }
         }
-        const { text, group, address } = _replaceTextWithComment(data);             // 如果没有文本但有注释，用注释替换文本
-        // 如果组存在，处理组地址：组名和组成员列表
+        const { text, group, address } = _replaceTextWithComment(data);             // 如果没有文本但有注释,用注释替换文本
+        // 如果组存在,处理组地址:组名和组成员列表
         if (isGroup) return [{ name: text.join(' ') || '', group: group.length ? addressparser(group.join(',')) : [] }];
         else {
-            if (!address.length && text.length) _extractEmailFromText(data);         // 如果没有地址，从文本中提取电子邮件地址
+            if (!address.length && text.length)
+                _extractEmailFromText(data); // 如果没有地址,从文本中提取电子邮件地址
 
             const { text: newTxt, address: newAdd } = _replaceTextWithComment(data); // 再次检查是否需要将注释转换为文本
-            if (newAdd.length > 1) newTxt.push(...newAdd.splice(1));                 // 如果找到多个地址,只保留第一个,其余的转到文本数组
+            if (newAdd.length > 1)
+                newTxt.push(...newAdd.splice(1)); // 如果找到多个地址,只保留第一个,其余的转到文本数组
             const addressText = newTxt.join(' ').trim(), addressValue = newAdd.join(' ').trim(),// 合并文本和地址数据
                 // 创建地址对象
                 addressObj = { address: addressValue || addressText || '', name: addressText || addressValue || '' };
 
-            // 如果地址和名称相同，根据内容决定清除哪个(如果是邮件地址,清除名称,否则,清除地址)
+            // 如果地址和名称相同,根据内容决定清除哪个(如果是邮件地址,清除名称,否则,清除地址)
             if (addressObj.address === addressObj.name)
                 addressObj.address.includes('@') ? addressObj.name = '' : addressObj.address = '';
 
@@ -213,7 +217,7 @@ const addressparser = (str, options = {}) => {
         if (address.length) parsedAddresses = parsedAddresses.concat(address);
     });
 
-    // 如果要求展平，将组地址转换为平面列表
+    // 如果要求展平,将组地址转换为平面列表
     if (options.flatten) {
         const flattenedAddresses = [],
             walkAddressList = list => {