chaimi-keep-mcp 3.1.40-beta.2 → 3.1.40-beta.4

package/SKILL.md

@@ -205,7 +205,15 @@ get_statistics period="this_week"
 
 Agent **直接使用当前时间**作为消费时间，无需进行时间语义解析。
 
-**最终传入的 `date` 参数格式：**毫秒级时间戳（13位数字）⚠️ **重要：**必须根据实际年月日时分秒计算时间戳，示例格式：`YYYY-MM-DD HH:mm:ss` → `[毫秒时间戳]`（北京时间），禁止使用示例中的具体数字，必须根据当前实际时间重新计算
+**最终传入的 `date` 参数格式：**毫秒级时间戳（13位数字）⚠️ **⚠️ ⚠️ 重要 ⚠️ ⚠️ ⚠️**：
+
+- **必须使用 date 命令计算时间戳，禁止手动填写或猜测**
+- **强制使用以下命令：**
+  ```bash
+  date -j -f "%Y-%m-%d %H:%M:%S" "YYYY-MM-DD HH:MM:SS" +%s000
+  ```
+- 如果未使用 date 命令计算，服务端将拒绝保存
+- 示例格式：`2026-04-20 18:30:00` → `1776604200000`（北京时间），禁止使用示例中的具体数字，必须根据实际时间计算
 
 **必填字段：** `name`、`amount`、`category`、`date`
 
@@ -238,7 +246,15 @@ Agent **直接使用当前时间**作为收入时间，无需进行时间语义
 
 **必填字段：**
 - `store`：商家名称
-- `date`：毫秒时间戳（13位数字，格式：`[毫秒时间戳]`），小票上的真实消费时间，禁止使用示例中的具体数字，必须根据小票上的实际时间重新计算
+- `date`：毫秒时间戳（13位数字，格式：`[毫秒时间戳]`），小票上的真实消费时间，⚠️ **⚠️ ⚠️ 重要 ⚠️ ⚠️ ⚠️**：
+  
+  - **必须使用 date 命令计算时间戳，禁止手动填写或猜测**
+  - **强制使用以下命令：**
+    ```bash
+    date -j -f "%Y-%m-%d %H:%M:%S" "YYYY-MM-DD HH:MM:SS" +%s000
+    ```
+  - 如果未使用 date 命令计算，服务端将拒绝保存
+  - 禁止使用示例中的具体数字，必须根据小票上的实际时间重新计算
 - `totalAmount`：商品原价总和
 - `actualAmount`：实付金额（优惠后）
 - `originalAmount`：原价（优惠前）
@@ -277,21 +293,36 @@ Agent **直接使用当前时间**作为收入时间，无需进行时间语义
 ```
 ✅ 【商品名/店名】¥【金额】 已录入柴米AI记账。
 
-[自定义其他内容]
-
 【友好结束语】
-------------
-chaimi-keep-mcp: v【版本号】
 
+消费洞察：【洞察内容】（可选）
+-------------
+chaimi-keep-mcp: v【版本号】
 ```
 
 **友好结束语参考：**
 - 餐饮类：用餐愉快！🍚 / 好好吃饭哦~
+- 食品类：吃好喝好！🍎
 - 交通类：出行顺利！🚗
 - 购物类：买得开心！🛍️
 - 收入类：入账顺利！💰
 - 通用：记账完成！继续保持~ ✨
 
+**消费洞察（可选）：**
+- 由云函数自动生成，返回记账后的即时洞察
+- 示例：这是你本周第19次餐饮消费，要不要看看本周餐饮花了多少钱？
+
+**真实示例：**
+```
+✅ 【肌肉】¥24 已录入柴米AI记账。
+
+好好吃饭哦~
+
+消费洞察：这是你本周第19次餐饮消费，要不要看看本周餐饮花了多少钱？
+-------------
+chaimi-keep-mcp: v3.1.40-beta.3
+```
+
 ---
 
 ## 错误处理

package/package.json

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

package/server.js

@@ -702,8 +702,28 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           const displayName = processedArgs.name || '未知商品';
           const displayAmount = processedArgs.amount || 0;
           const displayCategory = processedArgs.category || '其他';
-          const displayStore = processedArgs.store || '-';
-          userMessage = `✅ 记账成功\n\n| 商品 | 金额 | 分类 | 商家 |\n|------|------|------|------|\n| ${displayName} | ${displayAmount}元 | ${displayCategory} | ${displayStore} |\n\n已保存到你的柴米记账小程序数据库。`;
+          const displayStore = processedArgs.store || '';
+          
+          // 友好结束语（根据分类）
+          const friendlyEndings = {
+            '餐饮': '用餐愉快！🍚 / 好好吃饭哦~',
+            '食品': '吃好喝好！🍎',
+            '交通': '出行顺利！🚗',
+            '购物': '买得开心！🛍️',
+            '收入': '入账顺利！💰',
+            '其他': '记账完成！继续保持~ ✨'
+          };
+          const friendlyEnding = friendlyEndings[displayCategory] || '记账完成！继续保持~ ✨';
+          
+          // 消费洞察（如果有）
+          let insightsText = '';
+          if (result.insights && result.insights.length > 0) {
+            insightsText = '\n\n消费洞察：' + result.insights.map(ins => ins.message || ins.title).join('；');
+          }
+          
+          // 按 SKILL 规范格式：记账成功 + 友好结束语 + 消费洞察 + 版本号
+          const displayStoreText = displayStore ? `【${displayStore}】` : '';
+          userMessage = `✅ ${displayName}${displayStoreText} ¥${displayAmount} 已录入柴米AI记账。\n\n${friendlyEnding}${insightsText}\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
           
           if (!processedArgs.agentType || !processedArgs.apiProvider) {
             userMessage += '\n\n💡 提示：传递agentType和apiProvider参数可解锁小程序记录来源统计功能，示例：agentType="openclaw", apiProvider="doubao"';
@@ -941,10 +961,26 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         
         if (result.success) {
           const totalAmount = processedArgs.totalAmount || processedArgs.items?.reduce((sum, item) => sum + (item.amount || 0), 0) || 0;
-          const itemsList = processedArgs.items?.map(item => `• ${item.name || '未知商品'} - ${item.amount || 0}元`).join('\n') || '暂无商品明细';
-          const storeName = processedArgs.store || '-';
-          const category = processedArgs.items?.[0]?.category || '其他';
-          userMessage = `✅ 小票记录成功\n\n| 项目 | 内容 |\n|------|------|\n| 商家 | ${storeName} |\n| 金额 | ${totalAmount}元 |\n| 分类 | ${category} |\n\n商品明细：\n${itemsList}\n\n已保存到你的柴米记账小程序数据库。`;
+          const storeName = processedArgs.store || '';
+          const category = processedArgs.items?.[0]?.category || '购物';
+          const itemCount = processedArgs.items?.length || 0;
+          
+          // 友好结束语（根据分类）
+          const friendlyEndings = {
+            '餐饮': '用餐愉快！🍚',
+            '食品': '吃好喝好！🍎',
+            '购物': '买得开心！🛍️',
+            '其他': '记账完成！继续保持~ ✨'
+          };
+          const friendlyEnding = friendlyEndings[category] || '买得开心！🛍️';
+          
+          // 消费洞察（如果有）
+          let insightsText = '';
+          if (result.insights && result.insights.length > 0) {
+            insightsText = '\n\n消费洞察：' + result.insights.map(ins => ins.message || ins.title).join('；');
+          }
+          
+          userMessage = `✅ ${storeName} ¥${totalAmount} 已录入柴米AI记账（${itemCount}件商品）。\n\n${friendlyEnding}${insightsText}\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
           
           if (!processedArgs.agentType || !processedArgs.apiProvider) {
             userMessage += '\n\n💡 提示：传递agentType和apiProvider参数可解锁小程序记录来源统计功能，示例：agentType="openclaw", apiProvider="doubao"';
@@ -958,9 +994,39 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const toolName = toolMapping[name];
         const mcpParams = convertParams(name, processedArgs);
         result = await callMcpHub(toolName, mcpParams, token);
-        
+
         if (result.success) {
-          userMessage = `📊 消费记录查询成功\n共找到 ${result.data?.length || 0} 条记录`;
+          const total = result.data?.total || 0;
+          const items = result.data?.items || [];
+          const patterns = result.data?.patterns || {};
+
+          // 构建友好的摘要信息
+          let summary = `📊 消费记录查询成功\n\n`;
+          summary += `📋 共找到 ${total} 条记录\n`;
+
+          // 高频商家
+          if (patterns.highFrequencyStores && patterns.highFrequencyStores.length > 0) {
+            const topStore = patterns.highFrequencyStores[0];
+            summary += `🏪 高频商家：${topStore.store}（${topStore.count}次，均价¥${topStore.avgAmount}）\n`;
+          }
+
+          // 消费时间模式
+          if (patterns.timePattern) {
+            summary += `⏰ 消费高峰：${patterns.timePattern.peakTime}\n`;
+            if (patterns.timePattern.lateNightCount > 0) {
+              summary += `🌙 深夜消费：${patterns.timePattern.lateNightCount}次\n`;
+            }
+          }
+
+          // 异常消费
+          if (patterns.unusualItems && patterns.unusualItems.length > 0) {
+            const topUnusual = patterns.unusualItems[0];
+            summary += `💡 大额消费：${topUnusual.name} ¥${topUnusual.amount}\n`;
+          }
+
+          summary += `\n💡 提示：完整数据（含每笔明细、flags标记）请查看下方 JSON 数据`;
+
+          userMessage = summary;
         }
         break;
       }
@@ -971,7 +1037,44 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         result = await callMcpHub(toolName, mcpParams, token);
 
         if (result.success) {
-          userMessage = `📈 统计查询成功`;
+          const data = result.data || {};
+
+          // 构建友好的统计摘要
+          let summary = `📈 统计查询成功\n\n`;
+          summary += `📅 周期：${data.periodDisplay || data.period || '未知'}\n`;
+          summary += `💰 总支出：¥${data.totalAmount || 0}（${data.totalCount || 0}笔）\n`;
+
+          // 环比对比
+          if (data.compare && data.compare.vsLastPeriod !== undefined) {
+            const change = data.compare.vsLastPeriod;
+            const emoji = change > 0 ? '📈' : change < 0 ? '📉' : '➡️';
+            summary += `${emoji} 环比：${change > 0 ? '+' : ''}${change}%\n`;
+          }
+
+          // 预算进度
+          if (data.budget) {
+            summary += `🎯 预算：已用¥${data.budget.used}/¥${data.budget.total}（${data.budget.progress}%）\n`;
+          }
+
+          // Top 3 分类
+          if (data.categories && data.categories.length > 0) {
+            summary += `\n📂 消费分类 Top3：\n`;
+            data.categories.slice(0, 3).forEach((cat, idx) => {
+              summary += `  ${idx + 1}. ${cat.category}：¥${cat.amount}（${cat.percentage}%）\n`;
+            });
+          }
+
+          // 洞察摘要
+          if (data.insights && data.insights.length > 0) {
+            summary += `\n💡 洞察线索（${data.insights.length}条）：\n`;
+            data.insights.slice(0, 3).forEach(insight => {
+              summary += `  ${insight.emoji || '•'} ${insight.title}：${insight.message}\n`;
+            });
+          }
+
+          summary += `\n💡 提示：完整数据（含每日统计、所有洞察）请查看下方 JSON 数据`;
+
+          userMessage = summary;
         }
         break;
       }
@@ -982,8 +1085,42 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         result = await callMcpHub(toolName, mcpParams, token);
 
         if (result.success) {
-          const insightsCount = result.data?.insights?.length || 0;
-          userMessage = `🔍 消费洞察获取成功\n共找到 ${insightsCount} 条洞察线索，供你进行深度分析！`;
+          const data = result.data || {};
+          const insights = data.insights || [];
+
+          // 构建友好的洞察摘要
+          let summary = `🔍 消费洞察获取成功\n\n`;
+          summary += `📅 周期：${data.periodDisplay || data.period || '未知'}\n`;
+          summary += `💡 共找到 ${insights.length} 条洞察线索\n`;
+
+          if (insights.length > 0) {
+            // 按优先级分组
+            const highPriority = insights.filter(i => i.priority === 'high');
+            const mediumPriority = insights.filter(i => i.priority === 'medium');
+            const lowPriority = insights.filter(i => i.priority === 'low');
+
+            if (highPriority.length > 0) {
+              summary += `\n🔴 高优先级（${highPriority.length}条）：\n`;
+              highPriority.forEach(insight => {
+                summary += `  ${insight.emoji || '•'} ${insight.title}：${insight.message}\n`;
+              });
+            }
+
+            if (mediumPriority.length > 0) {
+              summary += `\n🟡 中优先级（${mediumPriority.length}条）：\n`;
+              mediumPriority.slice(0, 2).forEach(insight => {
+                summary += `  ${insight.emoji || '•'} ${insight.title}：${insight.message}\n`;
+              });
+            }
+
+            if (lowPriority.length > 0) {
+              summary += `\n🟢 低优先级（${lowPriority.length}条）\n`;
+            }
+          }
+
+          summary += `\n💡 提示：每条洞察都包含 suggestionForAgent 字段，可用于深度分析`;
+
+          userMessage = summary;
         }
         break;
       }
@@ -994,9 +1131,20 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         result = await callMcpHub(toolName, mcpParams, token);
 
         if (result.success) {
-          const totalRecords = result.data?.summary?.totalRecords || 0;
-          const totalAmount = result.data?.summary?.totalAmount || 0;
-          userMessage = `📦 数据导出成功\n共导出 ${totalRecords} 条记录，总金额 ${totalAmount} 元\n数据已准备好，你可以使用大模型进行深度分析了！`;
+          const summary = result.data?.summary || {};
+          const totalRecords = summary.totalRecords || 0;
+          const totalAmount = summary.totalAmount || 0;
+          const periodDisplay = result.data?.periodDisplay || '';
+
+          let summaryText = `📦 数据导出完成\n\n`;
+          if (periodDisplay) {
+            summaryText += `📅 周期：${periodDisplay}\n`;
+          }
+          summaryText += `📊 导出记录数：${totalRecords}条\n`;
+          summaryText += `💰 总金额：¥${totalAmount.toFixed ? totalAmount.toFixed(2) : totalAmount}\n`;
+          summaryText += `\n✅ 完整数据已准备好，你可以使用自己的大模型进行深度分析了！\n（完整数据在下方的完整数据JSON中）`;
+
+          userMessage = summaryText;
         }
         break;
       }
@@ -1037,11 +1185,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         result = await callMcpHub('addIncome', mcpParams, token);
 
         if (result.success) {
-          const displayName = processedArgs.name;
-          const displayAmount = processedArgs.amount;
-          const displayCategory = processedArgs.category;
-          const displayStore = processedArgs.store || '-';
-          userMessage = `✅ 收入记录成功\n\n| 来源 | 金额 | 分类 | 付款方 |\n|------|------|------|--------|\n| ${displayName} | ${displayAmount}元 | ${displayCategory} | ${displayStore} |`;
+          const displayName = processedArgs.name || '未知收入';
+          const displayAmount = processedArgs.amount || 0;
+          const displayCategory = processedArgs.category || '其他';
+          const displayStore = processedArgs.store || '';
+          const displayStoreText = displayStore ? `【${displayStore}】` : '';
+          
+          userMessage = `✅ ${displayName}${displayStoreText} ¥${displayAmount} 已录入柴米AI记账。\n\n入账顺利！💰\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
         }
         break;
       }
@@ -1129,13 +1279,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       userMessage = `❌ 操作失败：${result.error || '未知错误'}`;
     }
 
-    userMessage += `\n\n---\n📦 柴米记账 MCP v${MCP_VERSION}`;
+    // 构建完整的返回内容：userMessage + 完整的 result 数据
+    const fullResponse = {
+      userMessage: userMessage,
+      result: result,
+      mcp_version: MCP_VERSION
+    };
 
     return {
       content: [
         {
           type: 'text',
-          text: userMessage,
+          text: `${userMessage}\n\n---\n📦 柴米记账 MCP v${MCP_VERSION}\n\n## 完整数据\n\`\`\`json\n${JSON.stringify(result, null, 2)}\n\`\`\``,
         },
       ],
     };