docs: 更新README文档内容与结构

This commit is contained in:
zihanjian
2025-07-18 14:48:27 +08:00
parent a826e23015
commit d55bff7197

View File

@@ -2,7 +2,7 @@
# 🫧 Bubbles - WechatAI 🫧
*我叫 泡泡Bubbles - 一个致力于链接万物的个人微信助手*
*我叫 泡泡Bubbles - 一个致力于链接身边万物的个人助手*
</div>
@@ -38,19 +38,21 @@ Bubbles 是一个功能丰富的微信机器人框架,基于 [wcferry](https:/
1. **命令路由系统** - 基于正则表达式的精确命令匹配,适合有明确触发词的功能
2. **AI智能路由系统** - 基于AI的自然语言理解自动识别用户意图并调用相应功能
通过这两套路由系统,添加新功能变得极其简单,且不需要改动原有代码。相当于给一个主线 Hub 添加插件,让海量的、不同种类的工具都能集成到 AI 里。具体操作详见 **如何添加新功能** 章节。
通过这两套路由系统,同一个功能函数,可以让 ai 有两种方式进行调用。这不但使得添加新功能变得极其简单,且不需要改动原有代码。相当于给一个主线 Hub 添加插件,让海量的、不同种类的工具都能集成到 AI 里。
路由系统是本项目的核心,通过它,理论上可以实现任何操作。
已实现的操作详见 **如何添加新功能** 章节。
## 案例演示
#### 案例演示其一:使用自然语言设置提醒(命令路由)
结构:
1. 用户输入 -> 击中命令 -> 调用命令函数 -> agent分析 -> agent格式化输出 -> 选择函数 -> 格式解析 -> 函数循环调用 -> 数据库持久化 -> 结果回调
2. 每分钟扫描一次数据库,判断当前时间 -> (存在超时任务) -> 访问数据库 -> 整合近期context -> 回传agent -> 输出提醒 -> 回调打印
用户输入 -> 击中命令 -> 调用命令函数 -> agent分析 -> agent格式化输出 -> 选择函数 -> 格式解析 -> 函数循环调用 -> 数据库持久化 -> 结果回调
<img src="img_1.jpg" width="400"/>
<img src="img_2.jpg" width="400"/>
#### 案例演示其二使用自然语言设置提醒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
- `天气 城市名`、`温度 城市名` - 查询指定城市的当前天气
- `新闻` - 获取最新新闻
##### 决斗系统命令(默认关闭)
- `决斗 @用户名` - 发起决斗(仅群聊)
- `偷袭 @用户名`、`偷分 @用户名` - 偷袭其他玩家(仅群聊)
- `决斗排行`、`决斗排名`、`排行榜` - 查看决斗排行榜(仅群聊)
- `决斗战绩`、`我的战绩`、`战绩查询` - 查看决斗战绩(仅群聊)
- `我的装备`、`查看装备` - 查看自己的装备(仅群聊)
- `改名 旧名称 新名称` - 更改昵称(仅群聊)
## 📋 项目结构
```