mirror of
https://github.com/Zippland/Bubbles.git
synced 2026-02-26 07:57:08 +08:00
docs: 更新README文档内容与结构
This commit is contained in:
31
README.MD
31
README.MD
@@ -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
|
||||
- `天气 城市名`、`温度 城市名` - 查询指定城市的当前天气
|
||||
- `新闻` - 获取最新新闻
|
||||
|
||||
##### 决斗系统命令(默认关闭)
|
||||
- `决斗 @用户名` - 发起决斗(仅群聊)
|
||||
- `偷袭 @用户名`、`偷分 @用户名` - 偷袭其他玩家(仅群聊)
|
||||
- `决斗排行`、`决斗排名`、`排行榜` - 查看决斗排行榜(仅群聊)
|
||||
- `决斗战绩`、`我的战绩`、`战绩查询` - 查看决斗战绩(仅群聊)
|
||||
- `我的装备`、`查看装备` - 查看自己的装备(仅群聊)
|
||||
- `改名 旧名称 新名称` - 更改昵称(仅群聊)
|
||||
|
||||
## 📋 项目结构
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user