结构调整

Service/EmailServices/EmailFetchService.cs

@@ -4,7 +4,7 @@ using MailKit.Search;
 using MailKit.Security;
 using MimeKit;
 
-namespace Service;
+namespace Service.EmailServices;
 
 /// <summary>
 /// 邮件抓取服务接口

Service/EmailServices/EmailHandleService.cs

@@ -1,6 +1,6 @@
 using Service.EmailParseServices;
 
-namespace Service;
+namespace Service.EmailServices;
 
 public interface IEmailHandleService
 {

Service/EmailServices/EmailParse/IEmailParseServices.cs

@@ -72,17 +72,17 @@ public abstract class EmailParseServicesBase(
     )[]?> ParseByAiAsync(string body)
     {
         var systemPrompt = $"""
-        你是一个信息抽取助手。
+    你是一个信息抽取助手。
-        仅输出严格的JSON数组，不要包含任何多余文本。
+    仅输出严格的JSON数组，不要包含任何多余文本。
-        每个交易记录包含字段: card(字符串), reason(字符串), amount(数字), balance(数字), type(字符串，值为'收入'或'支出'), occurredAt(字符串，yyyy-MM-dd HH:mm:ss格式日期时间)。
+    每个交易记录包含字段: card(字符串), reason(字符串), amount(数字), balance(数字), type(字符串，值为'收入'或'支出'), occurredAt(字符串，yyyy-MM-dd HH:mm:ss格式日期时间)。
-        如果缺失，请推断或置空。
+    如果缺失，请推断或置空。
-        [重要] 当前时间为{DateTime.Now:yyyy-MM-dd HH:mm:ss}，请根据当前时间推断交易发生的时间。
+    [重要] 当前时间为{DateTime.Now:yyyy-MM-dd HH:mm:ss}，请根据当前时间推断交易发生的时间。
-        """;
+    """;
         var userPrompt = $"""
-        从下面这封银行账单相关邮件正文中提取所有交易记录，返回JSON数组格式，
+    从下面这封银行账单相关邮件正文中提取所有交易记录，返回JSON数组格式，
-        每个元素包含: card, reason, amount, balance, type(收入或支出), occurredAt(非必要)。
+    每个元素包含: card, reason, amount, balance, type(收入或支出), occurredAt(非必要)。
-        正文如下:\n\n{body}
+    正文如下:\n\n{body}
-        """;
+    """;
 
         var contentText = await openAiService.ChatAsync(systemPrompt, userPrompt);
         if (string.IsNullOrWhiteSpace(contentText))

Service/EmailServices/EmailSyncService.cs

@@ -1,9 +1,9 @@
 using System.ComponentModel;
 using MimeKit;
 
-namespace Service;
+namespace Service.EmailServices;
 
-public interface IEmailBackgroundService
+public interface IEmailSyncService
 {
     /// <summary>
     /// 手动触发邮件同步
@@ -11,12 +11,12 @@ public interface IEmailBackgroundService
     Task SyncEmailsAsync();
 }
 
-public class EmailBackgroundService(
+public class EmailSyncService(
     IOptions<EmailSettings> emailSettings,
     IServiceProvider serviceProvider,
     IEmailHandleService emailHandleService,
-    ILogger<EmailBackgroundService> logger)
+    ILogger<EmailSyncService> logger)
-    : BackgroundWorker, IEmailBackgroundService
+    : BackgroundWorker, IEmailSyncService
 {
     private readonly Dictionary<string, IEmailFetchService> _emailFetchServices = new();
     private bool _isInitialized;

Service/ImportService.cs

@@ -496,4 +496,3 @@ public class ImportService(
         "yyyyMMddHHmmss",
     ];
 }
-

Service/Jobs/EmailSyncJob.cs

@@ -1,5 +1,6 @@
 using MimeKit;
 using Quartz;
+using Service.EmailServices;
 
 namespace Service.Jobs;
 

Service/SmartHandleService.cs

@@ -112,33 +112,33 @@ public class SmartHandleService(
             }
 
             var systemPrompt = $$"""
-                你是一个专业的账单分类助手。请根据提供的账单分组信息和分类列表，为每个分组选择最合适的分类。
+            你是一个专业的账单分类助手。请根据提供的账单分组信息和分类列表，为每个分组选择最合适的分类。
 
-                可用的分类列表：
+            可用的分类列表：
-                {{categoryInfo}}
+            {{categoryInfo}}
 
-                分类规则：
+            分类规则：
-                1. 根据账单的摘要和涉及金额，选择最匹配的分类
+            1. 根据账单的摘要和涉及金额，选择最匹配的分类
-                2. 如果提供了【参考】信息，优先参考相似账单的分类，这些是历史上已分类的相似账单
+            2. 如果提供了【参考】信息，优先参考相似账单的分类，这些是历史上已分类的相似账单
-                3. 如果无法确定分类，可以选择"其他"
+            3. 如果无法确定分类，可以选择"其他"
-                4. 每个分组可能包含多条账单，你需要为整个分组选择一个分类
+            4. 每个分组可能包含多条账单，你需要为整个分组选择一个分类
 
-                输出格式要求（强制）：
+            输出格式要求（强制）：
-                - 请使用 NDJSON（每行一个独立的 JSON 对象，末尾以换行符分隔），不要输出数组。
+            - 请使用 NDJSON（每行一个独立的 JSON 对象，末尾以换行符分隔），不要输出数组。
-                - 每行的JSON格式严格为：{"reason": "交易摘要", "type": 0, "classify": "分类名称"}
+            - 每行的JSON格式严格为：{"reason": "交易摘要", "type": 0, "classify": "分类名称"}
-                - 不要输出任何解释性文字、编号、标点或多余的文本
+            - 不要输出任何解释性文字、编号、标点或多余的文本
-                - 如果无法判断分类，请将 "classify" 设为 "其他"，并确保仍然输出 JSON 行
+            - 如果无法判断分类，请将 "classify" 设为 "其他"，并确保仍然输出 JSON 行
 
-                只输出按行的JSON对象（NDJSON），不要有其他文字说明。
+            只输出按行的JSON对象（NDJSON），不要有其他文字说明。
-                """;
+            """;
 
             var userPrompt = $$"""
-                请为以下账单分组进行分类：
+            请为以下账单分组进行分类：
 
-                {{billsInfo}}
+            {{billsInfo}}
 
-                请逐个输出分类结果。
+            请逐个输出分类结果。
-                """;
+            """;
 
             // 流式调用AI
             chunkAction(("start", $"开始分类，共 {sampleRecords.Length} 条账单"));
@@ -253,56 +253,56 @@ public class SmartHandleService(
             // 第一步：使用AI生成聚合SQL查询
             var now = DateTime.Now;
             var sqlPrompt = $"""
-                当前日期：{now:yyyy年M月d日}（{now:yyyy-MM-dd}）
+            当前日期：{now:yyyy年M月d日}（{now:yyyy-MM-dd}）
-                用户问题：{userInput}
+            用户问题：{userInput}
             
-                数据库类型：SQLite
+            数据库类型：SQLite
-                数据库表名：TransactionRecord
+            数据库表名：TransactionRecord
-                字段说明：
+            字段说明：
-                - Id: bigint 主键
+            - Id: bigint 主键
-                - Card: nvarchar 卡号
+            - Card: nvarchar 卡号
-                - Reason: nvarchar 交易原因/摘要
+            - Reason: nvarchar 交易原因/摘要
-                - Amount: decimal 交易金额（支出为负数，收入为正数）
+            - Amount: decimal 交易金额（支出为负数，收入为正数）
-                - OccurredAt: datetime 交易发生时间（TEXT类型，格式：'2025-12-26 10:30:00'）
+            - OccurredAt: datetime 交易发生时间（TEXT类型，格式：'2025-12-26 10:30:00'）
-                - Type: int 交易类型（0=支出, 1=收入, 2=不计入收支）
+            - Type: int 交易类型（0=支出, 1=收入, 2=不计入收支）
-                - Classify: nvarchar 交易分类（如：交通、餐饮、购物等）
+            - Classify: nvarchar 交易分类（如：交通、餐饮、购物等）
             
-                【核心原则】直接生成用户所需的聚合统计SQL，而不是查询原始记录后再统计
+            【核心原则】直接生成用户所需的聚合统计SQL，而不是查询原始记录后再统计
             
-                要求：
+            要求：
-                1. 根据用户问题判断需要什么维度的聚合数据
+            1. 根据用户问题判断需要什么维度的聚合数据
-                2. 使用 GROUP BY 按分类、时间等维度分组
+            2. 使用 GROUP BY 按分类、时间等维度分组
-                3. 使用聚合函数：SUM(ABS(Amount)) 计算金额总和、COUNT(*) 计数、AVG()平均、MAX()最大、MIN()最小
+            3. 使用聚合函数：SUM(ABS(Amount)) 计算金额总和、COUNT(*) 计数、AVG()平均、MAX()最大、MIN()最小
-                4. 时间范围使用 OccurredAt 字段，"最近X个月/天"基于当前日期计算
+            4. 时间范围使用 OccurredAt 字段，"最近X个月/天"基于当前日期计算
-                5. 支出用 Type = 0，收入用 Type = 1
+            5. 支出用 Type = 0，收入用 Type = 1
-                6. 给聚合字段起有意义的别名（如 TotalAmount, TransactionCount, AvgAmount）
+            6. 给聚合字段起有意义的别名（如 TotalAmount, TransactionCount, AvgAmount）
-                7. 使用 ORDER BY 对结果排序（通常按金额降序）
+            7. 使用 ORDER BY 对结果排序（通常按金额降序）
-                8. 只返回SQL语句，不要解释
+            8. 只返回SQL语句，不要解释
             
-                【重要】SQLite日期函数：
+            【重要】SQLite日期函数：
-                - 提取年份：strftime('%Y', OccurredAt)
+            - 提取年份：strftime('%Y', OccurredAt)
-                - 提取月份：strftime('%m', OccurredAt)
+            - 提取月份：strftime('%m', OccurredAt)
-                - 提取日期：strftime('%Y-%m-%d', OccurredAt)
+            - 提取日期：strftime('%Y-%m-%d', OccurredAt)
-                - 不要使用 YEAR()、MONTH()、DAY() 函数，SQLite不支持
+            - 不要使用 YEAR()、MONTH()、DAY() 函数，SQLite不支持
             
-                示例1（按分类统计）：
+            示例1（按分类统计）：
-                用户：这三个月坐车花了多少钱？
+            用户：这三个月坐车花了多少钱？
-                返回：SELECT Classify, COUNT(*) as TransactionCount, SUM(ABS(Amount)) as TotalAmount, AVG(ABS(Amount)) as AvgAmount FROM TransactionRecord WHERE Type = 0 AND OccurredAt >= '2025-10-01' AND OccurredAt < '2026-01-01' AND (Classify LIKE '%交通%' OR Reason LIKE '%打车%' OR Reason LIKE '%公交%' OR Reason LIKE '%地铁%') GROUP BY Classify ORDER BY TotalAmount DESC
+            返回：SELECT Classify, COUNT(*) as TransactionCount, SUM(ABS(Amount)) as TotalAmount, AVG(ABS(Amount)) as AvgAmount FROM TransactionRecord WHERE Type = 0 AND OccurredAt >= '2025-10-01' AND OccurredAt < '2026-01-01' AND (Classify LIKE '%交通%' OR Reason LIKE '%打车%' OR Reason LIKE '%公交%' OR Reason LIKE '%地铁%') GROUP BY Classify ORDER BY TotalAmount DESC
             
-                示例2（按月统计）：
+            示例2（按月统计）：
-                用户：最近半年每月支出情况
+            用户：最近半年每月支出情况
-                返回：SELECT strftime('%Y', OccurredAt) as Year, strftime('%m', OccurredAt) as Month, COUNT(*) as TransactionCount, SUM(ABS(Amount)) as TotalAmount FROM TransactionRecord WHERE Type = 0 AND OccurredAt >= '2025-06-01' GROUP BY strftime('%Y', OccurredAt), strftime('%m', OccurredAt) ORDER BY Year, Month
+            返回：SELECT strftime('%Y', OccurredAt) as Year, strftime('%m', OccurredAt) as Month, COUNT(*) as TransactionCount, SUM(ABS(Amount)) as TotalAmount FROM TransactionRecord WHERE Type = 0 AND OccurredAt >= '2025-06-01' GROUP BY strftime('%Y', OccurredAt), strftime('%m', OccurredAt) ORDER BY Year, Month
             
-                示例3（总体统计）：
+            示例3（总体统计）：
-                用户：本月花了多少钱？
+            用户：本月花了多少钱？
-                返回：SELECT COUNT(*) as TransactionCount, SUM(ABS(Amount)) as TotalAmount, AVG(ABS(Amount)) as AvgAmount, MAX(ABS(Amount)) as MaxAmount FROM TransactionRecord WHERE Type = 0 AND OccurredAt >= '2025-12-01' AND OccurredAt < '2026-01-01'
+            返回：SELECT COUNT(*) as TransactionCount, SUM(ABS(Amount)) as TotalAmount, AVG(ABS(Amount)) as AvgAmount, MAX(ABS(Amount)) as MaxAmount FROM TransactionRecord WHERE Type = 0 AND OccurredAt >= '2025-12-01' AND OccurredAt < '2026-01-01'
             
-                示例4（详细记录 - 仅在用户明确要求详情时使用）：
+            示例4（详细记录 - 仅在用户明确要求详情时使用）：
-                用户：单笔超过1000元的支出有哪些？
+            用户：单笔超过1000元的支出有哪些？
-                返回：SELECT OccurredAt, Classify, Reason, ABS(Amount) as Amount FROM TransactionRecord WHERE Type = 0 AND ABS(Amount) > 1000 ORDER BY Amount DESC LIMIT 50
+            返回：SELECT OccurredAt, Classify, Reason, ABS(Amount) as Amount FROM TransactionRecord WHERE Type = 0 AND ABS(Amount) > 1000 ORDER BY Amount DESC LIMIT 50
             
-                只返回SQL语句。
+            只返回SQL语句。
-                """;
+            """;
 
             var sqlText = await openAiService.ChatAsync(sqlPrompt);
 
@@ -339,39 +339,39 @@ public class SmartHandleService(
             });
 
             var dataPrompt = $"""
-                当前日期：{DateTime.Now:yyyy年M月d日}
+            当前日期：{DateTime.Now:yyyy年M月d日}
-                用户问题：{userInput}
+            用户问题：{userInput}
             
-                查询结果数据（JSON格式）：
+            查询结果数据（JSON格式）：
-                {dataJson}
+            {dataJson}
             
-                说明：以上数据是根据用户问题查询出的聚合统计结果，请基于这些数据生成分析报告。
+            说明：以上数据是根据用户问题查询出的聚合统计结果，请基于这些数据生成分析报告。
             
-                请生成一份专业的数据分析报告，严格遵守以下要求：
+            请生成一份专业的数据分析报告，严格遵守以下要求：
             
-                【格式要求】
+            【格式要求】
-                1. 使用HTML格式（移动端H5页面风格）
+            1. 使用HTML格式（移动端H5页面风格）
-                2. 生成清晰的报告标题（基于用户问题）
+            2. 生成清晰的报告标题（基于用户问题）
-                3. 使用表格展示统计数据（table > thead/tbody > tr > th/td）
+            3. 使用表格展示统计数据（table > thead/tbody > tr > th/td）
-                4. 使用合适的HTML标签：h2（标题）、h3（小节）、p（段落）、table（表格）、ul/li（列表）、strong（强调）
+            4. 使用合适的HTML标签：h2（标题）、h3（小节）、p（段落）、table（表格）、ul/li（列表）、strong（强调）
-                5. 支出金额用 <span class='expense-value'>金额</span> 包裹
+            5. 支出金额用 <span class='expense-value'>金额</span> 包裹
-                6. 收入金额用 <span class='income-value'>金额</span> 包裹
+            6. 收入金额用 <span class='income-value'>金额</span> 包裹
-                7. 重要结论用 <span class='highlight'>内容</span> 高亮
+            7. 重要结论用 <span class='highlight'>内容</span> 高亮
             
-                【样式限制（重要）】
+            【样式限制（重要）】
-                8. 不要包含 html、body、head 标签
+            8. 不要包含 html、body、head 标签
-                9. 不要使用任何 style 属性或 <style> 标签
+            9. 不要使用任何 style 属性或 <style> 标签
-                10. 不要设置 background、background-color、color 等样式属性
+            10. 不要设置 background、background-color、color 等样式属性
-                11. 不要使用 div 包裹大段内容
+            11. 不要使用 div 包裹大段内容
             
-                【内容要求】
+            【内容要求】
-                12. 准确解读数据：将JSON数据转换为易读的表格和文字说明
+            12. 准确解读数据：将JSON数据转换为易读的表格和文字说明
-                13. 提供洞察分析：根据数据给出有价值的发现和趋势分析
+            13. 提供洞察分析：根据数据给出有价值的发现和趋势分析
-                14. 给出实用建议：基于数据提供合理的财务建议
+            14. 给出实用建议：基于数据提供合理的财务建议
-                15. 语言专业、清晰、简洁
+            15. 语言专业、清晰、简洁
             
-                直接输出纯净的HTML内容，不要markdown代码块标记。
+            直接输出纯净的HTML内容，不要markdown代码块标记。
-                """;
+            """;
 
             // 第四步：流式输出AI分析结果
             await foreach (var chunk in openAiService.ChatStreamAsync(dataPrompt))

WebApi/Controllers/EmailMessageController.cs

@@ -1,4 +1,6 @@
-namespace WebApi.Controllers.EmailMessage;
+using Service.EmailServices;
+
+namespace WebApi.Controllers.EmailMessage;
 
 [ApiController]
 [Route("api/[controller]/[action]")]
@@ -7,7 +9,7 @@ public class EmailMessageController(
     ITransactionRecordRepository transactionRepository,
     ILogger<EmailMessageController> logger,
     IEmailHandleService emailHandleService,
-    IEmailBackgroundService emailBackgroundService
+    IEmailSyncService emailBackgroundService
 ) : ControllerBase
 {
     /// <summary>