chaimi-keep-mcp 3.1.29 → 3.1.33-beta.0

package/SKILL.md

@@ -125,28 +125,111 @@ Agent 通过 MCP 协议自动获取工具列表，无需手动查询。
 
 ---
 
+### 📝 简单记账字段核对清单（save_expense）
+
+**调用 `save_expense` 前必须检查：**
+
+| 字段 | 是否必须 | 说明 |
+|------|----------|------|
+| `name` | ✅ | 商品/服务名称 |
+| `amount` | ✅ | 金额（正数）|
+| `category` | ✅ **新增** | 分类（如：餐饮、交通）|
+| `date` | ✅ | 日期（ISO 8601 格式）|
+| `store` | 可选 | 商家名称 |
+| `note` | 可选 | 备注 |
+
+**⚠️ 注意**：category 是记账的基本信息，必须提供！
+
+---
+
 ### 🚨 小票字段核对清单（调用前必须检查）
 
 **从 prompt 解析结果中提取的所有字段，必须全部传递给 `save_receipt`**：
 
-| 字段 | 是否必须 | 常见遗漏 | 检查方式 |
-|------|----------|----------|----------|
+| 字段 | 是否必须 | 常见遗漏 | 说明 |
+|------|----------|----------|------|
 | `store` | ✅ | 否 | 商家名称 |
 | `date` | ✅ **高频遗漏** | **是** | ISO 8601 格式，如：2026-01-08T11:42:27 |
 | `totalAmount` | ✅ | 否 | 商品原价总和 |
 | `actualAmount` | ✅ **高频遗漏** | **是** | 实付金额（优惠后）|
 | `originalAmount` | ✅ **高频遗漏** | **是** | 原价（优惠前）|
 | `discountAmount` | ✅ **高频遗漏** | **是** | 优惠金额 |
-| `paymentMethod` | ✅ **高频遗漏** | **是** | 如：支付宝支付、微信支付 |
-| `items` | ✅ | 否 | 商品数组，每个必须有 name/amount/price/quantity |
+| `paymentMethod` | 可选 | 是 | 如：支付宝支付、微信支付 |
+| `items` | ✅ | 否 | 商品数组，每个必须有完整字段 |
+
+**items 数组中每个商品必须包含：**
+
+| 字段 | 是否必须 | 说明 |
+|------|----------|------|
+| `name` | ✅ | 商品名称 |
+| `amount` | ✅ | 金额（= price × quantity）|
+| `price` | ✅ | 单价 |
+| `quantity` | ✅ | 数量 |
+| `category` | ✅ **新增** | 分类（如：食品、日用品）|
 
 **核对步骤**：
 1. 提取完小票信息后，对照上表检查每个字段
-2. **重点检查标记"高频遗漏"的字段**：date、actualAmount、originalAmount、discountAmount、paymentMethod
-3. 确认所有字段都在 args 中后再调用 `save_receipt`
-4. 如果某个字段小票上确实没有，可以传空字符串或 0，但不能省略
+2. **重点检查标记"高频遗漏"的字段**：date、actualAmount、originalAmount、discountAmount
+3. **确保每个商品都有 category**，这是记账的基本信息
+4. 确认所有字段都在 args 中后再调用 `save_receipt`
+5. 如果某个字段小票上确实没有，可以传空字符串或 0，但不能省略
 
-**注意**：MCP 工具会不断迭代更新，请以实际通过 MCP 协议获取的工具定义为准。
+**⚠️ 重要**：缺少必填字段会导致保存失败，请严格按照清单核对！
+
+---
+
+## 数据准确性校验（P1）
+
+服务器会自动校验以下规则，**校验失败会拒绝保存**：
+
+### 日期合理性
+- ✅ 不能是未来日期
+- ✅ 不能是60年前的日期
+- ✅ 格式必须是 ISO 8601（如：2026-01-08T11:42:27）
+
+### 金额一致性（save_receipt）
+- ✅ **商品金额总和 ≈ 总金额**（允许0.1元误差）
+  - 计算方式：`items` 中每个商品 `amount` 之和
+  - 注意：`amount` 必须等于 `price × quantity`
+- ✅ **优惠计算正确**（允许0.1元误差）
+  - 计算方式：`originalAmount - discountAmount = actualAmount`
+
+### 常见错误
+| 错误 | 原因 | 解决 |
+|------|------|------|
+| 商品金额总和与总金额不一致 | 商品 amount 计算错误或遗漏商品 | 检查每个商品的 amount = price × quantity |
+| 优惠计算不正确 | discountAmount 填写错误 | 检查 original - discount = actual |
+
+---
+
+## 智能补全（P2）
+
+如果调用 `save_receipt` 时遗漏了某些字段，但提供了 `rawInput`（原始小票文本），服务器会尝试自动补全：
+
+### 补全逻辑
+1. 检测缺失字段（store、date、totalAmount、actualAmount 等）
+2. 调用大模型重新解析 `rawInput`
+3. 提取缺失字段并补全
+4. 补全后再次进行 P1 校验
+
+### 使用建议
+- **尽量传递完整字段**，不要依赖智能补全
+- 智能补全是兜底机制，可能因解析不准确而失败
+- 如果补全后仍校验失败，会返回错误
+
+### rawInput 格式
+```json
+{
+  "store": "华润万家",
+  "date": "2026-01-08T11:42:27",
+  "totalAmount": 26.59,
+  "actualAmount": 25.88,
+  "originalAmount": 26.59,
+  "discountAmount": 0.71,
+  "items": [...],
+  "rawInput": "华润万家春风店 2026-01-08 丛林香菇、油条、红糖馒头..."
+}
+```
 
 ---
 
@@ -160,6 +243,49 @@ Agent 通过 MCP 协议自动获取工具列表，无需手动查询。
 
 ---
 
+## 防重复录入（Agent 本地实现）
+
+**目标**：提醒用户可能的重复录入，但不阻止保存
+
+### 实现方式
+
+Agent 维护本地记账记录日志（内存或本地文件）：
+
+```javascript
+// 记录格式
+{
+  store: "商家名称",
+  date: "2026-01-08",  // 只记录到日期
+  actualAmount: 25.88,
+  timestamp: 1704694947000  // 记账时间戳
+}
+```
+
+### 重复检测规则
+
+- **时间窗口**：24 小时内
+- **匹配条件**：`store` + `date(到天)` + `actualAmount` 相同
+- **处理方式**：
+  1. 发现重复时，提醒用户："⚠️ 24 小时内已有相似记录（华润万家春风店 25.88元），确认要重复录入吗？"
+  2. 用户确认后，继续调用 `save_receipt`
+  3. 用户取消，停止操作
+
+### 代码示例
+
+```javascript
+// 检查是否重复
+function isDuplicate(store, date, actualAmount) {
+  const fingerprint = `${store}_${date.substring(0,10)}_${actualAmount}`;
+  const recentRecord = recentLogs.find(log => {
+    const timeDiff = Date.now() - log.timestamp;
+    return log.fingerprint === fingerprint && timeDiff < 24 * 60 * 60 * 1000;
+  });
+  return recentRecord;
+}
+```
+
+---
+
 ## 回复规范（必须严格遵守）
 
 记账成功后，回复内容必须包含以下格式：
@@ -244,4 +370,10 @@ MCP Server: v3.1.23
 
 ---
 
+## 相关文档
+
+- [MCP优化需求跟踪表](../../../docs/08-项目管理/02-需求跟踪/MCP优化需求跟踪表.md) - 项目需求跟踪
+
+---
+
 *最后更新：2026-04-14*

package/bin/sync-skill.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+/**
+ * Skill 文件同步脚本
+ * 
+ * 功能：安装时自动同步 SKILL.md 到 Skill 架构的 Agent
+ * 支持：OpenClaw、WorkBuddy 等
+ * 扩展：可通过 ~/.chaimi-mcp/skill-config.json 添加自定义路径
+ */
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+// 内置常见 Skill 架构 Agent 路径
+const BUILT_IN_PATHS = [
+  {
+    name: 'OpenClaw',
+    skillPath: path.join(os.homedir(), '.openclaw', 'skills', 'chaimi-keep-mcp'),
+    platform: ['darwin', 'linux']
+  },
+  {
+    name: 'WorkBuddy',
+    skillPath: path.join(os.homedir(), '.workbuddy', 'skills', 'chaimi-keep-mcp'),
+    platform: ['darwin', 'linux', 'win32']
+  }
+];
+
+// 用户自定义配置文件路径
+const USER_CONFIG_PATH = path.join(os.homedir(), '.chaimi-mcp', 'skill-config.json');
+
+/**
+ * 加载用户自定义配置
+ */
+function loadUserConfig() {
+  try {
+    if (fs.existsSync(USER_CONFIG_PATH)) {
+      const config = JSON.parse(fs.readFileSync(USER_CONFIG_PATH, 'utf8'));
+      return config.skillDirectories || [];
+    }
+  } catch (error) {
+    console.error(`⚠️  读取用户配置失败: ${error.message}`);
+  }
+  return [];
+}
+
+/**
+ * 同步 SKILL.md 到指定目录
+ */
+function syncSkillToDirectory(targetPath, agentName) {
+  try {
+    const skillSourcePath = path.join(__dirname, '..', 'SKILL.md');
+
+    // 检查源文件是否存在
+    if (!fs.existsSync(skillSourcePath)) {
+      console.error(`❌ ${agentName}: SKILL.md 源文件不存在`);
+      return { success: false, error: 'source-not-found' };
+    }
+
+    // 检查父目录是否存在（Agent 是否安装）
+    const parentDir = path.dirname(targetPath);
+    if (!fs.existsSync(parentDir)) {
+      // Agent 未安装，静默跳过
+      return { success: false, reason: 'agent-not-installed' };
+    }
+
+    // 创建 skill 目录
+    if (!fs.existsSync(targetPath)) {
+      fs.mkdirSync(targetPath, { recursive: true });
+    }
+
+    // 复制 SKILL.md
+    const targetFilePath = path.join(targetPath, 'SKILL.md');
+    fs.copyFileSync(skillSourcePath, targetFilePath);
+
+    return { success: true, path: targetFilePath };
+
+  } catch (error) {
+    console.error(`❌ ${agentName}: 同步失败 - ${error.message}`);
+    return { success: false, error: error.message };
+  }
+}
+
+/**
+ * 主函数
+ */
+function main() {
+  console.log('📋 同步 Skill 文件到 Agent...\n');
+
+  const results = [];
+
+  // 1. 同步内置路径
+  for (const agent of BUILT_IN_PATHS) {
+    // 平台检查
+    if (agent.platform && !agent.platform.includes(os.platform())) {
+      continue;
+    }
+
+    const result = syncSkillToDirectory(agent.skillPath, agent.name);
+    results.push({ agent: agent.name, ...result });
+
+    if (result.success) {
+      console.log(`✅ ${agent.name}: Skill 文件已同步`);
+    } else if (result.reason === 'agent-not-installed') {
+      // 静默跳过未安装的 Agent
+    } else {
+      console.error(`❌ ${agent.name}: 同步失败`);
+    }
+  }
+
+  // 2. 同步用户自定义路径
+  const userPaths = loadUserConfig();
+  for (const userPath of userPaths) {
+    if (!userPath.name || !userPath.path) {
+      console.error(`⚠️  无效的用户配置: ${JSON.stringify(userPath)}`);
+      continue;
+    }
+
+    const result = syncSkillToDirectory(userPath.path, userPath.name);
+    results.push({ agent: userPath.name, ...result });
+
+    if (result.success) {
+      console.log(`✅ ${userPath.name}: Skill 文件已同步（自定义）`);
+    } else if (result.reason !== 'agent-not-installed') {
+      console.error(`❌ ${userPath.name}: 同步失败`);
+    }
+  }
+
+  // 统计
+  const successCount = results.filter(r => r.success).length;
+  const skipCount = results.filter(r => r.reason === 'agent-not-installed').length;
+
+  console.log(`\n📊 同步完成: ${successCount} 个成功, ${skipCount} 个跳过（未安装）\n`);
+
+  // 提示用户如何添加自定义路径
+  if (userPaths.length === 0) {
+    console.log('💡 提示: 如需添加其他 Skill 架构 Agent，可创建配置文件:');
+    console.log(`   ${USER_CONFIG_PATH}`);
+    console.log('   格式: {"skillDirectories": [{"name": "Agent名称", "path": "skill目录路径"}]}\n');
+  }
+}
+
+// 执行
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.1.29",
+  "version": "3.1.33-beta.0",
   "description": "柴米记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {
@@ -18,7 +18,8 @@
   "type": "commonjs",
   "scripts": {
     "start": "node server.js",
-    "dev": "node server.js"
+    "dev": "node server.js",
+    "postinstall": "node bin/sync-skill.js"
   },
   "keywords": [
     "mcp",

package/server.js

@@ -441,6 +441,75 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
     switch (name) {
       case 'save_expense': {
+        // P0: 数据完整性检查 - 必填字段验证
+        const requiredFields = ['name', 'amount', 'category', 'date'];
+        const missingFields = [];
+        
+        for (const field of requiredFields) {
+          if (processedArgs[field] === undefined || processedArgs[field] === null || processedArgs[field] === '') {
+            missingFields.push(field);
+          }
+        }
+        
+        if (missingFields.length > 0) {
+          result = {
+            success: false,
+            error: `必填字段缺失：${missingFields.join(', ')}。请从解析结果中提取并传递所有字段。`,
+            code: 400
+          };
+          userMessage = `❌ 记账失败\n\n错误：缺少必填字段：${missingFields.join(', ')}\n\n💡 解决方案：\n1. 请检查是否从用户输入中提取了所有信息\n2. 确保传递以下字段：name（商品名）、amount（金额）、category（分类）、date（日期）\n3. 参考 SKILL.md 中的"调用前检查清单"`;
+          break;
+        }
+        
+        // 数值校验
+        if (typeof processedArgs.amount !== 'number' || processedArgs.amount <= 0) {
+          result = {
+            success: false,
+            error: '金额必须是正数',
+            code: 400
+          };
+          userMessage = '❌ 记账失败：金额必须是正数';
+          break;
+        }
+        
+        // P1: 日期合理性检查
+        if (processedArgs.date) {
+          const inputDate = new Date(processedArgs.date);
+          const now = new Date();
+          const sixtyYearsAgo = new Date();
+          sixtyYearsAgo.setFullYear(now.getFullYear() - 60);
+          
+          if (isNaN(inputDate.getTime())) {
+            result = {
+              success: false,
+              error: '日期格式无效',
+              code: 400
+            };
+            userMessage = '❌ 记账失败：日期格式无效，请使用 ISO 8601 格式（如：2026-01-08T11:42:27）';
+            break;
+          }
+          
+          if (inputDate > now) {
+            result = {
+              success: false,
+              error: '日期不能是未来时间',
+              code: 400
+            };
+            userMessage = '❌ 记账失败：日期不能是未来时间';
+            break;
+          }
+          
+          if (inputDate < sixtyYearsAgo) {
+            result = {
+              success: false,
+              error: '日期不能是60年前',
+              code: 400
+            };
+            userMessage = '❌ 记账失败：日期不能是60年前';
+            break;
+          }
+        }
+        
         const mcpParams = convertParams('save_expense', processedArgs);
         result = await callMcpHub('addExpense', mcpParams, token);
         
@@ -459,44 +528,190 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
 
       case 'save_receipt': {
-        // 0. 参数完整性检查 - 提醒 Agent 哪些字段缺失
-        const requiredFields = ['store', 'date', 'totalAmount', 'actualAmount', 'originalAmount', 'discountAmount', 'paymentMethod'];
+        // P0: 数据完整性检查 - 必填字段验证
+        const requiredFields = ['store', 'date', 'totalAmount', 'actualAmount', 'originalAmount', 'discountAmount'];
         const missingFields = [];
-        requiredFields.forEach(field => {
+        
+        for (const field of requiredFields) {
           if (processedArgs[field] === undefined || processedArgs[field] === null || processedArgs[field] === '') {
             missingFields.push(field);
           }
-        });
+        }
         
         if (missingFields.length > 0) {
-          console.error(`⚠️ 警告：save_receipt 缺少以下字段：${missingFields.join(', ')}`);
-          console.error(`   请从 get_parse_prompt 的解析结果中提取并传递所有字段`);
+          result = {
+            success: false,
+            error: `必填字段缺失：${missingFields.join(', ')}。请从 get_parse_prompt 的解析结果中提取并传递所有字段。`,
+            code: 400
+          };
+          userMessage = `❌ 保存失败\n\n错误：缺少必填字段：${missingFields.join(', ')}\n\n💡 解决方案：\n1. 请检查是否从 get_parse_prompt 的解析结果中提取了所有信息\n2. 确保传递以下字段：store、date、totalAmount、actualAmount、originalAmount、discountAmount\n3. 参考 SKILL.md 中的"小票字段核对清单"`;
+          break;
         }
         
-        // 1. 参数格式强制检查 - 确保 items 中每个商品都有完整的字段
-        if (processedArgs.items && Array.isArray(processedArgs.items)) {
-          const invalidItems = [];
-          processedArgs.items.forEach((item, index) => {
-            const itemMissingFields = [];
-            if (!item.hasOwnProperty('name')) itemMissingFields.push('name');
-            if (!item.hasOwnProperty('amount')) itemMissingFields.push('amount');
-            if (!item.hasOwnProperty('price')) itemMissingFields.push('price');
-            if (!item.hasOwnProperty('quantity')) itemMissingFields.push('quantity');
-            
-            if (itemMissingFields.length > 0) {
-              invalidItems.push(`商品${index + 1}(${item.name || '未命名'})缺少字段: ${itemMissingFields.join(', ')}`);
-            }
-          });
+        // 数值校验
+        const amountFields = ['totalAmount', 'actualAmount', 'originalAmount'];
+        for (const field of amountFields) {
+          if (typeof processedArgs[field] !== 'number' || processedArgs[field] <= 0) {
+            result = {
+              success: false,
+              error: `${field} 必须是正数`,
+              code: 400
+            };
+            userMessage = `❌ 保存失败：${field} 必须是正数`;
+            break;
+          }
+        }
+        if (result && !result.success) break;
+        
+        if (typeof processedArgs.discountAmount !== 'number' || processedArgs.discountAmount < 0) {
+          result = {
+            success: false,
+            error: 'discountAmount 必须是非负数',
+            code: 400
+          };
+          userMessage = '❌ 保存失败：优惠金额必须是非负数';
+          break;
+        }
+        
+        // 检查 items 是否存在且非空
+        if (!processedArgs.items || !Array.isArray(processedArgs.items) || processedArgs.items.length === 0) {
+          result = {
+            success: false,
+            error: 'items 不能为空，必须包含至少一个商品',
+            code: 400
+          };
+          userMessage = '❌ 保存失败：商品列表不能为空\n\n💡 请确保从 get_parse_prompt 的解析结果中正确提取了 items 数组';
+          break;
+        }
+        
+        // 检查 items 中每个商品的必填字段（包括 category）
+        const invalidItems = [];
+        processedArgs.items.forEach((item, index) => {
+          const itemMissingFields = [];
+          if (!item.hasOwnProperty('name') || item.name === '') itemMissingFields.push('name');
+          if (!item.hasOwnProperty('amount') || item.amount === undefined) itemMissingFields.push('amount');
+          if (!item.hasOwnProperty('price') || item.price === undefined) itemMissingFields.push('price');
+          if (!item.hasOwnProperty('quantity') || item.quantity === undefined) itemMissingFields.push('quantity');
+          if (!item.hasOwnProperty('category') || item.category === '') itemMissingFields.push('category');
           
-          if (invalidItems.length > 0) {
+          if (itemMissingFields.length > 0) {
+            invalidItems.push(`商品${index + 1}(${item.name || '未命名'})缺少字段: ${itemMissingFields.join(', ')}`);
+          }
+        });
+        
+        if (invalidItems.length > 0) {
+          result = {
+            success: false,
+            error: `商品数据不完整：${invalidItems.join('; ')}。每个商品必须包含：name, amount, price, quantity, category`,
+            code: 400
+          };
+          userMessage = `❌ 保存失败\n\n错误：商品数据格式不完整\n\n${invalidItems.join('\n')}\n\n💡 解决方案：\n1. 请更新您的柴米记账 MCP Skill\n2. 确保每个商品包含完整的5个字段：name, amount, price, quantity, category\n3. category 是记账的基本信息，不能为空`;
+          break;
+        }
+        
+        // P1: 日期合理性检查
+        if (processedArgs.date) {
+          const inputDate = new Date(processedArgs.date);
+          const now = new Date();
+          const sixtyYearsAgo = new Date();
+          sixtyYearsAgo.setFullYear(now.getFullYear() - 60);
+          
+          if (isNaN(inputDate.getTime())) {
             result = {
               success: false,
-              error: `参数格式错误：${invalidItems.join('; ')}。请更新您的 MCP Skill 或检查 items 数组格式。每个商品必须包含：name, amount, price, quantity`,
+              error: '日期格式无效',
               code: 400
             };
-            userMessage = `❌ 保存失败\n\n错误：商品数据格式不完整\n\n${invalidItems.join('\n')}\n\n💡 解决方案：\n1. 请更新您的柴米记账 MCP Skill\n2. 确保每个商品包含完整的4个字段：name, amount, price, quantity\n3. amount 必须等于 price × quantity`;
+            userMessage = '❌ 保存失败：日期格式无效，请使用 ISO 8601 格式（如：2026-01-08T11:42:27）';
             break;
           }
+          
+          if (inputDate > now) {
+            result = {
+              success: false,
+              error: '日期不能是未来时间',
+              code: 400
+            };
+            userMessage = '❌ 保存失败：日期不能是未来时间，请检查小票日期是否正确';
+            break;
+          }
+          
+          if (inputDate < sixtyYearsAgo) {
+            result = {
+              success: false,
+              error: '日期不能是60年前',
+              code: 400
+            };
+            userMessage = '❌ 保存失败：日期不能是60年前，请检查小票日期是否正确';
+            break;
+          }
+        }
+        
+        // P2: 智能补全 - 如果有缺失字段且提供了 rawInput，尝试重新解析
+        const missingFieldsForFill = [];
+        const fillableFields = ['store', 'date', 'totalAmount', 'actualAmount', 'originalAmount', 'discountAmount', 'paymentMethod'];
+        for (const field of fillableFields) {
+          if (processedArgs[field] === undefined || processedArgs[field] === null || processedArgs[field] === '') {
+            missingFieldsForFill.push(field);
+          }
+        }
+        
+        if (missingFieldsForFill.length > 0 && processedArgs.rawInput) {
+          console.error(`⚠️ 字段缺失，尝试从 rawInput 重新解析：${missingFieldsForFill.join(', ')}`);
+          
+          const parseResult = await callMcpPrompt(
+            'parseReceipt',
+            {
+              text: processedArgs.rawInput,
+              type: 'parseReceipt'
+            },
+            token
+          );
+          
+          if (parseResult.success && parseResult.data) {
+            // 只补全缺失的字段
+            for (const field of missingFieldsForFill) {
+              if (parseResult.data[field] !== undefined && parseResult.data[field] !== null && parseResult.data[field] !== '') {
+                processedArgs[field] = parseResult.data[field];
+                console.error(`✅ 补全字段：${field} = ${processedArgs[field]}`);
+              }
+            }
+            
+            // 如果 items 也缺失，尝试补全
+            if ((!processedArgs.items || processedArgs.items.length === 0) && parseResult.data.items) {
+              processedArgs.items = parseResult.data.items;
+              console.error(`✅ 补全字段：items（${processedArgs.items.length} 个商品）`);
+            }
+          } else {
+            console.error(`❌ 重新解析失败：${parseResult.error || '未知错误'}`);
+          }
+        }
+        
+        // P1: 金额一致性校验
+        const ERROR_MARGIN = 0.1; // 允许0.1元误差
+        
+        // 校验1：items 各项 amount 之和 ≈ totalAmount
+        const itemsSum = processedArgs.items.reduce((sum, item) => sum + (item.amount || 0), 0);
+        if (Math.abs(itemsSum - processedArgs.totalAmount) > ERROR_MARGIN) {
+          result = {
+            success: false,
+            error: `商品金额总和 (${itemsSum.toFixed(2)}) 与总金额 (${processedArgs.totalAmount}) 不一致`,
+            code: 400
+          };
+          userMessage = `❌ 保存失败：金额校验不通过\n\n商品金额总和：${itemsSum.toFixed(2)}元\n小票总金额：${processedArgs.totalAmount}元\n\n💡 请检查：\n1. 每个商品的 amount 是否正确（amount = price × quantity）\n2. 是否有遗漏的商品`;
+          break;
+        }
+        
+        // 校验2：originalAmount - discountAmount ≈ actualAmount
+        const calculatedActual = processedArgs.originalAmount - processedArgs.discountAmount;
+        if (Math.abs(calculatedActual - processedArgs.actualAmount) > ERROR_MARGIN) {
+          result = {
+            success: false,
+            error: `优惠计算不正确：原价(${processedArgs.originalAmount}) - 优惠(${processedArgs.discountAmount}) = ${calculatedActual.toFixed(2)}，不等于实付金额(${processedArgs.actualAmount})`,
+            code: 400
+          };
+          userMessage = `❌ 保存失败：金额校验不通过\n\n原价：${processedArgs.originalAmount}元\n优惠：${processedArgs.discountAmount}元\n计算实付：${calculatedActual.toFixed(2)}元\n实际实付：${processedArgs.actualAmount}元\n\n💡 请检查优惠金额是否正确`;
+          break;
         }
         
         // 1. 调用 parseReceipt 重新提取小票信息（覆盖 Agent 传的数据）