chaimi-keep-mcp 3.3.1-beta.4 → 3.3.1

package/SKILL.md

@@ -263,11 +263,27 @@ references/
 
 | 错误 | 现象 | 解决方案 | 参考文档 |
 |:-----|:-----|:---------|:---------|
-| **授权失败** | "未找到有效授权" | 运行 `./scripts/auth-flow.sh` 重新授权 | troubleshooting.md |
+| **授权失败** | "未找到有效授权" | 执行 `mcporter auth 柴米记账` 重新授权 | troubleshooting.md |
 | **分类不明** | "无法识别分类" | 明确说分类："午餐35元餐饮" | api-reference.md |
 | **网络超时** | "请求超时" | 检查网络，稍后重试 | troubleshooting.md |
 
-**完整故障排除** → 见 references/troubleshooting.md
+---
+
+## 📚 重要参考文档
+
+> **遇到问题？查看详细文档：**
+
+### 🔧 故障排除
+**完整故障排除指南 →** [references/troubleshooting.md](references/troubleshooting.md)
+- 授权失败、Token过期
+- 记账失败、分类错误
+- 网络超时、服务器错误
+
+### 😊 回复模板  
+**详细情绪词库和完整模板 →** [references/response-templates.md](references/response-templates.md)
+- 记账成功回复模板
+- 错误引导模板
+- 情感化表达词库
 
 ---
 

package/package.json

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

package/references/authentication.md

@@ -56,25 +56,31 @@ updated: "2026-04-25"
 
 **步骤：**
 
-1. **生成验证码**
+1. **启动授权流程**
    ```bash
-   ./scripts/auth-flow.sh
+   mcporter auth 柴米记账
    ```
-   输出：
+   或
+   ```bash
+   chaimi-keep-mcp
+   ```
+
+2. **查看验证码**
+   终端会显示：
    ```
-   🔐 柴米AI记账授权
+   🔐 柴米记账授权
    ═══════════════════════════
    📱 验证码：GGCY-AC84
    ⏰ 有效期：5分钟
    ```
 
-2. **小程序确认**
-   - 打开"柴米AI记账"小程序
-   - 点击"我的" → "Agent 授权"
+3. **小程序确认**
+   - 打开"柴米记账"小程序
+   - 点击"我的" → "AI 助手绑定"
    - 输入验证码
    - 点击确认
 
-3. **完成授权**
+4. **完成授权**
    - Agent显示授权成功
    - 开始记账
 
@@ -83,14 +89,66 @@ updated: "2026-04-25"
 **场景：** Token过期、更换设备、安全考虑
 
 ```bash
-# 方式1：直接重新授权
-./scripts/auth-flow.sh
+# 重新授权
+mcporter auth 柴米记账
 
-# 方式2：先撤销再授权
-./scripts/revoke-auth.sh
-./scripts/auth-flow.sh
+# 强制清除缓存后重新授权
+mcporter auth 柴米记账 --reset
 ```
 
+**然后：**
+1. 查看终端显示的验证码
+2. 打开"柴米记账"小程序
+3. 进入"我的" → "AI 助手绑定"
+4. 输入验证码完成授权
+
+### 2.3 原生 MCP 客户端授权失败（Claude/Cursor）
+
+**适用场景：**
+- Claude Desktop
+- Cursor
+- Windsurf
+- 其他原生支持 MCP 的客户端
+
+**现象：**
+```
+错误：未找到有效授权信息
+或
+错误：Token 已过期
+```
+
+**解决方案（方式1 - 命令行）：**
+1. 打开终端执行：
+   ```bash
+   chaimi-keep-mcp
+   ```
+   或
+   ```bash
+   mcporter auth 柴米记账
+   ```
+2. 查看终端显示的验证码
+3. 在小程序"我的"→"AI 助手绑定"中输入验证码
+4. 返回 Claude/Cursor 重新尝试记账
+
+**解决方案（方式2 - 删除 Token 文件）：**
+
+**macOS/Linux:**
+```bash
+rm ~/.mcporter/oauth-token.json
+```
+
+**Windows:**
+```cmd
+del %USERPROFILE%\.mcporter\oauth-token.json
+```
+
+然后完全退出并重新启动 Claude/Cursor
+
+**解决方案（方式3 - 重启客户端）：**
+1. 完全退出 Claude/Cursor
+2. 重新启动
+3. 尝试记账，会触发重新授权流程
+
 ---
 
 ## 三、Token管理
@@ -98,19 +156,24 @@ updated: "2026-04-25"
 ### 3.1 检查Token状态
 
 ```bash
-./scripts/check-auth.sh
+# 查看 Token 文件是否存在
+cat ~/.mcporter/oauth-token.json
+
+# 或尝试调用工具测试
+mcporter call 柴米记账.get_skill
 ```
 
-**输出：**
+**Token 文件位置：**
 ```
-✅ 授权状态：有效
-📅 Token有效期：还剩 23 小时
-🔒 安全等级：高
+~/.mcporter/oauth-token.json
 ```
 
 ### 3.2 Token刷新
 
-Token将在过期前自动刷新，无需手动操作。
+Token 过期后需要重新授权：
+```bash
+mcporter auth 柴米记账
+```
 
 ---
 
@@ -128,7 +191,8 @@ Token将在过期前自动刷新，无需手动操作。
 ### 4.2 撤销授权
 
 ```bash
-./scripts/revoke-auth.sh
+# 强制清除缓存后重新授权
+mcporter auth 柴米记账 --reset
 ```
 
 **场景：**

package/references/troubleshooting.md

@@ -12,6 +12,9 @@ updated: "2026-04-25"
 ## 目录
 
 - [一、授权问题](#一授权问题)
+  - [1.1 未找到有效授权](#11-未找到有效授权)
+  - [1.2 授权过期](#12-授权过期)
+  - [1.3 验证码错误](#13-验证码错误)
 - [二、记账失败](#二记账失败)
 - [三、查询问题](#三查询问题)
 - [四、网络与连接](#四网络与连接)
@@ -35,9 +38,10 @@ updated: "2026-04-25"
 - 授权被撤销
 
 **解决方案：**
-1. 运行 `./scripts/auth-flow.sh` 生成新验证码
-2. 在小程序中完成授权流程
-3. 重新尝试记账
+1. 执行 `mcporter auth 柴米记账`
+2. 查看终端显示的验证码
+3. 在小程序"我的"→"AI 助手绑定"中输入验证码
+4. 重新尝试记账
 
 ### 1.2 授权过期
 
@@ -52,9 +56,13 @@ updated: "2026-04-25"
 - 超过有效期未使用
 
 **解决方案：**
-1. 运行 `./scripts/check-auth.sh` 检查状态
-2. 如已过期，运行 `./scripts/auth-flow.sh` 重新授权
-3. 或使用 `./scripts/revoke-auth.sh` 清除后重新授权
+```bash
+# 重新授权
+mcporter auth 柴米记账
+
+# 或强制清除缓存后重新授权
+mcporter auth 柴米记账 --reset
+```
 
 ### 1.3 验证码错误
 
@@ -68,10 +76,12 @@ updated: "2026-04-25"
 - 验证码超过5分钟有效期
 
 **解决方案：**
-1. 重新生成验证码：`./scripts/auth-flow.sh`
-2. 在5分钟内在小程序中输入
+1. 重新执行 `mcporter auth 柴米记账` 生成新验证码
+2. 在5分钟内在小程序"我的"→"AI 助手绑定"中输入
 3. 注意区分大小写
 
+> **注意：** 使用 Claude/Cursor 等原生 MCP 客户端的用户，如遇授权问题，请参考 [authentication.md - 2.3 原生 MCP 客户端授权失败](authentication.md#23-原生-mcp-客户端授权失败claudecursor)
+
 ---
 
 ## 二、记账失败
@@ -188,7 +198,10 @@ updated: "2026-04-25"
 1. 检查网络连接
 2. 稍后重试
 3. 减少查询时间范围
-4. 使用 `./scripts/verify-setup.sh` 测试连接
+4. 测试连接：
+   ```bash
+   chaimi-keep-mcp --version
+   ```
 
 ### 4.2 服务器错误
 
@@ -252,14 +265,15 @@ cat /mcp-server-local/references/response-templates.md
 ## 快速诊断命令
 
 ```bash
-# 检查授权状态
-./scripts/check-auth.sh
+# 检查版本和安装状态
+chaimi-keep-mcp --version
 
-# 验证安装完整性
-./scripts/verify-setup.sh
+# 重新授权
+mcporter auth 柴米记账
 
 # 测试记账连接
-curl -X POST $MCP_URL -H "Content-Type: application/json" \
+curl -X POST https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpHub-mcp \
+  -H "Content-Type: application/json" \
   -d '{"action":"get_skill"}'
 ```