chaimi-keep-mcp 3.5.0-beta.4 → 3.5.0-beta.5

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # Changelog
 
+## v3.5.0-beta.5 (2026-05-02)
+
+- **修复** 重新授权流程 - 修复 Token 过期/取消授权后无法弹出新验证码的问题
+  - Bug 1: `getToken()` 函数中添加 `await startAuthFlow()`
+  - Bug 2: `callMcpHubWithLogging()` 中检测业务 401 并触发重新授权
+  - 新增: `clearCachedToken()` 工具函数
+- **优化** 文档 - 在 SKILL.md, authentication.md, troubleshooting.md 中添加授权流程关键说明
+
+## v3.5.0-beta.4 (2026-05-02)
+- **优化** 回复模板 - 调整确认提示对齐方式
+  - SKILL.md: `🔴🔴` → `🔴`，添加空格对齐
+  - response-templates.md: `🔴🔴` → `🔴`，添加空格对齐
+  - "请"字与下方的"¥"符号左对齐，更美观
+
 ## v3.4.0 (2026-05-01) 🎉 正式版
 
 **首个正式生产版本 - 多端记账分类统一**

package/README.md

@@ -89,6 +89,13 @@ export MCP_PROMPT_URL="你的Prompt服务地址"
 
 ## Changelog
 
+### v3.5.0-beta.5 (2026-05-02)
+- **修复** 重新授权流程 - 修复 Token 过期/取消授权后无法弹出新验证码的问题
+- **优化** 文档 - 在 SKILL.md, authentication.md, troubleshooting.md 中添加授权流程关键说明
+
+### v3.5.0-beta.4 (2026-05-02)
+- **优化** 回复模板 - 调整确认提示对齐方式
+
 ### v3.4.0 (2026-05-01) 🎉 正式版
 - **变更** 多端记账分类统一 - 支持商品分类和记账分类分离
 - **修复** mcp-server-local case 重复问题

package/SKILL.md

@@ -296,6 +296,17 @@ references/
 
 ## 九、错误速查
 
+### ⚠️ 授权流程关键说明（必读！）
+
+**重要提示：验证码只能在 Agent/MCP 端（终端）生成！小程序里无法生成验证码，只能输入验证码！**
+
+| 位置 | 作用 |
+|:-----|:------|
+| Agent/MCP 端（终端） | 生成验证码 |
+| 小程序 | 只负责输入验证码 |
+
+---
+
 ### Top 3 常见错误
 
 | 错误 | 现象 | 解决方案 | 参考文档 |

package/package.json

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

package/references/authentication.md

@@ -25,22 +25,26 @@ updated: "2026-04-30"
 ```
 用户（小程序端）          Agent（MCP端）
     │                         │
-    │  1. 请求授权             │
+    │  1. 请求记账             │
     │────────────────────────>│
     │                         │
-    │  2. 生成验证码           │
+    │  2. 检测未授权          │
+    │                         │
+    │  3. Agent 端（终端）生成验证码 │
     │<────────────────────────│
     │                         │
-    │  3. 小程序确认           │
+    │  4. 用户在小程序输入验证码 │
     │────────────────────────>│
     │                         │
-    │  4. 发放Token            │
+    │  5. 小程序验证并发放Token │
     │<────────────────────────│
     │                         │
-    │  5. Token记账            │
+    │  6. Token记账            │
     │────────────────────────>│
 ```
 
+> ⚠️ **重要提示：验证码只能在 Agent/MCP 端（终端）生成！小程序里无法生成验证码，只能输入验证码！**
+
 ### 1.2 Token有效期
 
 | Token类型 | 有效期 | 说明 |
@@ -65,7 +69,7 @@ updated: "2026-04-30"
    chaimi-keep-mcp
    ```
 
-2. **查看验证码**
+2. **查看验证码（注意：验证码只在 Agent/终端 显示）**
    终端会显示：
    ```
    🔐 柴米AI记账授权
@@ -74,10 +78,10 @@ updated: "2026-04-30"
    ⏰ 有效期：5分钟
    ```
 
-3. **小程序确认**
+3. **小程序确认（注意：小程序只负责输入验证码，不会生成验证码）**
    - 打开"柴米AI记账"小程序
-   - 点击"我的" → "AI 助手绑定"
-   - 输入验证码
+   - 点击"我的" → "Agent 授权"
+   - 输入刚才在 Agent/终端 看到的验证码
    - 点击确认
 
 4. **完成授权**
@@ -99,7 +103,7 @@ mcporter auth 柴米AI记账 --reset
 **然后：**
 1. 查看终端显示的验证码
 2. 打开"柴米AI记账"小程序
-3. 进入"我的" → "AI 助手绑定"
+3. 进入"我的" → "Agent 授权"
 4. 输入验证码完成授权
 
 ### 2.3 原生 MCP 客户端授权失败（Claude/Cursor）
@@ -127,7 +131,7 @@ mcporter auth 柴米AI记账 --reset
    mcporter auth 柴米AI记账
    ```
 2. 查看终端显示的验证码
-3. 在小程序"我的"→"AI 助手绑定"中输入验证码
+3. 在小程序"我的"→"Agent 授权"中输入验证码
 4. 返回 Claude/Cursor 重新尝试记账
 
 **解决方案（方式2 - 删除 Token 文件）：**

package/references/troubleshooting.md

@@ -24,6 +24,17 @@ updated: "2026-04-25"
 
 ## 一、授权问题
 
+### ⚠️ 授权流程关键说明（必读！）
+
+**重要提示：验证码只能在 Agent/MCP 端（终端）生成！小程序里无法生成验证码，只能输入验证码！**
+
+| 位置 | 作用 |
+|:-----|:------|
+| Agent/MCP 端（终端） | 生成验证码 |
+| 小程序 | 只负责输入验证码 |
+
+---
+
 ### 1.1 未找到有效授权
 
 **现象：**
@@ -40,7 +51,7 @@ updated: "2026-04-25"
 **解决方案：**
 1. 执行 `mcporter auth 柴米AI记账`
 2. 查看终端显示的验证码
-3. 在小程序"我的"→"AI 助手绑定"中输入验证码
+3. 在小程序"我的"→"Agent 授权"中输入验证码
 4. 重新尝试记账
 
 ### 1.2 授权过期
@@ -77,7 +88,7 @@ mcporter auth 柴米AI记账 --reset
 
 **解决方案：**
 1. 重新执行 `mcporter auth 柴米AI记账` 生成新验证码
-2. 在5分钟内在小程序"我的"→"AI 助手绑定"中输入
+2. 在5分钟内在小程序"我的"→"Agent 授权"中输入
 3. 注意区分大小写
 
 ### 1.4 签名验证失败（版本升级问题）
@@ -102,7 +113,7 @@ Unsupported state or unable to authenticate data
    chaimi-keep-mcp
    ```
 2. 查看终端显示的新验证码
-3. 在小程序"我的"→"AI 助手绑定"中输入新验证码
+3. 在小程序"我的"→"Agent 授权"中输入新验证码
 4. 重新尝试记账
 
 **重要提示：** 此问题仅在安全加固版本升级时出现一次，后续不会再遇到。

package/server.js

@@ -237,6 +237,11 @@ function setCachedToken(token) {
   cachedEncryptedToken = encrypt(token, tokenEncryptionKey);
 }
 
+// 清除缓存的 Token
+function clearCachedToken() {
+  cachedEncryptedToken = null;
+}
+
 // OAuth 管理器实例
 let oauthManager = null;
 
@@ -652,7 +657,8 @@ async function getToken() {
     // Token 获取失败，可能需要重新授权
     authState.isAuthorized = false;
     authState.isWaiting = false;
-    throw new Error(`NEED_AUTH:授权已过期，请重新授权`);
+    await startAuthFlow();
+    throw new Error(`NEED_AUTH:${authState.userCode || '等待生成验证码'}`);
   }
 }
 
@@ -757,6 +763,20 @@ async function callMcpHubWithLogging(tool, params, token, traceId, startTime, os
   try {
     const result = await callMcpHub(tool, paramsWithMeta, token, traceId, osInfo);
 
+    // ✅ 检查业务返回的 401 错误
+    if (!result.success && result.code === 401) {
+      console.error('检测到业务 401，触发重新授权流程');
+      
+      // 清除缓存的 token
+      clearCachedToken();
+      await oauthManager.clearAuthState();
+      
+      // 启动新授权流程
+      await startAuthFlow();
+      
+      throw new Error(`NEED_AUTH:${authState.userCode || '等待生成验证码'}`);
+    }
+
     // 记录云函数调用成功（已停用：MCP调用日志待迁移到独立云函数）
     // logMcpCall({
     //   traceId,
@@ -1852,6 +1872,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 📱 验证码：**${userCode}**
 ━━━━━━━━━━━━━━
 
+⚠️ 重要说明：
+• 上面的验证码是我为您生成的！（只有在 Agent/MCP 端才能看到）
+• 小程序里无法生成验证码，只负责输入验证码！
+
 请在"柴米AI记账"小程序中完成授权：
 
 1️⃣ 打开微信小程序"柴米AI记账"