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

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`：计价单位（如：元/500g、元/个、元/盒、元/袋）
+- `marketPrice`：单价，根据 unit 计算
+
+---
+
+### 收入记账（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`：计价单位（如：元/500g、元/个、元/盒、元/袋）
+- `marketPrice`：单价，根据 unit 计算
+
 ---
 
 ### 小票记账（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.0",
   "description": "柴米记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {

package/server.js

@@ -139,7 +139,10 @@ 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: '计价单位（如：元/500g、元/个、元/盒、元/袋）' },
+            marketPrice: { type: 'string', description: '单价数值，根据unit计算' },
             store: { type: 'string', description: '商家名称（可选）' },
             date: { type: 'string', description: '消费时间（ISO格式）（可选）' },
             note: { type: 'string', description: '备注（可选）' },
@@ -175,11 +178,12 @@ 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'],
               },
@@ -227,22 +231,22 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         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: '备注' },
+            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'],
         },
       },
       {
@@ -529,7 +533,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 +1198,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 || '',