chaimi-keep-mcp 3.1.27 → 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/bin/cli.js

@@ -31,7 +31,7 @@ const DEFAULT_CHAIMI_CONFIG = {
   lifecycle: 'keep-alive'
 };
 
-// 支持的 Agent 列表
+// 支持的 Agent 列表（MCP 配置）
 const SUPPORTED_AGENTS = [
   {
     name: 'MCPorter (WorkBuddy/OpenClaw)',
@@ -74,6 +74,30 @@ const SUPPORTED_AGENTS = [
   }
 ];
 
+// 支持的 Skill 目录（OpenClaw/WorkBuddy 架构）
+const SKILL_DIRECTORIES = [
+  {
+    name: 'OpenClaw',
+    skillPath: path.join(os.homedir(), '.openclaw', 'skills', 'chaimi-keep-mcp'),
+    platform: 'darwin'
+  },
+  {
+    name: 'OpenClaw (Linux)',
+    skillPath: path.join(os.homedir(), '.openclaw', 'skills', 'chaimi-keep-mcp'),
+    platform: 'linux'
+  },
+  {
+    name: 'WorkBuddy',
+    skillPath: path.join(os.homedir(), '.workbuddy', 'skills', 'chaimi-keep-mcp'),
+    platform: 'darwin'
+  },
+  {
+    name: 'WorkBuddy (Windows)',
+    skillPath: path.join(os.homedir(), 'workbuddy', 'skills', 'chaimi-keep-mcp'),
+    platform: 'win32'
+  }
+];
+
 /**
  * 安全读取 JSON 文件
  */
@@ -156,6 +180,62 @@ function installToAgent(agent) {
   }
 }
 
+/**
+ * 同步 SKILL.md 到 Skill 目录
+ * 用于 OpenClaw/WorkBuddy 等支持 Skill 文件的 Agent
+ */
+function syncSkillFiles() {
+  const skillSourcePath = path.join(__dirname, '..', 'SKILL.md');
+
+  if (!fs.existsSync(skillSourcePath)) {
+    return { success: false, reason: 'source-not-found' };
+  }
+
+  const results = [];
+
+  for (const skillDir of SKILL_DIRECTORIES) {
+    try {
+      // 平台检查
+      if (skillDir.platform && skillDir.platform !== os.platform()) {
+        continue;
+      }
+
+      // 检查父目录是否存在（Agent 是否安装）
+      const parentDir = path.dirname(skillDir.skillPath);
+      if (!fs.existsSync(parentDir)) {
+        continue; // Agent 未安装，跳过
+      }
+
+      // 创建 skill 目录
+      if (!fs.existsSync(skillDir.skillPath)) {
+        fs.mkdirSync(skillDir.skillPath, { recursive: true });
+      }
+
+      // 复制 SKILL.md
+      const targetPath = path.join(skillDir.skillPath, 'SKILL.md');
+      fs.copyFileSync(skillSourcePath, targetPath);
+
+      results.push({
+        agent: skillDir.name,
+        success: true,
+        path: targetPath
+      });
+
+      console.error(`✓ ${skillDir.name}: Skill 文件已同步`);
+
+    } catch (error) {
+      results.push({
+        agent: skillDir.name,
+        success: false,
+        error: error.message
+      });
+      console.error(`✗ ${skillDir.name}: Skill 同步失败 (${error.message})`);
+    }
+  }
+
+  return results;
+}
+
 /**
  * 配置所有支持的 Agent
  * 注意：所有输出使用 console.error，避免污染 stdout（MCP 协议通信使用 stdout）
@@ -165,6 +245,7 @@ function configureAllAgents() {
 
   const results = [];
 
+  // 1. 配置 MCP Server
   for (const agent of SUPPORTED_AGENTS) {
     const result = installToAgent(agent);
     results.push({ agent: agent.name, ...result });
@@ -187,13 +268,17 @@ function configureAllAgents() {
     }
   }
 
+  // 2. 同步 Skill 文件
+  console.error('\n📋 正在同步 Skill 文件...\n');
+  syncSkillFiles();
+
   // 统计
   const configured = results.filter(r => r.success && r.action !== 'skipped').length;
   const skipped = results.filter(r => r.success && r.action === 'skipped').length;
   const failed = results.filter(r => !r.success).length;
 
   console.error('\n📊 配置统计:');
-  console.error(`   新增配置: ${configured} 个`);
+  console.error(`   新增 MCP 配置: ${configured} 个`);
   console.error(`   已存在: ${skipped} 个`);
   if (failed > 0) {
     console.error(`   失败: ${failed} 个`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.1.27",
+  "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(', ')}`);
             }
           });