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

package/README.md

@@ -89,6 +89,12 @@ export MCP_PROMPT_URL="你的Prompt服务地址"
 
 ## Changelog
 
+### v3.3.3-beta.7 (2026-04-29)
+- **优化** 回复模板 - 新增"请确认信息"提示，时间移到核心数据区，添加类型变量
+- **优化** 空值处理 - 商家为空时不显示，timeNote 仅异常时显示
+- **修复** save_income - 添加 date 兜底逻辑，不传时间时使用当前时间
+- **修复** save_expense - 优化 timeNote 显示逻辑
+
 ### v3.3.3-beta.6 (2026-04-29)
 - **优化** 品牌统一 - 所有"柴米记账"改为"柴米AI记账"
 - **优化** 工具描述 - 重写三个记账工具描述，包含完整调用示例和格式要求

package/SKILL.md

@@ -154,6 +154,11 @@ chaimi-keep-mcp ⭐ 本Skill
 - ✅ 返回 `_templateHint` 提示使用哪个模板
 - ✅ 返回 `_templateVariables` 提供模板变量数据
 
+**空值处理原则**：
+- 模板变量中，如果某个维度的值为空（null/undefined/空字符串），Agent 应跳过该行不显示
+- 必填字段（金额、类型、商品、分类）必须显示
+- 可选字段（商家、时间、洞察）为空时不显示
+
 ### 7.2 模板文件位置
 
 **主模板文件**: `references/response-templates.md`
@@ -191,6 +196,8 @@ references/
 【第1层：成功标识】✅ 「Agent名称」已帮您记账成功
 【第2层：分隔强调】═══════════════
 【第3层：核心数据】💰 金额：¥xx.xx
+                      📊 类型：支出/收入
+═══════════════
 【第4层：详细信息】
     📦 商品：xxx
     🏷️ 分类：xxx
@@ -211,6 +218,7 @@ references/
 ✅ 「{agentName}」已帮您记账成功
 ═══════════════
 💰 金额：¥{金额}
+📊 类型：{类型}
 ═══════════════
 
 📦 商品：{商品名}
@@ -234,6 +242,7 @@ references/
 | {agentName} | Agent显示名称 | 「你的小可爱」 |
 | {商品名} | 商品或商家名称 | 午餐、麦当劳 |
 | {金额} | 金额（带¥符号） | ¥35.00 |
+| {类型} | 支出/收入类型 | 支出、收入 |
 | {分类} | 消费分类 | 餐饮 |
 | {商家} | 商家名称（可选） | 麦当劳 |
 | {日期时间} | 格式化时间 | 2026-04-24 12:30 |

package/package.json

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

package/references/response-templates.md

@@ -47,6 +47,7 @@ updated: "2026-04-25"
 |:-----|:------|:-----|
 | 成功标识 | ✅ | 操作成功 |
 | 金额 | 💰 | 核心数据 |
+| 类型 | 📊 | 支出/收入 |
 | 商品 | 📦 | 物品 |
 | 分类 | 🏷️ | 标签分类 |
 | 商家 | 🏪 | 商店 |
@@ -54,6 +55,63 @@ updated: "2026-04-25"
 | 祝福 | 🎉 | 庆祝 |
 | 警示 | ⚠️ | 需要关注 |
 
+### 1.4 空值处理规范（重要）
+
+**规则**：详细信息区（第4层）的维度，如果值为空，则不展示该行。
+
+**处理逻辑**：
+```
+渲染前检查每个字段：
+- 如果字段值存在且不为空 → 显示该行
+- 如果字段值为空/null/undefined → 跳过该行
+```
+
+**示例**：
+```markdown
+// 完整数据
+📦 商品：午餐
+🏷️ 分类：餐饮
+🏪 商家：麦当劳
+🕐 时间：2026-04-24 12:30
+
+// 商家为空时
+📦 商品：午餐
+🏷️ 分类：餐饮
+🕐 时间：2026-04-24 12:30
+（🏪 商家：这一行不显示）
+
+// 只有商品和金额时
+📦 商品：午餐
+（其他维度为空，都不显示）
+```
+
+**必填 vs 可选字段**：
+| 字段 | 是否必填 | 为空时处理 |
+|:-----|:---------|:-----------|
+| 商品名 | ✅ 必填 | 必须显示 |
+| 分类 | ✅ 必填 | 必须显示 |
+| 类型 | ✅ 必填 | 必须显示 |
+| 金额 | ✅ 必填 | 必须显示 |
+| 商家 | ❌ 可选 | 为空不显示 |
+| 时间 | ❌ 可选 | 为空不显示 |
+| 洞察 | ❌ 可选 | 为空不显示 |
+
+**规则2：避免重复显示**
+- 如果商品名和分类相同 → 只显示分类行（避免重复）
+- 如果商品名和分类不同 → 两行都显示
+
+**示例**：
+```markdown
+// 用户说"交通 12"（商品名=分类）
+🏷️ 分类：交通
+（📦 商品：交通 不显示，避免重复）
+
+// 用户说"午餐 35"（商品名=午餐，分类=餐饮）
+📦 商品：午餐
+🏷️ 分类：餐饮
+（两行都显示）
+```
+
 ---
 
 ## 二、标准模板
@@ -65,18 +123,20 @@ updated: "2026-04-25"
 ```markdown
 ✅ 「{agentName}」已帮您记账成功
 ═══════════════
+🔴🔴 请确认以下信息是否正确
 💰 金额：¥{金额}
+📊 类型：{类型}
+🕐 时间：{日期时间}
 ═══════════════
 
 📦 商品：{商品名}
 🏷️ 分类：{分类}
 🏪 商家：{商家}
-🕐 时间：{日期时间}
-
-💡 消费洞察：{洞察内容}（可选）
+💡 消费洞察：{洞察内容}
+⏰ 时间说明：{timeNote}
 
 ───────────────
-🎉 {正能量祝福语}！
+🎉 {正能量情绪词}！
   柴米AI记账
   chaimi-keep-mcp v{版本号}
 ───────────────
@@ -87,14 +147,15 @@ updated: "2026-04-25"
 ```markdown
 ✅ 「你的小可爱」已帮您记账成功
 ═══════════════
+🔴🔴 请确认以下信息是否正确
 💰 金额：¥35.00
+📊 类型：支出
+🕐 时间：2026-04-24 12:30
 ═══════════════
 
 📦 商品：午餐
 🏷️ 分类：餐饮
 🏪 商家：麦当劳
-🕐 时间：2026-04-24 12:30
-
 💡 消费洞察：本月餐饮支出占比30%，建议控制
 
 ───────────────

package/server.js

@@ -1071,15 +1071,16 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           result._templateHint = '请使用references/response-templates.md中的2.1标准成功模板渲染回复';
           result._templateVariables = {
             agentName: await getAgentName(),
+            类型: '支出',
             商品名: displayName,
-            商家: displayStore || '',
+            商家: displayStore || null,
             金额: displayAmount,
             分类: result.data?.categoryName || displayCategory,
-            日期: result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN'),
+            日期: result.data?.date ? new Date(result.data.date).toLocaleString('zh-CN') : new Date().toLocaleString('zh-CN'),
             正能量祝福语: friendlyEnding,
             insightsText,
             achievementsText,
-            timeNote  // 【新增】时间说明
+            timeNote: timeNote || null
           };
         }
         break;
@@ -1526,6 +1527,12 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           timeNote = getTimeNote(processedArgs.time_description);
           console.log(`[save_income] 时间描述解析: ${processedArgs.time_description} → ${parsedDate} (${new Date(parsedDate).toLocaleString('zh-CN')})`);
         }
+        // 【新增】兜底：如果既没传 time_description 也没传 date，使用当前时间
+        else if (!processedArgs.date) {
+          processedArgs.date = Date.now();
+          timeNote = '⏰ 时间说明：未指定时间，使用当前时间';
+          console.log(`[save_income] 未传时间参数，使用当前时间: ${processedArgs.date}`);
+        }
         
         // P1: 日期合理性检查
         if (processedArgs.date) {
@@ -1567,13 +1574,14 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           result._templateHint = '请使用references/response-templates.md中的2.1标准成功模板渲染回复';
           result._templateVariables = {
             agentName: await getAgentName(),
+            类型: '收入',
             商品名: displayName,
-            商家: displayStore,
+            商家: displayStore || null,
             金额: displayAmount,
             分类: result.data?.categoryName || displayCategory,
-            日期: result.data?.date ? new Date(result.data.date).toLocaleDateString('zh-CN') : new Date().toLocaleDateString('zh-CN'),
+            日期: result.data?.date ? new Date(result.data.date).toLocaleString('zh-CN') : new Date().toLocaleString('zh-CN'),
             正能量祝福语: '入账顺利！💰',
-            timeNote  // 【新增】时间说明
+            timeNote: timeNote || null
           };
         }
         break;