chaimi-keep-mcp 3.1.49 → 3.2.0

package/references/response-templates.md

@@ -0,0 +1,424 @@
+---
+name: "chaimi-keep-response-templates"
+description: 柴米AI记账详细回复模板库，包含完整情绪词库和场景模板
+version: "1.0.0"
+updated: "2026-04-25"
+---
+
+# 柴米AI记账回复模板库
+
+> 超级美学用户体验 - 详细模板与情绪词库
+
+---
+
+## 目录
+
+- [一、设计规范](#一设计规范)
+- [二、标准模板](#二标准模板)
+- [三、情绪词库](#三情绪词库)
+- [四、分类Emoji映射](#四分类emoji映射)
+- [五、排版检查清单](#五排版检查清单)
+
+---
+
+## 一、设计规范
+
+### 1.1 5层视觉结构
+
+```
+【第1层】✅ 成功标识
+【第2层】═══════════════════════════ 分隔强调
+【第3层】💰 核心数据（金额）
+【第4层】📦 详细信息（商品/分类/商家/时间）
+【第5层】━━━━━━━━━━━━━━━━━━━━━━━━━━ 品牌落款
+```
+
+### 1.2 分隔符使用规范
+
+| 场景 | 分隔符 | 长度 |
+|:-----|:-------|:-----|
+| 金额强调 | ═══════════════════════════ | 27字符 |
+| 底部品牌 | ━━━━━━━━━━━━━━━━━━━━━━━━━━ | 27字符 |
+| 视觉分隔 | ✦ ━━━━━━━ ✦ | 11字符 |
+
+### 1.3 Emoji使用规范
+
+| 位置 | Emoji | 含义 |
+|:-----|:------|:-----|
+| 成功标识 | ✅ | 操作成功 |
+| 金额 | 💰 | 核心数据 |
+| 商品 | 📦 | 物品 |
+| 分类 | 🏷️ | 标签分类 |
+| 商家 | 🏪 | 商店 |
+| 时间 | 🕐 | 时间 |
+| 祝福 | 🎉 | 庆祝 |
+| 警示 | ⚠️ | 需要关注 |
+
+---
+
+## 二、标准模板
+
+### 2.1 标准成功模板
+
+**适用场景：** 常规记账成功（默认）
+
+```markdown
+✅ 「{agentName}」已帮您记账成功
+═══════════════════════════
+💰 金额：¥{金额}
+═══════════════════════════
+
+📦 商品：{商品名}
+🏷️ 分类：{分类}
+🏪 商家：{商家}
+🕐 时间：{日期时间}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎉 {情绪祝福语}！
+   柴米AI记账
+   chaimi-keep-mcp v{版本号}
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**填充示例：**
+
+```markdown
+✅ 「你的小可爱」已帮您记账成功
+═══════════════════════════
+💰 金额：¥35.00
+═══════════════════════════
+
+📦 商品：午餐
+🏷️ 分类：餐饮
+🏪 商家：麦当劳
+🕐 时间：2026-04-24 12:30
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎉 祝您用餐愉快！
+   柴米AI记账
+   chaimi-keep-mcp v3.2.0
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### 2.2 极简模板
+
+**适用场景：** 连续记账、快速记录
+
+```markdown
+✅ 已记录：{商品名} ¥{金额} · {分类}
+   {情绪祝福语}
+```
+
+**填充示例：**
+
+```markdown
+✅ 已记录：午餐 ¥35 · 餐饮
+   祝您用餐愉快！
+```
+
+---
+
+### 2.3 高金额模板
+
+**适用场景：** 金额>1000元，需要强调确认
+
+```markdown
+⚠️ 大额消费确认
+═══════════════════════════
+💰 金额：¥{金额}
+📦 商品：{商品名}
+🕐 时间：{日期}
+
+✅ 已确认录入「柴米AI记账」
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+💡 {消费建议}
+   柴米AI记账
+   chaimi-keep-mcp v{版本号}
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**填充示例：**
+
+```markdown
+⚠️ 大额消费确认
+═══════════════════════════
+💰 金额：¥2999.00
+📦 商品：新手机
+🕐 时间：2026-04-24
+
+✅ 已确认录入「柴米AI记账」
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+💡 本月大额支出，建议关注预算余额
+   柴米AI记账
+   chaimi-keep-mcp v3.2.0
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### 2.4 收入记账模板
+
+**适用场景：** 收入记账成功
+
+```markdown
+✅ 「{agentName}」已帮您记录收入
+═══════════════════════════
+💰 金额：¥{金额}
+═══════════════════════════
+
+📦 来源：{收入来源}
+🏷️ 分类：{分类}
+🕐 时间：{日期时间}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎉 {收入祝福语}！
+   柴米AI记账
+   chaimi-keep-mcp v{版本号}
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+**填充示例：**
+
+```markdown
+✅ 「你的小可爱」已帮您记录收入
+═══════════════════════════
+💰 金额：¥5000.00
+═══════════════════════════
+
+📦 来源：工资
+🏷️ 分类：收入
+🕐 时间：2026-04-24 09:00
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+🎉 辛苦工作的回报，值得庆祝！
+   柴米AI记账
+   chaimi-keep-mcp v3.2.0
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### 2.5 查询结果模板
+
+**适用场景：** 查询消费记录返回
+
+```markdown
+📊 {查询周期}消费记录
+═══════════════════════════
+
+💰 总支出：¥{总金额}
+📈 笔数：{笔数}笔
+🎯 日均：¥{日均金额}
+
+TOP 3 消费：
+  1️⃣ {分类1}：¥{金额1}
+  2️⃣ {分类2}：¥{金额2}
+  3️⃣ {分类3}：¥{金额3}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+💡 {消费建议}
+   柴米AI记账
+   chaimi-keep-mcp v{版本号}
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### 2.6 智能洞察模板
+
+**适用场景：** AI消费分析结果
+
+```markdown
+💡 柴米AI消费洞察
+═══════════════════════════
+
+🎯 消费特征：
+   · 本周{分类}消费{次数}次
+   · 高频时段：{时间段}
+   · 常去商家：{商家1}、{商家2}
+
+✨ 优化建议：
+   {具体建议}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+💕 每一笔钱都值得被温柔记录
+   柴米AI记账
+   chaimi-keep-mcp v{版本号}
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### 2.7 错误提示模板
+
+**适用场景：** 记账失败、参数错误
+
+```markdown
+❌ 记账信息不完整
+═══════════════════════════
+
+需要补充以下信息：
+  · {缺失字段1}
+  · {缺失字段2}
+
+💡 提示：可以直接说"午餐35元"，我会自动识别~
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+✨ 再试一次吧
+   柴米AI记账
+   chaimi-keep-mcp v{版本号}
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+### 2.8 授权引导模板
+
+**适用场景：** 需要用户完成授权
+
+```markdown
+🔐 需要完成授权
+═══════════════════════════
+
+请在"柴米AI记账"小程序中完成授权：
+
+📱 验证码：{验证码}
+
+1️⃣ 打开微信小程序"柴米AI记账"
+2️⃣ 点击"我的" → "Agent 授权"
+3️⃣ 输入上方验证码
+4️⃣ 点击确认授权
+
+授权完成后告诉我，我将继续为您记账~
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+💕 期待为您服务 ✨
+   柴米AI记账
+   chaimi-keep-mcp v{版本号}
+━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+---
+
+## 三、情绪词库
+
+### 3.1 餐饮类
+
+| 场景 | 结束语 |
+|:-----|:-------|
+| 早餐 | 早安~ 开启元气满满的一天！☀️ |
+| 午餐 | 祝您用餐愉快！🍚 |
+| 晚餐 | 晚餐愉快，注意休息~ 🌙 |
+| 零食 | 偶尔犒劳一下自己也不错~ 😋 |
+| 外卖 | 即使再忙也要好好吃饭~ 💕 |
+| 聚餐 | 和朋友们吃得开心~ 🎉 |
+| 咖啡 | 一杯咖啡，活力满满~ ☕ |
+| 奶茶 | 甜蜜小确幸~ 🧋 |
+
+### 3.2 交通类
+
+| 场景 | 结束语 |
+|:-----|:-------|
+| 地铁 | 通勤辛苦啦，平安抵达~ 🚇 |
+| 打车 | 一路平安~ 🚗 |
+| 加油 | 出行顺利，注意安全~ ⛽ |
+| 停车 | 找到车位就是小确幸~ 🅿️ |
+| 公交 | 绿色出行，环保达人~ 🚌 |
+| 高铁 | 旅途愉快，一路顺风~ 🚄 |
+
+### 3.3 购物类
+
+| 场景 | 结束语 |
+|:-----|:-------|
+| 日用品 | 精明消费，品质生活~ ✨ |
+| 服装 | 买到心仪好物，心情美美哒~ 👗 |
+| 电子产品 | 新装备get，效率upup~ 💻 |
+| 超市 | 生活小确幸，从采购开始~ 🛒 |
+| 网购 | 快递即将送达，期待开箱~ 📦 |
+| 美妆 | 精致生活，从美丽开始~ 💄 |
+
+### 3.4 居住类
+
+| 场景 | 结束语 |
+|:-----|:-------|
+| 房租 | 温馨的港湾，值得投资~ 🏠 |
+| 水电 | 节约能源，绿色生活~ 💡 |
+| 物业 | 安心居住，服务贴心~ 🏢 |
+| 装修 | 打造温馨小家，累并快乐着~ 🔨 |
+| 家具 | 添置新物件，生活更美好~ 🛋️ |
+
+### 3.5 娱乐类
+
+| 场景 | 结束语 |
+|:-----|:-------|
+| 电影 | 享受光影时光，放松心情~ 🎬 |
+| 游戏 | 适度娱乐，快乐加倍~ 🎮 |
+| 旅游 | 诗和远方，都在脚下~ ✈️ |
+| 健身 | 投资健康，收获活力~ 💪 |
+| 书籍 | 知识投资，智慧增值~ 📚 |
+
+### 3.6 收入类
+
+| 场景 | 结束语 |
+|:-----|:-------|
+| 工资 | 辛苦工作的回报，值得庆祝~ 🎉 |
+| 奖金 | 越努力越幸运，继续加油~ 💪 |
+| 兼职 | 斜杠青年的额外收获~ ✨ |
+| 理财 | 让钱生钱，财务自由更进一步~ 📈 |
+| 红包 | 好运降临，喜气洋洋~ 🧧 |
+
+### 3.7 通用类
+
+| 情绪 | 结束语 |
+|:-----|:-------|
+| 鼓励 | 今天的你超棒的！👍 |
+| 温暖 | 记录美好生活，从每一笔开始~ 📝 |
+| 正能量 | 每一分钱都值得被温柔记录~ 💕 |
+| 轻松 | 记账完成！继续保持~ ✨ |
+| 感恩 | 感谢使用柴米记账~ 🙏 |
+| 期待 | 期待您的下一次记录~ 🌟 |
+
+---
+
+## 四、分类Emoji映射
+
+| 分类 | Emoji | 颜色暗示 | 结束语推荐 |
+|:-----|:------|:---------|:-----------|
+| 餐饮 | 🍚 | 暖橙色 | 祝您用餐愉快！ |
+| 交通 | 🚗 | 蓝色 | 一路平安~ |
+| 购物 | 🛍️ | 粉红色 | 精明消费，品质生活~ |
+| 娱乐 | 🎮 | 紫色 | 适度娱乐，快乐加倍~ |
+| 居住 | 🏠 | 棕色 | 温馨的港湾，值得投资~ |
+| 通讯 | 📱 | 蓝色 | 保持联系，沟通无障碍~ |
+| 医疗 | 💊 | 红色 | 健康第一，早日康复~ |
+| 教育 | 📚 | 绿色 | 知识投资，智慧增值~ |
+| 收入 | 💰 | 金色 | 辛苦工作的回报，值得庆祝~ |
+| 美妆 | 💄 | 粉色 | 精致生活，从美丽开始~ |
+| 宠物 | 🐾 | 橙色 | 毛孩子的快乐，无价~ |
+| 礼物 | 🎁 | 红色 | 心意满满，情谊珍贵~ |
+
+---
+
+## 五、排版检查清单
+
+每次生成回复时，确认以下事项：
+
+- [ ] ✅ 成功标识在顶部
+- [ ] ═══ 金额分隔线使用双横线（27字符）
+- [ ] 💰 金额带¥符号，保留两位小数
+- [ ] 📦🏷️🏪🕐 信息项使用对应Emoji
+- [ ] ━━━ 底部使用粗横线分隔（27字符）
+- [ ] 🎉 情绪祝福语带感叹号
+- [ ] 品牌落款居中对齐
+- [ ] 版本号格式：v3.2.0
+- [ ] 无多余空行
+- [ ] 无语法错误
+
+---
+
+**文档版本：v1.0.0**
+**最后更新：2026-04-25**

package/references/troubleshooting.md

@@ -0,0 +1,269 @@
+---
+name: "chaimi-keep-troubleshooting"
+description: 柴米AI记账故障排除指南，包含常见问题及解决方案
+version: "1.0.0"
+updated: "2026-04-25"
+---
+
+# 柴米AI记账故障排除指南
+
+---
+
+## 目录
+
+- [一、授权问题](#一授权问题)
+- [二、记账失败](#二记账失败)
+- [三、查询问题](#三查询问题)
+- [四、网络与连接](#四网络与连接)
+- [五、其他问题](#五其他问题)
+
+---
+
+## 一、授权问题
+
+### 1.1 未找到有效授权
+
+**现象：**
+```
+错误：未找到有效授权信息
+错误码：401 Unauthorized
+```
+
+**原因：**
+- 首次使用未完成授权
+- Token已过期
+- 授权被撤销
+
+**解决方案：**
+1. 运行 `./scripts/auth-flow.sh` 生成新验证码
+2. 在小程序中完成授权流程
+3. 重新尝试记账
+
+### 1.2 授权过期
+
+**现象：**
+```
+错误：Token已过期
+错误码：401 Token Expired
+```
+
+**原因：**
+- Token有效期24小时
+- 超过有效期未使用
+
+**解决方案：**
+1. 运行 `./scripts/check-auth.sh` 检查状态
+2. 如已过期，运行 `./scripts/auth-flow.sh` 重新授权
+3. 或使用 `./scripts/revoke-auth.sh` 清除后重新授权
+
+### 1.3 验证码错误
+
+**现象：**
+```
+错误：验证码无效或已过期
+```
+
+**原因：**
+- 验证码输入错误
+- 验证码超过5分钟有效期
+
+**解决方案：**
+1. 重新生成验证码：`./scripts/auth-flow.sh`
+2. 在5分钟内在小程序中输入
+3. 注意区分大小写
+
+---
+
+## 二、记账失败
+
+### 2.1 无法识别分类
+
+**现象：**
+```
+错误：无法识别消费分类
+```
+
+**原因：**
+- 商品名称过于模糊
+- 新分类不在系统中
+
+**解决方案：**
+1. 明确指定分类："午餐35元餐饮"
+2. 使用更具体的商品名："麦当劳午餐"而非"吃的"
+3. 查看支持的分类列表：调用 `get_text_parse_prompt`
+
+### 2.2 金额识别失败
+
+**现象：**
+```
+错误：无法识别金额
+```
+
+**原因：**
+- 金额格式不规范
+- 文字与数字混杂
+
+**解决方案：**
+1. 使用标准格式："35元"、"¥35"、"35"
+2. 避免："三十五块"、"35块多"
+3. 明确说出金额和商品："午餐35元"
+
+### 2.3 小票识别失败
+
+**现象：**
+```
+错误：小票识别失败
+错误码：OCR_FAILED
+```
+
+**原因：**
+- 图片模糊
+- 小票格式不支持
+- 光线太暗
+
+**解决方案：**
+1. 确保图片清晰，文字可辨认
+2. 调整光线，避免反光
+3. 尝试手动输入关键信息
+4. 查看支持的小票类型：调用 `get_parse_prompt`
+
+---
+
+## 三、查询问题
+
+### 3.1 查询无结果
+
+**现象：**
+```
+结果：未找到消费记录
+```
+
+**原因：**
+- 时间范围选择错误
+- 确实没有记录
+- 数据同步延迟
+
+**解决方案：**
+1. 检查时间范围是否正确
+2. 尝试扩大查询范围
+3. 等待1-2分钟后重试（同步延迟）
+4. 确认记账是否成功
+
+### 3.2 统计数据异常
+
+**现象：**
+```
+统计数据与预期不符
+```
+
+**原因：**
+- 包含未入账记录
+- 时间范围计算错误
+- 分类统计口径不同
+
+**解决方案：**
+1. 检查是否包含"待确认"记录
+2. 确认时间范围的起止时间
+3. 查看详细记录列表核对
+4. 使用 `export_data` 导出完整数据核对
+
+---
+
+## 四、网络与连接
+
+### 4.1 请求超时
+
+**现象：**
+```
+错误：请求超时
+错误码：408 Request Timeout
+```
+
+**原因：**
+- 网络连接不稳定
+- 服务器响应慢
+- 请求数据量过大
+
+**解决方案：**
+1. 检查网络连接
+2. 稍后重试
+3. 减少查询时间范围
+4. 使用 `./scripts/verify-setup.sh` 测试连接
+
+### 4.2 服务器错误
+
+**现象：**
+```
+错误：服务器内部错误
+错误码：500 Internal Server Error
+```
+
+**原因：**
+- 服务器维护
+- 数据库连接问题
+- 代码异常
+
+**解决方案：**
+1. 等待几分钟后重试
+2. 检查柴米记账官方公告
+3. 提交反馈：调用 `submit_feedback`
+
+---
+
+## 五、其他问题
+
+### 5.1 如何更新Skill
+
+**场景：** 获取最新Skill文档
+
+**解决方案：**
+```bash
+# 方式1：调用工具
+调用 get_skill 工具
+
+# 方式2：查看本地文件
+cat /mcp-server-local/SKILL.md
+
+# 方式3：查看详细模板
+cat /mcp-server-local/references/response-templates.md
+```
+
+### 5.2 如何提交反馈
+
+**场景：** 遇到问题需要反馈
+
+**解决方案：**
+1. 调用 `submit_feedback` 工具
+2. 描述问题现象和复现步骤
+3. 提供错误码和时间
+
+### 5.3 紧急处理流程
+
+**场景：** 记账数据异常，需要紧急处理
+
+**步骤：**
+1. 停止记账操作
+2. 检查云函数日志
+3. 联系技术支持
+4. 备份现有数据
+
+---
+
+## 快速诊断命令
+
+```bash
+# 检查授权状态
+./scripts/check-auth.sh
+
+# 验证安装完整性
+./scripts/verify-setup.sh
+
+# 测试记账连接
+curl -X POST $MCP_URL -H "Content-Type: application/json" \
+  -d '{"action":"get_skill"}'
+```
+
+---
+
+**文档版本：v1.0.0**
+**最后更新：2026-04-25**

package/server.js

@@ -486,6 +486,9 @@ async function getToken() {
             tokenExpireTime = token.expiresAt;
             authState.isAuthorized = true;
             await oauthManager.tokenStorage.save(token);
+            // 【新增】保存默认 Agent 名称和 deviceCode
+            await oauthManager.tokenStorage.saveAgentName('柴米AI助手');
+            await oauthManager.tokenStorage.saveDeviceCode(savedAuthState.deviceCode);
             await oauthManager.clearAuthState();
             console.error('✅ 授权成功！可以继续使用记账功能');
             // 返回特殊标记，让上层知道这是刚完成授权的情况