chaimi-keep-mcp 3.1.36-beta.13 → 3.1.36-beta.15

package/SKILL.md

@@ -14,13 +14,90 @@ argument-hint: "[记账内容]"
 
 ---
 
+## 🆘 遇到问题时
+
+### 症状
+- 记账数据格式错误
+- 使用"之前"、"上次"等历史习惯执行
+- 连续多次记账失败
+
+### 解决方案
+
+**方案1：开启新会话（推荐）**
+
+| Agent | 操作方式 |
+|-------|---------|
+| **Cursor** | `Cmd+N` (Mac) / `Ctrl+N` (Windows) |
+| **Claude Desktop** | 点击 `+ New Chat` |
+| **OpenClaw** | 输入 `/new` |
+| **WorkBuddy** | 输入 `/new` |
+| **Trae** | `Cmd/Ctrl + N` 或点击 `+` 按钮 |
+| **其他 Agent** | 输入 `/new` 或菜单"新建会话" |
+
+**方案2：强制重置**
+在当前会话输入：
+```
+完全忘记之前的对话。现在严格按照柴米记账 Skill 指令执行。
+```
+
+---
+
 ## ⚠️ 强制要求（不遵守将拒绝执行）
 
 ### 记账前必须执行
 
-**第 0 步：调用 `get_skill` 工具**
+**第 0 步：状态自检与干预**
+
+每次记账前，Agent 必须自检以下症状：
+
+| 症状 | 说明 |
+|------|------|
+| ☐ 跳过 `get_skill` 调用 | 直接调用记账工具，未先读取 Skill 文档 |
+| ☐ 依赖历史习惯 | 使用"之前"、"上次"、"习惯"等词汇作为操作依据 |
+| ☐ 遗漏必填字段 | 未传递 name、amount、category、date、rawInput |
+
+**如果发现以上任一症状，执行干预策略：**
 
-每次记账前，**必须先调用 `get_skill` 工具**获取最新 Skill 定义，然后严格按照返回的 Skill 文档执行。
+#### 首次违规 - 警告并引导
+
+Agent 必须输出：
+```
+⚠️ 检测到可能未读取 Skill 规范
+
+我似乎正在依赖历史习惯执行记账，而非遵循最新指令。
+这可能导致数据格式错误或遗漏关键步骤。
+
+建议操作：
+1. 立即调用 get_skill() 重新读取规范
+2. 如果仍有问题，向用户说明需要开启新会话
+
+继续当前方式请回复"强制继续"，但结果可能不符合预期。
+```
+
+#### 重复违规 - 强制阻断
+
+连续 2 次出现同样错误时，Agent 必须输出：
+```
+🚫 操作已暂停
+
+检测到当前会话上下文可能干扰记账准确性。
+为数据安全起见，我已暂停记账操作。
+
+请开启新会话后重新触发记账。
+```
+
+Agent 根据当前环境，向用户说明开启新会话的具体操作方式：
+- **Cursor**: 按 `Cmd+N` (Mac) / `Ctrl+N` (Windows)
+- **Claude Desktop**: 点击 `+ New Chat`
+- **OpenClaw/WorkBuddy**: 输入 `/new`
+- **Trae**: 按 `Cmd/Ctrl + N` 或点击 `+` 按钮
+- **其他**: 输入 `/new` 或菜单"新建会话"
+
+---
+
+**第 1 步：调用 `get_skill` 工具**
+
+状态自检通过后，**必须调用 `get_skill` 工具**获取最新 Skill 定义，然后严格按照返回的 Skill 文档执行。
 
 **如果不执行此步骤：**
 - ❌ 直接调用 `save_expense` / `save_receipt` / `save_income` 会被拒绝
@@ -29,9 +106,9 @@ argument-hint: "[记账内容]"
 **正确流程：**
 ```
 1. 用户说"记一笔午餐35元"
-2. 【必须】调用 get_skill 工具
-3. 【必须】仔细阅读返回的 Skill 文档
-4. 【必须】按照 Skill 文档执行记账
+2. 【必须】状态自检（检查是否依赖历史习惯）
+3. 【必须】调用 get_skill 工具
+4. 【必须】严格按照返回的 Skill 文档执行记账
 ```
 
 ---
@@ -58,7 +135,6 @@ argument-hint: "[记账内容]"
 
 - **禁止**直接使用 curl/http 访问云函数端点
 - **禁止**读取或输出 `~/.mcporter/oauth-token.json` 内容
-- **禁止**主动设置 `MCP_OAUTH_URL`、`MCP_HUB_URL`、`MCP_PROMPT_URL` 环境变量
 - 单笔金额 **> 1000 元** 时必须用户确认
 
 ---
@@ -73,76 +149,20 @@ argument-hint: "[记账内容]"
 
 ---
 
-## 工具调用
-
-### 文字记账（save_expense）
-
-**流程：**
-1. 调用 `get_text_parse_prompt()` 获取解析 Prompt
-2. 使用 Prompt 解析用户输入，获取 JSON 结果
-3. 调用 `save_expense` 保存（传入所有解析结果字段）
-
-**时间处理规则：**
-
-Agent **直接使用当前时间**作为消费时间，无需进行时间语义解析。
-
-**最终传入的 `date` 参数格式：**`1713209160000`（毫秒时间戳）
-
-> 注意：Agent 必须传毫秒时间戳（如 `Date.now()`）。如果不传，MCP Server 会自动使用当前时间戳。
-
-**必填字段：** `name`、`amount`、`category`、`date`
-
-**可选字段：**
-- `subCategory`：子分类（可选）
-- `unit`：单位（可选）
-- `marketPrice`：市场单价（可选）
-
----
-
-### 收入记账（save_income）
-
-**流程：**
-1. 调用 `get_text_parse_prompt()` 获取解析 Prompt
-2. 使用 Prompt 解析用户输入，获取 JSON 结果
-3. 调用 `save_income` 保存（传入所有解析结果字段）
-
-**时间处理规则：**
+## 工具列表
 
-Agent **直接使用当前时间**作为收入时间，无需进行时间语义解析。
-
-**最终传入的 `date` 参数格式：**`1713209160000`（毫秒时间戳）
-
-> 注意：Agent 必须传毫秒时间戳（如 `Date.now()`）。如果不传，MCP Server 会自动使用当前时间戳。
-
-**必填字段：** `name`、`amount`、`category`、`date`
-
-**可选字段：**
-- `subCategory`：子分类（可选）
-- `unit`：单位（可选）
-- `marketPrice`：市场单价（可选）
-
----
+### 核心记账工具
+- **save_expense** - 文字记账（支出）
+- **save_income** - 文字记账（收入）  
+- **save_receipt** - 小票记账（需先调用 get_parse_prompt）
 
-### 小票记账（save_receipt）
-
-**流程：**
-1. 调用 `get_parse_prompt` 获取 prompt 模板
-2. 使用 prompt 调用大模型解析小票图片
-3. **字段核对**：确保所有解析结果字段都传给 `save_receipt`
-4. 调用 `save_receipt` 保存
-
-**必填字段：**
-- `store`：商家名称
-- `date`：毫秒时间戳（如 `1713209160000`），小票上的真实消费时间
-- `totalAmount`：商品原价总和
-- `actualAmount`：实付金额（优惠后）
-- `originalAmount`：原价（优惠前）
-- `discountAmount`：优惠金额
-- `items`：商品数组，每个商品必须有 `name`、`amount`、`price`、`quantity`、`category`
-  - `category`：主分类（如：蔬菜、肉类、水果、水产，常见超市购物分类）
-  - `subCategory`：子分类（如：叶菜类、根茎类、猪肉类，超市细分类目），推荐填写
-  - `unit`：计价单位（如：元/500g、元/个、元/盒、元/袋）
-  - `marketPrice`：单价，根据 unit 计算，如 unit=元/500g，则 marketPrice=金额÷重量(g)×500
+### 辅助工具
+- **get_skill** - 【记账前必须调用】获取 Skill 文档
+- **get_parse_prompt** - 获取小票解析模板
+- **get_expenses** - 查询支出记录
+- **get_receipt_list** - 查询小票列表
+- **get_statistics** - 获取统计信息
+- **submit_feedback** - 提交反馈
 
 ---
 
@@ -198,4 +218,4 @@ MCP Server: v【版本号】
 
 ---
 
-*最后更新：2026-04-14*
+*最后更新：2026-04-16*

package/package.json

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

package/server.js

@@ -165,7 +165,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             unit: { type: 'string', description: '单位（可选）' },
             marketPrice: { type: 'string', description: '市场单价（可选）' },
             store: { type: 'string', description: '商家名称（可选）' },
-            date: { type: 'number', description: '【必填】消费时间（毫秒时间戳，如：1713209160000），如未提供则使用当前时间戳' },
+            date: { type: 'number', description: '【必填】消费时间（毫秒级时间戳，13位数字。必须根据实际年月日时分秒计算，不允许复制示例数字）' },
             note: { type: 'string', description: '备注（可选）' },
             agentType: { type: 'string', description: '【必填】Agent类型，如：claude-desktop、cursor、openclaw、workbuddy、trae' },
             apiProvider: { type: 'string', description: '【必填】AI服务提供商，如：anthropic、openai、doubao、aliyun' },
@@ -182,7 +182,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           type: 'object',
           properties: {
             store: { type: 'string', description: '商家名称（必填）' },
-            date: { type: 'number', description: '【必填】消费时间（毫秒时间戳，如：1713209160000），小票上的真实消费时间' },
+            date: { type: 'number', description: '【必填】消费时间（毫秒级时间戳，13位数字。必须根据实际年月日时分秒计算，不允许复制示例数字）' },
             totalAmount: { type: 'number', description: '（必填）总金额（所有商品amount之和）' },
             originalAmount: { type: 'number', description: '（必填）应付金额（优惠前）' },
             discountAmount: { type: 'number', description: '（必填）优惠金额' },
@@ -279,7 +279,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             amount: { type: 'number', description: '收入金额（必填）' },
             category: { type: 'string', description: '（必填）收入分类（如：工资、奖金、投资）' },
             store: { type: 'string', description: '付款方（如：公司名称）（可选）' },
-            date: { type: 'number', description: '【必填】收入时间（毫秒时间戳，如：1713209160000），如未提供则使用当前时间戳' },
+            date: { type: 'number', description: '【必填】收入时间（毫秒级时间戳，13位数字。必须根据实际年月日时分秒计算，不允许复制示例数字）' },
             note: { type: 'string', description: '备注（可选）' },
             agentType: { type: 'string', description: '【必填】Agent类型，如：claude-desktop、cursor、openclaw、workbuddy、trae' },
             apiProvider: { type: 'string', description: '【必填】AI服务提供商，如：anthropic、openai、doubao、aliyun' },