chaimi-keep-mcp 3.1.49-beta.2 → 3.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/SKILL.md +185 -277
- package/_meta.json +59 -0
- package/bin/get-auth-code.js +2 -2
- package/bin/global-install.js +56 -0
- package/bin/sync-skill.js +89 -24
- package/oauth.js +2 -1
- package/package.json +3 -1
- package/references/advanced-features.md +146 -0
- package/references/api-reference.md +205 -0
- package/references/authentication.md +142 -0
- package/references/response-templates.md +424 -0
- package/references/troubleshooting.md +269 -0
- package/server.js +8 -2
package/README.md
CHANGED
|
@@ -61,7 +61,7 @@ MCP Server 会显示:
|
|
|
61
61
|
║ 请在"柴米AI记账"小程序中完成授权: ║
|
|
62
62
|
║ ║
|
|
63
63
|
║ 1. 打开"柴米AI记账"小程序 ║
|
|
64
|
-
║ 2. 点击"我的" → "
|
|
64
|
+
║ 2. 点击"我的" → "Agent 授权" ║
|
|
65
65
|
║ 3. 输入验证码:ABCD-EFGH ║
|
|
66
66
|
║ ║
|
|
67
67
|
╚════════════════════════════════════════════════════════╝
|
|
@@ -69,7 +69,7 @@ MCP Server 会显示:
|
|
|
69
69
|
|
|
70
70
|
### 3. 小程序授权
|
|
71
71
|
|
|
72
|
-
打开"柴米AI记账"小程序 → 点击"我的" → "
|
|
72
|
+
打开"柴米AI记账"小程序 → 点击"我的" → "Agent 授权" → 输入上述验证码
|
|
73
73
|
|
|
74
74
|
### 4. 完成
|
|
75
75
|
|
package/SKILL.md
CHANGED
|
@@ -1,360 +1,268 @@
|
|
|
1
1
|
---
|
|
2
|
-
name: chaimi-keep-mcp
|
|
2
|
+
name: "chaimi-keep-mcp"
|
|
3
3
|
description: >-
|
|
4
|
-
柴米AI记账
|
|
4
|
+
柴米AI记账MCP Server,连接微信小程序记账功能。
|
|
5
5
|
TRIGGER: 用户提及"记账/记录/保存"并涉及金额或商品信息。
|
|
6
6
|
DO NOT TRIGGER: 非记账操作,或明确使用其他记账工具时。
|
|
7
|
-
|
|
8
|
-
|
|
7
|
+
version: "3.2.0"
|
|
8
|
+
updated: "2026-04-25"
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
# 柴米AI记账 Skill
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
> ✨ 柴米记账超级美学版 - 让记账变成享受
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
17
|
-
##
|
|
17
|
+
## 目录
|
|
18
18
|
|
|
19
|
-
|
|
20
|
-
-
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
| Agent | 操作方式 |
|
|
29
|
-
|-------|---------|
|
|
30
|
-
| **Cursor** | `Cmd+N` (Mac) / `Ctrl+N` (Windows) |
|
|
31
|
-
| **Claude Desktop** | 点击 `+ New Chat` |
|
|
32
|
-
| **OpenClaw** | 输入 `/new` |
|
|
33
|
-
| **WorkBuddy** | 输入 `/clear` |
|
|
34
|
-
| **Trae** | `Cmd/Ctrl + N` 或点击 `+` 按钮 |
|
|
35
|
-
| **其他 Agent** | 输入 `/new` 或菜单"新建会话" |
|
|
36
|
-
|
|
37
|
-
**方案2:强制重置**
|
|
38
|
-
在当前会话输入:
|
|
39
|
-
```
|
|
40
|
-
完全忘记之前的对话。现在严格按照柴米记账 Skill 指令执行。
|
|
41
|
-
```
|
|
19
|
+
- [一、触发规则](#一触发规则)
|
|
20
|
+
- [二、风险等级确认策略](#二风险等级确认策略)
|
|
21
|
+
- [三、与其他Skill的关系](#三与其他skill的关系)
|
|
22
|
+
- [四、场景路由表](#四场景路由表)
|
|
23
|
+
- [五、工具速查表](#五工具速查表)
|
|
24
|
+
- [六、快速开始](#六快速开始)
|
|
25
|
+
- [七、回复规范](#七回复规范)
|
|
26
|
+
- [八、记忆口诀](#八记忆口诀)
|
|
27
|
+
- [九、错误速查](#九错误速查)
|
|
42
28
|
|
|
43
29
|
---
|
|
44
30
|
|
|
45
|
-
##
|
|
46
|
-
|
|
47
|
-
### 记账前必须执行
|
|
31
|
+
## 一、触发规则
|
|
48
32
|
|
|
49
|
-
|
|
33
|
+
**必须同时满足以下条件才执行:**
|
|
50
34
|
|
|
51
|
-
|
|
35
|
+
1. **关键词匹配**(满足任一):
|
|
36
|
+
- "记账"、"记录"、"保存"、"录入"
|
|
37
|
+
- "花了"、"支出"、"收入"、"工资"
|
|
38
|
+
- "多少钱"、"元"、"块"
|
|
39
|
+
- "小票"、"发票"、"收据"
|
|
52
40
|
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
| ☐ 遗漏必填字段 | 未传递 name、amount、category、date、rawInput |
|
|
41
|
+
2. **数据特征**(满足任一):
|
|
42
|
+
- 包含金额数字
|
|
43
|
+
- 包含商品/商家名称
|
|
44
|
+
- 上传图片(小票识别)
|
|
58
45
|
|
|
59
|
-
|
|
46
|
+
**禁止触发场景:**
|
|
60
47
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
```
|
|
65
|
-
⚠️ 检测到可能未读取 Skill 规范
|
|
48
|
+
- 用户明确说"用其他记账软件"
|
|
49
|
+
- 纯金额计算("100+200等于多少")
|
|
50
|
+
- 询问历史记录但不记账("上月花了多少"由场景路由处理)
|
|
66
51
|
|
|
67
|
-
|
|
68
|
-
这可能导致数据格式错误或遗漏关键步骤。
|
|
52
|
+
**上下文延续规则:**
|
|
69
53
|
|
|
70
|
-
|
|
71
|
-
1. 立即调用 get_skill() 重新读取规范
|
|
72
|
-
2. 如果仍有问题,向用户说明需要开启新会话
|
|
54
|
+
当前对话已在记账流程中时,后续补充信息无需再次提及"记账"即可继续。
|
|
73
55
|
|
|
74
|
-
|
|
75
|
-
```
|
|
76
|
-
|
|
77
|
-
#### 重复违规 - 强制阻断
|
|
78
|
-
|
|
79
|
-
连续 2 次出现同样错误时,Agent 必须输出:
|
|
80
|
-
```
|
|
81
|
-
🚫 操作已暂停
|
|
82
|
-
|
|
83
|
-
检测到当前会话上下文可能干扰记账准确性。
|
|
84
|
-
为数据安全起见,我已暂停记账操作。
|
|
56
|
+
---
|
|
85
57
|
|
|
86
|
-
|
|
58
|
+
## 二、风险等级确认策略
|
|
87
59
|
|
|
88
|
-
|
|
89
|
-
|
|
60
|
+
| 风险等级 | 场景 | 策略 | 确认话术 |
|
|
61
|
+
|---------|------|------|---------|
|
|
62
|
+
| **🔴 高** | 金额>1000元、批量操作、异常数据 | 必须确认 | "⚠️ 大额消费¥{金额},请确认是否记账?" |
|
|
63
|
+
| **🟡 中** | 金额500-1000元、分类不明确 | 温柔确认 | "确认:{商品} ¥{金额},分类为{分类}?" |
|
|
64
|
+
| **🟢 低** | 常规记账<500元、信息完整 | 直接执行 | 立即记账并返回成功模板 |
|
|
90
65
|
|
|
91
66
|
---
|
|
92
67
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
状态自检通过后,**必须调用 `get_skill` 工具**获取最新 Skill 定义,然后严格按照返回的 Skill 文档执行。
|
|
68
|
+
## 三、文档引用关系
|
|
96
69
|
|
|
97
|
-
**如果不执行此步骤:**
|
|
98
|
-
- ❌ 直接调用 `save_expense` / `save_receipt` / `save_income` 会被拒绝
|
|
99
|
-
- ❌ 返回错误:没有读取 Skill 文件,请先调用 get_skill 工具
|
|
100
|
-
|
|
101
|
-
**正确流程:**
|
|
102
70
|
```
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
71
|
+
用户使用柴米记账
|
|
72
|
+
↓
|
|
73
|
+
chaimi-keep-mcp ⭐ 本Skill
|
|
74
|
+
├── 记账成功 → 使用回复模板(见七、回复规范)
|
|
75
|
+
├── 记账失败 → troubleshooting.md
|
|
76
|
+
├── 深度分析 → advanced-features.md
|
|
77
|
+
└── 授权问题 → authentication.md
|
|
107
78
|
```
|
|
108
79
|
|
|
109
80
|
---
|
|
110
81
|
|
|
111
|
-
##
|
|
112
|
-
|
|
113
|
-
### 必须同时满足
|
|
114
|
-
|
|
115
|
-
1. 用户明确提及以下关键词之一:
|
|
116
|
-
- "记账"、"记一笔"、"记录"
|
|
117
|
-
|
|
118
|
-
2. 包含以下信息之一:
|
|
119
|
-
- 金额数字(如:35、100.5)
|
|
120
|
-
- 商品/服务名称(如:午餐、咖啡)
|
|
121
|
-
- 小票/发票信息
|
|
122
|
-
|
|
123
|
-
### 禁止触发
|
|
124
|
-
|
|
125
|
-
- 明确使用其他记账工具时(如:"用支付宝记账")
|
|
126
|
-
|
|
127
|
-
---
|
|
82
|
+
## 四、场景路由表
|
|
128
83
|
|
|
129
|
-
|
|
84
|
+
根据用户意图,快速匹配工具和参考文档:
|
|
130
85
|
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
86
|
+
| 用户意图 | 关键词示例 | 推荐工具 | 参考文档 | 回复模板 |
|
|
87
|
+
|---------|-----------|---------|---------|---------|
|
|
88
|
+
| **文字记账** | "午餐35元" | save_expense | - | 标准成功模板 |
|
|
89
|
+
| **收入记账** | "工资5000" | save_income | - | 标准成功模板 |
|
|
90
|
+
| **小票记账** | "小票识别" | save_receipt | - | 高金额模板 |
|
|
91
|
+
| **查询记录** | "这周花了多少" | get_expenses | api-reference.md | 查询结果模板 |
|
|
92
|
+
| **消费统计** | "月度统计" | get_statistics | api-reference.md | 统计分析模板 |
|
|
93
|
+
| **智能洞察** | "分析消费习惯" | get_insights | advanced-features.md | 洞察分析模板 |
|
|
94
|
+
| **深度分析** | "详细分析" | export_data | advanced-features.md | 分析模板 |
|
|
95
|
+
| **授权问题** | "无法记账" | - | troubleshooting.md | 错误提示模板 |
|
|
96
|
+
| **回复格式** | "回复格式" | - | response-templates.md | - |
|
|
134
97
|
|
|
135
98
|
---
|
|
136
99
|
|
|
137
|
-
##
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
100
|
+
## 五、工具速查表
|
|
101
|
+
|
|
102
|
+
**设计原则:** Agent一眼看到所有工具,按功能分类
|
|
103
|
+
- **记账工具**:直接调用,无需查看详细文档
|
|
104
|
+
- **查询分析工具**:详细参数见 api-reference.md
|
|
105
|
+
|
|
106
|
+
| 分类 | 工具名 | 功能一句话 | 典型场景 |
|
|
107
|
+
|:-----|:-------|:-----------|:---------|
|
|
108
|
+
| **记账** | save_expense | 支出记账 | "午餐35元" |
|
|
109
|
+
| | save_income | 收入记账 | "工资5000" |
|
|
110
|
+
| | save_receipt | 小票图片记账 | 上传小票照片 |
|
|
111
|
+
| **查询** | get_expenses | 查询消费记录 | "这周花了多少" |
|
|
112
|
+
| | get_statistics | 消费统计分析 | "月度统计" |
|
|
113
|
+
| | get_receipt_list | 查询小票列表 | "查看小票记录" |
|
|
114
|
+
| **分析** | get_insights | AI消费洞察 | "分析消费习惯" |
|
|
115
|
+
| | export_data | 导出完整数据 | 深度分析 |
|
|
116
|
+
| **辅助** | get_skill | 【必须】获取Skill文档 | 记账前调用 |
|
|
117
|
+
| | get_text_parse_prompt | 获取文字解析模板 | 文字记账前 |
|
|
118
|
+
| | get_parse_prompt | 获取小票解析模板 | 小票记账前 |
|
|
119
|
+
| | submit_feedback | 提交反馈 | 问题反馈 |
|
|
144
120
|
|
|
145
121
|
---
|
|
146
122
|
|
|
147
|
-
##
|
|
148
|
-
|
|
149
|
-
### 核心记账工具
|
|
150
|
-
- **save_expense** - 文字记账(支出)
|
|
151
|
-
- **save_income** - 文字记账(收入)
|
|
152
|
-
- **save_receipt** - 小票记账(需先调用 get_parse_prompt)
|
|
153
|
-
|
|
154
|
-
### 智能查询工具(新功能)
|
|
155
|
-
- **get_insights** - 【推荐使用】获取消费洞察(零AI成本!)
|
|
156
|
-
- 返回消费趋势、模式、优化建议
|
|
157
|
-
- 让 Agent 结合用户的大模型分析
|
|
158
|
-
- **export_data** - 【深度分析用】导出完整消费数据
|
|
159
|
-
- 用于 Agent 深度分析
|
|
160
|
-
- **get_statistics** - 获取消费统计(支持周/月周期!)
|
|
161
|
-
- 新增 `period` 参数:支持 `this_week`、`last_week`、`this_month`、`last_month`
|
|
162
|
-
|
|
163
|
-
### 辅助工具
|
|
164
|
-
- **get_skill** - 【记账前必须调用】获取 Skill 文档
|
|
165
|
-
- **get_text_parse_prompt** - 获取文字记账解析模板(云端实现,包含43个标准分类)
|
|
166
|
-
- **get_parse_prompt** - 获取小票解析模板
|
|
167
|
-
- **get_expenses** - 查询支出记录(支持周/月周期!)
|
|
168
|
-
- 新增 `period` 参数:支持 `this_week`、`last_week`、`this_month`、`last_month`
|
|
169
|
-
- **get_receipt_list** - 查询小票列表
|
|
170
|
-
- **submit_feedback** - 提交反馈
|
|
171
|
-
|
|
172
|
-
---
|
|
123
|
+
## 六、快速开始
|
|
173
124
|
|
|
174
|
-
|
|
125
|
+
### 3步极简记账流程
|
|
175
126
|
|
|
176
|
-
### 场景 1:用户问「帮我看看这周花了多少钱」
|
|
177
|
-
**推荐工具:`get_statistics` 搭配 `period: this_week`**
|
|
178
|
-
参数示例:
|
|
179
127
|
```
|
|
180
|
-
|
|
128
|
+
第1步:状态自检
|
|
129
|
+
↓ 检查依赖历史习惯
|
|
130
|
+
第2步:获取Skill
|
|
131
|
+
↓ 调用 get_skill 获取最新规范
|
|
132
|
+
第3步:执行记账
|
|
133
|
+
↓ 调用对应工具(save_expense/income/receipt)
|
|
134
|
+
↓ 返回美学回复
|
|
181
135
|
```
|
|
182
136
|
|
|
183
|
-
###
|
|
184
|
-
**推荐工具:`get_insights` + `export_data`**
|
|
185
|
-
1. 先用 `get_insights` 获取洞察
|
|
186
|
-
2. 再用 `export_data` 获取完整数据
|
|
187
|
-
3. 用用户的大模型进行深度分析
|
|
188
|
-
|
|
189
|
-
### 场景 3:用户问「最近的消费记录」
|
|
190
|
-
**推荐工具:`get_expenses`**
|
|
191
|
-
- 也可以搭配 `period: this_week` 使用
|
|
137
|
+
### 首次使用必做
|
|
192
138
|
|
|
139
|
+
1. **完成授权** → 运行 `./scripts/auth-flow.sh`
|
|
140
|
+
2. **验证安装** → 运行 `./scripts/verify-setup.sh`
|
|
141
|
+
3. **开始记账** → "午餐35元"
|
|
193
142
|
|
|
194
143
|
---
|
|
195
144
|
|
|
196
|
-
##
|
|
197
|
-
|
|
198
|
-
### 时间戳规则(所有记账工具通用)
|
|
145
|
+
## 七、回复规范
|
|
199
146
|
|
|
200
|
-
|
|
147
|
+
### 7.1 5层视觉结构
|
|
201
148
|
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
149
|
+
```
|
|
150
|
+
【第1层:成功标识】✅ 「Agent名称」已帮您记账成功
|
|
151
|
+
【第2层:分隔强调】═══════════════════════════
|
|
152
|
+
【第3层:核心数据】💰 金额:¥xx.xx
|
|
153
|
+
【第4层:详细信息】
|
|
154
|
+
📦 商品:xxx
|
|
155
|
+
🏷️ 分类:xxx
|
|
156
|
+
🏪 商家:xxx
|
|
157
|
+
🕐 时间:xxxx-xx-xx xx:xx
|
|
158
|
+
【第5层:品牌落款】
|
|
159
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
160
|
+
🎉 情绪祝福语!
|
|
161
|
+
柴米AI记账
|
|
162
|
+
chaimi-keep-mcp v版本号
|
|
163
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
164
|
+
```
|
|
207
165
|
|
|
208
|
-
|
|
166
|
+
### 7.2 标准成功模板
|
|
209
167
|
|
|
210
|
-
|
|
168
|
+
```markdown
|
|
169
|
+
✅ 「{agentName}」已帮您记账成功
|
|
170
|
+
═══════════════════════════
|
|
171
|
+
💰 金额:¥{金额}
|
|
172
|
+
═══════════════════════════
|
|
211
173
|
|
|
212
|
-
|
|
174
|
+
📦 商品:{商品名}
|
|
175
|
+
🏷️ 分类:{分类}
|
|
176
|
+
🏪 商家:{商家}
|
|
177
|
+
🕐 时间:{日期时间}
|
|
213
178
|
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
179
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
180
|
+
🎉 {情绪祝福语}!
|
|
181
|
+
柴米AI记账
|
|
182
|
+
chaimi-keep-mcp v{版本号}
|
|
183
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
184
|
+
```
|
|
218
185
|
|
|
219
|
-
|
|
186
|
+
### 7.3 极简模板(连续记账)
|
|
220
187
|
|
|
221
|
-
|
|
188
|
+
```markdown
|
|
189
|
+
✅ 已记录:{商品名} ¥{金额} · {分类}
|
|
190
|
+
{情绪祝福语}
|
|
191
|
+
```
|
|
222
192
|
|
|
223
|
-
|
|
224
|
-
1. 调用 `get_text_parse_prompt()` 获取解析 Prompt
|
|
225
|
-
2. 使用 Prompt 解析用户输入,获取 JSON 结果
|
|
226
|
-
3. 调用 `save_income` 保存(传入所有解析结果字段)
|
|
193
|
+
### 7.4 高金额模板(>1000元)
|
|
227
194
|
|
|
228
|
-
|
|
195
|
+
```markdown
|
|
196
|
+
⚠️ 大额消费确认
|
|
197
|
+
═══════════════════════════
|
|
198
|
+
💰 金额:¥{金额}
|
|
199
|
+
📦 商品:{商品名}
|
|
200
|
+
🕐 时间:{日期}
|
|
229
201
|
|
|
230
|
-
|
|
202
|
+
✅ 已确认录入「柴米AI记账」
|
|
231
203
|
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
204
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
205
|
+
💡 {消费建议}
|
|
206
|
+
柴米AI记账
|
|
207
|
+
chaimi-keep-mcp v{版本号}
|
|
208
|
+
━━━━━━━━━━━━━━━━━━━━━━━━━━
|
|
209
|
+
```
|
|
237
210
|
|
|
238
|
-
|
|
211
|
+
### 7.5 变量说明
|
|
239
212
|
|
|
240
|
-
|
|
213
|
+
| 变量 | 说明 | 示例 |
|
|
214
|
+
|:-----|:-----|:-----|
|
|
215
|
+
| {agentName} | Agent显示名称 | 「你的小可爱」 |
|
|
216
|
+
| {商品名} | 商品或商家名称 | 午餐、麦当劳 |
|
|
217
|
+
| {金额} | 金额(带¥符号) | ¥35.00 |
|
|
218
|
+
| {分类} | 消费分类 | 餐饮 |
|
|
219
|
+
| {商家} | 商家名称(可选) | 麦当劳 |
|
|
220
|
+
| {日期时间} | 格式化时间 | 2026-04-24 12:30 |
|
|
221
|
+
| {情绪祝福语} | 分类对应祝福语 | 祝您用餐愉快! |
|
|
222
|
+
| {版本号} | MCP版本 | 3.2.0 |
|
|
241
223
|
|
|
242
|
-
|
|
243
|
-
|----------|------|------|
|
|
244
|
-
| **高** | 金额 > 1000元、批量 > 10笔、退款/负数 | 必须确认 |
|
|
245
|
-
| **中** | 分类不明确、商家名称模糊 | 确认后执行 |
|
|
246
|
-
| **低** | 信息完整明确 | 直接执行 |
|
|
224
|
+
**详细情绪词库和模板** → 见 references/response-templates.md
|
|
247
225
|
|
|
248
226
|
---
|
|
249
227
|
|
|
250
|
-
##
|
|
228
|
+
## 八、记忆口诀
|
|
251
229
|
|
|
252
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
230
|
+
> **柴米记账超美学,五层结构要牢记。**
|
|
231
|
+
> **成功标识在顶部,金额分隔最醒目。**
|
|
232
|
+
> **商品分类商家时,底部祝福加品牌。**
|
|
233
|
+
> **场景路由先匹配,工具速查再执行。**
|
|
234
|
+
> **大额消费要确认,极简连续记账快。**
|
|
256
235
|
|
|
257
236
|
---
|
|
258
237
|
|
|
259
|
-
##
|
|
238
|
+
## 九、错误速查
|
|
260
239
|
|
|
261
|
-
|
|
240
|
+
### Top 3 常见错误
|
|
262
241
|
|
|
263
|
-
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
|
|
268
|
-
· 时间:【购买日期】
|
|
269
|
-
✅ 【友好结束语】
|
|
270
|
-
|
|
271
|
-
💡 消费洞察:【洞察内容】(可选)
|
|
272
|
-
-------------
|
|
273
|
-
chaimi-keep-mcp: v【版本号】
|
|
274
|
-
```
|
|
275
|
-
|
|
276
|
-
**Agent名称说明:**
|
|
277
|
-
- 如果用户为当前授权设置了自定义Agent名称(如"你的小可爱"),则显示:`✅ 「你的小可爱」已帮您录入「柴米AI记账」`
|
|
278
|
-
- 如果未设置自定义名称(默认"柴米AI助手"),则显示:`✅ 「柴米AI助手」已帮您录入「柴米AI记账」`
|
|
279
|
-
- Agent名称从MCP返回的数据中获取,字段名为 `agentName`
|
|
280
|
-
|
|
281
|
-
**友好结束语参考(一定要是正能量,且给足情绪价值的词):**
|
|
282
|
-
- 餐饮类:用餐愉快!🍚 / 好好吃饭哦~ / 美食治愈一切!😋 / 每一餐都是生活的小确幸~ 🌟
|
|
283
|
-
- 食品类:吃好喝好!🍎 / 健康第一,美味加倍!💪 / 好好照顾自己哦~ 🤗
|
|
284
|
-
- 交通类:出行顺利!🚗 / 一路平安!🙏 / 顺利抵达,心情愉悦~ 😊
|
|
285
|
-
- 购物类:买得开心!🛍️ / 精明消费,品质生活!✨ / 买到心仪好物,心情美美哒~ 💕
|
|
286
|
-
- 收入类:入账顺利!💰 / 财富+1,好运连连!🍀 / 越努力越幸运,继续加油!🚀
|
|
287
|
-
- 通用:记账完成!继续保持~ ✨ / 今天的你超棒的!👍 / 记录美好生活,从每一笔开始~ 📝
|
|
288
|
-
|
|
289
|
-
**消费洞察(可选):**
|
|
290
|
-
- 由云函数自动生成,返回记账后的即时洞察
|
|
291
|
-
- 示例:这是你本周第19次餐饮消费,要不要看看本周餐饮花了多少钱?
|
|
242
|
+
| 错误 | 现象 | 解决方案 | 参考文档 |
|
|
243
|
+
|:-----|:-----|:---------|:---------|
|
|
244
|
+
| **授权失败** | "未找到有效授权" | 运行 `./scripts/auth-flow.sh` 重新授权 | troubleshooting.md |
|
|
245
|
+
| **分类不明** | "无法识别分类" | 明确说分类:"午餐35元餐饮" | api-reference.md |
|
|
246
|
+
| **网络超时** | "请求超时" | 检查网络,稍后重试 | troubleshooting.md |
|
|
292
247
|
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
```
|
|
296
|
-
✅ 「你的小可爱」已帮您录入「柴米AI记账」
|
|
297
|
-
· 商品:猪脚 💰 ¥33
|
|
298
|
-
· 收支类型: 支出
|
|
299
|
-
· 分类: 餐饮
|
|
300
|
-
· 时间:2026年4月24日
|
|
301
|
-
✅ 好好吃饭哦~
|
|
302
|
-
|
|
303
|
-
💡 消费洞察:这是你本周第23次餐饮消费,要不要看看本周餐饮花了多少钱?
|
|
304
|
-
-------------
|
|
305
|
-
chaimi-keep-mcp: v3.1.48
|
|
306
|
-
```
|
|
248
|
+
**完整故障排除** → 见 references/troubleshooting.md
|
|
307
249
|
|
|
308
250
|
---
|
|
309
251
|
|
|
310
|
-
##
|
|
311
|
-
|
|
312
|
-
| 错误类型 | 处理方式 |
|
|
313
|
-
|----------|----------|
|
|
314
|
-
| 未安装 | 引导安装:`npm install -g chaimi-keep-mcp` |
|
|
315
|
-
| 未授权 | MCP Server 自动返回授权错误和验证码,Agent 引导用户在小程序中完成授权 |
|
|
316
|
-
| Token 过期 | MCP Server 自动刷新,或返回授权错误需要重新授权 |
|
|
317
|
-
| 参数错误 | 提示用户补充必要信息 |
|
|
318
|
-
|
|
319
|
-
### 未授权详细处理流程
|
|
320
|
-
|
|
321
|
-
当调用记账工具时,如果用户未授权,MCP Server 会自动返回授权错误,包含验证码。
|
|
322
|
-
|
|
323
|
-
**第 1 步:捕获授权错误**
|
|
324
|
-
|
|
325
|
-
当 MCP Server 返回如下错误时:
|
|
326
|
-
```
|
|
327
|
-
NEED_AUTH:GGCY-AC84
|
|
328
|
-
```
|
|
329
|
-
|
|
330
|
-
表示需要授权,验证码为 `GGCY-AC84`。
|
|
331
|
-
|
|
332
|
-
**第 2 步:引导用户完成授权**
|
|
333
|
-
|
|
334
|
-
Agent 必须向用户显示:
|
|
335
|
-
```
|
|
336
|
-
🔐 请先完成授权
|
|
337
|
-
|
|
338
|
-
━━━━━━━━━━━━━━
|
|
339
|
-
📱 验证码:GGCY-AC84
|
|
340
|
-
━━━━━━━━━━━━━━
|
|
341
|
-
|
|
342
|
-
请在"柴米AI记账"小程序中完成授权:
|
|
343
|
-
|
|
344
|
-
1️⃣ 打开微信小程序"柴米AI记账"
|
|
345
|
-
2️⃣ 点击"我的" → "🤖 Agent 授权"
|
|
346
|
-
3️⃣ 输入验证码:GGCY-AC84
|
|
347
|
-
4️⃣ 点击确认授权
|
|
348
|
-
|
|
349
|
-
授权完成后告诉我,我将继续为您记账。
|
|
350
|
-
```
|
|
351
|
-
|
|
352
|
-
**第 3 步:用户确认授权后**
|
|
252
|
+
## 相关文档
|
|
353
253
|
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
-
|
|
254
|
+
| 文档 | 路径 | 说明 |
|
|
255
|
+
|:-----|:-----|:-----|
|
|
256
|
+
| 详细回复模板 | references/response-templates.md | 情绪词库、完整模板 |
|
|
257
|
+
| API详细说明 | references/api-reference.md | 工具参数、返回值 |
|
|
258
|
+
| 故障排除 | references/troubleshooting.md | 常见问题、解决方案 |
|
|
259
|
+
| 高级功能 | references/advanced-features.md | insights、export深度用法 |
|
|
260
|
+
| 授权详解 | references/authentication.md | 授权流程、Token管理 |
|
|
261
|
+
| 可执行脚本 | scripts/ | auth-flow.sh 等 |
|
|
262
|
+
| 输出模板 | templates/ | 分析报告固定格式 |
|
|
357
263
|
|
|
358
264
|
---
|
|
359
265
|
|
|
360
|
-
|
|
266
|
+
**文档版本:v3.2.0**
|
|
267
|
+
**最后更新:2026-04-25**
|
|
268
|
+
**Status:生产就绪**
|
package/_meta.json
ADDED
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "chaimi-keep-mcp",
|
|
3
|
+
"description": "柴米AI记账MCP Server,连接微信小程序记账功能,提供超级美学用户体验",
|
|
4
|
+
"version": "3.2.0",
|
|
5
|
+
"updated": "2026-04-25",
|
|
6
|
+
"author": "柴米AI团队",
|
|
7
|
+
"category": "financial",
|
|
8
|
+
"tags": ["记账", "财务管理", "小程序", "微信"],
|
|
9
|
+
"entry": "SKILL.md",
|
|
10
|
+
"references": {
|
|
11
|
+
"response-templates": {
|
|
12
|
+
"path": "references/response-templates.md",
|
|
13
|
+
"description": "详细回复模板库,包含情绪词库和场景模板",
|
|
14
|
+
"lines": 424,
|
|
15
|
+
"trigger": "记账成功后、查询结果展示、错误提示、用户引导"
|
|
16
|
+
},
|
|
17
|
+
"api-reference": {
|
|
18
|
+
"path": "references/api-reference.md",
|
|
19
|
+
"description": "查询分析类工具API说明(记账工具已保密)",
|
|
20
|
+
"lines": 206,
|
|
21
|
+
"trigger": "查询统计、数据分析、导出数据"
|
|
22
|
+
},
|
|
23
|
+
"troubleshooting": {
|
|
24
|
+
"path": "references/troubleshooting.md",
|
|
25
|
+
"description": "故障排除指南,包含常见问题及解决方案",
|
|
26
|
+
"lines": 269,
|
|
27
|
+
"trigger": "授权失败、记账失败、查询异常"
|
|
28
|
+
},
|
|
29
|
+
"authentication": {
|
|
30
|
+
"path": "references/authentication.md",
|
|
31
|
+
"description": "授权流程详解,包含Token管理和安全实践",
|
|
32
|
+
"lines": 142,
|
|
33
|
+
"trigger": "首次授权、Token过期、安全设置"
|
|
34
|
+
},
|
|
35
|
+
"advanced-features": {
|
|
36
|
+
"path": "references/advanced-features.md",
|
|
37
|
+
"description": "高级功能详解,包含深度分析和智能洞察",
|
|
38
|
+
"lines": 146,
|
|
39
|
+
"trigger": "深度分析、数据导出、高级查询"
|
|
40
|
+
}
|
|
41
|
+
},
|
|
42
|
+
"stats": {
|
|
43
|
+
"total_lines": 1489,
|
|
44
|
+
"main_skill_lines": 273,
|
|
45
|
+
"references_lines": 1216,
|
|
46
|
+
"reference_count": 5
|
|
47
|
+
},
|
|
48
|
+
"dependencies": [],
|
|
49
|
+
"status": "production",
|
|
50
|
+
"features": [
|
|
51
|
+
"支出记账",
|
|
52
|
+
"收入记账",
|
|
53
|
+
"小票识别记账",
|
|
54
|
+
"消费记录查询",
|
|
55
|
+
"统计分析",
|
|
56
|
+
"智能洞察",
|
|
57
|
+
"数据导出"
|
|
58
|
+
]
|
|
59
|
+
}
|
package/bin/get-auth-code.js
CHANGED
|
@@ -54,7 +54,7 @@ async function getAuthCode() {
|
|
|
54
54
|
message: `请在"柴米AI记账"小程序中完成授权`,
|
|
55
55
|
steps: [
|
|
56
56
|
'打开"柴米AI记账"小程序',
|
|
57
|
-
'点击"我的" → "
|
|
57
|
+
'点击"我的" → "Agent 授权"',
|
|
58
58
|
`输入验证码:${qrData.userCode}`
|
|
59
59
|
]
|
|
60
60
|
}));
|
|
@@ -79,7 +79,7 @@ async function getAuthCode() {
|
|
|
79
79
|
message: `授权进行中,请使用验证码 ${authState.userCode} 完成授权`,
|
|
80
80
|
steps: [
|
|
81
81
|
'打开"柴米AI记账"小程序',
|
|
82
|
-
'点击"我的" → "
|
|
82
|
+
'点击"我的" → "Agent 授权"',
|
|
83
83
|
`输入验证码:${authState.userCode}`
|
|
84
84
|
]
|
|
85
85
|
}));
|