chaimi-keep-mcp 3.3.3-beta.13 → 3.3.3-beta.15

package/README.md

@@ -89,6 +89,12 @@ export MCP_PROMPT_URL="你的Prompt服务地址"
 
 ## Changelog
 
+### v3.3.3-beta.13 (2026-04-30)
+- **变更** 多端记账分类统一 - 支持商品分类和记账分类分离
+  - 保持 `category`（记账分类，43个标准分类）
+  - 新增 `productCategory`（商品一级分类，展示用）
+  - 新增 `productSubCategory`（商品子分类，展示用）
+
 ### v3.3.3-beta.8 (2026-04-30)
 - **变更** 配置存储路径迁移 - 从 `~/.mcporter/` 迁移到 `~/.chaimi-keep/`，避免与其他 MCP 工具冲突
 - **优化** 安全权限 - 新增目录权限控制（0700），敏感文件权限控制（0600）

package/package.json

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

package/server.js

@@ -265,8 +265,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           properties: {
             name: { type: 'string', description: '商品名称（必填）' },
             amount: { type: 'number', description: '金额（必填）' },
-            category: { type: 'string', description: '【必填】分类，如：餐饮、食品、交通' },
-            subCategory: { type: 'string', description: '子分类（可选）' },
+            category: { type: 'string', description: '【必填】支出分类（43个标准分类之一，如：餐饮、食品、交通、蔬菜）' },
             unit: { type: 'string', description: '单位（可选）' },
             marketPrice: { type: 'string', description: '市场单价（可选）' },
             store: { type: 'string', description: '商家名称（可选）' },
@@ -314,10 +313,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                   amount: { type: 'number', description: '【必填】金额，必须等于 price × quantity' },
                   weight: { type: 'string', description: '重量' },
                   marketPrice: { type: 'string', description: '【必填】单价数值，根据unit计算，如unit=元/500g，则marketPrice=金额÷重量(g)×500' },
-                  category: { type: 'string', description: '【必填】主分类（如：蔬菜、肉类、水果、水产，常见超市购物分类）' },
-                  subCategory: { type: 'string', description: '子分类（如：叶菜类、根茎类、猪肉类，超市细分类目），推荐填写' },
+                  // 【改造】商品分类字段
+                  productCategory: { type: 'string', description: '【必填】商品一级分类（如：蔬菜、肉类、水果、日化用品）' },
+                  productSubCategory: { type: 'string', description: '商品二级分类（如：叶菜类、根茎类、家居清洁）' },
+                  // 【改造】记账分类字段
+                  category: { type: 'string', description: '【必填】记账分类（43个标准分类之一，如：蔬菜、购物、餐饮）' },
                 },
-                required: ['name', 'amount', 'price', 'quantity', 'unit', 'marketPrice', 'category'],
+                required: ['name', 'amount', 'price', 'quantity', 'unit', 'marketPrice', 'productCategory', 'category'],
               },
             },
             agentType: { type: 'string', description: '【必填】Agent类型：claude-desktop、cursor、openclaw、workbuddy、trae' },
@@ -340,7 +342,6 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             startDate: { type: 'string', description: '开始日期（ISO格式，如：2026-04-01）' },
             endDate: { type: 'string', description: '结束日期（ISO格式，如：2026-04-30）' },
             category: { type: 'string', description: '按分类筛选（如：餐饮、食品、交通）' },
-            subCategory: { type: 'string', description: '按子分类筛选（如：叶菜类、猪肉类）' },
             store: { type: 'string', description: '按商家名称筛选' },
             source: { type: 'string', description: '按来源筛选（如：mcp_txt_expense、mcp_receipt）' },
             keyword: { type: 'string', description: '按商品名称关键词搜索' },
@@ -411,13 +412,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'save_income',
-        description: '【文本记账-收入】用户提及收入关键词（工资、红包、转账、退款等）时用此工具。前置：必须先调用get_skill获取规范，再调用get_text_parse_prompt获取凭证和解析模板。用法：mcporter call 柴米AI记账.save_income _flowmate="SOLINWANG..." name="红包" amount=100 category="礼金" rawInput="收红包100元"',
+        description: '【文本记账-收入】用户提及收入关键词（工资、红包、转账、退款等）时用此工具。前置：必须先调用get_skill获取规范，再调用get_text_parse_prompt获取凭证和解析模板。用法：mcporter call 柴米AI记账.save_income _flowmate="SOLINWANG..." name="红包" amount=100 category="红包" rawInput="收红包100元"',
         inputSchema: {
           type: 'object',
           properties: {
             name: { type: 'string', description: '收入来源（如：工资、奖金、红包）（必填）' },
             amount: { type: 'number', description: '收入金额（必填）' },
-            category: { type: 'string', description: '（必填）收入分类（如：工资、奖金、投资）' },
+            category: { type: 'string', description: '【必填】收入分类（8个标准分类之一：工资、兼职、奖金、红包、退款、理财、转账、其他）' },
             store: { type: 'string', description: '付款方（如：公司名称）（可选）' },
             date: { type: 'number', description: '【必填】收入时间（毫秒级时间戳，13位数字。必须根据实际年月日时分秒计算，不允许复制示例数字）' },
             note: { type: 'string', description: '备注（可选）' },
@@ -1169,7 +1170,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           break;
         }
         
-        // 检查 items 中每个商品的必填字段（包括 category）
+        // 检查 items 中每个商品的必填字段（包括分类字段）
         const invalidItems = [];
         processedArgs.items.forEach((item, index) => {
           const itemMissingFields = [];
@@ -1177,7 +1178,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           if (!item.hasOwnProperty('amount') || item.amount === undefined) itemMissingFields.push('amount');
           if (!item.hasOwnProperty('price') || item.price === undefined) itemMissingFields.push('price');
           if (!item.hasOwnProperty('quantity') || item.quantity === undefined) itemMissingFields.push('quantity');
-          if (!item.hasOwnProperty('category') || item.category === '') itemMissingFields.push('category');
+          // 【改造】检查新字段 productCategory 和 category
+          if (!item.hasOwnProperty('productCategory') || item.productCategory === '') {
+            itemMissingFields.push('productCategory');
+          }
+          if (!item.hasOwnProperty('category') || item.category === '') {
+            itemMissingFields.push('category');
+          }
           
           if (itemMissingFields.length > 0) {
             invalidItems.push(`商品${index + 1}(${item.name || '未命名'})缺少字段: ${itemMissingFields.join(', ')}`);
@@ -1187,10 +1194,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         if (invalidItems.length > 0) {
           result = {
             success: false,
-            error: `商品数据不完整：${invalidItems.join('; ')}。每个商品必须包含：name, amount, price, quantity, category`,
+            error: `商品数据不完整：${invalidItems.join('; ')}。每个商品必须包含：name, amount, price, quantity, productCategory, category`,
             code: 400
           };
-          userMessage = `❌ 保存失败\n\n错误：商品数据格式不完整\n\n${invalidItems.join('\n')}\n\n💡 解决方案：\n1. 请更新您的柴米AI记账 MCP Skill\n2. 确保每个商品包含完整的5个字段：name, amount, price, quantity, category\n3. category 是记账的基本信息，不能为空`;
+          userMessage = `❌ 保存失败\n\n错误：商品数据格式不完整\n\n${invalidItems.join('\n')}\n\n💡 解决方案：\n1. 请更新您的柴米AI记账 MCP Skill\n2. 确保每个商品包含完整的6个字段：name, amount, price, quantity, productCategory, category\n3. productCategory 是商品分类，category 是记账分类，都是必填项`;
           break;
         }
         
@@ -2110,8 +2117,9 @@ function convertParams(toolName, args) {
         amount: amount,
         price: amount,
         quantity: 1,
+        productCategory: sanitizeString(args.productCategory, 50) || '其他',
+        productSubCategory: sanitizeString(args.productSubCategory, 50) || '',
         category: sanitizeString(args.category, 50) || '其他',
-        subCategory: sanitizeString(args.subCategory, 50) || '',
         unit: sanitizeString(args.unit, 20) || '',
         weight: '',
         marketPrice: sanitizeString(args.marketPrice, 50) || '',
@@ -2148,20 +2156,21 @@ function convertParams(toolName, args) {
           const marketPrice = sanitizeString(item.marketPrice, 50) || calculateMarketPrice(amount, weight);
           
           return {
-            itemIndex: index,
-            name: sanitizeString(item.name, 100),
-            originalName: sanitizeString(item.originalName, 200) || sanitizeString(item.name, 100),
-            amount: amount,
-            category: sanitizeString(item.category, 50) || '其他',
-            subCategory: sanitizeString(item.subCategory, 50) || '',
-            transactionType: sanitizeString(item.transactionType, 50) || 'expense',
-            price: validateAmount(item.price),
-            quantity: item.quantity ? String(item.quantity).substring(0, 20) : '1',
-            unit: sanitizeString(item.unit, 20),
-            weight: weight,
-            marketPrice: marketPrice,
-            note: sanitizeString(item.note, 500),
-          };
+          itemIndex: index,
+          name: sanitizeString(item.name, 100),
+          originalName: sanitizeString(item.originalName, 200) || sanitizeString(item.name, 100),
+          amount: amount,
+          productCategory: sanitizeString(item.productCategory, 50) || '其他',
+          productSubCategory: sanitizeString(item.productSubCategory, 50) || '',
+          category: sanitizeString(item.category, 50) || '其他',
+          transactionType: sanitizeString(item.transactionType, 50) || 'expense',
+          price: validateAmount(item.price),
+          quantity: item.quantity ? String(item.quantity).substring(0, 20) : '1',
+          unit: sanitizeString(item.unit, 20),
+          weight: weight,
+          marketPrice: marketPrice,
+          note: sanitizeString(item.note, 500),
+        };
         }),
         store: sanitizeString(args.store, 100),
         receiptNo: sanitizeString(args.receiptNo, 50),
@@ -2185,7 +2194,7 @@ function convertParams(toolName, args) {
       };
     }
 
-    case 'save_receipt': {
+    case 'get_expenses': {
       // 【新增】支持 period 参数
       const periodDates = args.period ? parsePeriod(args.period) : {};
       return {