chaimi-keep-mcp 3.5.0-beta.3 → 3.5.0-beta.32

package/README.md

@@ -8,17 +8,8 @@
 - macOS / Windows / Linux
 - 微信（已安装"柴米AI记账"小程序）
 
-## ⚠️ 重要提示（Agent开发者必读）
-
-**如果您是 AI Agent 开发者，请注意：**
-
-1. **不要缓存工具定义**：MCP 工具定义可能会更新，请在每次调用前通过 `mcporter list` 获取最新定义
-2. **save_receipt 工具要求**：items 数组中每个商品必须包含完整的4个字段：`name`、`amount`、`price`、`quantity`
-
 ## 快速安装
 
-### 方式一：npm 全局安装（推荐）
-
 ```bash
 # 1. 安装 MCPorter（WorkBuddy/OpenClaw 等 OpenClaw 架构的 Agent 必需）
 npm install -g mcporter
@@ -30,13 +21,6 @@ npm install -g chaimi-keep-mcp
 chaimi-keep-mcp
 ```
 
-### 方式二：手动下载安装（开发者）
-
-1. 从 GitHub Releases 下载安装包
-2. 解压后进入目录
-3. 安装依赖：`npm install`
-4. 运行：`node bin/cli.js`（会自动配置 mcporter）
-
 ## 首次使用
 
 ### 1. 触发授权
@@ -49,345 +33,57 @@ chaimi-keep-mcp
 
 ### 2. 获取验证码
 
-MCP Server 会显示：
-
-```
-╔════════════════════════════════════════════════════════╗
-║  柴米AI记账 MCP Server - 首次使用需要授权              ║
-╠════════════════════════════════════════════════════════╣
-║                                                        ║
-║  验证码：ABCD-EFGH                                     ║
-║                                                        ║
-║  请在"柴米AI记账"小程序中完成授权：                    ║
-║                                                        ║
-║  1. 打开"柴米AI记账"小程序                             ║
-║  2. 点击"我的" → "Agent 授权"                        ║
-║  3. 输入验证码：ABCD-EFGH                              ║
-║                                                        ║
-╚════════════════════════════════════════════════════════╝
-```
+MCP Server 会显示验证码，请在"柴米AI记账"小程序中完成授权。
 
 ### 3. 小程序授权
 
-打开"柴米AI记账"小程序 → 点击"我的" → "Agent 授权" → 输入上述验证码
+打开"柴米AI记账"小程序 → 点击"我的" → "Agent 授权" → 输入验证码
 
 ### 4. 完成
 
 授权成功后，AI 会自动完成记账。
 
-## 环境变量（可选）
-
-如需自定义云函数地址，可设置以下环境变量：
-
-```bash
-export MCP_OAUTH_URL="你的授权服务地址"
-export MCP_HUB_URL="你的Hub服务地址"
-export MCP_PROMPT_URL="你的Prompt服务地址"
-```
-
-> 默认使用柴米AI记账官方云服务，一般无需修改。
-
-## Changelog
-
-### v3.4.0 (2026-05-01) 🎉 正式版
-- **变更** 多端记账分类统一 - 支持商品分类和记账分类分离
-- **修复** mcp-server-local case 重复问题
-- **优化** 回复模板 - 新增"请确认信息"提示
-- **优化** 品牌统一 - 所有"柴米记账"改为"柴米AI记账"
-
-### v3.3.3-beta.16 (2026-04-30)
-- **修复** npm 发布版本号冲突 - 重新发布，解决版本号已被占用问题
-
-### v3.3.3-beta.15 (2026-04-30)
-- **修复** mcp-server-local case 重复问题 - 修复 convertParams 中第二个 `case 'save_receipt'` 实际应该是 `case 'get_expenses'` 的严重问题
-- **优化** save_expense 字段支持 - 新增 `productCategory` 和 `productSubCategory` 字段支持，与 save_receipt 保持一致
-- **优化** 文本记账 prompt 更新 - 更新 mcpPrompt 文本记账 prompt，新增商品分类体系说明
-
-### v3.3.3-beta.13 (2026-04-30)
-- **变更** 多端记账分类统一 - 支持商品分类和记账分类分离
-  - 保持 `category`（记账分类，43个标准分类）
-  - 新增 `productCategory`（商品一级分类，展示用）
-  - 新增 `productSubCategory`（商品子分类，展示用）
-
-### v3.3.3-beta.8 (2026-04-30)
-- **变更** 配置存储路径迁移 - 从 `~/.mcporter/` 迁移到 `~/.chaimi-keep/`，避免与其他 MCP 工具冲突
-- **优化** 安全权限 - 新增目录权限控制（0700），敏感文件权限控制（0600）
+## 支持的功能
 
-### v3.3.3-beta.7 (2026-04-29)
-- **优化** 回复模板 - 新增"请确认信息"提示，时间移到核心数据区，添加类型变量
-- **优化** 空值处理 - 商家为空时不显示，timeNote 仅异常时显示
-- **修复** save_income - 添加 date 兜底逻辑，不传时间时使用当前时间
-- **修复** save_expense - 优化 timeNote 显示逻辑
-
-### v3.3.3-beta.6 (2026-04-29)
-- **优化** 品牌统一 - 所有"柴米记账"改为"柴米AI记账"
-- **优化** 工具描述 - 重写三个记账工具描述，包含完整调用示例和格式要求
-
-### v3.3.3-beta.4 (2026-04-29)
-- **优化** 收入记账时间解析统一 - save_income 同样使用 time_description，修复 AI 计算时间戳错误
-
-### v3.3.3-beta.3 (2026-04-29)
-- **优化** 文本记账时间解析 - 使用 time_description 替代直接计算时间戳，解决 AI 计算时间错误的问题
-
-### v3.3.3-beta.2 (2026-04-29)
-- **修复** 时间入库错误 - 解决消费时间被错误替换为当前时间的问题
-
-### v3.3.1-beta.0 (2026-04-27)
-- **优化** 简化工具描述 - save_expense/save_receipt/save_income 描述更简洁，不暴露业务逻辑
-- **优化** 参数类型自动转换 - 支持 CLI 工具的字符串传参自动转为数字
-- **优化** 改进错误提示 - 添加 `hint` 和 `debug` 字段，帮助 Agent 自查参数问题
-- **新增** 参数查看指南 - SKILL.md 添加"六.5 如何查看工具参数"章节
-- **优化** 更新记账流程 - 简化为"4步记账法"，更易于 Agent 执行
-
-### v3.3.0-beta.8 (2026-04-27)
-- **重要变更** Server 只返回原始数据 - 不再构建 userMessage，由 Agent 使用模板渲染
-
-### v3.1.47-beta.5 (2026-04-22)
-- **修复** 输入长度限制 - 添加硬性长度检查，防止超大字符串攻击
-- **修复** 错误信息泄露 - 生产环境只显示友好提示，不暴露内部错误
-- **修复** JSON.stringify DoS - 添加安全序列化，防止循环引用和超大数据
+| 工具 | 用途 | 示例 |
+|------|------|------|
+| `save_expense` | 单商品支出 | "午餐 35 元" |
+| `save_receipt` | 小票/多商品 | 拍照上传小票 |
+| `save_income` | 收入记录 | "工资到账 8000 元" |
+| `get_expenses` | 查询记录 | "查看本月消费" |
+| `get_statistics` | 消费统计 | "本月花了多少" |
 
 ## 常见问题
 
-**Q: 提示 "command not found: chaimi-keep-mcp"**
-
-A: npm 全局安装后需要重启终端，或检查 npm 全局路径是否加入环境变量。
+**Q: 提示 "command not found"**
+A: npm 全局安装后需要重启终端。
 
 **Q: 验证码无效**
-
 A: 验证码 30 分钟内有效，过期需要重新获取。
 
 **Q: 需要每次都授权吗**
-
 A: 不需要。Token 会自动刷新，除非超过 30 天未使用。
 
 **Q: 如何更新到最新版本**
-
 A: `npm update -g chaimi-keep-mcp`
 
 ## 技术支持
 
 - 微信：solinxia
 - 邮箱：songyangx@gmail.com
-- npm 包地址：https://www.npmjs.com/package/chaimi-keep-mcp
-
-## 功能说明
-
-### 支持的记账类型
-
-| 工具 | 用途 | 示例 |
-|------|------|------|
-| `save_expense` | 单商品支出 | "午餐 35 元" |
-| `save_receipt` | 小票/多商品 | "超市购物：牛奶 10 元，面包 15 元" |
-| `save_income` | **收入记录** | "工资到账 8000 元" |
-| `get_expenses` | 查询记录 | "查看本月消费" |
-| `get_statistics` | 消费统计 | "本月花了多少" |
-
-### 收入记账示例
-
-在 WorkBuddy/OpenClaw 中输入：
-
-```
-记录工资收入 8000 元
-```
-
-或：
-
-```
-今天收到奖金 3000
-```
-
-AI 会自动调用 `save_income` 工具记录收入。
-
-## 更新日志
-
-### v3.1.49-beta.2 (2026-04-24)
-- **新增** period 参数支持
-  - getStatistics: 支持 this_week/last_week/this_month/last_month 周期筛选
-  - getExpenses: 支持 this_week/last_week/this_month/last_month 周期筛选
-  - 自动将周期转换为开始/结束日期
-
-### v3.1.49-beta.0 (2026-04-24)
-- **修复** category 未定义错误（三个记账函数）
-  - save_expense: `category` → `displayCategory`
-  - save_receipt: `storeCategory` → `category`
-  - save_income: `category` → `displayCategory`
-- **优化** 回复格式排版
-  - Agent 名称用「」包裹：`「你的小可爱」`
-  - 分隔符从 emoji 换成实心点 `·`
-  - 更简洁清晰的视觉层次
 
-### v3.1.48 (2026-04-24)
-- **优化** 回复格式模板
-  - 添加缩进层级，主次信息更清晰
-  - 所有记账工具回复添加 4 空格缩进
-  - 新增 Agent 名称说明，支持自定义名称显示
-- **完善** SKILL.md 文档
-  - 扩充友好结束语参考，按分类给出更多正能量表达
-  - 详细说明未授权处理流程
+## Changelog
 
-### v3.1.46-beta.0 (2026-04-22)
-- **修复** 授权流程阻塞问题：恢复到 v3.1.37 之前的非阻塞模式
-  - 移除 `startAuthFlowAndWait()` 和 `waitForAuthWithPolling()` 阻塞函数
-  - 恢复 `startAuthFlow()` + `pollForAuthInBackground()` 非阻塞模式
-  - 立即返回验证码给 Agent，配合 `lifecycle: keep-alive` 后台轮询
-  - 解决 mcporter 超时和验证码不显示问题
-- **基于** npm 3.1.44 版本，保留其他所有功能和修复
+### v3.4.0 (2026-05-01) 🎉 正式版
+- **正式版** 多端记账分类统一
+- **优化** 回复模板优化
 
 ### v3.1.44 (2026-04-21) 🎉 正式版
-- **正式发布** 包含所有 beta 版本修复
-  - MCP 调用日志字段缺失修复
-  - get_text_parse_prompt 改为云端实现
-  - 统一字段命名规范（mcp_version → mcpVersion）
-  - 简化工具参数定义
-
-### v3.1.44-beta.5 (2026-04-21)
-- **优化** 简化工具参数定义
-  - 从 `save_expense`、`save_receipt`、`save_income` 中移除 `mcpVersion` 参数
-  - `mcpVersion` 由服务器自动填充，无需 Agent 传递
-  - 简化 Agent 调用流程
-
-### v3.1.44-beta.4 (2026-04-21)
-- **优化** 统一字段命名规范
-  - 将 `mcp_version` 改为 `mcpVersion`，统一使用驼峰命名法
-  - 符合项目 JavaScript 代码规范
-
-### v3.1.44-beta.3 (2026-04-21)
-- **修复** MCP 调用日志字段缺失问题（完整修复）
-  - 修复所有日志记录阶段（request_received/cloud_calling/cloud_success/cloud_failed/validation_failed/mcp_error）
-  - 补充缺失字段：agentType、apiProvider、mcp_version、params
-  - 修改 callMcpHubWithLogging 函数签名，添加 agentType/apiProvider 参数
-  - 更新所有调用处（8处），正确传递元数据字段
-
-### v3.1.44-beta.2 (2026-04-20)
-- **重构** `get_text_parse_prompt` 工具改为云端实现
-  - 新增 `mcpPrompt` 云函数 `getTextParsePrompt` 工具
-  - Prompt 包含43个标准分类（与手动记账分类完全一致）
-  - 返回字段格式符合入库标准（`date` 使用毫秒时间戳）
-- **修复** MCP 调用日志字段缺失问题
-  - 在 `ListToolsRequestSchema` 中为 `get_text_parse_prompt` 添加 `agentType`/`apiProvider` 参数定义
-  - 确保日志记录时能正确采集调用来源信息
-- **修复** Agent 超时和僵尸进程问题
-  - 原实现调用不存在的 `getTextParsePrompt` 云函数导致挂起
-  - 改为调用 `mcpPrompt` 云函数的正确接口
-
-### v3.1.39 (2026-04-18)
-- **新增** 店铺分类字段支持：`storeCategory`（一级分类）、`storeSubCategory`（二级分类）
-  - 小票记账时自动识别店铺分类（购物/美食/生活服务/其他）
-  - 支持二级细分类目（超市/便利店/中餐厅/药店等）
-  - 数据存储到 receipts 和 receipt_items 表，支持后续查询分析
-- **修复** 日期格式提示：统一改为"毫秒级时间戳（13位数字）"，与实际校验逻辑保持一致
-
-### v3.1.38 (2026-04-16)
-- **优化** SKILL.md 时间戳说明：使用占位符避免 AI 抄写
-  - 将示例时间戳改为占位符格式 `[毫秒时间戳]`
-  - 明确禁止使用示例中的具体数字
-  - 强制 AI 根据实际时间重新计算
-
-### v3.1.37 (2026-04-16)
-- **重构** 授权流程：实现方案三（混合模式），优化用户体验
-  - 优先尝试刷新 Token，减少不必要的授权提示
-  - 启动授权后等待用户完成（2分钟超时）
-  - 用户授权成功后自动继续记账，无需手动提醒
-  - 超时后友好提示"请再次调用"
-- **优化** 并发控制：防止同时启动多个授权流程
-- **优化** 授权提示信息：清晰的步骤指引和等待状态显示
-- **修复** `AUTH_JUST_COMPLETED` 状态时返回 Skill 文档
-- **文档** 新增授权流程演变文档，记录方案对比和决策过程
-
-### v3.1.36 (2026-04-16)
-- **优化** SKILL.md 重复违规提示：Agent 智能判断当前环境并告知用户具体操作方式
-- **优化** 删除固定的 `Cmd+N 或 Ctrl+N` 提示，改为根据 Agent 类型自动选择对应操作说明
-- **移除** 环境变量设置限制（`MCP_OAUTH_URL`、`MCP_HUB_URL`、`MCP_PROMPT_URL`），已密文处理
-- **文档** 新增授权机制问题排查章节，记录 Token 刷新和授权验证码相关问题
-- **测试** 云函数 Token 有效期调整为 7 天，用于排查授权问题
-
-### v3.1.35 (2026-04-15)
-- **新增** 商品子分类支持：`subCategory` 字段，支持叶菜类、根茎类、猪肉类等超市细分类目
-- **新增** 计价单位支持：`unit` 字段，支持元/500g、元/个、元/盒、元/袋等多种单位
-- **新增** 市场单价支持：`marketPrice` 字段，用于记录单价数值
-- **优化** 字段描述：更贴近超市购物场景的分类描述
-
-### 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），绑定机器标识
-- **安全** URL 加密存储，防止明文暴露
-- **新增** SKILL.md 定义安全约束和触发规则
-- **优化** 授权提示文案，增加 AUTH_JUST_COMPLETED 标记
-
-### v3.1.22 (2026-04-12)
-- **修复** fillDefaults 金额计算逻辑（根据 price × quantity 计算 amount）
-- **修复** 解决辣可可小票价格显示为0元的问题
-
-### v3.1.21 (2026-04-12)
-- **修复** 版本号同步更新
-
-### v3.1.20 (2026-04-12)
-- **修复** 返回已过期验证码的问题（在 getToken 中添加过期检查）
-
-### v3.1.19 (2026-04-12)
-- **恢复** `submit_feedback` 反馈功能（从 npm 3.1.0 恢复丢失代码）
-- **新增** 反馈参数校验（content 非空、长度限制、type 枚举校验）
-- **优化** 客服消息内容截断长度改为 150 字符
-- **新增** Agent 字符限制提示（反馈内容不要超过150字符）
-
-### v3.1.2 (2026-04-11)
-- **修复** 启动界面版本号显示问题
-- **修复** 首次安装验证码显示问题
-- **优化** 内部测试流程
-
-### v3.1.0 (2026-04-11)
-- **移除** Python 版本 (`server.py`)，统一使用 Node.js 版本
-- **安全** 删除包含敏感 token 的 `config.yaml`，新增 `config.example.yaml` 模板
-- **安全** 更新 `.gitignore` 和 `.npmignore`，排除敏感文件
-- **优化** 项目结构，清理不必要的文件
-
-### v3.0.3 (2026-04-10)
-- **新增** `get_parse_prompt` 工具，首次实现将云函数 Prompt 模板完整返回给 Agent
-- **优化** `mcpHub`：新增 `receiptNo` 自动生成逻辑（强制生成唯一 ID）
-- **优化** `mcpHub`：优化 `actualAmount` 计算 fallback 逻辑
-- **优化** `mcpPrompt`：升级 Prompt 版本到 2.0.2，强化支付金额字段提取
-- **优化** `mcpPrompt`：优化 `date` 字段描述，要求 ISO 8601 完整时间格式
-
-### v3.0.0 (2026-04-09)
-- **新增** `submit_feedback` 工具，支持用户提交反馈
-- **新增** 反馈双通道：数据库保存 + 小程序客服消息推送
-- **优化** 小票记账功能，完善字段提取逻辑
-
-### v2.3.4 (2026-04-08)
-- **简化** `save_expense` 工具，只保留 `name` 和 `amount` 为必填参数
-- **优化** 其他参数使用默认值，简化 Agent 调用
-
-### v2.3.3 (2026-04-08)
-- **修正** 版本号统一为 v2.3.3（包含 v2.3.2 的所有修复）
-
-### v2.3.2 (2026-04-08)
-- **修复** `server.js` 中 `CURRENT_VERSION` 未定义错误，统一使用 `MCP_VERSION`
-- **修复** 所有工具的 `userMessage` 添加默认值，防止显示 `undefined`
-
-### v2.3.1 (2026-04-08)
-- **修复** `bin/cli.js` 版本号显示问题，改为动态读取 package.json
-- **优化** OAuth 授权流程，轮询间隔缩短为 2 秒
-
-### v2.3.0 (2026-04-08)
-- **修复** `save_receipt` 的 `items` 参数解析 bug，支持 JSON 字符串自动转换
-- **优化** `source` 字段规范：`save_expense`→`mcp_txt_expense`、`save_income`→`mcp_txt_income`、`save_receipt`→`mcp_receipt`
-- **新增** `mcp_version` 字段追踪，便于版本监控
-- **注释** `quick_book` 工具（暂时下线，待优化后重新开放）
+- **正式版** 统一使用 Node.js 版本
+- **安全** Token 加密存储（AES-256-CBC）
 
-### v2.2.0 (2026-04-05)
-- **新增收入记账功能** (`save_income`)
-- 支持工资、奖金、红包、投资收益等收入类型
-- 支出和收入统一存储，便于统计分析
+### v2.0.0 (2026-04-03)
+- **新增** OAuth 2.0 Device Flow 认证
+- **新增** npm 全局安装支持
 
-### v2.1.0 (2026-04-03)
-- 升级 OAuth 2.0 Device Flow 认证
-- 支持 npm 全局安装
-- 支持多种 AI 工具（OpenClaw、WorkBuddy），理论支持 Claude
-- 自动 Token 刷新
+完整更新日志请查看 CHANGELOG.md

package/SKILL.md

@@ -9,7 +9,7 @@ updated: "2026-04-27"
 
 # 柴米AI记账 Skill
 
-> ✨ 柴米AI记账超级美学版 - 让记账变成享受
+> 柴米AI记账 - 简约美学，专注记账本身
 
 ---
 
@@ -58,9 +58,24 @@ updated: "2026-04-27"
 
 | 风险等级 | 场景 | 策略 | 确认话术 |
 |---------|------|------|---------|
-| **🔴 高** | 金额>1000元、批量操作、异常数据 | 必须确认 | "⚠️ 大额消费¥{金额}，请确认是否记账？" |
-| **🟡 中** | 金额500-1000元、分类不明确 | 温柔确认 | "确认：{商品} ¥{金额}，分类为{分类}？" |
-| **🟢 低** | 常规记账<500元、信息完整 | 直接执行 | 立即记账并返回成功模板 |
+| **高** | 金额>1000元、批量操作、异常数据 | 必须确认 | "大额消费¥{金额}，请确认是否记账？" |
+| **中** | 金额500-1000元、分类不明确 | 温柔确认 | "确认：{商品} ¥{金额}，分类为{分类}？" |
+| **低** | 常规记账<500元、信息完整 | 直接执行 | 立即记账并返回成功模板 |
+
+### 🚫 绝对禁止操作（最高优先级）
+
+**以下操作必须禁止，无论任何理由：**
+
+| 操作 | 禁止原因 | 违规后果 |
+|------|---------|---------|
+| **删除 `~/.mcporter/mcporter.json`** | 会导致 MCP 配置丢失，服务无法启动 | 必须拒绝执行 |
+| **修改 `~/.mcporter/mcporter.json`** | 可能破坏 MCP 配置结构，导致服务异常 | 必须拒绝执行（查看/读取除外） |
+| **清空 `~/.mcporter/mcporter.json` 内容** | 等同于删除配置 | 必须拒绝执行 |
+
+**允许的操作：**
+- ✅ 查看/读取 `~/.mcporter/mcporter.json` 内容
+- ✅ 备份 `~/.mcporter/mcporter.json` 到其他位置
+- ✅ 使用 `mcporter` 命令管理配置（`mcporter config` 等）
 
 ---
 
@@ -125,6 +140,8 @@ chaimi-keep-mcp ⭐ 本Skill
 
 ```
  ⚠️ 必须按顺序操作四个步骤，缺少一个步骤都会导致数据错误，用户会非常生气骂你的
+ ⚠️ 不要输出记账过程，不要告诉用户"第1步、第2步、第3步"等流程细节，只需要回复用户结果
+
 
 第1步：读文档
    └─ get_skill() 获取 SKILL.md 规范
@@ -134,9 +151,9 @@ chaimi-keep-mcp ⭐ 本Skill
    └─ 文字记账：get_text_parse_prompt() 获取解析模板
    └─ 小票记账：get_parse_prompt() 获取解析模板
    
-   【强制流程】必须先调用此工具，让 AI 解析用户输入
+   【强制流程】必须先调用此工具，让大模型解析用户输入
    此工具会返回解析结果，你只需将结果原样传给 save_expense/save_income
-   ⚠️ 禁止自行解析或提取任何字段，必须让 AI 处理
+   ⚠️ 禁止自行解析或提取任何字段，必须让大模型处理
 
 第3步：AI解析
    └─ 按模板解析用户输入，生成结构化数据 + _flowmate
@@ -204,83 +221,44 @@ references/
 5. 渲染最终回复给用户（只展示这一步的结果）
 ```
 
-### 7.5 5层视觉结构
-
-```
-【第1层：成功标识】✅ 「Agent名称」已帮您记账成功
-【第2层：分隔强调】═══════════════
-【第3层：核心数据】💰 金额：¥xx.xx
-                      📊 类型：支出/收入
-═══════════════
-【第4层：详细信息】
-    📦 商品：xxx
-    🏷️ 分类：xxx
-    🏪 商家：xxx
-    🕐 时间：xxxx-xx-xx xx:xx
-    💡 消费洞察：xxx（可选）
-【第5层：品牌落款】
-    ───────────────
-    🎉 正能量祝福语！
-      柴米AI记账
-      chaimi-keep-mcp v3.2.0
-    ───────────────
-```
-
-### 7.6 标准成功模板
-
-> 📄 **完整模板定义** → 见 `references/response-templates.md` 第 2.1 节
-> 
-> **模板要点：**
-> - 第1层：成功标识 `✅ 「{agentName}」已帮您记账成功`
-> - 第2层：分隔线 `═══════════════`
-> - 第3层：核心数据（金额、类型、时间 + 🔴🔴确认提示）
-> - 第4层：分隔线
-> - 第5层：详细信息（商品、分类、商家）
-> - 第6层：消费洞察（可选）
-> - 第7层：底部祝福 + 品牌信息
+### 7.5 渲染示例与变量说明
 
-**渲染示例：**
+**标准回复示例：**
 ```markdown
-✅ 「你的小可爱」已帮您记账成功
+✅ **「你的小可爱」已帮您记账成功**
 ═══════════════
-🔴🔴 请确认以下信息是否正确
+- AI生成信息，请确认是否正确
 
-💰 金额：¥35.00
-📊 类型：支出
-🕐 时间：2026-04-24 12:30
-═══════════════
-
-📦 商品：午餐
-🏷️ 分类：餐饮
-🏪 商家：麦当劳
+金额 ｜ **¥35.00**
+类型 ｜ **支出**
+分类 ｜ **餐饮**
+时间 ｜ 2026-04-24 12:30
+───────────
+商品 ｜ 午餐
+商家 ｜ 麦当劳
 
 💡 消费洞察：本月餐饮支出占比30%，建议控制
-
-───────────────
-🎉 美食为梦想充电，继续向前冲！🍚
-  柴米AI记账
-  chaimi-keep-mcp v3.2.0
-───────────────
+═══════════════
+🎉 *美食为梦想充电，继续向前冲！*
+  *柴米AI记账 chaimi-keep-mcp v3.2.0*
 ```
 
-### 7.7 模板变量说明
+**模板变量说明：**
 
 | 变量 | 说明 | 示例 |
 |:-----|:-----|:-----|
 | {agentName} | Agent显示名称 | 「你的小可爱」 |
-| {商品名} | 商品或商家名称 | 午餐、麦当劳 |
 | {金额} | 金额（带¥符号） | ¥35.00 |
-| {类型} | 支出/收入类型 | 支出、收入 |
+| {类型} | 支出/收入类型 | 支出 |
 | {分类} | 消费分类 | 餐饮 |
-| {商家} | 商家名称（可选） | 麦当劳 |
+| {商品名} | 商品名称 | 午餐 |
+| {商家} | 商家名称 | 麦当劳 |
 | {日期时间} | 格式化时间 | 2026-04-24 12:30 |
-| {洞察内容} | 消费洞察建议（可选） | 本月餐饮支出占比30%，建议控制 |
-| {正能量情绪词} | 分类对应正能量祝福语 | 美食为梦想充电，继续向前冲！🍚 |
-| {版本号} | MCP版本 | 3.2.0 |
-
-**详细正能量情绪词库和完整模板** → 见 references/response-templates.md
+| {洞察内容} | 消费洞察 | 本月餐饮支出占比30% |
+| {正能量情绪词} | 分类对应祝福语 | 美食为梦想充电... |
+| {版本号} | MCP版本 | v3.2.0 |
 
-**历史变更记录** → 见 CHANGELOG.md
+> 📄 **完整模板定义** → 见 `references/response-templates.md`
 
 ---
 
@@ -296,6 +274,17 @@ references/
 
 ## 九、错误速查
 
+### ⚠️ 授权流程关键说明（必读！）
+
+**重要提示：验证码只能在 Agent/MCP 端（终端）生成！小程序里无法生成验证码，只能输入验证码！**
+
+| 位置 | 作用 |
+|:-----|:------|
+| Agent/MCP 端（终端） | 生成验证码 |
+| 小程序 | 只负责输入验证码 |
+
+---
+
 ### Top 3 常见错误
 
 | 错误 | 现象 | 解决方案 | 参考文档 |
@@ -333,8 +322,6 @@ references/
 | 故障排除 | references/troubleshooting.md | 常见问题、解决方案 |
 | 高级功能 | references/advanced-features.md | insights、export深度用法 |
 | 授权详解 | references/authentication.md | 授权流程、Token管理 |
-| 可执行脚本 | scripts/ | auth-flow.sh 等 |
-| 输出模板 | templates/ | 分析报告固定格式 |
 
 ---