chaimi-keep-mcp 3.1.34 → 3.1.36-beta.1

package/README.md

@@ -141,6 +141,12 @@ AI 会自动调用 `save_income` 工具记录收入。
 
 ## 更新日志
 
+### v3.1.35 (2026-04-15)
+- **新增** 商品子分类支持：`subCategory` 字段，支持叶菜类、根茎类、猪肉类等超市细分类目
+- **新增** 计价单位支持：`unit` 字段，支持元/500g、元/个、元/盒、元/袋等多种单位
+- **新增** 市场单价支持：`marketPrice` 字段，用于记录单价数值
+- **优化** 字段描述：更贴近超市购物场景的分类描述
+
 ### v3.1.34 (2026-04-14)
 - **修复** 日期/时区处理：纯日期格式默认使用12:00，不再使用当前服务器时间
 - **优化** SKILL.md 精简：从385行精简到176行，聚焦Agent必须执行的行为规范

package/SKILL.md

@@ -99,6 +99,36 @@ argument-hint: "[记账内容]"
 
 **必填字段：** `name`、`amount`、`category`、`date`
 
+**可选字段：**
+- `subCategory`：子分类（可选）
+- `unit`：单位（可选）
+- `marketPrice`：市场单价（可选）
+
+---
+
+### 收入记账（save_income）
+
+**流程：**
+1. 调用 `get_text_parse_prompt()` 获取解析 Prompt
+2. 使用 Prompt 解析用户输入，获取 JSON 结果
+3. 调用 `save_income` 保存（传入所有解析结果字段）
+
+**Agent 必须执行的时间语义解析：**
+| 用户说法 | 解析为 |
+|---------|--------|
+| "工资"、"收入" | 09:00（默认工作时间） |
+| "红包"、"奖金" | 具体时间或当前时间 |
+| 无时间信息 | 使用当前时间 |
+
+**重要：** 最终传入的 `date` 参数必须包含时间部分，格式：`2026-04-14T09:00:00+08:00`
+
+**必填字段：** `name`、`amount`、`category`、`date`
+
+**可选字段：**
+- `subCategory`：子分类（可选）
+- `unit`：单位（可选）
+- `marketPrice`：市场单价（可选）
+
 ---
 
 ### 小票记账（save_receipt）
@@ -117,6 +147,10 @@ argument-hint: "[记账内容]"
 - `originalAmount`：原价（优惠前）
 - `discountAmount`：优惠金额
 - `items`：商品数组，每个商品必须有 `name`、`amount`、`price`、`quantity`、`category`
+  - `category`：主分类（如：蔬菜、肉类、水果、水产，常见超市购物分类）
+  - `subCategory`：子分类（如：叶菜类、根茎类、猪肉类，超市细分类目），推荐填写
+  - `unit`：计价单位（如：元/500g、元/个、元/盒、元/袋）
+  - `marketPrice`：单价，根据 unit 计算，如 unit=元/500g，则 marketPrice=金额÷重量(g)×500
 
 ---
 

package/package.json

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

package/server.js

@@ -139,16 +139,19 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           properties: {
             name: { type: 'string', description: '商品名称（必填）' },
             amount: { type: 'number', description: '金额（必填）' },
-            category: { type: 'string', description: '分类（必填，如：餐饮、食品、交通）' },
+            category: { type: 'string', description: '【必填】分类，如：餐饮、食品、交通' },
+            subCategory: { type: 'string', description: '子分类（可选）' },
+            unit: { type: 'string', description: '单位（可选）' },
+            marketPrice: { type: 'string', description: '市场单价（可选）' },
             store: { type: 'string', description: '商家名称（可选）' },
             date: { type: 'string', description: '消费时间（ISO格式）（可选）' },
             note: { type: 'string', description: '备注（可选）' },
-            agentType: { type: 'string', description: '【推荐自动填充】Agent类型，如：claude-desktop、cursor、openclaw、workbuddy、trae' },
-            apiProvider: { type: 'string', description: '【推荐自动填充】AI服务提供商，如：anthropic、openai、doubao、aliyun' },
-            rawInput: { type: 'string', description: '【推荐自动填充】用户的原始输入内容，用于记录用户原始请求' },
+            agentType: { type: 'string', description: '【必填】Agent类型，如：claude-desktop、cursor、openclaw、workbuddy、trae' },
+            apiProvider: { type: 'string', description: '【必填】AI服务提供商，如：anthropic、openai、doubao、aliyun' },
+            rawInput: { type: 'string', description: '【必填】用户的原始输入内容，用于记录用户原始请求' },
             mcp_version: { type: 'string', description: 'MCP Server 版本号（自动填充）' },
           },
-          required: ['name', 'amount'],
+          required: ['name', 'amount', 'category', 'agentType', 'apiProvider', 'rawInput'],
         },
       },
       {
@@ -175,74 +178,94 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                   originalName: { type: 'string', description: '原始商品名称（含规格）' },
                   price: { type: 'number', description: '【必填】单价' },
                   quantity: { type: 'number', description: '【必填】数量' },
-                  unit: { type: 'string', description: '单位，如：斤、个、份' },
+                  unit: { type: 'string', description: '【必填】计价单位（如：元/500g、元/个、元/盒、元/袋）' },
                   amount: { type: 'number', description: '【必填】金额，必须等于 price × quantity' },
                   weight: { type: 'string', description: '重量' },
-                  marketPrice: { type: 'string', description: '市场单价（元/500g）' },
-                  category: { type: 'string', description: '（必填）分类，如：餐饮、食品、购物' },
+                  marketPrice: { type: 'string', description: '【必填】单价数值，根据unit计算，如unit=元/500g，则marketPrice=金额÷重量(g)×500' },
+                  category: { type: 'string', description: '【必填】主分类（如：蔬菜、肉类、水果、水产，常见超市购物分类）' },
+                  subCategory: { type: 'string', description: '子分类（如：叶菜类、根茎类、猪肉类，超市细分类目），推荐填写' },
                 },
-                required: ['name', 'amount', 'price', 'quantity'],
+                required: ['name', 'amount', 'price', 'quantity', 'unit', 'marketPrice', 'category'],
               },
             },
-            agentType: { type: 'string', description: '【自动填充】Agent类型：claude-desktop、cursor、openclaw、workbuddy、trae' },
-            apiProvider: { type: 'string', description: '【自动填充】AI服务提供商：anthropic、openai、doubao、aliyun' },
-            rawInput: { type: 'string', description: '【自动填充】用户的原始输入内容' },
+            agentType: { type: 'string', description: '【必填】Agent类型：claude-desktop、cursor、openclaw、workbuddy、trae' },
+            apiProvider: { type: 'string', description: '【必填】AI服务提供商：anthropic、openai、doubao、aliyun' },
+            rawInput: { type: 'string', description: '【必填】用户的原始输入内容' },
             mcp_version: { type: 'string', description: '【自动填充】MCP Server版本号' },
           },
-          required: ['store', 'items'],
+          required: ['store', 'items', 'agentType', 'apiProvider', 'rawInput'],
         },
       },
       {
         name: 'get_expenses',
-        description: '查询消费记录',
+        description: '查询消费记录。支持按日期范围、分类、商家、来源等多维度筛选',
         inputSchema: {
           type: 'object',
           properties: {
-            limit: { type: 'number', description: '返回数量限制', default: 10 },
-            source: { type: 'string', description: '来源筛选' },
+            limit: { type: 'number', description: '返回数量限制，默认10条，最大100', default: 10 },
+            skip: { type: 'number', description: '跳过条数，用于分页', default: 0 },
+            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: '按商品名称关键词搜索' },
+            orderBy: { type: 'string', description: '排序方式：date_desc(默认)、date_asc、amount_desc、amount_asc', enum: ['date_desc', 'date_asc', 'amount_desc', 'amount_asc'], default: 'date_desc' },
           },
         },
       },
       {
         name: 'get_receipt_list',
-        description: '获取小票列表',
+        description: '获取小票列表。支持按日期范围、商家、金额等多维度筛选',
         inputSchema: {
           type: 'object',
           properties: {
-            limit: { type: 'number', description: '返回数量限制', default: 5 },
+            limit: { type: 'number', description: '返回数量限制，默认5条，最大50', default: 5 },
+            skip: { type: 'number', description: '跳过条数，用于分页', default: 0 },
+            startDate: { type: 'string', description: '开始日期（ISO格式，如：2026-04-01）' },
+            endDate: { type: 'string', description: '结束日期（ISO格式，如：2026-04-30）' },
+            store: { type: 'string', description: '按商家名称筛选' },
+            minAmount: { type: 'number', description: '最小金额筛选' },
+            maxAmount: { type: 'number', description: '最大金额筛选' },
+            orderBy: { type: 'string', description: '排序方式：date_desc(默认)、date_asc、amount_desc、amount_asc', enum: ['date_desc', 'date_asc', 'amount_desc', 'amount_asc'], default: 'date_desc' },
           },
         },
       },
       {
         name: 'get_statistics',
-        description: '获取消费统计',
+        description: '获取消费统计。支持按年月、日期范围统计，可查看分类占比、消费趋势等',
         inputSchema: {
           type: 'object',
           properties: {
-            yearMonth: { type: 'string', description: '年月（如：2026-03）' },
-            type: { type: 'string', description: '统计类型：item/receipt/category' },
+            yearMonth: { type: 'string', description: '年月（如：2026-03），与startDate/endDate二选一' },
+            startDate: { type: 'string', description: '开始日期（ISO格式），与yearMonth二选一' },
+            endDate: { type: 'string', description: '结束日期（ISO格式），与yearMonth二选一' },
+            type: { type: 'string', description: '统计维度：item(商品明细)、receipt(小票汇总)、category(分类统计)、daily(每日趋势)、store(商家统计)', enum: ['item', 'receipt', 'category', 'daily', 'store'], default: 'category' },
+            category: { type: 'string', description: '按特定分类筛选统计' },
+            store: { type: 'string', description: '按特定商家筛选统计' },
+            groupBy: { type: 'string', description: '分组方式：category(分类)、date(日期)、store(商家)', enum: ['category', 'date', 'store'] },
           },
-          required: ['yearMonth'],
         },
       },
       {
         name: 'save_income',
-        description: '保存收入记录（工资、奖金、红包等）',
+        description: '保存收入记录（工资、奖金、红包等）。⚠️ 重要：必须先调用 get_text_parse_prompt 解析，然后传入所有解析结果字段',
         inputSchema: {
           type: 'object',
           properties: {
-            name: { type: 'string', description: '收入来源（如：工资、奖金、红包）' },
-            amount: { type: 'number', description: '收入金额' },
+            name: { type: 'string', description: '收入来源（如：工资、奖金、红包）（必填）' },
+            amount: { type: 'number', description: '收入金额（必填）' },
             category: { type: 'string', description: '（必填）收入分类（如：工资、奖金、投资）' },
-            store: { type: 'string', description: '付款方（如：公司名称）' },
-            date: { type: 'string', description: '收入时间（ISO格式）（可选）' },
-            note: { type: 'string', description: '备注' },
-            agentType: { type: 'string', description: '【推荐自动填充】Agent类型，如：claude-desktop、cursor、openclaw、workbuddy、trae' },
-            apiProvider: { type: 'string', description: '【推荐自动填充】AI服务提供商，如：anthropic、openai、doubao、aliyun' },
-            rawInput: { type: 'string', description: '【推荐自动填充】用户的原始输入内容，用于记录用户原始请求' },
+            store: { type: 'string', description: '付款方（如：公司名称）（可选）' },
+            date: { type: 'string', description: '收入时间（ISO格式，必须包含时间部分，如：2026-04-14T09:00:00+08:00）（可选）' },
+            note: { type: 'string', description: '备注（可选）' },
+            agentType: { type: 'string', description: '【必填】Agent类型，如：claude-desktop、cursor、openclaw、workbuddy、trae' },
+            apiProvider: { type: 'string', description: '【必填】AI服务提供商，如：anthropic、openai、doubao、aliyun' },
+            rawInput: { type: 'string', description: '【必填】用户的原始输入内容，用于记录用户原始请求' },
             mcp_version: { type: 'string', description: 'MCP Server 版本号（自动填充）' },
           },
-          required: ['name', 'amount'],
+          required: ['name', 'amount', 'category', 'agentType', 'apiProvider', 'rawInput'],
         },
       },
       {
@@ -529,7 +552,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             readAt: new Date().toISOString(),
             validFor: '5分钟'
           },
-          message: '✅ Skill 定义已获取，有效期5分钟\n\n请仔细阅读上述 Skill 文档，然后执行记账操作。'
+          message: `✅ Skill 定义已获取，有效期5分钟\n\n【重要】完整的 Skill 文档内容在 result.data.skill 字段中，请仔细阅读以下内容，然后严格按照 Skill 文档执行记账操作：\n\n${'='.repeat(60)}\n${skillContent}\n${'='.repeat(60)}`
         };
         userMessage = result.message;
         break;
@@ -1194,12 +1217,13 @@ 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) || '',
         store: sanitizeString(args.store, 100) || '',
         date: formatDateWithTimezone(args.date),
         transactionType: 'expense',
-        unit: '',
-        weight: '',
-        marketPrice: '',
         note: sanitizeString(args.note, 500) || '',
         rawInput: sanitizeString(args.rawInput, 1000) || '',
         agentType: args.agentType || '',