chaimi-keep-mcp 3.1.40-beta.1 → 3.1.40-beta.3

package/SKILL.md

@@ -84,15 +84,9 @@ Agent 必须输出：
 为数据安全起见，我已暂停记账操作。
 
 请开启新会话后重新触发记账。
-```
 
-Agent 根据当前环境，向用户说明开启新会话的具体操作方式：
-- **Cursor**: 按 `Cmd+N` (Mac) / `Ctrl+N` (Windows)
-- **Claude Desktop**: 点击 `+ New Chat`
-- **OpenClaw**: 输入 `/new`
-- **WorkBuddy**: 输入 `/clear`
-- **Trae**: 按 `Cmd/Ctrl + N` 或点击 `+` 按钮
-- **其他**: 输入 `/new` 或菜单"新建会话"
+（操作方式见上方「遇到问题时-方案1」）
+```
 
 ---
 
@@ -157,14 +151,45 @@ Agent 根据当前环境，向用户说明开启新会话的具体操作方式
 - **save_income** - 文字记账（收入）  
 - **save_receipt** - 小票记账（需先调用 get_parse_prompt）
 
+### 智能查询工具（新功能）
+- **get_insights** - 【推荐使用】获取消费洞察（零AI成本！）
+  - 返回消费趋势、模式、优化建议
+  - 让 Agent 结合用户的大模型分析
+- **export_data** - 【深度分析用】导出完整消费数据
+  - 用于 Agent 深度分析
+- **get_statistics** - 获取消费统计（支持周/月周期！）
+  - 新增 `period` 参数：支持 `this_week`、`last_week`、`this_month`、`last_month`
+
 ### 辅助工具
 - **get_skill** - 【记账前必须调用】获取 Skill 文档
 - **get_parse_prompt** - 获取小票解析模板
-- **get_expenses** - 查询支出记录
+- **get_expenses** - 查询支出记录（支持周/月周期！）
+  - 新增 `period` 参数：支持 `this_week`、`last_week`、`this_month`、`last_month`
 - **get_receipt_list** - 查询小票列表
-- **get_statistics** - 获取统计信息
 - **submit_feedback** - 提交反馈
 
+---
+
+## 📊 场景说明（智能分析）
+
+### 场景 1：用户问「帮我看看这周花了多少钱」
+**推荐工具：`get_statistics` 搭配 `period: this_week`**
+参数示例：
+```
+get_statistics period="this_week"
+```
+
+### 场景 2：用户问「分析一下消费习惯」
+**推荐工具：`get_insights` + `export_data`**
+1. 先用 `get_insights` 获取洞察
+2. 再用 `export_data` 获取完整数据
+3. 用用户的大模型进行深度分析
+
+### 场景 3：用户问「最近的消费记录」
+**推荐工具：`get_expenses`**
+- 也可以搭配 `period: this_week` 使用
+
+
 ---
 
 ## 工具详细说明
@@ -180,7 +205,15 @@ Agent 根据当前环境，向用户说明开启新会话的具体操作方式
 
 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`
 
@@ -213,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`：原价（优惠前）
@@ -254,8 +295,10 @@ Agent **直接使用当前时间**作为收入时间，无需进行时间语义
 
 [自定义其他内容]
 
-MCP Server: v【版本号】
 【友好结束语】
+------------
+chaimi-keep-mcp: v【版本号】
+
 ```
 
 **友好结束语参考：**

package/package.json

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

package/server.js

@@ -958,9 +958,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 +1001,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 +1049,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 +1095,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;
       }
@@ -1129,13 +1241,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\`\`\``,
         },
       ],
     };