chaimi-keep-mcp 3.1.28 → 3.1.29

package/SKILL.md

@@ -120,7 +120,31 @@ Agent 通过 MCP 协议自动获取工具列表，无需手动查询。
 ⚠️ **强制流程**：保存小票时必须按以下顺序执行：
 1. 调用 `get_parse_prompt` 获取 prompt 模板
 2. 使用 prompt 模板调用大模型解析小票图片
-3. 调用 `save_receipt` 保存解析结果
+3. **调用 `save_receipt` 前，必须完成字段核对清单（见下文）**
+4. 调用 `save_receipt` 保存解析结果
+
+---
+
+### 🚨 小票字段核对清单（调用前必须检查）
+
+**从 prompt 解析结果中提取的所有字段，必须全部传递给 `save_receipt`**：
+
+| 字段 | 是否必须 | 常见遗漏 | 检查方式 |
+|------|----------|----------|----------|
+| `store` | ✅ | 否 | 商家名称 |
+| `date` | ✅ **高频遗漏** | **是** | ISO 8601 格式，如：2026-01-08T11:42:27 |
+| `totalAmount` | ✅ | 否 | 商品原价总和 |
+| `actualAmount` | ✅ **高频遗漏** | **是** | 实付金额（优惠后）|
+| `originalAmount` | ✅ **高频遗漏** | **是** | 原价（优惠前）|
+| `discountAmount` | ✅ **高频遗漏** | **是** | 优惠金额 |
+| `paymentMethod` | ✅ **高频遗漏** | **是** | 如：支付宝支付、微信支付 |
+| `items` | ✅ | 否 | 商品数组，每个必须有 name/amount/price/quantity |
+
+**核对步骤**：
+1. 提取完小票信息后，对照上表检查每个字段
+2. **重点检查标记"高频遗漏"的字段**：date、actualAmount、originalAmount、discountAmount、paymentMethod
+3. 确认所有字段都在 args 中后再调用 `save_receipt`
+4. 如果某个字段小票上确实没有，可以传空字符串或 0，但不能省略
 
 **注意**：MCP 工具会不断迭代更新，请以实际通过 MCP 协议获取的工具定义为准。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.1.28",
+  "version": "3.1.29",
   "description": "柴米记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {

package/server.js

@@ -459,18 +459,32 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       }
 
       case 'save_receipt': {
-        // 0. 参数格式强制检查 - 确保 items 中每个商品都有完整的字段
+        // 0. 参数完整性检查 - 提醒 Agent 哪些字段缺失
+        const requiredFields = ['store', 'date', 'totalAmount', 'actualAmount', 'originalAmount', 'discountAmount', 'paymentMethod'];
+        const missingFields = [];
+        requiredFields.forEach(field => {
+          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 的解析结果中提取并传递所有字段`);
+        }
+        
+        // 1. 参数格式强制检查 - 确保 items 中每个商品都有完整的字段
         if (processedArgs.items && Array.isArray(processedArgs.items)) {
           const invalidItems = [];
           processedArgs.items.forEach((item, index) => {
-            const missingFields = [];
-            if (!item.hasOwnProperty('name')) missingFields.push('name');
-            if (!item.hasOwnProperty('amount')) missingFields.push('amount');
-            if (!item.hasOwnProperty('price')) missingFields.push('price');
-            if (!item.hasOwnProperty('quantity')) missingFields.push('quantity');
+            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 (missingFields.length > 0) {
-              invalidItems.push(`商品${index + 1}(${item.name || '未命名'})缺少字段: ${missingFields.join(', ')}`);
+            if (itemMissingFields.length > 0) {
+              invalidItems.push(`商品${index + 1}(${item.name || '未命名'})缺少字段: ${itemMissingFields.join(', ')}`);
             }
           });