chaimi-keep-mcp 3.1.49-beta.1 → 3.1.49-beta.2

package/README.md

@@ -148,6 +148,12 @@ AI 会自动调用 `save_income` 工具记录收入。
 
 ## 更新日志
 
+### v3.1.49-beta.2 (2026-04-24)
+- **新增** period 参数支持
+  - getStatistics: 支持 this_week/last_week/this_month/last_month 周期筛选
+  - getExpenses: 支持 this_week/last_week/this_month/last_month 周期筛选
+  - 自动将周期转换为开始/结束日期
+
 ### v3.1.49-beta.0 (2026-04-24)
 - **修复** category 未定义错误（三个记账函数）
   - save_expense: `category` → `displayCategory`

package/package.json

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

package/server.js

@@ -1909,18 +1909,29 @@ function convertParams(toolName, args) {
       };
     }
 
-    case 'get_expenses':
+    case 'get_expenses': {
+      // 【新增】支持 period 参数
+      const periodDates = args.period ? parsePeriod(args.period) : {};
       return {
+        startDate: periodDates.startDate || args.startDate,
+        endDate: periodDates.endDate || args.endDate,
         limit: Math.min(parseInt(args.limit) || 10, 100),
         source: args.source,
+        category: args.category,
+        store: args.store,
       };
+    }
 
-    case 'get_statistics':
+    case 'get_statistics': {
+      // 【新增】支持 period 参数
+      const periodDates = args.period ? parsePeriod(args.period) : {};
       return {
-        startDate: args.yearMonth ? `${args.yearMonth}-01` : undefined,
-        endDate: args.yearMonth ? getMonthEndDate(args.yearMonth) : undefined,
+        startDate: periodDates.startDate || (args.yearMonth ? `${args.yearMonth}-01` : undefined),
+        endDate: periodDates.endDate || (args.yearMonth ? getMonthEndDate(args.yearMonth) : undefined),
         type: args.type,
+        includeInsights: args.includeInsights,
       };
+    }
 
     case 'save_income':
       return {
@@ -1949,6 +1960,64 @@ function getMonthEndDate(yearMonth) {
   return `${yearMonth}-${lastDay}`;
 }
 
+// 【新增】解析 period 参数为日期范围
+function parsePeriod(period) {
+  const now = new Date();
+  const year = now.getFullYear();
+  const month = now.getMonth();
+  const day = now.getDate();
+  const weekDay = now.getDay(); // 0=周日, 1=周一...
+
+  let startDate, endDate;
+
+  switch (period) {
+    case 'this_week': {
+      // 本周一到今天
+      const mondayOffset = weekDay === 0 ? 6 : weekDay - 1;
+      const monday = new Date(year, month, day - mondayOffset);
+      startDate = formatDateISO(monday);
+      endDate = formatDateISO(now);
+      break;
+    }
+    case 'last_week': {
+      // 上周一到上周日
+      const thisMondayOffset = weekDay === 0 ? 6 : weekDay - 1;
+      const lastMonday = new Date(year, month, day - thisMondayOffset - 7);
+      const lastSunday = new Date(year, month, day - thisMondayOffset - 1);
+      startDate = formatDateISO(lastMonday);
+      endDate = formatDateISO(lastSunday);
+      break;
+    }
+    case 'this_month': {
+      // 本月1号到今天
+      const firstDay = new Date(year, month, 1);
+      startDate = formatDateISO(firstDay);
+      endDate = formatDateISO(now);
+      break;
+    }
+    case 'last_month': {
+      // 上月1号到上月最后一天
+      const firstDayLastMonth = new Date(year, month - 1, 1);
+      const lastDayLastMonth = new Date(year, month, 0);
+      startDate = formatDateISO(firstDayLastMonth);
+      endDate = formatDateISO(lastDayLastMonth);
+      break;
+    }
+    default:
+      return { startDate: undefined, endDate: undefined };
+  }
+
+  return { startDate, endDate };
+}
+
+// 格式化日期为 YYYY-MM-DD
+function formatDateISO(date) {
+  const y = date.getFullYear();
+  const m = String(date.getMonth() + 1).padStart(2, '0');
+  const d = String(date.getDate()).padStart(2, '0');
+  return `${y}-${m}-${d}`;
+}
+
 // 授权状态管理
 let authState = {
   isAuthorized: false,