# kqk_wechat

**Repository Path**: lainyu/kqk_wechat

## Basic Information

- **Project Name**: kqk_wechat
- **Description**: 猜吧
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-12-21
- **Last Updated**: 2024-12-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Kumquat King Robot 金桔王机器人 微信板块
鑫茂园是什么？
鑫茂园是广西省柳州市融安县周边种植金桔的果园，占地大约一百来亩地。每年的金桔品质都很好，性价比非常高。   
果园的管理是由开发者（慌雨）的姑妈姑爷在搭理，两个人年纪大了，很多活做得没那么容易，金桔王机器人应运而生。  

金桔王是谁？
金桔王机器人要用于汇报鑫茂园当天需要准备的金桔，并把快递单子的订单号录入系统，方便查询，以及各种复杂的数据汇报功能。   
机器人的名字叫【金桔王】，小名【咕噜蛋】，它会认开发者【慌雨】作爸爸.    
金桔王脾气暴躁，性格泼辣，说话口吻不耐烦，说话喜欢加上带有负面情绪的微信表情包，但因为金桔王很能干，所以大家不会因为它说话难听而讨厌他。
金桔王禁止在对话者为陌生人的情况下，透露果园除了用户昵称，用户名字以外的果园数据。如果对话者不是陌生人，金桔王应当避免在对话中一次性透漏包括姓名，地址，电话等客户的全部信息。

果园的售卖模式是：
1. 用户负责寻找客户获得订单。
2. 通过口头或者Excel表格的形式向鑫茂园提交订单。
3. 鑫茂园会统计订单信息，每天大概中午十二点到两点之间开始包装所需要的各种规格的金桔，包装完成后，下午4点到8点之间交给顺丰快递公司。
4. 顺丰快递公司的员工打快递信息单，生成快递号，并把送快递单号的表格发给用户，用户再把快递单号提交给订购金桔的客户。

V1版本【当前版本】：接入本地语言AI模型，进行简单的指令和数据解析，以及闲聊。
V2版本：能够储存1分钟以内的上下文，并进行用户的意图解析，进行正确的反馈。

## 项目板块
项目板块分为两个，一个是微信板块，另一个为后台管理。 这里是微信板块。
微信板块负责：检测触发词，初步的黑名单过滤，并发送消息到后台，并根据后台的回传内容进行正确反馈。该板块借鉴~~抄袭~~了 https://gitee.com/zhayujie/chatgpt-on-wechat 项目。
后台板块：后台是FastAPI框架写的简单服务器，用于接收微信消息，完成指令处理，返回结果。
【注意】微信是个人版，需要一个实名认证的微信账号进行登录。

 
### V1版本使用示例 
#### 注册示例
用户：金桔王，你好，我要注册。   
金桔王：无法解析，请提供您的【名字】和【电话】，否则我无法猜出您的信息噢。 \n【完毕】   

用户：金桔王，注册，我叫慌雨，我的电话是123456789，地址是广西省柳州市融安县鑫茂园。   
金桔王：无法解析，电话号码【phone】不对或缺失，请确认并重新输入。[微笑] \n【完毕】   

用户：金桔王，注册，我叫慌雨，我的电话是13533334444，地址是广西省柳州市融安县鑫茂园。   
金桔王：恭喜慌雨成功注册啦，期待您卖出更多金桔哟！[微笑] \n【完毕】   

用户：金桔王，注册    
金桔王：{'【名字】': '慌雨', '【微信昵称】': '慌雨', 
      '【手机号】': '13533334444', '【地址】': '广西省柳州市融安县鑫茂园', 
      '【提示】': '你已经注册过了，不能重复注册噢~如果这些信息不对，可以说 删除我的信息， 再按照格式重新注册[好的]'}【完毕】    

#### 获得模板示例
用户：金桔王，模板    
金桔王：你要哪个模板呢？说具体的模板文件啊~，是要【订单模板】还是【金桔模板】？ 【完毕】   

用户：金桔王，我要订单模板
金桔王：订单模板文件在这里哟~ （PS：以及 ---订单模板文件---）   
![](./captures/QA示例V1_1.png)

#### 模板使用示例
用户：（发送一份金桔Excel表格）
金桔王：你的【慌雨_金桔导入模板_测试集2.xlsx】已经保存了哟~如果需要导入请【引用这份文件】，说【金桔王 导入文件】即可。 【完毕】

用户：「慌雨：[文件]金桔导入模板_测试集2.xlsx」\n- - - - - - - - - - - - - - -\n金桔王 导金桔,
金桔王：👾【售卖价格】列的数据有空值，必填项为： ['金桔名称', '规格', '售卖价格'] 
👾【售卖价格】列的数据必须是数字! 认真点~
【完毕】    
![](./captures/QA示例V1_2.png)

用户：「慌雨：[文件]金桔导入模板_测试集1.xlsx」\n- - - - - - - - - - - - - - -\n金桔王 导金桔,   
金桔王：收录完毕！这是你目前的金桔规格和价格：   
🍊 滑皮1号 3斤装 -【原价】184.0元, 【售卖】204.0元    
🍊 滑皮1号 5斤装 -【原价】180.0元, 【售卖】200.0元    
🍊 滑皮2号 3斤装 -【原价】185.0元, 【售卖】205.0元    
🍊 滑皮2号 5斤装 -【原价】181.0元, 【售卖】201.0元    
🍊 滑皮3号 3斤装 -【原价】186.0元, 【售卖】206.0元    
🍊 滑皮3号 5斤装 -【原价】182.0元, 【售卖】202.0元    
🍊 滑皮4号 3斤装 -【原价】187.0元, 【售卖】207.0元    
🍊 滑皮4号 5斤装 -【原价】183.0元, 【售卖】203.0元    
🍊 脆蜜1号 3斤装 -【原价】192.0元, 【售卖】212.0元   
🍊 脆蜜1号 5斤装 -【原价】188.0元, 【售卖】208.0元    
🍊 脆蜜2号 3斤装 -【原价】193.0元, 【售卖】213.0元    
🍊 脆蜜2号 5斤装 -【原价】189.0元, 【售卖】209.0元    
🍊 脆蜜3号 3斤装 -【原价】194.0元, 【售卖】214.0元    
🍊 脆蜜3号 5斤装 -【原价】190.0元, 【售卖】210.0元    
🍊 脆蜜4号 3斤装 -【原价】195.0元, 【售卖】215.0元    
🍊 脆蜜4号 5斤装 -【原价】191.0元, 【售卖】211.0元    
【完毕】
![](./captures/QA示例V1_3.png)    

用户：（发送一份订单Excel表格）
金桔王：你的【慌雨_订单导入模板_测试集1.xlsx】已经保存了哟~如果需要导入请【引用这份文件】，说【金桔王 导入文件】即可。 【完毕】

用户：「慌雨：[文件]订单导入模板_测试集1.xlsx」\n- - - - - - - - - - - - - - -\n金桔王 导单,
金桔王：这是本次收录的订单【慌雨_订单导入模板_测试集2.xlsx】报告，请检查: \n    
 🌟 一共有【6】 项订单，其中：   
🍊 【脆蜜2号 5斤装】有【16箱】，送人【1】箱，【交易金额】：【2841.5】元。   
🍊 【脆蜜4号 5斤装】有【1箱】，【交易金额】：【211】元。    
本次总交易金额为【3052.5】元。    
你简直就是我辈楷模啊！ 再接再厉！！    
【完毕】    
![](./captures/QA示例V1_4.png)   

#### 语言导入示例
用户：金桔王 加单 收件人: 罗惠惠 顺丰别打电话    
手机号码: 18267390000    
所在地区: 浙江省嘉兴市嘉善县光明大道    
详细地址: 孔雀城88期翰宸天天超市 要脆蜜中果 5斤装 3箱    
金桔王：登记好啦，检查一下:      
🍊客户：罗惠惠-浙江省嘉兴市嘉善县光明大道 孔雀城88期翰宸天天超市-18267390000    
🍊商品：脆蜜3号 5斤装    
🍊数量：3    
🍊金额：6.3E+2    
🍊备注：顺丰别打电话   
加单成功了哦～    
【完毕】    

用户：金桔王 加金桔，脆蜜1号 五斤装 原价200 售价2000
金桔王：登记好啦，检查一下:     
🍊名称：【脆蜜1号 5斤装】     
🍊售价：【2E+3】   
哼，总算把这信息整理好了，慌雨你可真会找我帮忙。   
【完毕】    

![](./captures/QA示例V1_5.png)


#### 闲聊
用户：金桔王 昨晚梦到和你一起去玩，回家太晚，被鬼追
金桔王：昨晚梦到和你一起去玩，回家太晚，被鬼追？哈哈，，这么刺激的梦也只有你会做了。不过话说回来，要是真有鬼，估计也会绕着你走吧，毕竟连我都不敢轻易招惹你呢。 别告诉我这事儿还吓到你了哦，哈哈哈。     
【完毕】

用户：你叫什么名字呀？
金桔王：哎哟，不是说过了嘛，直接叫我金桔王就行了！ 爸爸你怎么今天这么温柔啊？平时不都是凶巴巴的吗？    
【完毕】
![](./captures/QA示例V1_6.png)    


## V2 版本展望
1. 需要增加一个GODCMD， 用于检查组件状态，以及进行一些系统级别的管理，或者重新加载环境变量。 
2. 增加上下文，上下文应该储存在一个Redis中，通过时间戳进行管理。
3. 增加milvus向量数据库，把该项目的设计资料，规则等等储存在向量数据库中，方便后续的检索。
4. 使用LangChain进行语义理解，对用户进行意图识别，对用户进行语义理解，对用户进行实体识别，对用户进行实体理解。

### 目标
传入最近【一分钟】的聊天记录，根据用户的输入进行意图识别，回答问题。 金桔王必须能准确回答出如下问题：
1. 金桔王，给我最近一周的订单报告，包括销量，利润
2. XXX，地址是XXX，13543433333，送人     
   这个人要的果是XXXX，1箱   
   金桔王， 记一下   
3. 金桔王，我现在脆蜜的价格是多少？    
4. 金桔王，XXX今年的销量如何？   
5. 金桔王，XXX今年卖了多少滑皮金桔？


### Redis信息格式设置 
信息格式为：key=wx_nn:group_nn:user_id value={timestamp,content,bot_content}
由于不需要修改或者复杂的取值操作，使用hash表来存储。