chaimi-keep-mcp 3.1.33-beta.7 → 3.1.34

package/README.md

@@ -141,6 +141,12 @@ AI 会自动调用 `save_income` 工具记录收入。
 
 ## 更新日志
 
+### v3.1.34 (2026-04-14)
+- **修复** 日期/时区处理：纯日期格式默认使用12:00，不再使用当前服务器时间
+- **优化** SKILL.md 精简：从385行精简到176行，聚焦Agent必须执行的行为规范
+- **新增** 时间语义解析规则：明确"早餐"→08:00、"午餐"→12:00等映射关系
+- **优化** 云函数日期存储：统一使用ISO 8601字符串格式，避免时区转换问题
+
 ### v3.1.23 (2026-04-13)
 - **安全** 新增请求签名验证，防止 Agent 直接 curl 访问云函数
 - **安全** Token 加密存储（AES-256-CBC），绑定机器标识

package/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: chaimi-bookkeeping
+name: chaimi-keep-mcp
 description: >-
   柴米AI记账 — 微信小程序记账工具，支持 AI Agent 直接记账。
   TRIGGER: 用户提及"记账/记录/保存"并涉及金额或商品信息。
@@ -25,7 +25,6 @@ argument-hint: "[记账内容]"
 **如果不执行此步骤：**
 - ❌ 直接调用 `save_expense` / `save_receipt` / `save_income` 会被拒绝
 - ❌ 返回错误：`SKILL_NOT_READ`
-- ❌ 错误提示："记账失败：未读取最新 Skill 定义"
 
 **正确流程：**
 ```
@@ -33,16 +32,8 @@ argument-hint: "[记账内容]"
 2. 【必须】调用 get_skill 工具
 3. 【必须】仔细阅读返回的 Skill 文档
 4. 【必须】按照 Skill 文档执行记账
-5. 【文字记账】调用 get_text_parse_prompt 获取解析 Prompt
-6. 【文字记账】使用 Prompt 解析用户输入，获取时间、分类等信息
-7. 调用 save_expense 等工具（传入解析后的完整信息）
 ```
 
-**为什么强制要求？**
-- Skill 文档会频繁更新
-- Agent 的"记忆"不可靠，会过时
-- 必须每次都读取最新规范，避免凭记忆操作导致错误
-
 ---
 
 ## 触发规则
@@ -51,54 +42,24 @@ argument-hint: "[记账内容]"
 
 1. 用户明确提及以下关键词之一：
    - "记账"、"记一笔"、"记录"
-   - "保存"（结合上下文判断为记账场景）
 
 2. 包含以下信息之一：
    - 金额数字（如：35、100.5）
-   - 商品/服务名称（如：午餐、咖啡、打车）
+   - 商品/服务名称（如：午餐、咖啡）
    - 小票/发票信息
 
 ### 禁止触发
 
 - 明确使用其他记账工具时（如："用支付宝记账"）
-- 金额信息不明确且无法推断（如："记点东西"）
-
-### 上下文延续
-
-当前对话已在进行记账操作时，后续消息无需再次提及"记账"即可触发。
 
 ---
 
 ## 安全约束（最高优先级）
 
-### 1. 禁止直接访问
-
 - **禁止**直接使用 curl/http 访问云函数端点
-- **禁止**暴露 `MCP_HUB_URL`、`MCP_OAUTH_URL`、`MCP_PROMPT_URL` 给 Agent
-- 所有请求**必须**通过 MCP Server 中转
-
-### 2. Token 保护
-
 - **禁止**读取或输出 `~/.mcporter/oauth-token.json` 内容
-- Token 仅用于内部 HTTP 请求，不向用户展示
-- **禁止**将 Token 作为参数传递给其他命令
-
-### 3. 配置保护
-
 - **禁止**主动设置 `MCP_OAUTH_URL`、`MCP_HUB_URL`、`MCP_PROMPT_URL` 环境变量
-- URL 由 MCP Server 内部管理，对用户不可见
-
-### 4. 金额确认
-
 - 单笔金额 **> 1000 元** 时必须用户确认
-- 批量记账（**> 10 笔**）时必须用户确认
-- 涉及退款、负数金额时必须用户确认
-
-### 5. 认证流程
-
-- **必须**使用内置授权流程完成 Device Flow 授权
-- **禁止**直接调用 `chaimi-keep-mcp` 的授权子命令
-- **禁止**绕过授权流程直接操作
 
 ---
 
@@ -106,130 +67,56 @@ argument-hint: "[记账内容]"
 
 每次触发时按顺序执行：
 
-### 1. 安装检查
-
-检查 MCP Server 是否已安装：
-```bash
-command -v chaimi-keep-mcp
-```
-
-**未安装**：引导用户执行安装
-```bash
-npm install -g chaimi-keep-mcp
-```
-
-### 2. 授权检查
-
-检查是否已完成授权：
-```bash
-test -f ~/.mcporter/oauth-token.json
-```
-
-**未授权**：引导完成 Device Flow 授权流程
-
-### 3. Token 有效性检查
-
-检查 Token 文件是否存在且未过期。
-
-**Token 无效特征**：
-- 文件不存在
-- 已过期（超过30天）
-- 调用云函数返回 401/403 错误
-
-**无效**：引导重新授权
+1. **安装检查**：`command -v chaimi-keep-mcp`
+2. **授权检查**：`test -f ~/.mcporter/oauth-token.json`
+3. **Token 有效性检查**：调用云函数验证
 
 ---
 
 ## 工具调用
 
-### 获取工具列表
+### 文字记账（save_expense）
 
-Agent 通过 MCP 协议自动获取工具列表，无需手动查询。
+**流程：**
+1. 调用 `get_text_parse_prompt()` 获取解析 Prompt
+2. 使用 Prompt 解析用户输入，获取 JSON 结果
+3. 调用 `save_expense` 保存（传入所有解析结果字段）
 
-### 小票记账特殊要求
+**Agent 必须执行的时间语义解析：**
+| 用户说法 | 解析为 |
+|---------|--------|
+| "早餐"、"早饭" | 08:00 |
+| "午餐"、"午饭" | 12:00 |
+| "晚餐"、"晚饭" | 18:00 或 19:00 |
+| "夜宵" | 23:00 |
+| "早上" | 09:00 |
+| "下午" | 15:00 |
+| "晚上" | 20:00 |
+| 具体时间（如"11点半"） | 使用具体时间 |
+| 无时间信息 | 使用当前时间 |
 
-⚠️ **强制流程**：保存小票时必须按以下顺序执行：
-1. 调用 `get_parse_prompt` 获取 prompt 模板
-2. 使用 prompt 模板调用大模型解析小票图片
-3. **调用 `save_receipt` 前，必须完成字段核对清单（见下文）**
-4. 调用 `save_receipt` 保存解析结果
+**重要：** 最终传入的 `date` 参数必须包含时间部分，格式：`2026-04-14T12:00:00+08:00`
 
----
-
-### 📝 简单记账字段核对清单（save_expense）
-
-**调用 `save_expense` 前必须执行：**
-
-#### 第 1 步：调用 `get_text_parse_prompt` 获取解析 Prompt
-
-**文字记账（如"午餐 24块"）必须先调用此工具！**
-
-```
-1. 调用 get_text_parse_prompt()
-2. 获取返回的 prompt、当前日期、当前时间
-3. 将 prompt 作为 system message，用户输入作为 user message
-4. 调用大模型解析，获取 JSON 结果
-```
-
-**解析结果示例：**
-```json
-{
-  "name": "午餐",
-  "amount": 24,
-  "category": "餐饮",
-  "datetime": "2026-04-14T12:30:00+08:00",
-  "transactionType": "expense"
-}
-```
-
-#### 第 2 步：调用 `save_expense` 保存
-
-| 字段 | 是否必须 | 说明 |
-|------|----------|------|
-| `name` | ✅ | 商品/服务名称（从解析结果获取）|
-| `amount` | ✅ | 金额（正数，从解析结果获取）|
-| `category` | ✅ **新增** | 分类（从解析结果获取）|
-| `date` | ✅ | 日期时间（从解析结果的 `datetime` 获取）|
-| `store` | 可选 | 商家名称 |
-| `note` | 可选 | 备注 |
-
-**⚠️ 重要**：
-- **文字记账必须先调用 `get_text_parse_prompt` 解析！**
-- **date 必须带时区**（如：`2026-04-14T12:30:00+08:00`）
-- 解析 Prompt 会自动处理时间推断（"午餐"→12:30，"晚餐"→19:00）
+**必填字段：** `name`、`amount`、`category`、`date`
 
 ---
 
-### 🚨 小票字段说明（save_receipt）
-
-**从 prompt 解析结果中提取的所有字段，必须全部传递给 `save_receipt`**：
-
-| 字段 | 是否必须 | 常见遗漏 | 说明 |
-|------|----------|----------|------|
-| `store` | ✅ | 否 | 商家名称 |
-| `date` | ✅ **高频遗漏** | **是** | ISO 8601 格式，**必须带时区**，如：`2026-01-08T11:42:27+08:00` |
-| `totalAmount` | ✅ | 否 | 商品原价总和 |
-| `actualAmount` | ✅ **高频遗漏** | **是** | 实付金额（优惠后）|
-| `originalAmount` | ✅ **高频遗漏** | **是** | 原价（优惠前）|
-| `discountAmount` | ✅ **高频遗漏** | **是** | 优惠金额 |
-| `paymentMethod` | 可选 | 是 | 如：支付宝支付、微信支付 |
-| `items` | ✅ | 否 | 商品数组，每个必须有完整字段 |
-
-**items 数组中每个商品必须包含：**
-
-| 字段 | 是否必须 | 说明 |
-|------|----------|------|
-| `name` | ✅ | 商品名称 |
-| `amount` | ✅ | 金额（= price × quantity）|
-| `price` | ✅ | 单价 |
-| `quantity` | ✅ | 数量 |
-| `category` | ✅ **新增** | 分类（如：食品、日用品）|
-
-**⚠️ 重要**：
-- 缺少必填字段会导致保存失败。服务器会自动校验数据完整性和准确性。
-- **date 必须带时区**（如 `+08:00` 表示北京时间）
-- **如果不确定具体时间，不要传 date 参数**，系统会自动使用当前时间
-- **禁止传默认时间**（如 `08:00:00`），这会导致时间记录错误
+### 小票记账（save_receipt）
+
+**流程：**
+1. 调用 `get_parse_prompt` 获取 prompt 模板
+2. 使用 prompt 调用大模型解析小票图片
+3. **字段核对**：确保所有解析结果字段都传给 `save_receipt`
+4. 调用 `save_receipt` 保存
+
+**必填字段：**
+- `store`：商家名称
+- `date`：ISO 8601 格式，必须带时区
+- `totalAmount`：商品原价总和
+- `actualAmount`：实付金额（优惠后）
+- `originalAmount`：原价（优惠前）
+- `discountAmount`：优惠金额
+- `items`：商品数组，每个商品必须有 `name`、`amount`、`price`、`quantity`、`category`
 
 ---
 
@@ -237,58 +124,24 @@ Agent 通过 MCP 协议自动获取工具列表，无需手动查询。
 
 | 风险等级 | 场景 | 策略 |
 |----------|------|------|
-| **高（必须确认）** | 金额 > 1000元、批量 > 10笔、退款/负数 | 列出详情，等待用户确认 |
-| **中（信息模糊时确认）** | 分类不明确、商家名称模糊 | 确认后执行 |
-| **低（直接执行）** | 信息完整明确 | 直接执行 |
+| **高** | 金额 > 1000元、批量 > 10笔、退款/负数 | 必须确认 |
+| **中** | 分类不明确、商家名称模糊 | 确认后执行 |
+| **低** | 信息完整明确 | 直接执行 |
 
 ---
 
 ## 防重复录入（Agent 本地实现）
 
-**目标**：提醒用户可能的重复录入，但不阻止保存
-
-### 实现方式
-
-Agent 维护本地记账记录日志（内存或本地文件）：
-
-```javascript
-// 记录格式
-{
-  store: "商家名称",
-  date: "2026-01-08",  // 只记录到日期
-  actualAmount: 25.88,
-  timestamp: 1704694947000  // 记账时间戳
-}
-```
-
-### 重复检测规则
-
+**规则：**
 - **时间窗口**：24 小时内
 - **匹配条件**：`store` + `date(到天)` + `actualAmount` 相同
-- **处理方式**：
-  1. 发现重复时，提醒用户："⚠️ 24 小时内已有相似记录（华润万家春风店 25.88元），确认要重复录入吗？"
-  2. 用户确认后，继续调用 `save_receipt`
-  3. 用户取消，停止操作
-
-### 代码示例
-
-```javascript
-// 检查是否重复
-function isDuplicate(store, date, actualAmount) {
-  const fingerprint = `${store}_${date.substring(0,10)}_${actualAmount}`;
-  const recentRecord = recentLogs.find(log => {
-    const timeDiff = Date.now() - log.timestamp;
-    return log.fingerprint === fingerprint && timeDiff < 24 * 60 * 60 * 1000;
-  });
-  return recentRecord;
-}
-```
+- **处理方式**：提醒用户，用户确认后继续
 
 ---
 
 ## 回复规范（必须严格遵守）
 
-记账成功后，回复内容必须包含以下格式：
+记账成功后，回复格式：
 
 ```
 ✅ 【商品名/店名】¥【金额】 已录入柴米AI记账。
@@ -296,65 +149,15 @@ function isDuplicate(store, date, actualAmount) {
 [自定义其他内容]
 
 MCP Server: v【版本号】
-【友好正能量结束语】
+【友好结束语】
 ```
 
-### 友好结束语参考
-
-| 分类 | 结束语 |
-|------|--------|
-| 餐饮类 | 用餐愉快！🍚 / 下午茶快乐！🧋 / 好好吃饭哦~ |
-| 交通类 | 出行顺利！🚗 |
-| 购物类 | 买得开心！🛍️ |
-| 收入类 | 入账顺利！💰 |
-| 通用 | 记账完成！继续保持~ / 理财小能手！✨ |
-
-### 示例
-
-**用户：** 记一笔午餐 35元
-
-**Agent 回复：**
-```
-✅ 午餐¥35 已录入柴米AI记账。
-
-今天也要好好吃饭哦~
-
-MCP Server: v3.1.23
-```
-
----
-
-## 使用示例
-
-### 示例1：简单记账
-
-**用户：** 记一笔午餐 35元
-
-**Agent：**
-1. 触发 Skill
-2. 前置检查通过
-3. 调用 `save_expense(name="午餐", amount=35, category="餐饮")`
-4. 返回结果：✅ 已记录：午餐 35元
-
-### 示例2：小票记账
-
-**用户：** 保存小票，沃尔玛，买了苹果5元、香蕉3元
-
-**Agent：**
-1. 触发 Skill
-2. 前置检查通过
-3. 调用 `save_receipt(store="沃尔玛", items=[...], totalAmount=8)`
-4. 返回结果：✅ 已保存小票：沃尔玛，共8元
-
-### 示例3：首次使用（未授权）
-
-**用户：** 记一笔咖啡 25元
-
-**Agent：**
-1. 触发 Skill
-2. 前置检查发现未授权
-3. 引导用户完成 Device Flow 授权
-4. 授权完成后执行记账
+**友好结束语参考：**
+- 餐饮类：用餐愉快！🍚 / 好好吃饭哦~
+- 交通类：出行顺利！🚗
+- 购物类：买得开心！🛍️
+- 收入类：入账顺利！💰
+- 通用：记账完成！继续保持~ ✨
 
 ---
 
@@ -365,7 +168,6 @@ MCP Server: v3.1.23
 | 未安装 | 引导安装：`npm install -g chaimi-keep-mcp` |
 | 未授权 | 引导完成 Device Flow 授权 |
 | Token 过期 | 引导重新授权 |
-| 网络错误 | 提示用户检查网络，稍后重试 |
 | 参数错误 | 提示用户补充必要信息 |
 
 ---

package/package.json

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

package/server.js

@@ -139,7 +139,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           properties: {
             name: { type: 'string', description: '商品名称（必填）' },
             amount: { type: 'number', description: '金额（必填）' },
-            category: { type: 'string', description: '分类（可选，如：餐饮、食品、交通）' },
+            category: { type: 'string', description: '分类（必填，如：餐饮、食品、交通）' },
             store: { type: 'string', description: '商家名称（可选）' },
             date: { type: 'string', description: '消费时间（ISO格式）（可选）' },
             note: { type: 'string', description: '备注（可选）' },
@@ -158,11 +158,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           type: 'object',
           properties: {
             store: { type: 'string', description: '商家名称（必填）' },
-            date: { type: 'string', description: '消费时间（ISO 8601 格式，必须包含日期和时间，如：2026-04-10T13:06:21）' },
-            totalAmount: { type: 'number', description: '总金额（所有商品amount之和）' },
-            originalAmount: { type: 'number', description: '应付金额（优惠前）' },
-            discountAmount: { type: 'number', description: '优惠金额' },
-            actualAmount: { type: 'number', description: '实付金额（优惠后）' },
+            date: { type: 'string', description: '（必填）消费时间（ISO 8601 格式，必须包含日期和时间，如：2026-04-10T13:06:21）' },
+            totalAmount: { type: 'number', description: '（必填）总金额（所有商品amount之和）' },
+            originalAmount: { type: 'number', description: '（必填）应付金额（优惠前）' },
+            discountAmount: { type: 'number', description: '（必填）优惠金额' },
+            actualAmount: { type: 'number', description: '（必填）实付金额（优惠后）' },
             paymentMethod: { type: 'string', description: '支付方式，如：微信支付、支付宝' },
             receiptNo: { type: 'string', description: '小票编号' },
             items: {
@@ -179,7 +179,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                   amount: { type: 'number', description: '【必填】金额，必须等于 price × quantity' },
                   weight: { type: 'string', description: '重量' },
                   marketPrice: { type: 'string', description: '市场单价（元/500g）' },
-                  category: { type: 'string', description: '分类，如：餐饮、食品、购物' },
+                  category: { type: 'string', description: '（必填）分类，如：餐饮、食品、购物' },
                 },
                 required: ['name', 'amount', 'price', 'quantity'],
               },
@@ -233,7 +233,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           properties: {
             name: { type: 'string', description: '收入来源（如：工资、奖金、红包）' },
             amount: { type: 'number', description: '收入金额' },
-            category: { type: 'string', description: '收入分类（如：工资、奖金、投资）' },
+            category: { type: 'string', description: '（必填）收入分类（如：工资、奖金、投资）' },
             store: { type: 'string', description: '付款方（如：公司名称）' },
             date: { type: 'string', description: '收入时间（ISO格式）（可选）' },
             note: { type: 'string', description: '备注' },
@@ -1090,19 +1090,13 @@ function validateQuantity(quantity) {
 
 /**
  * 格式化日期为 ISO 8601 格式（带时区）
- * 解决时区转换问题：确保传入的本地时间正确存储
+ * 注意：此函数只负责格式标准化，不负责语义解析
+ * 语义解析（如"午餐"→12:00）应由 Agent 完成
  */
 function formatDateWithTimezone(dateStr) {
-  // 如果未提供日期，使用当前时间（北京时间）
+  // 如果未提供日期，返回空字符串（让云函数使用服务器时间）
   if (!dateStr) {
-    const now = new Date();
-    const year = now.getFullYear();
-    const month = String(now.getMonth() + 1).padStart(2, '0');
-    const day = String(now.getDate()).padStart(2, '0');
-    const hours = String(now.getHours()).padStart(2, '0');
-    const minutes = String(now.getMinutes()).padStart(2, '0');
-    const seconds = String(now.getSeconds()).padStart(2, '0');
-    return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}+08:00`;
+    return '';
   }
   
   try {
@@ -1117,16 +1111,11 @@ function formatDateWithTimezone(dateStr) {
       return dateStr + '+08:00';
     }
     
-    // 如果是纯日期格式（如 2026-04-14），使用当前时间
+    // 如果是纯日期格式（如 2026-04-14），默认使用中午12:00
+    // 注意：这是合理的默认值，因为纯日期通常表示"当天的消费"
+    // 如果 Agent 需要更精确的时间（如晚餐18:00），应该在传入时就包含时间部分
     if (dateStr.match(/^\d{4}-\d{2}-\d{2}$/)) {
-      const now = new Date();
-      const year = dateStr.slice(0, 4);
-      const month = dateStr.slice(5, 7);
-      const day = dateStr.slice(8, 10);
-      const hours = String(now.getHours()).padStart(2, '0');
-      const minutes = String(now.getMinutes()).padStart(2, '0');
-      const seconds = String(now.getSeconds()).padStart(2, '0');
-      return `${year}-${month}-${day}T${hours}:${minutes}:${seconds}+08:00`;
+      return `${dateStr}T12:00:00+08:00`;
     }
     
     // 其他情况，尝试解析并格式化为带时区的格式