chaimi-keep-mcp 3.1.47 → 3.1.49-beta.1

package/README.md

@@ -148,6 +148,25 @@ AI 会自动调用 `save_income` 工具记录收入。
 
 ## 更新日志
 
+### v3.1.49-beta.0 (2026-04-24)
+- **修复** category 未定义错误（三个记账函数）
+  - save_expense: `category` → `displayCategory`
+  - save_receipt: `storeCategory` → `category`
+  - save_income: `category` → `displayCategory`
+- **优化** 回复格式排版
+  - Agent 名称用「」包裹：`「你的小可爱」`
+  - 分隔符从 emoji 换成实心点 `·`
+  - 更简洁清晰的视觉层次
+
+### v3.1.48 (2026-04-24)
+- **优化** 回复格式模板
+  - 添加缩进层级，主次信息更清晰
+  - 所有记账工具回复添加 4 空格缩进
+  - 新增 Agent 名称说明，支持自定义名称显示
+- **完善** SKILL.md 文档
+  - 扩充友好结束语参考，按分类给出更多正能量表达
+  - 详细说明未授权处理流程
+
 ### v3.1.46-beta.0 (2026-04-22)
 - **修复** 授权流程阻塞问题：恢复到 v3.1.37 之前的非阻塞模式
   - 移除 `startAuthFlowAndWait()` 和 `waitForAuthWithPolling()` 阻塞函数

package/SKILL.md

@@ -261,23 +261,30 @@ get_statistics period="this_week"
 记账成功后，使用以下格式回复（代码块内每行一个换行）：
 
 ```
-✅ 【商品名/店名】¥【金额】
-    已录入【柴米AI记账】
-    【补充信息，如购买地点日期】
+✅ 「Agent名称」已帮您录入「柴米AI记账」
+    · 商品/店名：【名称】 💰【金额】
+    · 收支类型： 【收入/支出】
+    · 分类：【商品类型】
+    · 时间：【购买日期】
 ✅ 【友好结束语】
 
-消费洞察：【洞察内容】（可选）
+💡 消费洞察：【洞察内容】（可选）
 -------------
 chaimi-keep-mcp: v【版本号】
 ```
 
-**友好结束语参考：**
-- 餐饮类：用餐愉快！🍚 / 好好吃饭哦~
-- 食品类：吃好喝好！🍎
-- 交通类：出行顺利！🚗
-- 购物类：买得开心！🛍️
-- 收入类：入账顺利！💰
-- 通用：记账完成！继续保持~ ✨
+**Agent名称说明：**
+- 如果用户为当前授权设置了自定义Agent名称（如"你的小可爱"），则显示：`✅ 「你的小可爱」已帮您录入「柴米AI记账」`
+- 如果未设置自定义名称（默认"柴米AI助手"），则显示：`✅ 「柴米AI助手」已帮您录入「柴米AI记账」`
+- Agent名称从MCP返回的数据中获取，字段名为 `agentName`
+
+**友好结束语参考（一定要是正能量，且给足情绪价值的词）：**
+- 餐饮类：用餐愉快！🍚 / 好好吃饭哦~ / 美食治愈一切！😋 / 每一餐都是生活的小确幸~ 🌟
+- 食品类：吃好喝好！🍎 / 健康第一，美味加倍！💪 / 好好照顾自己哦~ 🤗
+- 交通类：出行顺利！🚗 / 一路平安！🙏 / 顺利抵达，心情愉悦~ 😊
+- 购物类：买得开心！🛍️ / 精明消费，品质生活！✨ / 买到心仪好物，心情美美哒~ 💕
+- 收入类：入账顺利！💰 / 财富+1，好运连连！🍀 / 越努力越幸运，继续加油！🚀
+- 通用：记账完成！继续保持~ ✨ / 今天的你超棒的！👍 / 记录美好生活，从每一笔开始~ 📝
 
 **消费洞察（可选）：**
 - 由云函数自动生成，返回记账后的即时洞察
@@ -286,14 +293,16 @@ chaimi-keep-mcp: v【版本号】
 **真实示例：**
 
 ```
-✅ 【牛肉】¥24
-    已录入【柴米AI记账】
-    华润万家超市，2026年4月16日购买
+✅ 「你的小可爱」已帮您录入「柴米AI记账」
+    · 商品：猪脚 💰 ¥33
+    · 收支类型： 支出
+    · 分类：     餐饮
+    · 时间：2026年4月24日
 ✅ 好好吃饭哦~
 
-消费洞察：这是你本周第19次餐饮消费，要不要看看本周餐饮花了多少钱？
+💡 消费洞察：这是你本周第23次餐饮消费，要不要看看本周餐饮花了多少钱？
 -------------
-chaimi-keep-mcp: v3.1.40
+chaimi-keep-mcp: v3.1.48
 ```
 
 ---
@@ -303,10 +312,49 @@ chaimi-keep-mcp: v3.1.40
 | 错误类型 | 处理方式 |
 |----------|----------|
 | 未安装 | 引导安装：`npm install -g chaimi-keep-mcp` |
-| 未授权 | 引导完成 Device Flow 授权 |
-| Token 过期 | 引导重新授权 |
+| 未授权 | MCP Server 自动返回授权错误和验证码，Agent 引导用户在小程序中完成授权 |
+| Token 过期 | MCP Server 自动刷新，或返回授权错误需要重新授权 |
 | 参数错误 | 提示用户补充必要信息 |
 
+### 未授权详细处理流程
+
+当调用记账工具时，如果用户未授权，MCP Server 会自动返回授权错误，包含验证码。
+
+**第 1 步：捕获授权错误**
+
+当 MCP Server 返回如下错误时：
+```
+NEED_AUTH:GGCY-AC84
+```
+
+表示需要授权，验证码为 `GGCY-AC84`。
+
+**第 2 步：引导用户完成授权**
+
+Agent 必须向用户显示：
+```
+🔐 请先完成授权
+
+━━━━━━━━━━━━━━
+📱 验证码：GGCY-AC84
+━━━━━━━━━━━━━━
+
+请在"柴米AI记账"小程序中完成授权：
+
+1️⃣ 打开微信小程序"柴米AI记账"
+2️⃣ 点击"我的" → "🤖 Agent 授权"
+3️⃣ 输入验证码：GGCY-AC84
+4️⃣ 点击确认授权
+
+授权完成后告诉我，我将继续为您记账。
+```
+
+**第 3 步：用户确认授权后**
+
+用户告知授权完成后，Agent **直接重新调用**之前的记账工具，无需其他操作。
+- 如果授权成功，记账会自动完成
+- 如果授权失败，会再次返回错误
+
 ---
 
 *最后更新：2026-04-16*

package/oauth.js

@@ -484,6 +484,58 @@ class FileTokenStorage extends TokenStorage {
       }
     }
   }
+
+  // 【新增】保存 Agent 名称（不修改授权流程，仅用于记账回复）
+  async saveAgentName(agentName) {
+    try {
+      const agentNamePath = this.path.join(this.path.dirname(this.filePath), 'agent-name.json');
+      const data = {
+        agentName: agentName || '柴米AI助手',
+        updatedAt: new Date().toISOString()
+      };
+      await this.fs.writeFile(agentNamePath, JSON.stringify(data, null, 2), { mode: 0o600 });
+    } catch (err) {
+      // 忽略错误，不影响主流程
+    }
+  }
+
+  // 【新增】读取 Agent 名称
+  async loadAgentName() {
+    try {
+      const agentNamePath = this.path.join(this.path.dirname(this.filePath), 'agent-name.json');
+      const data = await this.fs.readFile(agentNamePath, 'utf8');
+      const parsed = JSON.parse(data);
+      return parsed.agentName || '柴米AI助手';
+    } catch (err) {
+      return '柴米AI助手';
+    }
+  }
+
+  // 【新增】保存 deviceCode
+  async saveDeviceCode(deviceCode) {
+    try {
+      const deviceCodePath = this.path.join(this.path.dirname(this.filePath), 'device-code.json');
+      const data = {
+        deviceCode,
+        updatedAt: new Date().toISOString()
+      };
+      await this.fs.writeFile(deviceCodePath, JSON.stringify(data, null, 2), { mode: 0o600 });
+    } catch (err) {
+      // 忽略错误
+    }
+  }
+
+  // 【新增】读取 deviceCode
+  async loadDeviceCode() {
+    try {
+      const deviceCodePath = this.path.join(this.path.dirname(this.filePath), 'device-code.json');
+      const data = await this.fs.readFile(deviceCodePath, 'utf8');
+      const parsed = JSON.parse(data);
+      return parsed.deviceCode;
+    } catch (err) {
+      return null;
+    }
+  }
 }
 
 module.exports = {

package/package.json

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

package/server.js

@@ -967,9 +967,13 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             achievementsText = '\n\n🎉 成就解锁：' + result.newlyUnlocked.map(a => `${a.icon} ${a.title}（+${a.points}分）`).join('；');
           }
           
-          // 按 SKILL 规范格式：记账成功 + 友好结束语 + 消费洞察 + 成就 + 版本号
+          // 【新增】获取 Agent 名称
+          const agentName = await getAgentName();
+          
+          // 按 SKILL 规范格式：新的回复模板
           const displayStoreText = displayStore ? `【${displayStore}】` : '';
-          userMessage = `✅ ${displayName}${displayStoreText} ¥${displayAmount} 已录入柴米AI记账。\n\n${friendlyEnding}${insightsText}${achievementsText}\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
+          const dateStr = result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN');
+          userMessage = `✅ 「${agentName}」已帮您录入「柴米AI记账」\n    · 商品/店名：${displayName}${displayStoreText} 💰¥${displayAmount}\n    · 收支类型： 支出\n    · 分类：${result.data?.categoryName || displayCategory}\n    · 时间：${dateStr}\n✅ ${friendlyEnding}${insightsText}${achievementsText}\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
           
           if (!processedArgs.agentType || !processedArgs.apiProvider) {
             userMessage += '\n\n💡 提示：传递agentType和apiProvider参数可解锁小程序记录来源统计功能，示例：agentType="openclaw", apiProvider="doubao"';
@@ -1208,7 +1212,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             achievementsText = '\n\n🎉 成就解锁：' + result.newlyUnlocked.map(a => `${a.icon} ${a.title}（+${a.points}分）`).join('；');
           }
           
-          userMessage = `✅ ${storeName} ¥${totalAmount} 已录入柴米AI记账（${itemCount}件商品）。\n\n${friendlyEnding}${insightsText}${achievementsText}\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
+          // 【新增】获取 Agent 名称
+          const agentName = await getAgentName();
+          
+          // 按 SKILL 规范格式：新的回复模板
+          const dateStr = result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN');
+          userMessage = `✅ 「${agentName}」已帮您录入「柴米AI记账」\n    · 商品/店名：${storeName} 💰¥${totalAmount}\n    · 收支类型： 支出\n    · 分类：${result.data?.storeCategory || category}\n    · 商品数量：${itemCount}件\n    · 时间：${dateStr}\n✅ ${friendlyEnding}${insightsText}${achievementsText}\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
           
           if (!processedArgs.agentType || !processedArgs.apiProvider) {
             userMessage += '\n\n💡 提示：传递agentType和apiProvider参数可解锁小程序记录来源统计功能，示例：agentType="openclaw", apiProvider="doubao"';
@@ -1433,7 +1442,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           const displayStore = processedArgs.store || '';
           const displayStoreText = displayStore ? `【${displayStore}】` : '';
           
-          userMessage = `✅ ${displayName}${displayStoreText} ¥${displayAmount} 已录入柴米AI记账。\n\n入账顺利！💰\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
+          // 【新增】获取 Agent 名称
+          const agentName = await getAgentName();
+          
+          // 按 SKILL 规范格式：新的回复模板
+          const dateStr = result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN');
+          userMessage = `✅ 「${agentName}」已帮您录入「柴米AI记账」\n    · 商品/店名：${displayName}${displayStoreText} 💰¥${displayAmount}\n    · 收支类型： 收入\n    · 分类：${result.data?.categoryName || displayCategory}\n    · 时间：${dateStr}\n✅ 入账顺利！💰\n-------------\nchaimi-keep-mcp: v${MCP_VERSION}`;
         }
         break;
       }
@@ -1521,6 +1535,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       userMessage = `❌ 操作失败：${result.error || '未知错误'}`;
     }
 
+    // 【新增】在结果中添加 agentName，让 Agent 可以使用
+    const agentName = await getAgentName();
+    if (result && typeof result === 'object') {
+      result.agentName = agentName;
+    }
+
     return {
       content: [
         {
@@ -1938,6 +1958,55 @@ let authState = {
   error: null
 };
 
+// 【新增】获取 Agent 名称（仅用于记账回复，不修改授权流程）
+async function getAgentName() {
+  try {
+    if (oauthManager && oauthManager.tokenStorage) {
+      const localName = await oauthManager.tokenStorage.loadAgentName();
+      
+      // 如果是默认名称，尝试从云端获取
+      if (localName === '柴米AI助手') {
+        // 获取保存的 deviceCode
+        const deviceCode = await oauthManager.tokenStorage.loadDeviceCode();
+        if (deviceCode) {
+          // 从云端获取
+          const cloudName = await fetchAgentNameFromCloud(deviceCode);
+          if (cloudName && cloudName !== '柴米AI助手') {
+            await oauthManager.tokenStorage.saveAgentName(cloudName);
+            return cloudName;
+          }
+        }
+      }
+      
+      return localName;
+    }
+  } catch (err) {
+    // 忽略错误
+  }
+  return '柴米AI助手';
+}
+
+// 【新增】从云端获取 Agent 名称
+async function fetchAgentNameFromCloud(deviceCode) {
+  try {
+    const response = await fetch(MCP_OAUTH_URL, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        tool: 'getDeviceInfo',
+        params: { deviceCode }
+      })
+    });
+    const result = await response.json();
+    if (result.success && result.data.agentName) {
+      return result.data.agentName;
+    }
+  } catch (err) {
+    // 忽略错误
+  }
+  return null;
+}
+
 async function main() {
   await initOAuthManager();
 
@@ -2017,6 +2086,11 @@ async function pollForAuthInBackground(deviceCode, interval) {
         
         // 保存token到文件
         await oauthManager.tokenStorage.save(token);
+        
+        // 【新增】保存默认 Agent 名称和 deviceCode（首次记账时会获取真实名称）
+        await oauthManager.tokenStorage.saveAgentName('柴米AI助手');
+        await oauthManager.tokenStorage.saveDeviceCode(authState.deviceCode);
+        
         // 清除授权状态
         await oauthManager.clearAuthState();