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

package/SKILL.md

@@ -178,6 +178,61 @@ Agent 通过 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 丛林香菇、油条、红糖馒头..."
+}
+```
+
+---
+
 ## 确认规则
 
 | 风险等级 | 场景 | 策略 |
@@ -315,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.30",
+  "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

@@ -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(