diff --git a/YLErpDAL/Modules/AppModule/EmailTemplateService.cs b/YLErpDAL/Modules/AppModule/EmailTemplateService.cs
index c98fb9d8..aeca2cbc 100644
--- a/YLErpDAL/Modules/AppModule/EmailTemplateService.cs
+++ b/YLErpDAL/Modules/AppModule/EmailTemplateService.cs
@@ -74,7 +74,12 @@ namespace YLErp.Modules.AppModule
         }
 
         /// <summary>
-        /// 生成邮件信息，如果template为null，返回null
+        /// 生成邮件信息，如果template为null，返回null。
+        /// 【设计决策·勿单边"升级"】占位符为朴素文本替换（非模板引擎），与本表另一消费者
+        /// bond-oms Java SwapEmailHandler.replaceMailPlaceholders 保持同构渲染语义——
+        /// 单边引入 FreeMarker/Thymeleaf 等更强语法或 HTML 转义，会造成两侧发出内容不一致。
+        /// 替换值(客户名称/文档编号等)不做 HTML 转义是有意为之：均为内部维护的可信数据；
+        /// 若未来要拼接用户自由输入的内容，必须两侧同步加转义。新占位符同样两侧同步加白名单。
         /// </summary>
         public static MailInfoResultModel GenerateMailInfo(EmailTemplate template, MailInfoRequestModel reqModel)
         {