chaimi-keep-mcp 3.1.30 → 3.1.33-beta.1

package/SKILL.md

@@ -142,7 +142,7 @@ Agent 通过 MCP 协议自动获取工具列表，无需手动查询。
 
 ---
 
-### 🚨 小票字段核对清单（调用前必须检查）
+### 🚨 小票字段说明（save_receipt）
 
 **从 prompt 解析结果中提取的所有字段，必须全部传递给 `save_receipt`**：
 
@@ -167,14 +167,7 @@ Agent 通过 MCP 协议自动获取工具列表，无需手动查询。
 | `quantity` | ✅ | 数量 |
 | `category` | ✅ **新增** | 分类（如：食品、日用品）|
 
-**核对步骤**：
-1. 提取完小票信息后，对照上表检查每个字段
-2. **重点检查标记"高频遗漏"的字段**：date、actualAmount、originalAmount、discountAmount
-3. **确保每个商品都有 category**，这是记账的基本信息
-4. 确认所有字段都在 args 中后再调用 `save_receipt`
-5. 如果某个字段小票上确实没有，可以传空字符串或 0，但不能省略
-
-**⚠️ 重要**：缺少必填字段会导致保存失败，请严格按照清单核对！
+**⚠️ 重要**：缺少必填字段会导致保存失败。服务器会自动校验数据完整性和准确性。
 
 ---
 
@@ -315,4 +308,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.30",
+  "version": "3.1.33-beta.1",
   "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

@@ -472,6 +472,44 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           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);
         
@@ -571,6 +609,111 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           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;
+          }
+        }
+        
+        // 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 传的数据）
         if (processedArgs.rawInput) {
           const parseResult = await callMcpPrompt(
@@ -828,6 +971,46 @@ function validateQuantity(quantity) {
   return isNaN(num) || num <= 0 ? 1 : num;
 }
 
+/**
+ * 格式化日期为 ISO 8601 格式（带时区）
+ * 解决时区转换问题：确保传入的本地时间正确存储
+ */
+function formatDateWithTimezone(dateStr) {
+  if (!dateStr) return '';
+  
+  try {
+    // 如果已经是带时区的格式，直接返回
+    if (dateStr.match(/[+-]\d{2}:\d{2}$/)) {
+      return dateStr;
+    }
+    
+    // 如果是简单的 ISO 格式（如 2026-04-14T12:00:00），添加本地时区
+    if (dateStr.match(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$/)) {
+      // 添加北京时间时区 +08:00
+      return dateStr + '+08:00';
+    }
+    
+    // 其他情况，尝试解析并格式化为带时区的格式
+    const date = new Date(dateStr);
+    if (isNaN(date.getTime())) {
+      return dateStr; // 解析失败，原样返回
+    }
+    
+    // 格式化为 ISO 8601 带时区格式
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    const hours = String(date.getHours()).padStart(2, '0');
+    const minutes = String(date.getMinutes()).padStart(2, '0');
+    const seconds = String(date.getSeconds()).padStart(2, '0');
+    
+    return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}+08:00`;
+  } catch (error) {
+    console.error('日期格式化错误:', error);
+    return dateStr;
+  }
+}
+
 function extractWeightInGrams(weightStr) {
   if (!weightStr || typeof weightStr !== 'string') return 0;
   
@@ -884,7 +1067,7 @@ function convertParams(toolName, args) {
         quantity: 1,
         category: sanitizeString(args.category, 50) || '其他',
         store: sanitizeString(args.store, 100) || '',
-        date: args.date,
+        date: formatDateWithTimezone(args.date),
         transactionType: 'expense',
         unit: '',
         weight: '',
@@ -943,7 +1126,7 @@ function convertParams(toolName, args) {
         memberCardNo: sanitizeString(args.memberCardNo, 50),
         currentPoints: parseInt(args.currentPoints) || 0,
         totalPoints: parseInt(args.totalPoints) || 0,
-        date: args.date,
+        date: formatDateWithTimezone(args.date),
         rawInput: sanitizeString(args.rawInput, 2000),
         agentType: args.agentType || '',
         apiProvider: args.apiProvider || '',
@@ -971,7 +1154,7 @@ function convertParams(toolName, args) {
         amount: validateAmount(args.amount),
         category: sanitizeString(args.category, 50) || '其他',
         store: sanitizeString(args.store, 100),
-        date: args.date,
+        date: formatDateWithTimezone(args.date),
         note: sanitizeString(args.note, 500),
         transactionType: 'income',
         rawInput: sanitizeString(args.rawInput, 1000),