chaimi-keep-mcp 3.3.2-beta.1 → 3.3.3-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.3.2-beta.1",
+  "version": "3.3.3-beta.0",
   "description": "柴米记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {
@@ -44,6 +44,7 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
+    "chaimi-keep-mcp": "^3.3.2-beta.1",
     "dotenv": "^17.3.1",
     "node-fetch": "^2.7.0"
   },

package/server.js

@@ -280,7 +280,19 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           type: 'object',
           properties: {
             store: { type: 'string', description: '商家名称（必填）' },
-            date: { type: 'number', description: '【必填】消费时间（毫秒级时间戳，13位数字。必须根据实际年月日时分秒计算，不允许复制示例数字）' },
+            date: { type: 'number', description: '消费时间（毫秒级时间戳，13位数字。如提供 date_components 可不传此字段）' },
+            date_components: { 
+              type: 'object', 
+              description: '【推荐】消费时间组件。包含：year、month、day、hour、minute、second。服务端会自动转换为时间戳',
+              properties: {
+                year: { type: 'number', description: '4位年份，如 2025' },
+                month: { type: 'number', description: '1-12，1月=1' },
+                day: { type: 'number', description: '1-31' },
+                hour: { type: 'number', description: '0-23' },
+                minute: { type: 'number', description: '0-59' },
+                second: { type: 'number', description: '0-59，默认0' }
+              }
+            },
             totalAmount: { type: 'number', description: '（必填）总金额（所有商品amount之和）' },
             originalAmount: { type: 'number', description: '（必填）应付金额（优惠前）' },
             discountAmount: { type: 'number', description: '（必填）优惠金额' },
@@ -1147,6 +1159,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           break;
         }
         
+        // 【新增】转换 date_components 为 date
+        if (processedArgs.date_components && !processedArgs.date) {
+          const { year, month, day, hour, minute, second } = processedArgs.date_components;
+          
+          // 校验时间组件完整性
+          if (!year || !month || !day || hour === undefined || minute === undefined) {
+            result = {
+              success: false,
+              error: 'date_components 不完整',
+              code: 400,
+              hint: '必须包含：year、month、day、hour、minute'
+            };
+            userMessage = '❌ 保存失败：时间信息不完整\n\n请确保 date_components 包含完整的年月日时分秒';
+            break;
+          }
+          
+          // 转换为时间戳
+          processedArgs.date = new Date(year, month - 1, day, hour, minute, second || 0).getTime();
+          console.log(`[save_receipt] 时间组件转换: ${JSON.stringify(processedArgs.date_components)} → ${processedArgs.date}`);
+        }
+        
         // P1: 日期合理性检查
         if (processedArgs.date) {
           const validation = validateDate(processedArgs.date, '小票日期');

package/utils/validators.js

@@ -44,6 +44,72 @@ function validateDate(dateInput, fieldName = '日期') {
   return { valid: true };
 }
 
+/**
+ * 校验时间组件合理性
+ * @param {Object} components - 时间组件对象
+ * @param {string} fieldName - 字段名称（用于错误提示）
+ * @returns {Object} { valid: boolean, error?: string, message?: string }
+ */
+function validateDateComponents(components, fieldName = '时间') {
+  if (!components || typeof components !== 'object') {
+    return {
+      valid: false,
+      error: '时间组件格式无效',
+      message: `❌ ${fieldName}组件必须是对象`
+    };
+  }
+
+  const { year, month, day, hour, minute, second } = components;
+
+  // 校验必填字段
+  const requiredFields = ['year', 'month', 'day', 'hour', 'minute'];
+  const missingFields = requiredFields.filter(f => components[f] === undefined || components[f] === null);
+  
+  if (missingFields.length > 0) {
+    return {
+      valid: false,
+      error: '时间组件缺少必填字段',
+      message: `❌ ${fieldName}组件缺少: ${missingFields.join(', ')}`
+    };
+  }
+
+  // 校验数值范围
+  if (year < 1965 || year > 2100) {
+    return { valid: false, error: '年份不合法', message: `❌ ${fieldName}年份必须在 1965-2100 之间` };
+  }
+  if (month < 1 || month > 12) {
+    return { valid: false, error: '月份不合法', message: `❌ ${fieldName}月份必须在 1-12 之间` };
+  }
+  if (day < 1 || day > 31) {
+    return { valid: false, error: '日期不合法', message: `❌ ${fieldName}日期必须在 1-31 之间` };
+  }
+  if (hour < 0 || hour > 23) {
+    return { valid: false, error: '小时不合法', message: `❌ ${fieldName}小时必须在 0-23 之间` };
+  }
+  if (minute < 0 || minute > 59) {
+    return { valid: false, error: '分钟不合法', message: `❌ ${fieldName}分钟必须在 0-59 之间` };
+  }
+  if (second !== undefined && (second < 0 || second > 59)) {
+    return { valid: false, error: '秒数不合法', message: `❌ ${fieldName}秒数必须在 0-59 之间` };
+  }
+
+  // 校验日期有效性（如 2025-02-30 是无效日期）
+  const testDate = new Date(year, month - 1, day);
+  if (testDate.getMonth() !== month - 1 || testDate.getDate() !== day) {
+    return { valid: false, error: '日期不存在', message: `❌ ${fieldName}日期不存在（如 2月30日）` };
+  }
+
+  // 校验不能是未来时间
+  const inputDate = new Date(year, month - 1, day, hour, minute, second || 0);
+  const now = new Date();
+  if (inputDate > now) {
+    return { valid: false, error: '不能是未来时间', message: `❌ ${fieldName}不能是未来时间` };
+  }
+
+  return { valid: true };
+}
+
 module.exports = {
-  validateDate
+  validateDate,
+  validateDateComponents
 };