chaimi-keep-mcp 3.3.3-beta.12 → 3.3.3-beta.14

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/SKILL.md

@@ -128,15 +128,19 @@ chaimi-keep-mcp ⭐ 本Skill
    └─ get_skill() 获取 SKILL.md 规范
    └─ references/response-templates.md 了解回复模板
 
-第2步：拿Token
-   └─ 文字记账：get_text_parse_prompt() 获取 Token 和解析模板
-   └─ 小票记账：get_parse_prompt() 获取 Token 和解析模板
+第2步：拿凭证
+   └─ 文字记账：get_text_parse_prompt() 获取凭证和解析模板
+   └─ 小票记账：get_parse_prompt() 获取凭证和解析模板
+   
+   【强制流程】必须先调用此工具，让 AI 解析用户输入
+   此工具会返回解析结果，你只需将结果原样传给 save_expense/save_income
+   ⚠️ 禁止自行解析或提取任何字段，必须让 AI 处理
 
 第3步：AI解析
-   └─ 按模板解析用户输入，生成结构化数据 + _requestToken
+   └─ 按模板解析用户输入，生成结构化数据 + _flowmate
 
 第4步：执行记账
-   └─ 调用工具（save_expense/income/receipt，带上 _requestToken）
+   └─ 调用工具（save_expense/income/receipt，带上 _flowmate）
    └─ 根据 _templateLocation 使用模板渲染美学回复
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.3.3-beta.12",
+  "version": "3.3.3-beta.14",
   "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(', ')}`);
@@ -2111,7 +2118,6 @@ function convertParams(toolName, args) {
         price: amount,
         quantity: 1,
         category: sanitizeString(args.category, 50) || '其他',
-        subCategory: sanitizeString(args.subCategory, 50) || '',
         unit: sanitizeString(args.unit, 20) || '',
         weight: '',
         marketPrice: sanitizeString(args.marketPrice, 50) || '',
@@ -2152,8 +2158,10 @@ function convertParams(toolName, args) {
             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) || '其他',
-            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',