chaimi-bookkeeping-mcp 3.1.1 → 3.1.2

package/README.md

@@ -1,12 +1,12 @@
-# 柴米记账 MCP Server
+# 柴米AI记账 MCP Server
 
-通过 OpenClaw、WorkBuddy 等 小龙虾AI 工具直接记账，理论支持 MCP 协议的 Claude，还未有测试。
+通过 OpenClaw、WorkBuddy 等 AI 工具直接记账，支持 MCP 协议的 Claude、Cursor 等。
 
 ## 系统要求
 
 - Node.js >= 18.0.0
 - macOS / Windows / Linux
-- 微信（已安装"柴米记账"小程序）
+- 微信（已安装"柴米AI记账"小程序）
 
 ## 快速安装
 
@@ -43,26 +43,23 @@ MCP Server 会显示：
 
 ```
 ╔════════════════════════════════════════════════════════╗
-║  柴米记账 MCP Server - 首次使用需要授权                ║
+║  柴米AI记账 MCP Server - 首次使用需要授权              ║
 ╠════════════════════════════════════════════════════════╣
 ║                                                        ║
-║  请在微信中打开以下链接完成授权：                      ║
+║  验证码：ABCD-EFGH                                     ║
 ║                                                        ║
-║  https://mcp.chaihuo.com/auth?code=ABCD-EFGH          ║
+║  请在"柴米AI记账"小程序中完成授权：                    ║
 ║                                                        ║
-║  或手动输入验证码：ABCD-EFGH                           ║
-║                                                        ║
-║  1. 打开"柴米记账"小程序                               ║
+║  1. 打开"柴米AI记账"小程序                             ║
 ║  2. 点击"我的" → "🤖 Agent 授权"                      ║
-║  3. 输入上述验证码                                     ║
+║  3. 输入验证码：ABCD-EFGH                              ║
 ║                                                        ║
 ╚════════════════════════════════════════════════════════╝
 ```
 
 ### 3. 小程序授权
 
-- **PC 端用户**：点击链接自动唤起微信授权
-- **手机端用户**：打开小程序 → 我的 → Agent 授权 → 输入验证码
+打开"柴米AI记账"小程序 → 点击"我的" → "🤖 Agent 授权" → 输入上述验证码
 
 ### 4. 完成
 
@@ -141,6 +138,50 @@ AI 会自动调用 `save_income` 工具记录收入。
 
 ## 更新日志
 
+### v3.1.2 (2026-04-11)
+- **修复** 启动界面版本号显示问题
+- **修复** 首次安装验证码显示问题
+- **优化** 内部测试流程
+
+### v3.1.0 (2026-04-11)
+- **移除** Python 版本 (`server.py`)，统一使用 Node.js 版本
+- **安全** 删除包含敏感 token 的 `config.yaml`，新增 `config.example.yaml` 模板
+- **安全** 更新 `.gitignore` 和 `.npmignore`，排除敏感文件
+- **优化** 项目结构，清理不必要的文件
+
+### v3.0.3 (2026-04-10)
+- **新增** `get_parse_prompt` 工具，首次实现将云函数 Prompt 模板完整返回给 Agent
+- **优化** `mcpHub`：新增 `receiptNo` 自动生成逻辑（强制生成唯一 ID）
+- **优化** `mcpHub`：优化 `actualAmount` 计算 fallback 逻辑
+- **优化** `mcpPrompt`：升级 Prompt 版本到 2.0.2，强化支付金额字段提取
+- **优化** `mcpPrompt`：优化 `date` 字段描述，要求 ISO 8601 完整时间格式
+
+### v3.0.0 (2026-04-09)
+- **新增** `submit_feedback` 工具，支持用户提交反馈
+- **新增** 反馈双通道：数据库保存 + 小程序客服消息推送
+- **优化** 小票记账功能，完善字段提取逻辑
+
+### v2.3.4 (2026-04-08)
+- **简化** `save_expense` 工具，只保留 `name` 和 `amount` 为必填参数
+- **优化** 其他参数使用默认值，简化 Agent 调用
+
+### v2.3.3 (2026-04-08)
+- **修正** 版本号统一为 v2.3.3（包含 v2.3.2 的所有修复）
+
+### v2.3.2 (2026-04-08)
+- **修复** `server.js` 中 `CURRENT_VERSION` 未定义错误，统一使用 `MCP_VERSION`
+- **修复** 所有工具的 `userMessage` 添加默认值，防止显示 `undefined`
+
+### v2.3.1 (2026-04-08)
+- **修复** `bin/cli.js` 版本号显示问题，改为动态读取 package.json
+- **优化** OAuth 授权流程，轮询间隔缩短为 2 秒
+
+### v2.3.0 (2026-04-08)
+- **修复** `save_receipt` 的 `items` 参数解析 bug，支持 JSON 字符串自动转换
+- **优化** `source` 字段规范：`save_expense`→`mcp_txt_expense`、`save_income`→`mcp_txt_income`、`save_receipt`→`mcp_receipt`
+- **新增** `mcp_version` 字段追踪，便于版本监控
+- **注释** `quick_book` 工具（暂时下线，待优化后重新开放）
+
 ### v2.2.0 (2026-04-05)
 - **新增收入记账功能** (`save_income`)
 - 支持工资、奖金、红包、投资收益等收入类型

package/bin/cli.js

@@ -10,6 +10,10 @@ const fs = require('fs');
 const os = require('os');
 const { spawn } = require('child_process');
 
+// 读取 package.json 获取版本号
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'));
+const CURRENT_VERSION = packageJson.version;
+
 // 获取 server.js 的绝对路径
 const serverPath = path.join(__dirname, '..', 'server.js');
 
@@ -183,7 +187,7 @@ function configureAllAgents() {
 function showWelcome() {
   console.log('╔════════════════════════════════════════════════════════╗');
   console.log('║                                                        ║');
-  console.log('║           柴米记账 MCP Server v2.1.0                   ║');
+  console.log(`║           柴米记账 MCP Server v${CURRENT_VERSION}                   ║`);
   console.log('║                                                        ║');
   console.log('║   支持: OpenClaw | WorkBuddy | Claude | Cursor        ║');
   console.log('║                                                        ║');

package/package.json

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

package/server.js

@@ -50,9 +50,28 @@ function initOAuthManager() {
   oauthManager = new OAuthManager({
     mcpOAuthUrl: MCP_OAUTH_URL,
     tokenStorage: tokenStorage,
+    // ⚠️ 重要：此回调在用户首次使用时显示验证码，切勿删除或清空！
+    // 如果删除，用户将无法看到授权验证码，导致无法使用 MCP Server
+    // 参见 FUNCTION_REGISTRY.md 中的 "验证码显示" 功能
     onQrCode: (qrData) => {
+      // 输出授权信息到控制台（用户可见）
+      console.log('\n' + '='.repeat(60));
+      console.log('  柴米AI记账 MCP Server - 首次使用需要授权');
+      console.log('='.repeat(60));
+      console.log('');
+      console.log(`  验证码：${qrData.userCode}`);
+      console.log('');
+      console.log('  请在"柴米AI记账"小程序中完成授权：');
+      console.log('');
+      console.log('  1. 打开"柴米AI记账"小程序');
+      console.log('  2. 点击"我的" → "🤖 Agent 授权"');
+      console.log(`  3. 输入验证码：${qrData.userCode}`);
+      console.log('');
+      console.log('='.repeat(60) + '\n');
     },
+    // ⚠️ 重要：此回调在授权成功后通知用户，切勿删除！
     onTokenReady: (token) => {
+      console.log('✅ 授权成功！Token 已保存。');
     }
   });
 
@@ -112,7 +131,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             receiptNo: { type: 'string', description: '小票编号' },
             items: {
               type: 'array',
-              description: '商品列表（必须是数组格式，如：[{"name":"苹果","amount":5.5,"price":5.5,"quantity":1}]，不要传JSON字符串）',
+              description: '商品列表，支持两种格式：1) 直接数组：[{"name":"苹果","amount":5.5}]  2) JSON字符串："[{\"name\":\"苹果\",\"amount\":5.5}]"（部分Agent如Claude Code可能传递JSON字符串）',
               items: {
                 type: 'object',
                 properties: {

package/SKILL.md

@@ -1,134 +0,0 @@
-# 柴米记账 Skill
-
-## 简介
-
-柴米记账是一款智能记账工具，支持通过自然语言快速记录消费。本 Skill 让 WorkBuddy 能够自动识别记账意图，调用 MCP 工具完成记账。
-
-## 安装
-
-本 Skill 文件随 MCP Server 一起提供，位于 `mcp-server-local/SKILL.md`。
-
-将本 Skill 复制到 WorkBuddy 的 skills 目录：
-
-```bash
-# 全局安装（推荐）
-mkdir -p ~/.workbuddy/skills/柴米记账/
-cp /path/to/caihuo_record_list/mcp-server-local/SKILL.md ~/.workbuddy/skills/柴米记账/
-
-# 或项目级安装
-mkdir -p ./.workbuddy/skills/柴米记账/
-cp /path/to/caihuo_record_list/mcp-server-local/SKILL.md ./.workbuddy/skills/柴米记账/
-```
-
-## 触发条件
-
-当用户输入包含以下关键词时，自动触发本 Skill：
-
-- 记账、花了、买了、消费、支出、付款
-- 吃饭、购物、交通、娱乐、医疗、教育
-- 元、块、钱、¥、$
-- 超市、餐厅、商场、医院、学校
-
-## 操作规范
-
-### 1. 单商品记账
-
-**用户示例：**
-- "中午吃了碗面，25元"
-- "买了杯咖啡35"
-- "打车花了50块"
-
-**调用工具：** `chaihuo.save_expense`
-
-**参数提取：**
-| 参数 | 提取规则 | 示例 |
-|------|---------|------|
-| name | 商品/服务名称 | "牛肉面"、"咖啡"、"打车" |
-| amount | 金额数字 | 25、35、50 |
-| category | 智能分类（见下表） | "餐饮"、"交通" |
-| store | 商家名称（如有） | "星巴克"、"滴滴" |
-
-**智能分类规则：**
-| 关键词 | 分类 |
-|--------|------|
-| 吃、饭、面、咖啡、奶茶、餐厅 | 餐饮 |
-| 打车、滴滴、地铁、公交、加油 | 交通 |
-| 超市、买菜、水果、零食 | 食品 |
-| 衣服、鞋、包、化妆品、购物 | 购物 |
-| 电影、游戏、KTV、娱乐 | 娱乐 |
-| 药、医院、看病、体检 | 医疗 |
-| 书、课程、学费、培训 | 教育 |
-| 其他 | 其他 |
-
-### 2. 小票记账
-
-**用户示例：**
-- "在沃尔玛买了牛奶30，面包15，鸡蛋20"
-- "晚餐：小炒肉45，米饭5，可乐8"
-
-**调用工具：** `chaihuo.save_receipt`
-
-**参数提取：**
-| 参数 | 提取规则 |
-|------|---------|
-| store | 商家名称（第一句提到） |
-| items | 商品列表，每个包含 name 和 amount |
-| totalAmount | 自动计算总和 |
-
-**商品解析示例：**
-用户："在沃尔玛买了牛奶30，面包15"
-→ items: [
-  { name: "牛奶", amount: 30 },
-  { name: "面包", amount: 15 }
-]
-→ totalAmount: 45
-
-## 回复格式
-
-**成功时，只输出：**
-```
-✅ [商品名] ¥[金额] 已录入柴米记账
-```
-
-**示例：**
-- ✅ 牛肉面 ¥25 已录入柴米记账
-- ✅ 咖啡 ¥35 已录入柴米记账
-- ✅ 小票（3件商品）¥58 已录入柴米记账
-
-**失败时，输出：**
-```
-❌ 记账失败：[错误原因]
-```
-
-## 注意事项
-
-1. **不要暴露技术细节**：不显示 MCP 工具名、参数、JSON 等
-2. **自动分类**：根据关键词智能判断分类，不确定时用"其他"
-3. **金额识别**：支持"元"、"块"、"¥"等格式
-4. **多商品**：一句话多个商品时，优先使用小票记账
-
-## 配置要求
-
-需要提前配置柴米记账 MCP Server：
-
-```json
-{
-  "mcpServers": {
-    "chaihuo": {
-      "command": "node",
-      "args": ["/path/to/caihuo_record_list/mcp-server-local/server.js"],
-      "env": {
-        "MCP_HUB_URL": "https://xxx.ap-shanghai.app.tcloudbase.com/mcpHub-mcp",
-        "MCP_TOKEN": "your-token",
-        "MCP_OPENID": "your-openid"
-      }
-    }
-  }
-}
-```
-
-Token 获取方式：微信小程序「柴米记账」→ 我的 → 桌面端记账 → 生成 Token
-
-## 版本
-
-- v1.0.0 - 支持单商品记账和小票记账