chaimi-keep-mcp 3.5.0-beta.2 → 3.5.0-beta.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.5.0-beta.2",
+  "version": "3.5.0-beta.21",
   "description": "柴米AI记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {
@@ -23,13 +23,18 @@
   "scripts": {
     "start": "node server.js",
     "dev": "node server.js",
-    "postinstall": "node bin/sync-skill.js",
+    "postinstall": "node bin/sync-skill.js && node bin/restart-daemon.js",
     "test": "jest",
-    "test:static": "jest test/static-analysis.test.js",
-    "prepublishOnly": "npm run test:static"
+    "test:static": "echo 'No tests'",
+    "obfuscate": "node scripts/obfuscate.js",
+    "build": "node scripts/build.js",
+    "build:dist": "node scripts/build.js",
+    "copy-files": "shx cp package.json dist/ && shx cp README.md dist/ && shx mkdir -p dist/bin && shx mkdir -p dist/references && shx mkdir -p dist/skills && shx cp -r bin/* dist/bin/ && shx cp -r references/* dist/references/ && shx cp -r skills/* dist/skills/"
   },
   "devDependencies": {
-    "jest": "^29.0.0"
+    "javascript-obfuscator": "^5.4.2",
+    "jest": "^29.0.0",
+    "shx": "^0.4.0"
   },
   "keywords": [
     "mcp",
@@ -45,7 +50,6 @@
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "chaimi-keep-mcp": "^3.3.2-beta.1",
     "dotenv": "^17.3.1",
     "node-fetch": "^2.7.0"
   },

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/response-templates.md

@@ -123,15 +123,15 @@ updated: "2026-04-25"
 ```markdown
 ✅ 「{agentName}」已帮您记账成功
 ═══════════════
-🔴🔴 请确认以下信息是否正确
+🔴 AI生成信息，请确认是否正确
 
 💰 金额：¥{金额}
 📊 类型：{类型}
+🏷️ 分类：{分类}
 🕐 时间：{日期时间}
 ═══════════════
 
 📦 商品：{商品名}
-🏷️ 分类：{分类}
 🏪 商家：{商家}
 💡 消费洞察：{洞察内容}
 ⏰ 时间说明：{timeNote}
@@ -148,15 +148,15 @@ updated: "2026-04-25"
 ```markdown
 ✅ 「你的小可爱」已帮您记账成功
 ═══════════════
-🔴🔴 请确认以下信息是否正确
+🔴 AI生成信息，请确认是否正确
 
 💰 金额：¥35.00
 📊 类型：支出
+🏷️ 分类：餐饮
 🕐 时间：2026-04-24 12:30
 ═══════════════
 
 📦 商品：午餐
-🏷️ 分类：餐饮
 🏪 商家：麦当劳
 💡 消费洞察：本月餐饮支出占比30%，建议控制
 
@@ -236,12 +236,15 @@ updated: "2026-04-25"
 ```markdown
 ✅ 「{agentName}」已帮您记录收入
 ═══════════════
+🔴 AI生成信息，请确认是否正确
+
 💰 金额：¥{金额}
-═══════════════
- 
 📊 类型：{类型}
 🏷️ 分类：{分类}
 🕐 时间：{日期时间}
+═══════════════
+
+🏪 付款方：{商家}
 
 💡 消费洞察：{洞察内容}（可选）
 
@@ -257,12 +260,15 @@ updated: "2026-04-25"
 ```markdown
 ✅ 「你的小可爱」已帮您记录收入
 ═══════════════
-💰 金额：¥5000.00
-═══════════════
+🔴 AI生成信息，请确认是否正确
 
+💰 金额：¥5000.00
 📊 类型：收入
 🏷️ 分类：工资
 🕐 时间：2026-04-24 09:00
+═══════════════
+
+🏪 付款方：公司
 
 💡 消费洞察：本月收入储蓄率50%，继续保持！
 

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,9 +88,36 @@ mcporter auth 柴米AI记账 --reset
 
 **解决方案：**
 1. 重新执行 `mcporter auth 柴米AI记账` 生成新验证码
-2. 在5分钟内在小程序"我的"→"AI 助手绑定"中输入
+2. 在5分钟内在小程序"我的"→"Agent 授权"中输入
 3. 注意区分大小写
 
+### 1.4 签名验证失败（版本升级问题）
+
+**现象：**
+```
+错误：签名验证失败
+或
+Unsupported state or unable to authenticate data
+```
+
+**原因：**
+- 2026年5月1日安全加固升级，旧 Token 使用的密钥已变更
+- MCP Server 版本从 ≤3.4.0 升级到 ≥3.5.0 时需要重新授权
+
+**解决方案：**
+1. **手动清理旧配置（推荐）：**
+   ```bash
+   # 清理旧的 token 配置
+   rm -rf ~/.chaimi-keep
+   # 重新运行 MCP Server
+   chaimi-keep-mcp
+   ```
+2. 查看终端显示的新验证码
+3. 在小程序"我的"→"Agent 授权"中输入新验证码
+4. 重新尝试记账
+
+**重要提示：** 此问题仅在安全加固版本升级时出现一次，后续不会再遇到。
+
 > **注意：** 使用 Claude/Cursor 等原生 MCP 客户端的用户，如遇授权问题，请参考 [authentication.md - 2.3 原生 MCP 客户端授权失败](authentication.md#23-原生-mcp-客户端授权失败claudecursor)
 
 ---
@@ -250,7 +288,38 @@ cat /mcp-server-local/references/response-templates.md
 2. 描述问题现象和复现步骤
 3. 提供错误码和时间
 
-### 5.3 紧急处理流程
+### 5.3 升级后 MCP Server 未生效
+
+**现象：**
+```
+更新了柴米AI记账 MCP Server，但功能没有变化
+或
+提示版本已升级，但行为与旧版本一致
+```
+
+**原因：**
+- mcporter daemon 缓存了旧版本
+- 需要重启 daemon 才能加载新版本
+
+**解决方案：**
+```bash
+# 方法1：重启 mcporter daemon
+mcporter restart
+
+# 如果 restart 无效，尝试先 stop 再 start
+mcporter stop
+mcporter start
+
+# 方法2：强制杀掉所有 chaimi-keep 进程（适用于 mcporter 命令不可用的情况）
+pkill -f chaimi-keep
+
+# 然后重新启动
+mcporter start
+```
+
+**重要提示：** 每次升级 MCP Server 后，请务必执行 `mcporter restart` 或 `pkill -f chaimi-keep` 后重启，否则 Agent 会继续使用旧版本。
+
+### 5.4 紧急处理流程
 
 **场景：** 记账数据异常，需要紧急处理