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

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/bin/record.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+/**
+ * 柴米AI记账 - 直接记账 CLI
+ * 一步完成：解析文本 → 分类 → 调用云函数存储
+ */
+
+const { callMcpHub } = require('../utils/api');
+const { getToken } = require('../utils/auth');
+const { parseText } = require('../utils/parser');
+
+async function record(text, options = {}) {
+  try {
+    // 1. 解析文本
+    const parsed = await parseText(text);
+    
+    // 2. 确定类型（收入/支出）
+    const type = options.type || parsed.type || 'expense';
+    
+    // 3. 获取 token
+    const token = await getToken();
+    
+    // 4. 调用云函数存储
+    const result = await callMcpHub(type === 'income' ? 'addIncome' : 'addExpense', {
+      ...parsed,
+      type,
+      rawInput: text
+    }, token);
+    
+    if (result.success) {
+      console.log('✅ 记账成功！');
+      console.log(`金额：¥${parsed.amount}`);
+      console.log(`分类：${parsed.category}`);
+      console.log(`商品：${parsed.name}`);
+    } else {
+      console.error('❌ 记账失败：', result.error);
+      process.exit(1);
+    }
+  } catch (error) {
+    console.error('❌ 错误：', error.message);
+    process.exit(1);
+  }
+}
+
+// 解析命令行参数
+const args = process.argv.slice(2);
+const text = args[0];
+const typeFlag = args.find(arg => arg.startsWith('--type='));
+const type = typeFlag ? typeFlag.split('=')[1] : null;
+
+if (!text) {
+  console.log('用法: chaimi-keep record "<记账文本>" [--type=income|expense]');
+  console.log('示例: chaimi-keep record "中午吃饭花了35元"');
+  console.log('示例: chaimi-keep record "工资收入5000" --type=income');
+  process.exit(1);
+}
+
+record(text, { type });

package/package.json

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

package/server.js

@@ -259,7 +259,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'save_expense',
-        description: '【文本记账-支出】用户提及支出/消费时用此工具。前置：必须先调用get_skill获取规范，再调用get_text_parse_prompt获取Token和解析模板。用法：mcporter call 柴米AI记账.save_expense _requestToken="RT..." name="午餐" amount=35 category="餐饮" rawInput="午餐35元"。注意：上传图片请用save_receipt',
+        description: '【文本记账-支出】用户提及支出/消费时用此工具。前置：必须先调用get_skill获取规范，再调用get_text_parse_prompt获取凭证和解析模板。用法：mcporter call 柴米AI记账.save_expense _flowmate="SOLINWANG..." name="午餐" amount=35 category="餐饮" rawInput="午餐35元"。注意：上传图片请用save_receipt',
         inputSchema: {
           type: 'object',
           properties: {
@@ -275,13 +275,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             agentType: { type: 'string', description: '【必填】Agent类型，如：claude-desktop、cursor、openclaw、workbuddy、trae' },
             apiProvider: { type: 'string', description: '【必填】AI服务提供商，如：anthropic、openai、doubao、aliyun' },
             rawInput: { type: 'string', description: '【必填】用户的原始输入内容，用于记录用户原始请求' },
+            _flowmate: { type: 'string', description: '【必填】流程凭证，从get_text_parse_prompt获取的myflowmate值' },
           },
-          required: ['name', 'amount', 'category', 'agentType', 'apiProvider', 'rawInput'],
+          required: ['name', 'amount', 'category', 'agentType', 'apiProvider', 'rawInput', '_flowmate'],
         },
       },
       {
         name: 'save_receipt',
-        description: '【图片记账-小票】用户上传小票/发票/收据图片时用此工具。前置：必须先调用get_skill获取规范，再调用get_parse_prompt获取Token和解析模板。用法：mcporter call 柴米AI记账.save_receipt _requestToken="RT..." store="超市" totalAmount=156.5 items="[...]"。注意：文字描述请用save_expense/save_income',
+        description: '【图片记账-小票】用户上传小票/发票/收据图片时用此工具。前置：必须先调用get_skill获取规范，再调用get_parse_prompt获取凭证和解析模板。用法：mcporter call 柴米AI记账.save_receipt _flowmate="SOLINWANG..." store="超市" totalAmount=156.5 items="[...]"。注意：文字描述请用save_expense/save_income',
         inputSchema: {
           type: 'object',
           properties: {
@@ -322,8 +323,9 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             agentType: { type: 'string', description: '【必填】Agent类型：claude-desktop、cursor、openclaw、workbuddy、trae' },
             apiProvider: { type: 'string', description: '【必填】AI服务提供商：anthropic、openai、doubao、aliyun' },
             rawInput: { type: 'string', description: '【必填】用户的原始输入内容' },
+            _flowmate: { type: 'string', description: '【必填】流程凭证，从get_parse_prompt获取的myflowmate值' },
           },
-          required: ['store', 'items', 'storeCategory', 'storeSubCategory', 'agentType', 'apiProvider', 'rawInput'],
+          required: ['store', 'items', 'storeCategory', 'storeSubCategory', 'agentType', 'apiProvider', 'rawInput', '_flowmate'],
         },
       },
       {
@@ -409,7 +411,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'save_income',
-        description: '【文本记账-收入】用户提及收入关键词（工资、红包、转账、退款等）时用此工具。前置：必须先调用get_skill获取规范，再调用get_text_parse_prompt获取Token和解析模板。用法：mcporter call 柴米AI记账.save_income _requestToken="RT..." 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: {
@@ -422,13 +424,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             agentType: { type: 'string', description: '【必填】Agent类型，如：claude-desktop、cursor、openclaw、workbuddy、trae' },
             apiProvider: { type: 'string', description: '【必填】AI服务提供商，如：anthropic、openai、doubao、aliyun' },
             rawInput: { type: 'string', description: '【必填】用户的原始输入内容，用于记录用户原始请求' },
+            _flowmate: { type: 'string', description: '【必填】流程凭证，从get_text_parse_prompt获取的myflowmate值' },
           },
-          required: ['name', 'amount', 'category', 'agentType', 'apiProvider', 'rawInput'],
+          required: ['name', 'amount', 'category', 'agentType', 'apiProvider', 'rawInput', '_flowmate'],
         },
       },
       {
         name: 'get_text_parse_prompt',
-        description: '【不调用100%失败】获取文字记账解析的Prompt模板和requestToken。⚠️ 文字/语音记账必须先调用此工具获取Token，AI解析时必须返回_requestToken字段，否则save_expense/save_income会报MISSING_TOKEN错误！',
+        description: '【不调用100%失败】获取文字记账解析的Prompt模板和流程凭证。⚠️ 文字/语音记账必须先调用此工具获取凭证，AI解析时必须返回_flowmate字段，否则save_expense/save_income会报MISSING_TOKEN错误！',
         inputSchema: {
           type: 'object',
           properties: {
@@ -439,7 +442,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'get_parse_prompt',
-        description: '【不调用100%失败】获取小票图片解析的Prompt模板和requestToken。⚠️ 小票记账必须先调用此工具获取Token，AI解析时必须返回_requestToken字段，否则save_receipt会报MISSING_TOKEN错误！',
+        description: '【不调用100%失败】获取小票图片解析的Prompt模板和流程凭证。⚠️ 小票记账必须先调用此工具获取凭证，AI解析时必须返回_flowmate字段，否则save_receipt会报MISSING_TOKEN错误！',
         inputSchema: {
           type: 'object',
           properties: {
@@ -1625,8 +1628,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               systemPrompt: promptResult.data.systemPrompt,
               userPromptTemplate: promptResult.data.userPromptTemplate,
               examples: promptResult.data.examples,
-              requestToken: promptResult.data.requestToken,
-              instructions: '请将 systemPrompt 作为 system message，把小票图片作为 user message，调用你的大模型进行解析。解析完成后，调用 save_receipt 工具保存结果。⚠️ 注意：AI解析结果必须包含 _requestToken 字段！'
+              myflowmate: promptResult.data.myflowmate,
+              instructions: '请将 systemPrompt 作为 system message，把小票图片作为 user message，调用你的大模型进行解析。解析完成后，调用 save_receipt 工具保存结果。⚠️ 注意：AI解析结果必须包含 _flowmate 字段！'
             }
           };
           // 【新增】返回模板位置信息（Server只返回原始数据，Agent使用模板渲染）
@@ -1653,7 +1656,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               prompt: promptResult.data.prompt,
               currentDate: promptResult.data.currentDate,
               currentTime: promptResult.data.currentTime,
-              requestToken: promptResult.data.requestToken,
+              myflowmate: promptResult.data.myflowmate,
               instructions: promptResult.data.instructions
             }
           };
@@ -2121,7 +2124,7 @@ function convertParams(toolName, args) {
         apiProvider: sanitizeString(args.apiProvider, 50) || '',
         mcpVersion: MCP_VERSION,
         source: 'mcp_txt_expense',
-        _requestToken: args._requestToken,
+        _flowmate: args._flowmate,
       };
     }
 
@@ -2178,11 +2181,11 @@ function convertParams(toolName, args) {
         source: 'mcp_receipt',
         storeCategory: sanitizeString(args.storeCategory, 50) || '其他',
         storeSubCategory: sanitizeString(args.storeSubCategory, 50) || '其他',
-        _requestToken: args._requestToken,
+        _flowmate: args._flowmate,
       };
     }
 
-    case 'get_expenses': {
+    case 'save_receipt': {
       // 【新增】支持 period 参数
       const periodDates = args.period ? parsePeriod(args.period) : {};
       return {
@@ -2220,7 +2223,7 @@ function convertParams(toolName, args) {
         apiProvider: sanitizeString(args.apiProvider, 50) || '',
         mcpVersion: MCP_VERSION,
         source: 'mcp_txt_income',
-        _requestToken: args._requestToken,
+        _flowmate: args._flowmate,
       };
 
     default:

package/utils/category-mapper.js

@@ -0,0 +1,15 @@
+/**
+ * 分类标准化映射器
+ * 将 Agent 提取的关键词映射到标准分类
+ * 确保分类一致性，便于后续统计
+ */
+
+// 标准分类列表
+const STANDARD_CATEGORIES = [
+  '餐饮', '购物', '交通', '蔬菜', '水果', '零食', '运动', '通讯', '服饰', '美容',
+  '住房', '孩子', '长辈', '社交', '旅行', '烟酒', '数码', '汽车', '医疗', '办公',
+  '学习', '宠物', '礼金', '亲友', '日用', '休闲娱乐', '维修', '居家', '饮品', '鲜花',
+  '追星', '首饰', '借出', '保险', '网络虚拟', '生活缴费', '转账', '书籍', '捐赠', '彩票', '快递', '其他'
+];
+
+// 关键词到