01系统概述与配置全景图
OimiChat 是一套深度集成微信生态的智能 AI 伴侣系统。为了降低管理和配置的门槛，系统提供了一个可视化的网页控制台（Console），将 AI 模型选择、记忆管理、语音通话、外卖下单、主动关怀等核心板块无缝融合。管理员与运营者只需在后台正确填入接口 Token 与配置值，即可在几分钟内让企微/微信机器人具备全方位的智能化交互能力。
| 功能模块 | 功能简介与核心效果 | 配置难度 | 推荐度 |
|---|---|---|---|
| 1. AI 模型 | 支持 DeepSeek、Gemini、豆包等，控制 API 密钥与角色人设 | 简单 | ★★★★★ |
| 2. 刻忆·记忆 | 提取和沉淀用户的瞬时对话和长期记忆，打上个性化标签 | 简单 | ★★★★★ |
| 3. 语音消息 | 支持微信语音消息双向识别与人声合成，让 AI 开口说话 | 中等 | ★★★★★ |
| 4. 邮件来信 | AI 根据羁绊度在后台悄悄向用户的注册邮箱发送深情邮件 | 简单 | ★★★★ |
| 5. 暮记日记 | 晚间引导用户撰写日记，生成专属的情感梳理和周报分析 | 简单 | ★★★★ |
| 6. 情绪表情包 | AI 回复时判断其情绪，精准匹配并发送精美可爱的表情 | 简单 | ★★★★★ |
| 7. 外卖点餐 | 重点难点。基于 MCP 协议，支持微信一键下单瑞幸/麦当劳 | 困难 | ★★★★★ |
| 8. 商城系统 | 用户在微信中赠送虚拟道具、礼物、装扮，以此提升好感度 | 中等 | ★★★★ |
| 9. 小游戏区 | 提供五子棋、真心话大冒险等轻量游戏，提升互动深度 | 简单 | ★★★★ |
| 10. 主动消息 | 定时问候、检测天气异常主动推送，打破被动回复模式 | 中等 | ★★★★★ |
| 11. 时区设置 | AI 感知当前真实时间与日夜交替，实现拟真作息与日夜流逝 | 简单 | ★★★★ |
| 12. 充值功能 | 对接微信/支付宝等微信内支付，管理账户虚拟金币余额 | 中等 | ★★★★ |
| 13. 会员订阅 | 展示月度、年度 VIP 会员订阅方案，支持角色和功能解锁 | 中等 | ★★★★ |
02外卖点餐 MCP 接入 （重点难点）
外卖点餐是 OimiChat 最具创新性的功能之一。系统通过标准的 Model Context Protocol（MCP）服务，无缝桥接瑞幸咖啡与麦当劳官方开放平台的下单总控。该模块由于涉及真实的支付流、高维度的餐品属性切换、以及地理位置精算，是控制台中配置最为复杂的区域，请仔细阅读以下流程。
1. 微信端用户触发指令
瑞幸咖啡：在聊天中发送“帮我点杯瑞幸 + 商品名（如：生椰拿铁，去冰，半糖）”。若留空则自动为您推荐今日热销单品。
麦当劳：发送“帮我点份麦当劳 + 商品名（如：麦辣鸡腿堡套餐，可乐换零度，薯条去盐）”，AI 会引导您直接完成外送选择。
2. 瑞幸咖啡（Luckin Coffee）接入配置
访问官方 open.luckincoffee.com，在开发者控制台创建 MCP 应用并获取专属 Token（结尾固定为 LUCKIN_MCP_AI）及分配的 Server 地址。
前往 OimiChat 控制台「外卖点餐 ➜ 瑞幸咖啡」栏目，填写以下 HTML 配置项：
| 控制台元素（HTML ID） | 参数物理说明与默认设置 | 必填 |
|---|---|---|
food-luckin-server | 瑞幸专属的 MCP 接入 API 终地址网关 | 是 |
food-luckin-token | 以 LUCKIN_MCP_AI 结尾的开发者授权秘钥 | 是 |
food-luckin-shop | 设定默认常用自提门店，如“星海广场店”，留空由 AI 自动寻址 | 否 |
food-luckin-lng / lat | 基准定位经纬度。默认使用天安门坐标（116.397128, 39.916527） | 是 |
food-luckin-pin | 6 位数字支付密码，配合免密支付开关使用（加密存储） | 否 |
3. 麦当劳（McDonald's）接入配置
访问麦当劳 MCP 平台 open.mcd.cn/mcp，使用微信绑定手机号验证登录，在控制台点击「激活」Token 并点击「复制」。
MCP Server 地址（food-mcd-server）全国固定填写 https://mcp.mcd.cn；MCP Token（food-mcd-token）粘贴平台激活得到的 Token（频控 600 次/分）。
这是麦当劳「麦乐送」送达的前提条件。系统下单时会读取该 Token 手机账号下的「首选送餐地址」，若账号内无地址会报错。可通过麦当劳小程序/App 维护，也可在控制台调用 delivery-create-address 工具传入 city、contactName、phone、address、addressDetail 来快速新建地址。
4. 核心链式 API 下单流程对比
瑞幸咖啡 · 到店自提
queryShopList— 定位筛选searchProductForMcp— 找规格previewOrder— 算优惠券createOrder— 创建生成自提单
其它工具：switchProduct（多规格切换）、cancelOrder（退单）、queryOrderDetailInfo（取餐码查询）
麦当劳 · 麦乐送外送
delivery-query-addresses— 读地址delivery-query-stores— 配外送店query-meals— 读餐品calculate-price— 算价（分转元）create-order— 创建生成配送单
其它工具：query-order（配送进度）、auto-bind-coupons（麦麦省领券）、query-my-account（积分与优惠）
| 功能维度 | 瑞幸咖啡（到店自提） | 麦当劳（麦乐送外送） |
|---|---|---|
| 核心模式 | 用户前往门店凭自提码自取 | 骑手配送到家，实时位置跟踪 |
| 控制台选店要求 | 必须准确配置高精经纬度坐标 | 无需填写，自动根据首选地址算店 |
| 微信付款路径 | 返回 payOrderUrl 唤起微信支付 | 返回 H5 专属聚合支付跳转链接 |
03其余核心功能精简配置说明
除了核心的外卖点餐 MCP 板块外，控制台其余 12 个功能模块皆遵循人性化设计，配置非常简单。以下为各个模块的接入要点及配置方式：
1. AI 模型切换系统 ai-models
作用：控制 AI 角色的基础大脑。支持 DeepSeek、Google Gemini、字节跳动豆包及 OpenAI 等主流大模型。
进入模型页面，在「API KEY」一栏填入对应提供商的授权秘钥，然后可选择模型的「温度（Temperature）」与「最大 token（Max Tokens）」。下方可直接输入「System Prompt」，定制机器人的专属人格性格、说话语气与特殊身份（如毒舌助手、温柔女仆等）。
2. 刻忆·记忆沉淀系统 memory
作用：赋予 AI 拟真的长期记忆能力，能记住用户的名字、生日、喜好和历史对话内容。
支持一键开关「长期记忆模式」，可设定「记忆沉淀触发阀值」（如单次对话超过 10 句时自动在后台提炼总结）。下方列表实时展现 AI 已沉淀的长期记忆条目，管理员可对其手动修改、置顶或删除，防止 AI 产生错误的幻觉记忆。
3. 语音消息双向处理 voice
作用：实现微信聊天中“发语音、听语音”双向通话体感，比文字交互更具亲和力。
可开启“自动语音转文字（STT）”及“自动回复合成语音（TTS）”开关。服务商支持科大讯飞、百度语音、OpenAI Whisper 或微软 Azure TTS，填入对应 AppId、API_KEY，并可挑选播音音色（男声、女声、卡通音），滑动调节语速、语调及音量参数。
4. 羁绊邮件来信 mail
作用：当用户与 AI 的交互达到一定亲密度（羁绊度）后，AI 会向用户绑定邮箱发送一份深情书信。
后台需开启 SMTP 邮箱发信授权，填写发件邮箱（支持 QQ 邮箱、网易邮箱等）、发件服务器地址和 SMTP 授权码。支持可视化的「邮件频率设置」（如好感度达到 100 时发送首封，之后每周最多 1 封）以及模板占位符（如 {username} 动态渲染收件人）。
5. 暮记·晚间情绪日记 dusk
作用：引导用户在每晚临睡前进行情绪倾诉，撰写暮夜日记，由 AI 生成专属的情绪梳理报告。
设置「入夜问候时间」（如晚上 21:30），届时机器人会自动向活跃用户发送日记引导语。可开启「周报情绪报告」开关，让系统在每周日晚自动汇聚分析用户本周的日记关键词，给出心灵梳理建议。
6. 情绪表情包精准匹配 emotion
作用：让 AI 回复时能够根据上下文情绪，自动附带发送契合的表情包图片。
一键开启「表情包功能」，滑块调节「发送概率」（推荐 40%~60%，过高会导致刷屏，过低会导致聊天生硬）。下方可点击「素材库维护」，上传带有开心、难过、撒娇、愤怒等情绪标签的表情包图片，AI 回复时自动匹配。
7. 好感度道具商城 shop
作用：微信用户可在聊天中“去商场买礼物”送给 AI 角色，以此提升好感度，解锁新的对话技能或立绘装扮。
配置列表支持管理员自由添加/修改商品条目：道具名称（如“提拉米苏”）、金币价格（如“50币”）、好感度提升数值（如“+5 好感度”）以及送礼答谢词模板。系统自带金币扣减逻辑，余额变动会自动写入本地库。
8. 轻量互动小游戏 games
作用：打破纯粹的一问一答，提供微信内即玩的小游戏，提升趣味性与留存效果。
可勾选开启的游戏项目，目前支持五子棋（发送坐标如“A3”和 AI 对弈）和真心话大冒险（触发词触发后 AI 随机抛出题目并智能评分）。可配置单局消耗虚拟金币、胜负奖励金币和日玩上限局数。
9. 支付充值与会员方案 recharge / subscribe
作用：为平台运营提供盈利闭环，支持增值代币（金币）购买及月度/年度会员套餐。
对接聚合支付 SDK，填入「微信支付商户号（MchId）」及「API 证书密钥」（支持国密签名）。可自由定义充值梯度（如 6 元得 60 金币）和 VIP 订阅套餐（如 15 元/月，30 元/季度，解锁所有模型与立绘）。所有充值明细和会员订单均有安全审计日志备查。
10. 主动关怀消息推送 proactive
作用：让机器人能在清晨、重要节日、甚至检测到用户所在城市突发暴雨时，主动发送贴心问候。
开启「主动消息主开关」，配置「早安/晚安问候时间段」和「发送概率因子」。可对接高德天气 API 密钥，当后台检测到用户属地天气降温超 5 度或有暴雪黄色预警时，系统会自动编写问候语并定时发送。
11. 时区与拟真作息设置 timezone
作用：让 AI 获取世界基准时钟，从而在聊天中切身感受现实世界的日落、深夜流逝。
下拉菜单选择默认时区（默认：亚洲/上海，东八区）。支持配置「AI 模拟作息开关」，例如设定晚上 23:00 至次日清晨 7:00 为“深度睡眠时间”，此期间用户发消息，机器人回复会附带「哈欠」表情或提示“需要去睡觉，明天见”。
04控制台常见问题解答（FAQ）
/v1 结尾；登录提供商控制台检查当前 API Key 账户是否欠费，且已给该模型（如 deepseek-chat）分配相应配额。