chaimi-keep-mcp 3.3.3-beta.5 → 3.3.3-beta.6

package/README.md

@@ -23,7 +23,7 @@
 # 1. 安装 MCPorter（WorkBuddy/OpenClaw 等 OpenClaw 架构的 Agent 必需）
 npm install -g mcporter
 
-# 2. 安装柴米记账 MCP
+# 2. 安装柴米AI记账 MCP
 npm install -g chaimi-keep-mcp
 
 # 3. 启动（自动配置 mcporter）
@@ -89,6 +89,10 @@ export MCP_PROMPT_URL="你的Prompt服务地址"
 
 ## Changelog
 
+### v3.3.3-beta.6 (2026-04-29)
+- **优化** 品牌统一 - 所有"柴米记账"改为"柴米AI记账"
+- **优化** 工具描述 - 重写三个记账工具描述，包含完整调用示例和格式要求
+
 ### v3.3.3-beta.4 (2026-04-29)
 - **优化** 收入记账时间解析统一 - save_income 同样使用 time_description，修复 AI 计算时间戳错误
 

package/SKILL.md

@@ -9,7 +9,7 @@ updated: "2026-04-27"
 
 # 柴米AI记账 Skill
 
-> ✨ 柴米记账超级美学版 - 让记账变成享受
+> ✨ 柴米AI记账超级美学版 - 让记账变成享受
 
 ---
 
@@ -67,7 +67,7 @@ updated: "2026-04-27"
 ## 三、文档引用关系
 
 ```
-用户使用柴米记账
+用户使用柴米AI记账
     ↓
 chaimi-keep-mcp ⭐ 本Skill
     ├── 记账成功 → 使用回复模板(见七、回复规范)
@@ -249,7 +249,7 @@ references/
 
 ## 八、记忆口诀
 
-> **柴米记账超美学，五层结构要牢记。**
+> **柴米AI记账超美学，五层结构要牢记。**
 > **成功标识在顶部，金额分隔最醒目。**
 > **商品分类商家时，底部祝福加品牌。**
 > **场景路由先匹配，工具速查再执行。**
@@ -263,7 +263,7 @@ references/
 
 | 错误 | 现象 | 解决方案 | 参考文档 |
 |:-----|:-----|:---------|:---------|
-| **授权失败** | "未找到有效授权" | 执行 `mcporter auth 柴米记账` 重新授权 | troubleshooting.md |
+| **授权失败** | "未找到有效授权" | 执行 `mcporter auth 柴米AI记账` 重新授权 | troubleshooting.md |
 | **分类不明** | "无法识别分类" | 明确说分类："午餐35元餐饮" | api-reference.md |
 | **网络超时** | "请求超时" | 检查网络，稍后重试 | troubleshooting.md |
 

package/bin/cli.js

@@ -161,8 +161,8 @@ function installToAgent(agent) {
       config.mcpServers = {};
     }
 
-    // 检查是否已存在柴米记账配置
-    if (config.mcpServers['柴米记账']) {
+    // 检查是否已存在柴米AI记账配置
+    if (config.mcpServers['柴米AI记账']) {
       return { 
         success: true, 
         action: 'skipped', 
@@ -171,8 +171,8 @@ function installToAgent(agent) {
       };
     }
 
-    // 添加柴米记账配置
-    config.mcpServers['柴米记账'] = JSON.parse(JSON.stringify(DEFAULT_CHAIMI_CONFIG));
+    // 添加柴米AI记账配置
+    config.mcpServers['柴米AI记账'] = JSON.parse(JSON.stringify(DEFAULT_CHAIMI_CONFIG));
 
     // 写入配置
     writeJSON(agent.configPath, config);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chaimi-keep-mcp",
-  "version": "3.3.3-beta.5",
+  "version": "3.3.3-beta.6",
   "description": "柴米AI记账 MCP Server - 支持 Claude、Cursor、OpenClaw、WorkBuddy 等 AI 工具直接记账",
   "main": "server.js",
   "bin": {
@@ -40,7 +40,7 @@
     "AI记账",
     "model-context-protocol"
   ],
-  "author": "柴米记账团队,songyangx@gmail.com",
+  "author": "柴米AI记账团队,songyangx@gmail.com",
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",

package/references/authentication.md

@@ -58,7 +58,7 @@ updated: "2026-04-25"
 
 1. **启动授权流程**
    ```bash
-   mcporter auth 柴米记账
+   mcporter auth 柴米AI记账
    ```
    或
    ```bash
@@ -68,14 +68,14 @@ updated: "2026-04-25"
 2. **查看验证码**
    终端会显示：
    ```
-   🔐 柴米记账授权
+   🔐 柴米AI记账授权
    ═══════════════════════════
    📱 验证码：GGCY-AC84
    ⏰ 有效期：5分钟
    ```
 
 3. **小程序确认**
-   - 打开"柴米记账"小程序
+   - 打开"柴米AI记账"小程序
    - 点击"我的" → "AI 助手绑定"
    - 输入验证码
    - 点击确认
@@ -90,15 +90,15 @@ updated: "2026-04-25"
 
 ```bash
 # 重新授权
-mcporter auth 柴米记账
+mcporter auth 柴米AI记账
 
 # 强制清除缓存后重新授权
-mcporter auth 柴米记账 --reset
+mcporter auth 柴米AI记账 --reset
 ```
 
 **然后：**
 1. 查看终端显示的验证码
-2. 打开"柴米记账"小程序
+2. 打开"柴米AI记账"小程序
 3. 进入"我的" → "AI 助手绑定"
 4. 输入验证码完成授权
 
@@ -124,7 +124,7 @@ mcporter auth 柴米记账 --reset
    ```
    或
    ```bash
-   mcporter auth 柴米记账
+   mcporter auth 柴米AI记账
    ```
 2. 查看终端显示的验证码
 3. 在小程序"我的"→"AI 助手绑定"中输入验证码
@@ -160,7 +160,7 @@ del %USERPROFILE%\.mcporter\oauth-token.json
 cat ~/.mcporter/oauth-token.json
 
 # 或尝试调用工具测试
-mcporter call 柴米记账.get_skill
+mcporter call 柴米AI记账.get_skill
 ```
 
 **Token 文件位置：**
@@ -172,7 +172,7 @@ mcporter call 柴米记账.get_skill
 
 Token 过期后需要重新授权：
 ```bash
-mcporter auth 柴米记账
+mcporter auth 柴米AI记账
 ```
 
 ---
@@ -192,7 +192,7 @@ mcporter auth 柴米记账
 
 ```bash
 # 强制清除缓存后重新授权
-mcporter auth 柴米记账 --reset
+mcporter auth 柴米AI记账 --reset
 ```
 
 **场景：**

package/references/troubleshooting.md

@@ -38,7 +38,7 @@ updated: "2026-04-25"
 - 授权被撤销
 
 **解决方案：**
-1. 执行 `mcporter auth 柴米记账`
+1. 执行 `mcporter auth 柴米AI记账`
 2. 查看终端显示的验证码
 3. 在小程序"我的"→"AI 助手绑定"中输入验证码
 4. 重新尝试记账
@@ -58,10 +58,10 @@ updated: "2026-04-25"
 **解决方案：**
 ```bash
 # 重新授权
-mcporter auth 柴米记账
+mcporter auth 柴米AI记账
 
 # 或强制清除缓存后重新授权
-mcporter auth 柴米记账 --reset
+mcporter auth 柴米AI记账 --reset
 ```
 
 ### 1.3 验证码错误
@@ -76,7 +76,7 @@ mcporter auth 柴米记账 --reset
 - 验证码超过5分钟有效期
 
 **解决方案：**
-1. 重新执行 `mcporter auth 柴米记账` 生成新验证码
+1. 重新执行 `mcporter auth 柴米AI记账` 生成新验证码
 2. 在5分钟内在小程序"我的"→"AI 助手绑定"中输入
 3. 注意区分大小写
 
@@ -218,7 +218,7 @@ mcporter auth 柴米记账 --reset
 
 **解决方案：**
 1. 等待几分钟后重试
-2. 检查柴米记账官方公告
+2. 检查柴米AI记账官方公告
 3. 提交反馈：调用 `submit_feedback`
 
 ---
@@ -269,7 +269,7 @@ cat /mcp-server-local/references/response-templates.md
 chaimi-keep-mcp --version
 
 # 重新授权
-mcporter auth 柴米记账
+mcporter auth 柴米AI记账
 
 # 测试记账连接
 curl -X POST https://cloud1-2gfe5jhjef06b85d-1412172089.ap-shanghai.app.tcloudbase.com/mcpHub-mcp \

package/server.js

@@ -243,7 +243,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     tools: [
       {
         name: 'get_skill',
-        description: '【记账前必须调用】获取柴米记账最新 Skill 定义。每次记账前必须先调用此工具，获取当前版本的完整 Skill 文档，然后严格按照 Skill 定义执行。如果不调用此工具直接记账，操作将被拒绝',
+        description: '【记账前必须调用】获取柴米AI记账最新 Skill 定义。每次记账前必须先调用此工具，获取当前版本的完整 Skill 文档，然后严格按照 Skill 定义执行。如果不调用此工具直接记账，操作将被拒绝',
         inputSchema: {
           type: 'object',
           properties: {
@@ -253,7 +253,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'save_expense',
-        description: '【强制验证Token】保存单商品消费记录。前置要求：先调用 get_skill 和 get_text_parse_prompt。字段列表见 get_text_parse_prompt 返回的模板。',
+        description: '【文本记账-支出】用户提及支出/消费时用此工具。前置：必须先调用get_skill获取规范，再调用get_text_parse_prompt获取Token和解析模板。用法：mcporter call 柴米AI记账.save_expense _requestToken="RT..." name="午餐" amount=35 category="餐饮" rawInput="午餐35元"。注意：上传图片请用save_receipt',
         inputSchema: {
           type: 'object',
           properties: {
@@ -275,7 +275,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'save_receipt',
-        description: '【强制验证Token】【必须上传图片】保存购物小票/发票/收据图片。⚠️ 注意：必须是图片才能使用此工具记账，文字描述请用 save_expense。前置要求：先调用 get_skill 和 get_parse_prompt。items为商品数组，字段列表见 get_parse_prompt 返回的模板.',
+        description: '【图片记账-小票】用户上传小票/发票/收据图片时用此工具。前置：必须先调用get_skill获取规范，再调用get_parse_prompt获取Token和解析模板。用法：mcporter call 柴米AI记账.save_receipt _requestToken="RT..." store="超市" totalAmount=156.5 items="[...]"。注意：文字描述请用save_expense/save_income',
         inputSchema: {
           type: 'object',
           properties: {
@@ -403,7 +403,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'save_income',
-        description: '【强制验证Token】保存收入记录。前置要求：先调用 get_skill 和 get_text_parse_prompt。字段列表见 get_text_parse_prompt 返回的模板.',
+        description: '【文本记账-收入】用户提及收入关键词（工资、红包、转账、退款等）时用此工具。前置：必须先调用get_skill获取规范，再调用get_text_parse_prompt获取Token和解析模板。用法：mcporter call 柴米AI记账.save_income _requestToken="RT..." name="红包" amount=100 category="礼金" rawInput="收红包100元"',
         inputSchema: {
           type: 'object',
           properties: {
@@ -779,10 +779,6 @@ function recordSkillRead() {
 // 工具调用处理
 server.setRequestHandler(CallToolRequestSchema, async (request) => {
   const { name, arguments: args } = request.params;
-  
-  // 【调试】记录实际接收到的参数
-  console.log(`[CallTool] ${name} 接收参数:`, JSON.stringify(args, null, 2));
-  
   const startTime = Date.now();
   const traceId = generateTraceId();
   const osInfo = getOSInfo();
@@ -981,7 +977,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             success: false,
             error: `必填字段缺失：${missingFields.join(', ')}`,
             code: 400,
-            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米记账 --schema 查看完整参数结构',
+            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米AI记账 --schema 查看完整参数结构',
             debug: {
               missing: missingFields,
               received: Object.keys(processedArgs),
@@ -1105,7 +1101,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             success: false,
             error: `必填字段缺失：${missingFields.join(', ')}`,
             code: 400,
-            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米记账 --schema 查看完整参数结构',
+            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米AI记账 --schema 查看完整参数结构',
             debug: {
               missing: missingFields,
               received: Object.keys(processedArgs),
@@ -1173,7 +1169,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             error: `商品数据不完整：${invalidItems.join('; ')}。每个商品必须包含：name, amount, price, quantity, category`,
             code: 400
           };
-          userMessage = `❌ 保存失败\n\n错误：商品数据格式不完整\n\n${invalidItems.join('\n')}\n\n💡 解决方案：\n1. 请更新您的柴米记账 MCP Skill\n2. 确保每个商品包含完整的5个字段：name, amount, price, quantity, category\n3. category 是记账的基本信息，不能为空`;
+          userMessage = `❌ 保存失败\n\n错误：商品数据格式不完整\n\n${invalidItems.join('\n')}\n\n💡 解决方案：\n1. 请更新您的柴米AI记账 MCP Skill\n2. 确保每个商品包含完整的5个字段：name, amount, price, quantity, category\n3. category 是记账的基本信息，不能为空`;
           break;
         }
         
@@ -1500,7 +1496,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             success: false,
             error: `必填字段缺失：${missingFields.join(', ')}`,
             code: 400,
-            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米记账 --schema 查看完整参数结构',
+            hint: '解决方法：1.查看 SKILL.md 中"六.5 如何查看工具参数" 2.运行 mcporter list 柴米AI记账 --schema 查看完整参数结构',
             debug: {
               missing: missingFields,
               received: Object.keys(processedArgs),
@@ -1707,7 +1703,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       content: [
         {
           type: 'text',
-          text: `⚠️ 【注意】Server 只返回原始数据，不返回格式化消息。\n请使用 _templateLocation 指定的模板自行渲染回复。\n\n---\n📦 柴米记账 MCP v${MCP_VERSION}\n\n## 完整数据\n\`\`\`json\n${safeStringify(responseData)}\n\`\`\``,
+          text: `⚠️ 【注意】Server 只返回原始数据，不返回格式化消息。\n请使用 _templateLocation 指定的模板自行渲染回复。\n\n---\n📦 柴米AI记账 MCP v${MCP_VERSION}\n\n## 完整数据\n\`\`\`json\n${safeStringify(responseData)}\n\`\`\``,
         },
       ],
     };