|
| 1 | +# QuecPython 基于小智平台 的 AI 聊天机器人 |
| 2 | + |
| 3 | +## 目录 |
| 4 | + |
| 5 | +- [介绍](#介绍) |
| 6 | +- [功能特性](#功能特性) |
| 7 | +- [快速开始](#快速开始) |
| 8 | + - [先决条件](#先决条件) |
| 9 | + - [安装](#安装) |
| 10 | + - [运行应用程序](#运行应用程序) |
| 11 | +- [目录结构](#目录结构) |
| 12 | +- [贡献](#贡献) |
| 13 | +- [许可证](#许可证) |
| 14 | +- [支持](#支持) |
| 15 | + |
| 16 | +## 介绍 |
| 17 | + |
| 18 | +QuecPython 推出了小智平台 AI 聊天机器人解决方案。该方案基于 websocket 协议,具有跨平台特性,可以适用于大部分 QuecPython 模组。 |
| 19 | + |
| 20 | +本案例采用搭载 EC800MCNLE 模组的 AI 开发板。 |
| 21 | + |
| 22 | +## 功能特性 |
| 23 | + |
| 24 | +- 支持按键语音中断/打断。 |
| 25 | +- 支持按键语音唤醒。 |
| 26 | +- 使用 Python 语言,便于二次开发。 |
| 27 | + |
| 28 | +## 快速开始 |
| 29 | + |
| 30 | +### 先决条件 |
| 31 | + |
| 32 | +在开始之前,请确保您具备以下先决条件: |
| 33 | + |
| 34 | +- **硬件:** |
| 35 | + - 联系移远官方获取 AI 开发板及配件。 |
| 36 | + - 电脑(Windows 7、Windows 10 或 Windows 11) |
| 37 | + - 喇叭 |
| 38 | + - 任意 2-5W 功率的喇叭即可 |
| 39 | + - [移远商城购买链接](https://www.quecmall.com/goods-detail/2c90800c94028da201948249e9f4012d) |
| 40 | + |
| 41 | +- **软件:** |
| 42 | + - 调试工具 [QPYcom](https://images.quectel.com/python/2022/12/QPYcom_V3.6.0.zip) |
| 43 | + - QuecPython 固件(仓库 fw 目录下有 beta 固件) |
| 44 | + - Python 文本编辑器(例如,[VSCode](https://code.visualstudio.com/)、[Pycharm](https://www.jetbrains.com/pycharm/download/)) |
| 45 | + |
| 46 | +### 安装 |
| 47 | + |
| 48 | +1. **克隆仓库**: |
| 49 | + ```bash |
| 50 | + git clone https://github.com/QuecPython/solution-xiaozhiAI.git |
| 51 | + cd solution-xiaozhiAI |
| 52 | + ``` |
| 53 | + |
| 54 | +3. **烧录固件:** |
| 55 | + 按照[说明](https://python.quectel.com/doc/Application_guide/zh/dev-tools/QPYcom/qpycom-dw.html#%E4%B8%8B%E8%BD%BD%E5%9B%BA%E4%BB%B6)将固件烧录到开发板上。 |
| 56 | + |
| 57 | +### 运行应用程序 |
| 58 | + |
| 59 | +1. **连接硬件:** |
| 60 | + 本案例采用移远 AI 开发板,如有需要请联系官方获取。按照下图进行硬件连接: |
| 61 | + |
| 62 | + <img src="./media/20250425131903.jpg" style="zoom:80%;" /> |
| 63 | + |
| 64 | + 1. 连接喇叭 |
| 65 | + 2. 连接天线 |
| 66 | + 3. 接入电池 |
| 67 | +4. 通过 Tpye-C 连接上位机 |
| 68 | + |
| 69 | +2. **将代码下载到设备:** |
| 70 | + - 启动 QPYcom 调试工具。 |
| 71 | + - 将数据线连接到计算机。 |
| 72 | + - 按下开发板上的 **PWRKEY** 按钮启动设备。 |
| 73 | + - 按照[说明](https://python.quectel.com/doc/Application_guide/zh/dev-tools/QPYcom/qpycom-dw.html#%E4%B8%8B%E8%BD%BD%E8%84%9A%E6%9C%AC)将 `code` 文件夹中的所有文件导入到模块的文件系统中,保留目录结构。 |
| 74 | + |
| 75 | +3. **运行应用程序:** |
| 76 | + - 选择 `File` 选项卡。 |
| 77 | + - 选择 `_main.py` 脚本。 |
| 78 | + - 右键单击并选择 `Run` 或使用`运行`快捷按钮执行脚本。 |
| 79 | + |
| 80 | +4. **按下主按键后,即可对话, 参考运行日志:** |
| 81 | + |
| 82 | +  |
| 83 | + |
| 84 | +5. 参考宣发视频:`media/example_video.mp4` |
| 85 | + |
| 86 | +## 贡献 |
| 87 | + |
| 88 | +我们欢迎对本项目的改进做出贡献!请按照以下步骤进行贡献: |
| 89 | + |
| 90 | +1. Fork 此仓库。 |
| 91 | +2. 创建一个新分支(`git checkout -b feature/your-feature`)。 |
| 92 | +3. 提交您的更改(`git commit -m 'Add your feature'`)。 |
| 93 | +4. 推送到分支(`git push origin feature/your-feature`)。 |
| 94 | +5. 打开一个 Pull Request。 |
| 95 | + |
| 96 | +## 许可证 |
| 97 | + |
| 98 | +本项目使用 Apache 许可证。详细信息请参阅 [LICENSE](LICENSE) 文件。 |
| 99 | + |
| 100 | +## 支持 |
| 101 | + |
| 102 | +如果您有任何问题或需要支持,请参阅 [QuecPython 文档](https://python.quectel.com/doc) 或在本仓库中打开一个 issue。 |
0 commit comments