From d55bff7197321538058536088125484e513fd45c Mon Sep 17 00:00:00 2001 From: zihanjian Date: Fri, 18 Jul 2025 14:48:27 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0README=E6=96=87?= =?UTF-8?q?=E6=A1=A3=E5=86=85=E5=AE=B9=E4=B8=8E=E7=BB=93=E6=9E=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.MD | 31 +++++++++++++------------------ 1 file changed, 13 insertions(+), 18 deletions(-) diff --git a/README.MD b/README.MD index 54e3f60..d303dd7 100644 --- a/README.MD +++ b/README.MD @@ -2,7 +2,7 @@ # 🫧 Bubbles - WechatAI 🫧 -*我叫 泡泡（Bubbles） - 一个致力于链接万物的个人微信助手* +*我叫 泡泡（Bubbles） - 一个致力于链接身边万物的个人助手* @@ -38,19 +38,21 @@ Bubbles 是一个功能丰富的微信机器人框架，基于 [wcferry](https:/ 1. **命令路由系统** - 基于正则表达式的精确命令匹配，适合有明确触发词的功能 2. **AI智能路由系统** - 基于AI的自然语言理解，自动识别用户意图并调用相应功能 -通过这两套路由系统，添加新功能变得极其简单，且不需要改动原有代码。相当于给一个主线 Hub 添加插件，让海量的、不同种类的工具都能集成到 AI 里。具体操作详见 **如何添加新功能** 章节。 +通过这两套路由系统，同一个功能函数，可以让 ai 有两种方式进行调用。这不但使得添加新功能变得极其简单，且不需要改动原有代码。相当于给一个主线 Hub 添加插件，让海量的、不同种类的工具都能集成到 AI 里。 + +路由系统是本项目的核心，通过它，理论上可以实现任何操作。 + +已实现的操作详见 **如何添加新功能** 章节。 ## 案例演示 #### 案例演示其一：使用自然语言设置提醒（命令路由） 结构： -1. 用户输入 -> 击中命令 -> 调用命令函数 -> agent分析 -> agent格式化输出 -> 选择函数 -> 格式解析 -> 函数循环调用 -> 数据库持久化 -> 结果回调 -2. 每分钟扫描一次数据库，判断当前时间 -> （存在超时任务） -> 访问数据库 -> 整合近期context -> 回传agent -> 输出提醒 -> 回调打印 + +用户输入 -> 击中命令 -> 调用命令函数 -> agent分析 -> agent格式化输出 -> 选择函数 -> 格式解析 -> 函数循环调用 -> 数据库持久化 -> 结果回调 - - #### 案例演示其二：使用自然语言设置提醒（AI 智能路由） 结构： @@ -65,7 +67,7 @@ Bubbles 是一个功能丰富的微信机器人框架，基于 [wcferry](https:/ - 支持为不同的群聊和私聊设置不同的 AI 模型和 system prompt - OpenAI (ChatGPT) - DeepSeek - - Perplexity + - Gemini #### 🛠️ 双重路由系统 - **命令路由系统**：基于正则表达式的精确匹配，高效处理特定命令 @@ -109,13 +111,14 @@ flowchart TD 3. **AI路由兜底**：如果没有匹配到命令，则使用AI分析用户意图 4. **智能分发**：AI可以理解自然语言并调用相应功能，或进入聊天模式 -#### ⏰ 定时任务与提醒功能 +### ⏰ 定时任务与提醒功能 - 每日天气预报推送 - 每日新闻资讯推送 - 工作日报/周报/月报提醒 - 个人自定义提醒系统（通过自然语言设置定时提醒） -#### 📊 对话管理 +### 📊 对话管理 +- 不管是群里的消息还是自己的消息，都本地写入 sql 队列中（长度可自定义） - 智能消息总结功能 - 处理各类微信消息（文本、图片、小程序、链接等） @@ -222,7 +225,7 @@ GROUP_MODELS: python main.py ``` -#### 可用命令 +#### 可用命令（命令路由系统） 机器人支持多种命令，按功能分类如下： @@ -247,14 +250,6 @@ python main.py - `天气 城市名`、`温度 城市名` - 查询指定城市的当前天气 - `新闻` - 获取最新新闻 -##### 决斗系统命令（默认关闭） -- `决斗 @用户名` - 发起决斗（仅群聊） -- `偷袭 @用户名`、`偷分 @用户名` - 偷袭其他玩家（仅群聊） -- `决斗排行`、`决斗排名`、`排行榜` - 查看决斗排行榜（仅群聊） -- `决斗战绩`、`我的战绩`、`战绩查询` - 查看决斗战绩（仅群聊） -- `我的装备`、`查看装备` - 查看自己的装备（仅群聊） -- `改名 旧名称 新名称` - 更改昵称（仅群聊） - ## 📋 项目结构 ```