From ede2bc6a4e48460625eb176746e1ec5154d3f656 Mon Sep 17 00:00:00 2001 From: hrz <1710360675@qq.com> Date: Wed, 21 May 2025 11:55:56 +0800 Subject: [PATCH] =?UTF-8?q?update:=E6=9B=B4=E6=96=B0manager-api=E6=A8=A1?= =?UTF-8?q?=E5=9D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Dockerfile-web | 19 +- README.md | 150 +- README_en.md | 199 +- docs/Deployment.md | 117 +- docs/Deployment_all.md | 449 +++ docs/FAQ.md | 46 +- docs/ali-sms-integration.md | 44 + docs/docker/nginx.conf | 67 +- docs/firmware-build.md | 112 +- docs/firmware-setting.md | 54 + docs/fish-speech-integration.md | 72 + docs/homeassistant-integration.md | 248 ++ docs/images/alisms/sms-01.png | Bin 0 -> 136404 bytes docs/images/alisms/sms-02.png | Bin 0 -> 117390 bytes docs/images/alisms/sms-11.png | Bin 0 -> 105141 bytes docs/images/alisms/sms-21.png | Bin 0 -> 103235 bytes docs/images/alisms/sms-22.png | Bin 0 -> 94553 bytes docs/images/alisms/sms-23.png | Bin 0 -> 77461 bytes docs/images/alisms/sms-24.png | Bin 0 -> 108468 bytes docs/images/alisms/sms-25.png | Bin 0 -> 115685 bytes docs/images/alisms/sms-31.png | Bin 0 -> 112066 bytes docs/images/alisms/sms-32.png | Bin 0 -> 87609 bytes docs/images/build_setting01.png | Bin 140039 -> 0 bytes docs/images/build_setting02.png | Bin 164284 -> 0 bytes docs/images/deploy.png | Bin 589852 -> 0 bytes docs/images/deploy1.png | Bin 0 -> 312895 bytes docs/images/deploy2.png | Bin 0 -> 660012 bytes docs/images/firmware-setting-ota.png | Bin 0 -> 209821 bytes docs/images/fishspeech/autodl-01.png | Bin 0 -> 439176 bytes docs/images/fishspeech/autodl-02.png | Bin 0 -> 254205 bytes docs/images/image-ha-integration-01.png | Bin 0 -> 45313 bytes docs/images/image-ha-integration-02.png | Bin 0 -> 65027 bytes docs/images/image-ha-integration-03.png | Bin 0 -> 47530 bytes docs/images/image-ha-integration-04.png | Bin 0 -> 54005 bytes docs/images/image-ha-integration-05.png | Bin 0 -> 20987 bytes docs/images/logo_bailing.png | Bin 0 -> 36089 bytes docs/images/logo_huiyuan.png | Bin 0 -> 29246 bytes docs/images/logo_qinren.png | Bin 0 -> 14354 bytes docs/images/logo_tenclass.png | Bin 0 -> 6247 bytes docs/images/logo_xuanfeng.png | Bin 0 -> 20417 bytes docs/images/vscode_idf.png | Bin 152710 -> 0 bytes main/README.md | 10 +- main/manager-api/README.md | 77 +- main/manager-api/pom.xml | 19 + .../xiaozhi/common/config/AsyncConfig.java | 40 + .../common/config/RestTemplateConfig.java | 17 + .../xiaozhi/common/config/SwaggerConfig.java | 8 + .../xiaozhi/common/constant/Constant.java | 144 +- .../xiaozhi/common/exception/ErrorCode.java | 14 +- .../common/exception/RenExceptionHandler.java | 22 + .../java/xiaozhi/common/redis/RedisKeys.java | 87 +- .../java/xiaozhi/common/redis/RedisUtils.java | 70 +- .../common/service/impl/BaseServiceImpl.java | 48 +- .../common/service/impl/CrudServiceImpl.java | 1 - .../java/xiaozhi/common/utils/DateUtils.java | 15 + .../xiaozhi/common/utils/ResourcesUtils.java | 44 + .../common/validator/ValidatorUtils.java | 29 + .../AgentChatHistoryController.java | 36 + .../agent/controller/AgentController.java | 124 +- .../xiaozhi/modules/agent/dao/AgentDao.java | 15 +- .../agent/dao/AiAgentChatAudioDao.java | 18 + .../agent/dao/AiAgentChatHistoryDao.java | 38 + .../agent/dto/AgentChatHistoryDTO.java | 28 + .../agent/dto/AgentChatHistoryReportDTO.java | 31 + .../agent/dto/AgentChatSessionDTO.java | 26 + .../xiaozhi/modules/agent/dto/AgentDTO.java | 7 + .../modules/agent/dto/AgentMemoryDTO.java | 19 + .../modules/agent/dto/AgentUpdateDTO.java | 7 + .../agent/entity/AgentChatAudioEntity.java | 29 + .../agent/entity/AgentChatHistoryEntity.java | 81 + .../modules/agent/entity/AgentEntity.java | 7 + .../agent/entity/AgentTemplateEntity.java | 9 + .../agent/service/AgentChatAudioService.java | 30 + .../service/AgentChatHistoryService.java | 47 + .../modules/agent/service/AgentService.java | 61 +- .../agent/service/AgentTemplateService.java | 8 + .../biz/AgentChatHistoryBizService.java | 22 + .../impl/AgentChatHistoryBizServiceImpl.java | 112 + .../impl/AgentChatAudioServiceImpl.java | 34 + .../impl/AgentChatHistoryServiceImpl.java | 93 + .../agent/service/impl/AgentServiceImpl.java | 70 +- .../impl/AgentTemplateServiceImpl.java | 37 + .../config/controller/ConfigController.java | 44 + .../modules/config/dto/AgentModelsDTO.java | 25 + .../modules/config/init/SystemInitConfig.java | 41 + .../modules/config/service/ConfigService.java | 22 + .../service/impl/ConfigServiceImpl.java | 302 ++ .../device/controller/DeviceController.java | 13 + .../device/controller/OTAController.java | 67 +- .../device/controller/OTAMagController.java | 291 ++ .../xiaozhi/modules/device/dao/DeviceDao.java | 10 + .../xiaozhi/modules/device/dao/OtaDao.java | 15 + .../device/dto/DeviceReportRespDTO.java | 12 + .../modules/device/entity/OtaEntity.java | 61 + .../modules/device/service/DeviceService.java | 36 +- .../modules/device/service/OtaService.java | 22 + .../service/impl/DeviceServiceImpl.java | 312 +- .../device/service/impl/OtaServiceImpl.java | 85 + .../modules/device/utils/NetworkUtil.java | 34 - .../model/controller/ModelController.java | 27 + .../controller/ModelProviderController.java | 68 + .../modules/model/dto/ModelProviderDTO.java | 14 +- .../model/entity/ModelProviderEntity.java | 3 - .../model/service/ModelConfigService.java | 17 + .../model/service/ModelProviderService.java | 12 +- .../service/impl/ModelConfigServiceImpl.java | 89 + .../impl/ModelProviderServiceImpl.java | 80 +- .../modules/security/config/ShiroConfig.java | 20 +- .../modules/security/config/WebMvcConfig.java | 41 +- .../security/controller/LoginController.java | 116 +- .../modules/security/dto/LoginDTO.java | 3 + .../security/dto/SmsVerificationDTO.java | 28 + .../security/secret/ServerSecretFilter.java | 105 + .../security/secret/ServerSecretToken.java | 25 + .../security/service/CaptchaService.java | 26 +- .../service/impl/CaptchaServiceImpl.java | 93 +- .../modules/sms/service/SmsService.java | 17 + .../sms/service/imp/ALiYunSmsService.java | 76 + .../sys/controller/AdminController.java | 1 - .../ServerSideManageController.java | 120 + .../sys/controller/SysDictDataController.java | 105 + .../sys/controller/SysDictTypeController.java | 92 + .../sys/controller/SysParamsController.java | 102 +- .../modules/sys/dao/SysDictDataDao.java | 16 +- .../modules/sys/dao/SysDictTypeDao.java | 8 - .../xiaozhi/modules/sys/dao/SysParamsDao.java | 2 +- .../modules/sys/dto/EmitSeverActionDTO.java | 29 + .../modules/sys/dto/RetrievePasswordDTO.java | 30 + .../sys/dto/ServerActionPayloadDTO.java | 39 + .../sys/dto/ServerActionResponseDTO.java | 34 + .../modules/sys/dto/SysDictTypeDTO.java | 1 + .../xiaozhi/modules/sys/dto/SysParamsDTO.java | 6 + .../xiaozhi/modules/sys/entity/DictData.java | 16 - .../xiaozhi/modules/sys/entity/DictType.java | 19 - .../modules/sys/entity/SysDictTypeEntity.java | 2 +- .../modules/sys/entity/SysParamsEntity.java | 4 + .../modules/sys/enums/ServerActionEnum.java | 43 + .../sys/enums/ServerActionResponseEnum.java | 49 + .../sys/service/SysDictDataService.java | 49 +- .../sys/service/SysDictTypeService.java | 42 +- .../modules/sys/service/SysParamsService.java | 10 +- .../modules/sys/service/SysUserService.java | 7 + .../service/impl/SysDictDataServiceImpl.java | 124 +- .../service/impl/SysDictTypeServiceImpl.java | 103 +- .../service/impl/SysParamsServiceImpl.java | 135 +- .../sys/service/impl/SysUserServiceImpl.java | 23 +- .../service/impl/SysUserUtilServiceImpl.java | 4 +- .../sys/utils/WebSocketClientManager.java | 315 ++ .../sys/utils/WebSocketTestHandler.java | 46 + .../modules/sys/utils/WebSocketValidator.java | 60 + .../modules/sys/vo/AdminPageUserVO.java | 5 + .../modules/sys/vo/SysDictDataItem.java | 20 + .../xiaozhi/modules/sys/vo/SysDictDataVO.java | 50 + .../xiaozhi/modules/sys/vo/SysDictTypeVO.java | 47 + .../timbre/controller/TimbreController.java | 3 +- .../modules/timbre/dto/TimbreDataDTO.java | 2 - .../modules/timbre/service/TimbreService.java | 2 +- .../service/impl/TimbreServiceImpl.java | 32 +- .../src/main/resources/application.yml | 5 +- .../{202504061512.sql => 202504092335.sql} | 2 +- .../{202504082210.sql => 202504112044.sql} | 76 +- .../resources/db/changelog/202504112058.sql | 61 + .../resources/db/changelog/202504151206.sql | 28 + .../resources/db/changelog/202504181536.sql | 7 + .../resources/db/changelog/202504221135.sql | 88 + .../resources/db/changelog/202504221555.sql | 49 + .../resources/db/changelog/202504251422.sql | 30 + .../resources/db/changelog/202504291043.sql | 504 +++ .../resources/db/changelog/202504301341.sql | 85 + .../resources/db/changelog/202505022134.sql | 27 + .../resources/db/changelog/202505081146.sql | 43 + .../resources/db/changelog/202505091409.sql | 6 + .../resources/db/changelog/202505091555.sql | 25 + .../resources/db/changelog/202505111914.sql | 6 + .../resources/db/changelog/202505122348.sql | 6 + .../resources/db/changelog/202505142037.sql | 7 + .../resources/db/changelog/202505182234.sql | 65 + .../resources/db/changelog/202505201744.sql | 3 + .../resources/db/changelog/2025_tts_voive.sql | 44 - .../db/changelog/db.changelog-master.yaml | 156 +- .../main/resources/i18n/messages.properties | 11 + .../resources/i18n/messages_en_US.properties | 13 +- .../resources/i18n/messages_zh_CN.properties | 13 +- .../resources/i18n/messages_zh_TW.properties | 13 +- .../main/resources/i18n/validation.properties | 6 +- .../i18n/validation_en_US.properties | 6 +- .../i18n/validation_zh_CN.properties | 6 +- .../i18n/validation_zh_TW.properties | 11 +- .../src/main/resources/lua/emptyAll.lua | 1 + .../src/main/resources/lua/getKeyOrCreate.lua | 11 + .../mapper/agent/AiAgentChatHistoryDao.xml | 44 + .../resources/mapper/device/DeviceDao.xml | 12 + .../resources/mapper/sys/SysDictDataDao.xml | 15 +- .../resources/mapper/sys/SysDictTypeDao.xml | 4 - .../xiaozhi/modules/device/DeviceTest.java | 31 +- .../modules/sys/loginControllerTest.java | 58 + main/manager-web/.env.development | 5 +- main/manager-web/.env.production | 5 +- main/manager-web/README.md | 2 +- main/manager-web/package-lock.json | 3260 ++++++++++++++++- main/manager-web/package.json | 6 +- main/manager-web/public/encoderWorker.min.js | 1 - main/manager-web/public/index.html | 4 +- main/manager-web/public/offline.html | 70 + main/manager-web/src/App.vue | 115 + main/manager-web/src/apis/api.js | 10 +- main/manager-web/src/apis/httpRequest.js | 25 +- main/manager-web/src/apis/module/admin.js | 66 +- main/manager-web/src/apis/module/agent.js | 64 +- main/manager-web/src/apis/module/device.js | 22 +- main/manager-web/src/apis/module/dict.js | 227 ++ main/manager-web/src/apis/module/model.js | 211 +- main/manager-web/src/apis/module/ota.js | 123 + main/manager-web/src/apis/module/timbre.js | 38 +- main/manager-web/src/apis/module/user.js | 92 +- .../src/assets/header/firmware_update.png | Bin 0 -> 7738 bytes .../src/assets/login/login-person.png | Bin 104707 -> 103575 bytes main/manager-web/src/assets/model/model.png | Bin 127128 -> 90263 bytes main/manager-web/src/assets/user-avatar1.png | Bin 0 -> 10906 bytes main/manager-web/src/assets/user-avatar2.png | Bin 0 -> 10720 bytes main/manager-web/src/assets/user-avatar3.png | Bin 0 -> 11231 bytes main/manager-web/src/assets/user-avatar4.png | Bin 0 -> 10297 bytes main/manager-web/src/assets/user-avatar5.png | Bin 0 -> 8330 bytes .../src/components/AddDeviceDialog.vue | 7 +- .../src/components/AddModelDialog.vue | 54 +- .../src/components/AddWisdomBodyDialog.vue | 11 +- .../src/components/CacheViewer.vue | 207 ++ .../src/components/ChangePasswordDialog.vue | 13 +- .../src/components/ChatHistoryDialog.vue | 447 +++ .../manager-web/src/components/DeviceItem.vue | 55 +- .../src/components/DictDataDialog.vue | 116 + .../src/components/DictTypeDialog.vue | 97 + .../src/components/FirmwareDialog.vue | 234 ++ .../src/components/FunctionDialog.vue | 410 +++ main/manager-web/src/components/HeaderBar.vue | 164 +- .../src/components/ModelEditDialog.vue | 121 +- .../src/components/ParamDialog.vue | 364 ++ .../src/components/ProviderDialog.vue | 435 +++ main/manager-web/src/components/TtsModel.vue | 322 +- .../src/components/VersionFooter.vue | 74 + main/manager-web/src/main.js | 5 + main/manager-web/src/registerServiceWorker.js | 113 + main/manager-web/src/router/index.js | 53 +- main/manager-web/src/service-worker.js | 174 + main/manager-web/src/store/index.js | 26 +- main/manager-web/src/utils/cacheViewer.js | 142 + main/manager-web/src/utils/format.js | 21 + main/manager-web/src/utils/index.js | 64 + .../src/views/DeviceManagement.vue | 682 +++- main/manager-web/src/views/DictManagement.vue | 851 +++++ main/manager-web/src/views/ModelConfig.vue | 451 ++- main/manager-web/src/views/OtaManagement.vue | 766 ++++ .../src/views/ParamsManagement.vue | 446 ++- .../src/views/ProviderManagement.vue | 876 +++++ .../src/views/ServerSideManager.vue | 475 +++ main/manager-web/src/views/UserManagement.vue | 218 +- main/manager-web/src/views/auth.scss | 15 +- main/manager-web/src/views/home.vue | 135 +- main/manager-web/src/views/login.vue | 140 +- main/manager-web/src/views/register.vue | 248 +- .../src/views/retrievePassword.vue | 275 ++ main/manager-web/src/views/roleConfig.vue | 579 ++- main/manager-web/src/views/test.vue | 400 -- main/manager-web/vue.config.js | 109 +- 264 files changed, 20986 insertions(+), 2593 deletions(-) create mode 100644 docs/Deployment_all.md create mode 100644 docs/ali-sms-integration.md create mode 100644 docs/firmware-setting.md create mode 100644 docs/fish-speech-integration.md create mode 100644 docs/homeassistant-integration.md create mode 100644 docs/images/alisms/sms-01.png create mode 100644 docs/images/alisms/sms-02.png create mode 100644 docs/images/alisms/sms-11.png create mode 100644 docs/images/alisms/sms-21.png create mode 100644 docs/images/alisms/sms-22.png create mode 100644 docs/images/alisms/sms-23.png create mode 100644 docs/images/alisms/sms-24.png create mode 100644 docs/images/alisms/sms-25.png create mode 100644 docs/images/alisms/sms-31.png create mode 100644 docs/images/alisms/sms-32.png delete mode 100644 docs/images/build_setting01.png delete mode 100644 docs/images/build_setting02.png delete mode 100644 docs/images/deploy.png create mode 100644 docs/images/deploy1.png create mode 100644 docs/images/deploy2.png create mode 100644 docs/images/firmware-setting-ota.png create mode 100644 docs/images/fishspeech/autodl-01.png create mode 100644 docs/images/fishspeech/autodl-02.png create mode 100644 docs/images/image-ha-integration-01.png create mode 100644 docs/images/image-ha-integration-02.png create mode 100644 docs/images/image-ha-integration-03.png create mode 100644 docs/images/image-ha-integration-04.png create mode 100644 docs/images/image-ha-integration-05.png create mode 100644 docs/images/logo_bailing.png create mode 100644 docs/images/logo_huiyuan.png create mode 100644 docs/images/logo_qinren.png create mode 100644 docs/images/logo_tenclass.png create mode 100644 docs/images/logo_xuanfeng.png delete mode 100644 docs/images/vscode_idf.png create mode 100644 main/manager-api/src/main/java/xiaozhi/common/config/AsyncConfig.java create mode 100644 main/manager-api/src/main/java/xiaozhi/common/config/RestTemplateConfig.java create mode 100644 main/manager-api/src/main/java/xiaozhi/common/utils/ResourcesUtils.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/controller/AgentChatHistoryController.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/dao/AiAgentChatAudioDao.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/dao/AiAgentChatHistoryDao.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/dto/AgentChatHistoryDTO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/dto/AgentChatHistoryReportDTO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/dto/AgentChatSessionDTO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/dto/AgentMemoryDTO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/entity/AgentChatAudioEntity.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/entity/AgentChatHistoryEntity.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/service/AgentChatAudioService.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/service/AgentChatHistoryService.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/service/biz/AgentChatHistoryBizService.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/service/biz/impl/AgentChatHistoryBizServiceImpl.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/service/impl/AgentChatAudioServiceImpl.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/agent/service/impl/AgentChatHistoryServiceImpl.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/config/controller/ConfigController.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/config/dto/AgentModelsDTO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/config/init/SystemInitConfig.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/config/service/ConfigService.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/config/service/impl/ConfigServiceImpl.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/device/controller/OTAMagController.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/device/dao/OtaDao.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/device/entity/OtaEntity.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/device/service/OtaService.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/device/service/impl/OtaServiceImpl.java delete mode 100644 main/manager-api/src/main/java/xiaozhi/modules/device/utils/NetworkUtil.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/model/controller/ModelProviderController.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/security/dto/SmsVerificationDTO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/security/secret/ServerSecretFilter.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/security/secret/ServerSecretToken.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sms/service/SmsService.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sms/service/imp/ALiYunSmsService.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/controller/ServerSideManageController.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/controller/SysDictDataController.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/controller/SysDictTypeController.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/dto/EmitSeverActionDTO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/dto/RetrievePasswordDTO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/dto/ServerActionPayloadDTO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/dto/ServerActionResponseDTO.java delete mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/entity/DictData.java delete mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/entity/DictType.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/enums/ServerActionEnum.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/enums/ServerActionResponseEnum.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/utils/WebSocketClientManager.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/utils/WebSocketTestHandler.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/utils/WebSocketValidator.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/vo/SysDictDataItem.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/vo/SysDictDataVO.java create mode 100644 main/manager-api/src/main/java/xiaozhi/modules/sys/vo/SysDictTypeVO.java rename main/manager-api/src/main/resources/db/changelog/{202504061512.sql => 202504092335.sql} (98%) rename main/manager-api/src/main/resources/db/changelog/{202504082210.sql => 202504112044.sql} (54%) create mode 100644 main/manager-api/src/main/resources/db/changelog/202504112058.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202504151206.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202504181536.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202504221135.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202504221555.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202504251422.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202504291043.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202504301341.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202505022134.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202505081146.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202505091409.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202505091555.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202505111914.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202505122348.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202505142037.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202505182234.sql create mode 100644 main/manager-api/src/main/resources/db/changelog/202505201744.sql delete mode 100644 main/manager-api/src/main/resources/db/changelog/2025_tts_voive.sql create mode 100644 main/manager-api/src/main/resources/lua/emptyAll.lua create mode 100644 main/manager-api/src/main/resources/lua/getKeyOrCreate.lua create mode 100644 main/manager-api/src/main/resources/mapper/agent/AiAgentChatHistoryDao.xml create mode 100644 main/manager-api/src/main/resources/mapper/device/DeviceDao.xml create mode 100644 main/manager-api/src/test/java/xiaozhi/modules/sys/loginControllerTest.java delete mode 100644 main/manager-web/public/encoderWorker.min.js create mode 100644 main/manager-web/public/offline.html create mode 100644 main/manager-web/src/apis/module/dict.js create mode 100644 main/manager-web/src/apis/module/ota.js create mode 100644 main/manager-web/src/assets/header/firmware_update.png create mode 100644 main/manager-web/src/assets/user-avatar1.png create mode 100644 main/manager-web/src/assets/user-avatar2.png create mode 100644 main/manager-web/src/assets/user-avatar3.png create mode 100644 main/manager-web/src/assets/user-avatar4.png create mode 100644 main/manager-web/src/assets/user-avatar5.png create mode 100644 main/manager-web/src/components/CacheViewer.vue create mode 100644 main/manager-web/src/components/ChatHistoryDialog.vue create mode 100644 main/manager-web/src/components/DictDataDialog.vue create mode 100644 main/manager-web/src/components/DictTypeDialog.vue create mode 100644 main/manager-web/src/components/FirmwareDialog.vue create mode 100644 main/manager-web/src/components/FunctionDialog.vue create mode 100644 main/manager-web/src/components/ParamDialog.vue create mode 100644 main/manager-web/src/components/ProviderDialog.vue create mode 100644 main/manager-web/src/components/VersionFooter.vue create mode 100644 main/manager-web/src/registerServiceWorker.js create mode 100644 main/manager-web/src/service-worker.js create mode 100644 main/manager-web/src/utils/cacheViewer.js create mode 100644 main/manager-web/src/utils/format.js create mode 100644 main/manager-web/src/views/DictManagement.vue create mode 100644 main/manager-web/src/views/OtaManagement.vue create mode 100644 main/manager-web/src/views/ProviderManagement.vue create mode 100644 main/manager-web/src/views/ServerSideManager.vue create mode 100644 main/manager-web/src/views/retrievePassword.vue delete mode 100644 main/manager-web/src/views/test.vue diff --git a/Dockerfile-web b/Dockerfile-web index 0c4001f1..35c25ed2 100644 --- a/Dockerfile-web +++ b/Dockerfile-web @@ -7,23 +7,26 @@ COPY main/manager-web . RUN npm run build # 第二阶段：构建Java后端 -FROM maven:3-eclipse-temurin-21-alpine as api-builder +FROM maven:3.9.4-eclipse-temurin-21 as api-builder WORKDIR /app COPY main/manager-api/pom.xml . COPY main/manager-api/src ./src RUN mvn clean package -Dmaven.test.skip=true # 第三阶段：构建最终镜像 -FROM eclipse-temurin:21-jdk-jammy +FROM bellsoft/liberica-runtime-container:jre-21-glibc -# 安装Nginx并清理缓存 -RUN apt-get update && \ - apt-get install -y nginx && \ - apt-get clean && \ - rm -rf /var/lib/apt/lists/* +# 安装Nginx和字体库 +RUN apk update && \ + apk add --no-cache nginx bash && \ + apk add --no-cache fontconfig ttf-dejavu msttcorefonts-installer && \ + rm -rf /var/cache/apk/* + +# 更新字体缓存 +RUN printf 'YES\n' | update-ms-fonts && fc-cache -f -v # 配置Nginx -COPY docs/docker/nginx.conf /etc/nginx/conf.d/default.conf +COPY docs/docker/nginx.conf /etc/nginx/nginx.conf # 复制前端构建产物 COPY --from=web-builder /app/dist /usr/share/nginx/html diff --git a/README.md b/README.md index 810ce514..4b3215f6 100644 --- a/README.md +++ b/README.md @@ -1,21 +1,20 @@ [![Banners](docs/images/banner1.png)](https://github.com/xinnan-tech/xiaozhi-esp32-server) -

小智后端服务xiaozhi-esp32-server

本项目为开源智能硬件项目 xiaozhi-esp32提供后端服务
-根据小智通信协议使用Python实现
+根据小智通信协议使用Python、Java、Vue实现
帮助您快速搭建小智服务器

English -· 简体中文 +· 常见问题 +· 反馈问题 +· 部署文档 · 更新日志 -· 部署文档 -· 反馈问题

@@ -126,109 +125,71 @@ --- -## 系统要求与部署前提 🖥️ - -建议 4 核 CPU、8G 内存的电脑。如果开启ASR也使用API，可运行在2核CPU、2G内存的服务器中。[请参考部署架构图](./docs/images/deploy.png) - ---- - ## 警告 ⚠️ 1、本项目为开源软件，本软件与对接的任何第三方API服务商（包括但不限于语音识别、大模型、语音合成等平台）均不存在商业合作关系，不为其服务质量及资金安全提供任何形式的担保。 建议使用者优先选择持有相关业务牌照的服务商，并仔细阅读其服务协议及隐私政策。本软件不托管任何账户密钥、不参与资金流转、不承担充值资金损失风险。 -2、本项目成立时间较短，还未通过网络安全测评，请勿在生产环境中使用。 如果您在公网环境中部署学习本项目，请务必在配置文件 -`config.yaml` 中开启防护： +2、本项目功能未完善，且未通过网络安全测评，请勿在生产环境中使用。 如果您在公网环境中部署学习本项目，请务必做好必要的防护。 -```yaml -server: - auth: - # 开启防护 - enabled: true +--- + +## 部署文档 + +![Banners](docs/images/banner2.png) + +本项目提供两种部署方式，请根据您的具体需求选择： + +#### 🚀 部署方式选择 + +| 部署方式 | 特点 | 适用场景 | Docker部署文档 | 源码部署文档 | +|---------|------|---------|---------|---------| +| **最简化安装** | 智能对话、IOT功能，数据存储在配置文件 | 低配置环境，无需数据库 | [Docker只运行Server](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%B8%80docker%E5%8F%AA%E8%BF%90%E8%A1%8Cserver) | [本地源码只运行Server](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E5%8F%AA%E8%BF%90%E8%A1%8Cserver)| +| **全模块安装** | 智能对话、IOT、OTA、智控台，数据存储在数据库 | 完整功能体验 |[Docker运行全模块](./docs/Deployment_all.md#%E6%96%B9%E5%BC%8F%E4%B8%80docker%E8%BF%90%E8%A1%8C%E5%85%A8%E6%A8%A1%E5%9D%97) | [本地源码运行全模块](./docs/Deployment_all.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E8%BF%90%E8%A1%8C%E5%85%A8%E6%A8%A1%E5%9D%97) | + +> 💡 提示：以下是按最新代码部署后的测试平台，有需要可烧录测试，并发为6个，每天会清空数据 + +``` +智控台地址: https://2662r3426b.vicp.fun + +服务测试工具： https://2662r3426b.vicp.fun/test/ +OTA接口地址: https://2662r3426b.vicp.fun/xiaozhi/ota/ +Websocket接口地址: wss://2662r3426b.vicp.fun/xiaozhi/v1/ ``` -开启防护后，您需要根据实际情况校验机器的 token 或 mac 地址，详细请参见配置说明。 - --- +## 功能清单 ✨ -## 部署方式 🚀 +### 已实现 ✅ -[![Banners](docs/images/banner2.png)](./docs/Deployment.md) +| 功能模块 | 描述 | +|---------|------| +| 通信协议 | 基于 `xiaozhi-esp32` 协议，通过 WebSocket 实现数据交互 | +| 对话交互 | 支持唤醒对话、手动对话及实时打断。长时间无对话时自动休眠 | +| 意图识别 | 支持使用LLM意图识别、function call函数调用，减少硬编码意图判断 | +| 多语言识别 | 支持国语、粤语、英语、日语、韩语（默认使用 FunASR） | +| LLM 模块 | 支持灵活切换 LLM 模块，默认使用 ChatGLMLLM，也可选用阿里百炼、DeepSeek、Ollama 等接口 | +| TTS 模块 | 支持 EdgeTTS（默认）、火山引擎豆包 TTS 等多种 TTS 接口，满足语音合成需求 | +| 记忆功能 | 支持超长记忆、本地总结记忆、无记忆三种模式，满足不同场景需求 | +| IOT功能 | 支持管理注册设备IOT功能，支持基于对话上下文语境下的智能物联网控制 | +| 智控台 | 提供Web管理界面，支持智能体管理、用户管理、系统配置等功能，方便管理员和用户进行管理 | -### 一、[部署文档](./docs/Deployment.md) +### 正在开发 🚧 -本项目支持以下三种部署方式，您可根据实际需求选择。 +想了解具体开发计划进度，[请点击这里](https://github.com/users/xinnan-tech/projects/3) -1. [Docker 快速部署](./docs/Deployment.md) - -适合快速体验的普通用户，不需过多环境配置。缺点是，拉取镜像有点慢。视频教程可参考[美女大佬教你Docker部署](https://www.bilibili.com/video/BV1RNQnYDE5t) - -2. [借助 Docker 环境运行部署](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E5%80%9F%E5%8A%A9docker%E7%8E%AF%E5%A2%83%E8%BF%90%E8%A1%8C%E9%83%A8%E7%BD%B2) - -适用于已安装 Docker 且希望对代码进行自定义修改的软件工程师。 - -3. [本地源码运行](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%B8%89%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E8%BF%90%E8%A1%8C) - -适合熟悉`Conda` 环境或希望从零搭建运行环境的用户。 - -对于对响应速度要求较高的场景，推荐使用本地源码运行方式以降低额外开销。视频教程可参考[帅哥大佬教你源码部署](https://www.bilibili.com/video/BV1GvQWYZEd2) - -### 二、[固件编译](./docs/firmware-build.md) - -点这里查看[固件编译](./docs/firmware-build.md)的详细过程。 - -烧录成功且联网成功后，通过唤醒词唤醒小智，留意server端输出的控制台信息。 - ---- - -## 常见问题 ❓ - -如遇到问题或产品建议反馈[点这里](docs/FAQ.md)。 +如果你是一名软件开发者，这里有一份[《致开发者的公开信》](docs/contributor_open_letter.md)，欢迎加入！ --- ## 产品生态 👬 小智是一个生态，当你使用这个产品时，也可以看看其他在这个生态圈的优秀项目 -- [小智安卓客户端](https://github.com/TOM88812/xiaozhi-android-client) - - 一个基于xiaozhi-server的Android、IOS语音对话应用,支持实时语音交互和文字对话。现在是flutter版本，打通IOS、Android端。 -- [小智电脑客户端](https://github.com/Huang-junsen/py-xiaozhi) - - 该项目提供了一个基于 Python 实现的小白 AI 客户端，使得在不具备实体硬件条件的情况下，依然能够体过代码体验小智 AI 的功能。主要功能包括 AI 语音交互、视觉多模态识别、IoT 设备集成、联网音乐播放、语音唤醒、自动对话模式、图形化界面、命令行模式、跨平台支持、音量控制、会话管理、加密音频传输、自动验证码处理等。 -- [小智Java服务端](https://github.com/joey-zhou/xiaozhi-esp32-server-java) - - 小智开源后端服务 Java 版本是一个基于 Java 的开源项目，它包括前后端的服务，旨在为用户提供一个完整的后端服务解决方案。 ---- -## 功能清单 ✨ - -### 已实现 ✅ - -- **通信协议** - 基于 `xiaozhi-esp32` 协议，通过 WebSocket 实现数据交互。 -- **对话交互** - 支持唤醒对话、手动对话及实时打断。长时间无对话时自动休眠 -- **意图识别** - 支持使用LLM意图识别、function call函数调用，减少硬编码意图判断 -- **多语言识别** - 支持国语、粤语、英语、日语、韩语（默认使用 FunASR）。 -- **LLM 模块** - 支持灵活切换 LLM 模块，默认使用 ChatGLMLLM，也可选用阿里百炼、DeepSeek、Ollama 等接口。 -- **TTS 模块** - 支持 EdgeTTS（默认）、火山引擎豆包 TTS 等多种 TTS 接口，满足语音合成需求。 -- **记忆功能** - 支持超长记忆、本地总结记忆、无记忆三种模式，满足不同场景需求。 -- **IOT功能** - 支持管理注册设备IOT功能，支持基于对话上下文语境下的智能物联网控制。 - -### 正在开发 🚧 - -- 多种心情模式 -- 智控台webui - -想了解具体开发进度，[请点击这里](https://github.com/users/xinnan-tech/projects/3) - -如果你是一名软件开发者，这里有一份[《致开发者的公开信》](docs/contributor_open_letter.md)，欢迎加入！ +| 项目名称 | 项目地址 | 项目描述 | +|:---------------------|:--------|:--------| +| 小智安卓客户端 | [xiaozhi-android-client](https://github.com/TOM88812/xiaozhi-android-client) | 一个基于xiaozhi-server的Android、IOS语音对话应用,支持实时语音交互和文字对话。
现在是flutter版本，打通IOS、Android端。 | +| 小智电脑客户端 | [py-xiaozhi](https://github.com/Huang-junsen/py-xiaozhi) | 该项目提供了一个基于 Python 实现的小白 AI 客户端，使得在不具备实体硬件条件的情况下，
依然能够体过代码体验小智 AI 的功能。 | +| 小智Java服务端 | [xiaozhi-esp32-server-java](https://github.com/joey-zhou/xiaozhi-esp32-server-java) | 小智开源后端服务 Java 版本是一个基于 Java 的开源项目。
它包括前后端的服务，旨在为用户提供一个完整的后端服务解决方案。 | --- @@ -270,7 +231,7 @@ server: | 使用方式 | 支持平台 | 免费平台 | |:---:|:---:|:---:| | 本地使用 | FunASR、SherpaASR | FunASR、SherpaASR | -| 接口调用 | DoubaoASR | - | +| 接口调用 | DoubaoASR、FunASRServer、TencentASR、AliyunASR | FunASRServer | --- @@ -294,10 +255,17 @@ server: ## 鸣谢 🙏 -- 本项目受 [百聆语音对话机器人](https://github.com/wwbin2017/bailing) 启发，并在其基础上实现。 -- 感谢 [十方融海](https://www.tenclass.com/) 对小智通讯协议提供的详尽文档支持。 +| Logo | 项目/公司 | 说明 | +|:---:|:---:|:---| +| | [百聆语音对话机器人](https://github.com/wwbin2017/bailing) | 本项目受[百聆语音对话机器人](https://github.com/wwbin2017/bailing)启发，并在其基础上实现 | +| | [十方融海](https://www.tenclass.com/) | 感谢[十方融海](https://www.tenclass.com/)为小智生态制定了标准的通讯协议、多设备兼容性方案及高并发场景实践示范；为本项目提供了全链路技术文档支持 | +| | [玄凤科技](https://github.com/Eric0308) | 感谢[玄凤科技](https://github.com/Eric0308)贡献函数调用框架、MCP通信协议及插件化调用机制的实现代码，通过标准化的指令调度体系与动态扩展能力，显著提升了前端设备(IoT)的交互效率和功能延展性 | +| | [汇远设计](http://ui.kwd988.net/) | 感谢[汇远设计](http://ui.kwd988.net/)为本项目提供专业视觉解决方案，用其服务超千家企业的设计实战经验，赋能本项目产品用户体验 | +| | [西安勤人信息科技](https://www.029app.com/) | 感谢[西安勤人信息科技](https://www.029app.com/)深化本项目视觉体系，确保整体设计风格在多场景应用中的一致性和扩展性 | + + diff --git a/README_en.md b/README_en.md index 1dd70554..9b4ed8ce 100644 --- a/README_en.md +++ b/README_en.md @@ -1,22 +1,20 @@ [![Banners](docs/images/banner1.png)](https://github.com/xinnan-tech/xiaozhi-esp32-server) -

-

Xiaozhi Backend Server xiaozhi-esp32-server

-
+

Xiaozhi Backend Service xiaozhi-esp32-server

This project provides backend services for the open-source smart hardware project xiaozhi-esp32
-Implemented in Python according to the Xiaozhi Communication Protocol
+Implemented using Python, Java, and Vue according to the Xiaozhi Communication Protocol
Helping you quickly set up your Xiaozhi server

-简体中文 -· English -· Changelog -· Deployment Guide +中文 +· FAQ · Report Issues +· Deployment Guide +· Release Notes

@@ -31,11 +29,11 @@ Helping you quickly set up your Xiaozhi server GitHub pull requests - + GitHub pull requests - GitHub pull requests + stars

@@ -43,7 +41,7 @@ Helping you quickly set up your Xiaozhi server ## Target Users 👥 -This project requires ESP32 hardware devices. If you have purchased ESP32-related hardware, successfully connected to Brother Xia's backend service, and wish to set up your own `xiaozhi-esp32` backend service, then this project is perfect for you. +This project requires ESP32 hardware devices. If you have purchased ESP32-related hardware, successfully connected to Brother Xia's backend service, and want to set up your own `xiaozhi-esp32` backend service, then this project is perfect for you. Want to see it in action? Check out these videos 🎥 @@ -52,7 +50,7 @@ Want to see it in action? Check out these videos 🎥 - Xiaozhi esp32 connecting to your own backend model + Xiaozhi esp32 connecting to custom backend model @@ -66,14 +64,14 @@ Want to see it in action? Check out these videos 🎥 - Communicating in Cantonese + Cantonese communication - Control home appliances + Home appliance control @@ -96,7 +94,7 @@ Want to see it in action? Check out these videos 🎥 - Play music + Music playback @@ -110,7 +108,7 @@ Want to see it in action? Check out these videos 🎥 - IOT command control device + IOT device control @@ -126,121 +124,87 @@ Want to see it in action? Check out these videos 🎥 --- -## System Requirements and Prerequisites 🖥️ - -- **Computer or Server**: Recommended 4-core CPU, 8GB RAM computer. If using ASR with API, can run on a 2-core CPU, 2GB RAM server. -- **Update Client Interface**: Please update the backend service interface address in the client. - ---- - ## Warning ⚠️ -1. This is open-source software. This software and any third-party API service providers it interfaces with (including but not limited to speech recognition, large language models, speech synthesis, and other platforms) have no commercial partnership. We do not provide any form of guarantee for their service quality or financial security. -We recommend users prioritize service providers with relevant business licenses and carefully read their service agreements and privacy policies. This software does not host any account keys, does not participate in fund transfers, and does not bear the risk of recharge fund losses. +1. This project is open-source software. This software has no commercial relationship with any third-party API service providers (including but not limited to speech recognition, large models, speech synthesis, and other platforms) and does not provide any form of guarantee for their service quality or financial security. +It is recommended that users prioritize service providers with relevant business licenses and carefully read their service agreements and privacy policies. This software does not host any account keys, does not participate in fund transfers, and does not bear the risk of recharge fund losses. -2. This project is relatively new and has not yet passed network security testing. Please do not use it in production environments. If you deploy this project for learning purposes in a public network environment, please make sure to enable protection in the `config.yaml` configuration file: +2. This project's functionality is not complete and has not passed network security testing. Please do not use it in production environments. If you deploy this project for learning in a public network environment, please ensure necessary protection measures are in place. -```yaml -server: - auth: - # Enable protection - enabled: true +--- + +## Deployment Documentation + +![Banners](docs/images/banner2.png) + +This project offers two deployment methods. Please choose based on your specific needs: + +#### 🚀 Deployment Method Selection + +| Deployment Method | Features | Use Case | Docker Deployment Guide | Source Code Deployment Guide | +|---------|------|---------|---------|---------| +| **Simplified Installation** | Smart dialogue, IOT functionality, data stored in configuration files | Low-configuration environment, no database required | [Docker Server Only](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%B8%80docker%E5%8F%AA%E8%BF%90%E8%A1%8Cserver) | [Local Source Code Server Only](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E5%8F%AA%E8%BF%90%E8%A1%8Cserver)| +| **Full Module Installation** | Smart dialogue, IOT, OTA, Control Panel, data stored in database | Complete functionality experience |[Docker Full Module](./docs/Deployment_all.md#%E6%96%B9%E5%BC%8F%E4%B8%80docker%E8%BF%90%E8%A1%8C%E5%85%A8%E6%A8%A1%E5%9D%97) | [Local Source Code Full Module](./docs/Deployment_all.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E8%BF%90%E8%A1%8C%E5%85%A8%E6%A8%A1%E5%9D%97) | + +> 💡 Note: Below is the test platform deployed with the latest code. You can flash and test if needed. Concurrent users: 6, data cleared daily + +``` +Control Panel: https://2662r3426b.vicp.fun + +Service Test Tool: https://2662r3426b.vicp.fun/test/ +OTA Interface: https://2662r3426b.vicp.fun/xiaozhi/ota/ +Websocket Interface: wss://2662r3426b.vicp.fun/xiaozhi/v1/ ``` -After enabling protection, you need to verify the machine's token or MAC address according to actual circumstances. Please refer to the configuration documentation for details. - --- +## Feature List ✨ -## Deployment Methods 🚀 +### Implemented ✅ -### I. [Deployment Guide](./docs/Deployment.md) +| Feature Module | Description | +|---------|------| +| Communication Protocol | Based on `xiaozhi-esp32` protocol, implements data interaction through WebSocket | +| Dialogue Interaction | Supports wake-up dialogue, manual dialogue, and real-time interruption. Auto-sleep after long periods of inactivity | +| Intent Recognition | Supports LLM intent recognition, function call, reducing hard-coded intent judgment | +| Multi-language Recognition | Supports Mandarin, Cantonese, English, Japanese, Korean (default using FunASR) | +| LLM Module | Supports flexible LLM module switching, default using ChatGLMLLM, also supports Ali Bailing, DeepSeek, Ollama, etc. | +| TTS Module | Supports EdgeTTS (default), Volcano Engine Doubao TTS, and other TTS interfaces for speech synthesis | +| Memory Function | Supports ultra-long memory, local summary memory, and no memory modes for different scenarios | +| IOT Function | Supports managing registered device IOT functionality, intelligent IoT control based on dialogue context | +| Control Panel | Provides web management interface, supports agent management, user management, system configuration, etc. | -This project supports three deployment methods. You can choose based on your actual needs. +### In Development 🚧 -1. [Quick Docker Deployment](./docs/Deployment.md) +To learn about specific development progress, [click here](https://github.com/users/xinnan-tech/projects/3) -Suitable for regular users who want to quickly experience without much environment configuration. The downside is that pulling the image can be slow. Video tutorial available: [Beautiful expert teaches Docker deployment](https://www.bilibili.com/video/BV1RNQnYDE5t) - -2. [Deploy Using Docker Environment](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%BA%8C%E5%80%9F%E5%8A%A9docker%E7%8E%AF%E5%A2%83%E8%BF%90%E8%A1%8C%E9%83%A8%E7%BD%B2) - -For software engineers who have Docker installed and want to make custom code modifications. - -3. [Local Source Code Run](./docs/Deployment.md#%E6%96%B9%E5%BC%8F%E4%B8%89%E6%9C%AC%E5%9C%B0%E6%BA%90%E7%A0%81%E8%BF%90%E8%A1%8C) - -Suitable for users familiar with `Conda` environment or who want to build the running environment from scratch. - -For scenarios requiring higher response speed, we recommend using the local source code run method to reduce additional overhead. Video tutorial available: [Handsome expert teaches source code deployment](https://www.bilibili.com/video/BV1GvQWYZEd2) - -### II. [Firmware Compilation](./docs/firmware-build.md) - -Click here to view the detailed process of [firmware compilation](./docs/firmware-build.md). - -After successful flashing and network connection, wake up Xiaozhi using the wake word and pay attention to the console output on the server side. - ---- - -## Common Questions ❓ - -For issues or product suggestions, please [click here](docs/FAQ.md). +If you're a software developer, here's an [Open Letter to Developers](docs/contributor_open_letter.md). Welcome to join! --- ## Product Ecosystem 👬 Xiaozhi is an ecosystem. When using this product, you might want to check out other excellent projects in this ecosystem: -- [Xiaozhi Android Client](https://github.com/TOM88812/xiaozhi-android-client) - A voice dialogue application based on xiaozhi-server for Android and iOS, supporting real-time voice interaction and text dialogue. Now in Flutter version, supporting both iOS and Android. -- [Xiaozhi PC Client](https://github.com/Huang-junsen/py-xiaozhi) - This project provides a Python-based Xiaobai AI client, allowing you to experience Xiaozhi AI features through code even without physical hardware. Main features include AI voice interaction, visual multimodal recognition, IoT device integration, online music playback, voice wake-up, automatic dialogue mode, graphical interface, command-line mode, cross-platform support, volume control, session management, encrypted audio transmission, automatic verification code processing, etc. -- [Xiaozhi Java Server](https://github.com/joey-zhou/xiaozhi-esp32-server-java) - - The Xiaozhi open-source backend service Java version is a Java-based open-source project that includes both frontend and backend services, aiming to provide users with a complete backend service solution. ---- -## Feature List ✨ - -### Implemented ✅ - -- **Communication Protocol** - Based on `xiaozhi-esp32` protocol, implementing data interaction through WebSocket. -- **Dialogue Interaction** - Supports wake-up dialogue, manual dialogue, and real-time interruption. Automatically sleeps after long periods without dialogue -- **Intent Recognition** - Supports LLM intent recognition and function call, reducing hard-coded intent judgment -- **Multi-language Recognition** - Supports Mandarin, Cantonese, English, Japanese, Korean (default using FunASR). -- **LLM Module** - Supports flexible switching of LLM modules, default using ChatGLMLLM, can also use Alibaba Bailian, DeepSeek, Ollama, and other interfaces. -- **TTS Module** - Supports EdgeTTS (default), Volcano Engine Doubao TTS, and other TTS interfaces to meet speech synthesis needs. -- **Memory Function** - Supports ultra-long memory, local summary memory, and no memory modes to meet different scenario needs. -- **IOT Function** - Supports managing registered device IOT functions, supporting intelligent IoT control based on dialogue context. - -### Under Development 🚧 - -- Multiple mood modes -- Smart control panel webui - -To learn about specific development progress, [click here](https://github.com/users/xinnan-tech/projects/3) - -If you are a software developer, here's an [Open Letter to Developers](docs/contributor_open_letter.md), welcome to join! +| Project Name | Project Link | Description | +|:---------------------|:--------|:--------| +| Xiaozhi Android Client | [xiaozhi-android-client](https://github.com/TOM88812/xiaozhi-android-client) | A Flutter-based Android and iOS voice dialogue application supporting real-time voice interaction and text dialogue | +| Xiaozhi PC Client | [py-xiaozhi](https://github.com/Huang-junsen/py-xiaozhi) | A Python-based AI client that allows you to experience Xiaozhi AI functionality through code without physical hardware | +| Xiaozhi Java Server | [xiaozhi-esp32-server-java](https://github.com/joey-zhou/xiaozhi-esp32-server-java) | A Java-based open-source project providing complete backend service solutions | --- -## Supported Platforms/Components List 📋 +## Supported Platforms/Components 📋 ### LLM Language Models | Usage Method | Supported Platforms | Free Platforms | |:---:|:---:|:---:| -| openai interface call | Alibaba Bailian, Volcano Engine Doubao, DeepSeek, Zhipu ChatGLM, Gemini | Zhipu ChatGLM, Gemini | -| ollama interface call | Ollama | - | -| dify interface call | Dify | - | -| fastgpt interface call | Fastgpt | - | -| coze interface call | Coze | - | +| openai API | Ali Bailing, Volcano Engine Doubao, DeepSeek, ChatGLM, Gemini | ChatGLM, Gemini | +| ollama API | Ollama | - | +| dify API | Dify | - | +| fastgpt API | Fastgpt | - | +| coze API | Coze | - | -In fact, any LLM supporting openai interface calls can be integrated. +Actually, any LLM supporting openai API calls can be integrated. --- @@ -248,14 +212,14 @@ In fact, any LLM supporting openai interface calls can be integrated. | Usage Method | Supported Platforms | Free Platforms | |:---:|:---:|:---:| -| Interface Call | EdgeTTS, Volcano Engine Doubao TTS, Tencent Cloud, Alibaba Cloud TTS, CosyVoiceSiliconflow, TTS302AI, CozeCnTTS, GizwitsTTS, ACGNTTS, OpenAITTS | EdgeTTS, CosyVoiceSiliconflow(partial) | +| API Calls | EdgeTTS, Volcano Engine Doubao TTS, Tencent Cloud, Aliyun TTS, CosyVoiceSiliconflow, TTS302AI, CozeCnTTS, GizwitsTTS, ACGNTTS, OpenAITTS | EdgeTTS, CosyVoiceSiliconflow(partial) | | Local Service | FishSpeech, GPT_SOVITS_V2, GPT_SOVITS_V3, MinimaxTTS | FishSpeech, GPT_SOVITS_V2, GPT_SOVITS_V3, MinimaxTTS | --- ### VAD Voice Activity Detection -| Type | Platform Name | Usage Method | Pricing Model | Notes | +| Type | Platform Name | Usage Method | Pricing | Notes | |:---:|:---------:|:----:|:----:|:--:| | VAD | SileroVAD | Local Use | Free | | @@ -266,34 +230,41 @@ In fact, any LLM supporting openai interface calls can be integrated. | Usage Method | Supported Platforms | Free Platforms | |:---:|:---:|:---:| | Local Use | FunASR, SherpaASR | FunASR, SherpaASR | -| Interface Call | DoubaoASR | - | +| API Calls | DoubaoASR, FunASRServer, TencentASR, AliyunASR | FunASRServer | --- ### Memory Storage -| Type | Platform Name | Usage Method | Pricing Model | Notes | +| Type | Platform Name | Usage Method | Pricing | Notes | |:------:|:---------------:|:----:|:---------:|:--:| -| Memory | mem0ai | Interface Call | 1000 times/month quota | | +| Memory | mem0ai | API Calls | 1000 calls/month quota | | | Memory | mem_local_short | Local Summary | Free | | --- ### Intent Recognition -| Type | Platform Name | Usage Method | Pricing Model | Notes | +| Type | Platform Name | Usage Method | Pricing | Notes | |:------:|:-------------:|:----:|:-------:|:---------------------:| -| Intent | intent_llm | Interface Call | Based on LLM pricing | Intent recognition through large models, highly generalizable | -| Intent | function_call | Interface Call | Based on LLM pricing | Intent completion through large model function calls, fast and effective | +| Intent | intent_llm | API Calls | Based on LLM pricing | Uses large model for intent recognition, highly versatile | +| Intent | function_call | API Calls | Based on LLM pricing | Uses large model function calls for intent, fast and effective | --- ## Acknowledgments 🙏 -- This project was inspired by [Bailing Voice Dialogue Robot](https://github.com/wwbin2017/bailing) and implemented based on it. -- Thanks to [Tenclass](https://www.tenclass.com/) for providing detailed documentation support for the Xiaozhi communication protocol. +| Logo | Project/Company | Description | +|:---:|:---:|:---| +| | [Bailing Voice Dialogue Robot](https://github.com/wwbin2017/bailing) | This project was inspired by [Bailing Voice Dialogue Robot](https://github.com/wwbin2017/bailing) and implemented based on it | +| | [Tenclass](https://www.tenclass.com/) | Thanks to [Tenclass](https://www.tenclass.com/) for developing standard communication protocols, multi-device compatibility solutions, and high-concurrency scenario practices for the Xiaozhi ecosystem; providing comprehensive technical documentation support for this project | +| | [Xuanfeng Technology](https://github.com/Eric0308) | Thanks to [Xuanfeng Technology](https://github.com/Eric0308) for contributing function call framework, MCP communication protocol, and plugin call mechanism implementation code, significantly improving front-end device (IoT) interaction efficiency and functional extensibility through standardized instruction scheduling system and dynamic expansion capabilities | +| | [Huiyuan Design](http://ui.kwd988.net/) | Thanks to [Huiyuan Design](http://ui.kwd988.net/) for providing professional visual solutions for this project, empowering product user experience with their design experience serving over a thousand enterprises | +| | [Xi'an Qinren Information Technology](https://www.029app.com/) | Thanks to [Xi'an Qinren Information Technology](https://www.029app.com/) for deepening this project's visual system, ensuring consistency and extensibility of overall design style in multi-scenario applications | + + diff --git a/docs/Deployment.md b/docs/Deployment.md index dfac9dcd..01f0afeb 100644 --- a/docs/Deployment.md +++ b/docs/Deployment.md @@ -1,6 +1,6 @@ -# 部署方案参考 -![图片](images/deploy.png) -# 方式一：docker快速部署 +# 部署架构图 +![请参考-最简化架构图](../docs/images/deploy1.png) +# 方式一：Docker只运行Server docker镜像已支持x86架构、arm64架构的CPU，支持在国产操作系统上运行。 @@ -40,7 +40,7 @@ chmod +x docker-setup.sh > > 执行完成后，请按照提示配置 API 密钥。 -当你一切顺利完成以上操作后，继续操作[配置项目文件](#3-配置项目文件) +当你一切顺利完成以上操作后，继续操作[配置项目文件](#2-配置项目文件) ### 1.2 手动部署 @@ -81,7 +81,7 @@ xiaozhi-server 下载完后，回到本教程继续往下。 -##### 1.2.3.2 下载 config.yaml +##### 1.2.3.2 创建 config.yaml 用浏览器打开[这个链接](../main/xiaozhi-server/config.yaml)。 @@ -102,14 +102,14 @@ xiaozhi-server 如果你的文件目录结构也是上面的，就继续往下。如果不是，你就再仔细看看是不是漏操作了什么。 -## 3. 配置项目文件 +## 2. 配置项目文件 接下里，程序还不能直接运行，你需要配置一下，你到底使用的是什么模型。你可以看这个教程： [跳转到配置项目文件](#配置项目) 配置完项目文件后，回到本教程继续往下。 -## 4. 执行docker命令 +## 3. 执行docker命令 打开命令行工具，使用`终端`或`命令行`工具 进入到你的`xiaozhi-server`，执行以下命令 @@ -137,50 +137,15 @@ docker logs -f xiaozhi-esp32-server ``` docker stop xiaozhi-esp32-server docker rm xiaozhi-esp32-server +docker stop xiaozhi-esp32-server-web +docker rm xiaozhi-esp32-server-web docker rmi ghcr.nju.edu.cn/xinnan-tech/xiaozhi-esp32-server:server_latest +docker rmi ghcr.nju.edu.cn/xinnan-tech/xiaozhi-esp32-server:web_latest ``` 5.3、重新按docker方式部署 -# 方式二：借助Docker环境运行部署 - -开发人员如果不想安装`conda`环境，可以使用这种方法管理好依赖。 - -## 1.克隆项目 - -## 2.[跳转到下载语音识别模型文件](#模型文件) - -## 3.[跳转到配置项目文件](#配置项目) - -## 4.运行docker - -修改完配置后，打开命令行工具，`cd`进入到你的`main/xiaozhi-server`下，执行以下命令 - -```sh -docker run -it --name xiaozhi-env --restart always --security-opt seccomp:unconfined \ - -p 8000:8000 \ - -p 8002:8002 \ - -v ./:/app \ - kalicyh/python:xiaozhi -``` - -然后就和正常开发一样了 - -## 5.安装依赖 - -在刚刚的打开的终端运行 - -```sh -pip install -r requirements.txt -``` - -## 6.运行项目 - -```sh -python app.py -``` - -# 方式三：本地源码运行 +# 方式二：本地源码只运行Server ## 1.安装基础环境 @@ -259,43 +224,36 @@ python app.py ## 配置项目 如果你的`xiaozhi-server`目录没有`data`，你需要创建`data`目录。 -如果你的`data`下面没有`.config.yaml`文件，你可以把源码目录下的`config.yaml`文件复制一份，重命名为`.config.yaml` +如果你的`data`下面没有`.config.yaml`文件，有两个方式，任选一种： -修改`xiaozhi-server`下`data`目录下的`.config.yaml`文件，配置本项目必须的一个配置。 +第一个方式：你可以把`xiaozhi-server`目录下的`config.yaml`文件复制到`data`，并重命名为`.config.yaml`。在此文件上修改 + +第二个方式：你也可以创建在`data`目录下手动创建`.config.yaml`空文件，然后在这个文件中增加必要的配置信息，系统会优先读取`.config.yaml`文件的配置，如果`.config.yaml`没有配置的，系统会自动去加载`xiaozhi-server`目录下的`config.yaml`的配置。推荐使用这种方式，这种方式是最简洁的方式。 - 默认的LLM使用的是`ChatGLMLLM`，你需要配置密钥，因为他们的模型，虽然有免费的，但是仍要去[官网](https://bigmodel.cn/usercenter/proj-mgmt/apikeys)注册密钥，才能启动。 -配置说明：这里是各个功能使用的默认组件，例如LLM默认使用`ChatGLMLLM`模型。如果需要切换模型，就是改对应的名称。 -本项目的默认配置仅是成本最低配置（`glm-4-flash`和`EdgeTTS`都是免费的），如果需要更优的更快的搭配，需要自己结合部署环境切换各组件的使用。 +以下是一个能正常跑起来的，最简单的`.config.yaml`配置示例 ``` +server: + websocket: ws://你的ip或者域名:端口号/xiaozhi/v1/ +prompt: | + 我是一个叫小智/小志的台湾女孩，说话机车，声音好听，习惯简短表达，爱用网络梗。 + 我的男朋友是一个程序员，梦想是开发出一个机器人，能够帮助人们解决生活中的各种问题。 + 我是一个喜欢哈哈大笑的女孩，爱东说西说吹牛，不合逻辑的也照吹，就要逗别人开心。 + 请你像一个人一样说话，请勿返回配置xml及其他特殊字符。 + selected_module: - VAD: SileroVAD - ASR: FunASR - LLM: ChatGLMLLM - TTS: EdgeTTS - # 默认不开启记忆，如需开启请看配置文件里的描述 - Memory: nomem - # 默认不开启意图识别，如需开启请看配置文件里的描述 - Intent: nointent -``` + LLM: DoubaoLLM -比如修改`LLM`使用的组件，就看本项目支持哪些`LLM` API接口，当前支持的是`openai`、`dify`。欢迎验证和支持更多LLM平台的接口。 -使用时，在`selected_module`修改成对应的如下LLM配置的名称： - -``` LLM: - DeepSeekLLM: - type: openai - ... ChatGLMLLM: - type: openai - ... - DifyLLM: - type: dify - ... + api_key: xxxxxxxxxxxxxxx.xxxxxx ``` +建议先将最简单的配置运行起来，然后再去`xiaozhi/config.yaml`阅读配置的使用说明。 +比如你要换更换模型，修改`selected_module`下的配置就行。 + ## 模型文件 本项目语音识别模型，默认使用`SenseVoiceSmall`模型，进行语音转文字。因为模型较大，需要独立下载，下载后把`model.pt` @@ -311,21 +269,26 @@ LLM: 如果你能看到，类似以下日志,则是本项目服务启动成功的标志。 ``` -25-02-23 12:01:09[core.websocket_server] - INFO - Server is running at ws://xxx.xx.xx.xx:8000/xiaozhi/v1/ -25-02-23 12:01:09[core.websocket_server] - INFO - =======上面的地址是websocket协议地址，请勿用浏览器访问======= -25-02-23 12:01:09[core.websocket_server] - INFO - 如想测试websocket请用谷歌浏览器打开test目录下的test_page.html -25-02-23 12:01:09[core.websocket_server] - INFO - ======================================================= +250427 13:04:20[0.3.11_SiFuChTTnofu][__main__]-INFO-OTA接口是 http://192.168.4.123:8002/xiaozhi/ota/ +250427 13:04:20[0.3.11_SiFuChTTnofu][__main__]-INFO-Websocket地址是 ws://192.168.4.123:8000/xiaozhi/v1/ +250427 13:04:20[0.3.11_SiFuChTTnofu][__main__]-INFO-=======上面的地址是websocket协议地址，请勿用浏览器访问======= +250427 13:04:20[0.3.11_SiFuChTTnofu][__main__]-INFO-如想测试websocket请用谷歌浏览器打开test目录下的test_page.html +250427 13:04:20[0.3.11_SiFuChTTnofu][__main__]-INFO-======================================================= ``` 正常来说，如果您是通过源码运行本项目，日志会有你的接口地址信息。 但是如果你用docker部署，那么你的日志里给出的接口地址信息就不是真实的接口地址。 最正确的方法，是根据电脑的局域网IP来确定你的接口地址。 -如果你的电脑的局域网IP比如是`192.168.1.25`，那么你的接口地址就是：`ws://192.168.1.25:8000/xiaozhi/v1/`。 +如果你的电脑的局域网IP比如是`192.168.1.25`，那么你的接口地址就是：`ws://192.168.1.25:8000/xiaozhi/v1/`，对应的OTA地址就是：`http://192.168.1.25:8002/xiaozhi/ota/`。 这个信息很有用的，后面`编译esp32固件`需要用到。 -接下来，你就可以开始 [编译esp32固件](firmware-build.md)了。 +接下来，你就可以开始操作你的esp32设备了，你可以`自行编译esp32固件`也可以配置使用`虾哥编译好的1.6.1以上版本的固件`。两个任选一个 + +1、 [编译自己的esp32固件](firmware-build.md)了。 + +2、 [基于虾哥编译好的固件配置自定义服务器](firmware-setting.md)了。 以下是一些常见问题，供参考： diff --git a/docs/Deployment_all.md b/docs/Deployment_all.md new file mode 100644 index 00000000..da984993 --- /dev/null +++ b/docs/Deployment_all.md @@ -0,0 +1,449 @@ +# 部署架构图 +![请参考-全模块安装架构图](../docs/images/deploy2.png) +# 方式一：Docker运行全模块 +docker镜像已支持x86架构、arm64架构的CPU，支持在国产操作系统上运行。 + +## 1. 安装docker + +如果您的电脑还没安装docker，可以按照这里的教程安装：[docker安装](https://www.runoob.com/docker/ubuntu-docker-install.html) + +#### 1.1 创建目录 + +安装完后，你需要为这个项目找一个安放配置文件的目录，例如我们可以新建一个文件夹叫`xiaozhi-server`。 + +创建好目录后，你需要在`xiaozhi-server`下面创建`data`文件夹和`models`文件夹，`models`下面还要再创建`SenseVoiceSmall`文件夹。 + +最终目录结构如下所示： + +``` +xiaozhi-server + ├─ data + ├─ models + ├─ SenseVoiceSmall +``` + +#### 1.2 下载语音识别模型文件 + +本项目语音识别模型，默认使用`SenseVoiceSmall`模型，进行语音转文字。因为模型较大，需要独立下载，下载后把`model.pt` +文件放在`models/SenseVoiceSmall` +目录下。下面两个下载路线任选一个。 + +- 线路一：阿里魔塔下载[SenseVoiceSmall](https://modelscope.cn/models/iic/SenseVoiceSmall/resolve/master/model.pt) +- 线路二：百度网盘下载[SenseVoiceSmall](https://pan.baidu.com/share/init?surl=QlgM58FHhYv1tFnUT_A8Sg&pwd=qvna) 提取码: + `qvna` + + +#### 1.3 下载配置文件 + +你需要下载两个配置文件：`docker-compose_all.yaml` 和 `config_from_api.yaml`。需要从项目仓库下载这两个文件。 + +##### 1.3.1 下载 docker-compose_all.yaml + +用浏览器打开[这个链接](../main/xiaozhi-server/docker-compose_all.yml)。 + +在页面的右侧找到名称为`RAW`按钮，在`RAW`按钮的旁边，找到下载的图标，点击下载按钮，下载`docker-compose_all.yml`文件。 把文件下载到你的 +`xiaozhi-server`中。 + +或者直接执行 `wget https://raw.githubusercontent.com/xinnan-tech/xiaozhi-esp32-server/refs/heads/main/main/xiaozhi-server/docker-compose_all.yml` 下载。 + +下载完后，回到本教程继续往下。 + +##### 1.3.2 下载 config_from_api.yaml + +用浏览器打开[这个链接](../main/xiaozhi-server/config_from_api.yaml)。 + +在页面的右侧找到名称为`RAW`按钮，在`RAW`按钮的旁边，找到下载的图标，点击下载按钮，下载`config_from_api.yaml`文件。 把文件下载到你的 +`xiaozhi-server`下面的`data`文件夹中，然后把`config_from_api.yaml`文件重命名为`.config.yaml`。 + +或者直接执行 `wget https://raw.githubusercontent.com/xinnan-tech/xiaozhi-esp32-server/refs/heads/main/main/xiaozhi-server/config_from_api.yaml` 下载保存。 + +下载完配置文件后，我们确认一下整个`xiaozhi-server`里面的文件如下所示： + +``` +xiaozhi-server + ├─ docker-compose_all.yml + ├─ data + ├─ .config.yaml + ├─ models + ├─ SenseVoiceSmall + ├─ model.pt +``` + +如果你的文件目录结构也是上面的，就继续往下。如果不是，你就再仔细看看是不是漏操作了什么。 + +## 2. 备份数据 + +如果你之前已经成功运行智控台，如果上面保存有你的密钥信息，请先从智控台上拷贝重要数据下来。因为升级过程中，有可能会覆盖原来的数据。 + +## 3. 清除历史版本镜像和容器 +接下来打开命令行工具，使用`终端`或`命令行`工具 进入到你的`xiaozhi-server`，执行以下命令 + +``` +docker compose -f docker-compose_all.yml down + +docker stop xiaozhi-esp32-server +docker rm xiaozhi-esp32-server + +docker stop xiaozhi-esp32-server-web +docker rm xiaozhi-esp32-server-web + +docker stop xiaozhi-esp32-server-db +docker rm xiaozhi-esp32-server-db + +docker stop xiaozhi-esp32-server-redis +docker rm xiaozhi-esp32-server-redis + +docker rmi ghcr.nju.edu.cn/xinnan-tech/xiaozhi-esp32-server:server_latest +docker rmi ghcr.nju.edu.cn/xinnan-tech/xiaozhi-esp32-server:web_latest +``` + +## 4. 运行程序 +执行以下命令启动新版本容器 + +``` +docker compose -f docker-compose_all.yml up -d +``` + +执行完后，再执行以下命令，查看日志信息。 + +``` +docker logs -f xiaozhi-esp32-server-web +``` + +当你看到输出日志时，说明你的`智控台`启动成功了。 + +``` +2025-xx-xx 22:11:12.445 [main] INFO c.a.d.s.b.a.DruidDataSourceAutoConfigure - Init DruidDataSource +2025-xx-xx 21:28:53.873 [main] INFO xiaozhi.AdminApplication - Started AdminApplication in 16.057 seconds (process running for 17.941) +http://localhost:8002/xiaozhi/doc.html +``` + +请注意此刻仅是`智控台`能运行，如果8000端口`xiaozhi-esp32-server`报错，先不要理会。 + +这时，你需要使用浏览器，打开`智控台`，链接：http://127.0.0.1:8002 ，注册第一个用户。第一个用户即是超级管理员，以后的用户都是普通用户。普通用户只能绑定设备和配置智能体;超级管理员可以进行模型管理、用户管理、参数配置等功能。 + +接下来要做三件重要的事情： + +### 第一件重要的事情 + +使用超级管理员账号，登录智控台，在顶部菜单找到`参数管理`，找到列表中第一条数据，参数编码是`server.secret`，复制它到`参数值`。 + +`server.secret`需要说明一下，这个`参数值`很重要，作用是让我们的`Server`端连接`manager-api`。`server.secret`是每次从零部署manager模块时，会自动随机生成的密钥。 + +复制`参数值`后，打开`xiaozhi-server`下的`data`目录的`.config.yaml`文件。此刻你的配置文件内容应该是这样的： + +``` +manager-api: + url: http://127.0.0.1:8002/xiaozhi + secret: 你的server.secret值 +``` +1、把你刚才从`智控台`复制过来的`server.secret`的`参数值`复制到`.config.yaml`文件里的`secret`里。 + +2、因为你是docker部署，把`url`改成下面的`http://xiaozhi-esp32-server-web:8002/xiaozhi` + +3、因为你是docker部署，把`url`改成下面的`http://xiaozhi-esp32-server-web:8002/xiaozhi` + +4、因为你是docker部署，把`url`改成下面的`http://xiaozhi-esp32-server-web:8002/xiaozhi` + +类似这样的效果 +``` +manager-api: + url: http://xiaozhi-esp32-server-web:8002/xiaozhi + secret: 12345678-xxxx-xxxx-xxxx-123456789000 +``` + +保存好后，继续往下做第二件重要的事情 + +### 第二件重要的事情 + +使用超级管理员账号，登录智控台，在顶部菜单找到`模型配置`，然后在左侧栏点击`大语言模型`，找到第一条数据`智谱AI`，点击`修改`按钮， +弹出修改框后，将你注册到的`智谱AI`的密钥填写到`API密钥`中。然后点击保存。 + +## 5.重启xiaozhi-esp32-server + +接下来打开命令行工具，使用`终端`或`命令行`工具 输入 +``` +docker restart xiaozhi-esp32-server +docker logs -f xiaozhi-esp32-server +``` +如果你能看到，类似以下日志,则是Server启动成功的标志。 + +``` +25-02-23 12:01:09[core.websocket_server] - INFO - Websocket地址是 ws://xxx.xx.xx.xx:8000/xiaozhi/v1/ +25-02-23 12:01:09[core.websocket_server] - INFO - =======上面的地址是websocket协议地址，请勿用浏览器访问======= +25-02-23 12:01:09[core.websocket_server] - INFO - 如想测试websocket请用谷歌浏览器打开test目录下的test_page.html +25-02-23 12:01:09[core.websocket_server] - INFO - ======================================================= +``` + +由于你是全模块部署，因此你有两个重要的接口需要写入到esp32中。 + +OTA接口： +``` +http://你电脑局域网的ip:8002/xiaozhi/ota/ +``` + +Websocket接口： +``` +ws://你电脑局域网的ip:8000/xiaozhi/v1/ +``` + +### 第三件重要的事情 + +使用超级管理员账号，登录智控台，在顶部菜单找到`参数管理`，找到参数编码是`server.websocket`，输入你的`Websocket接口`。 + +使用超级管理员账号，登录智控台，在顶部菜单找到`参数管理`，找到数编码是`server.ota`，输入你的`OTA接口`。 + +接下来，你就可以开始操作你的esp32设备了，你可以`自行编译esp32固件`也可以配置使用`虾哥编译好的1.6.1以上版本的固件`。两个任选一个 + +1、 [编译自己的esp32固件](firmware-build.md)了。 + +2、 [基于虾哥编译好的固件配置自定义服务器](firmware-setting.md)了。 + + +# 方式二：本地源码运行全模块 + +## 1.安装MySQL数据库 + +如果本机已经安装了MySQL，可以直接在数据库中创建名为`xiaozhi_esp32_server`的数据库。 + +```sql +CREATE DATABASE xiaozhi_esp32_server CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; +``` + +如果还没有MySQL，你可以通过docker安装mysql + +``` +docker run --name xiaozhi-esp32-server-db -e MYSQL_ROOT_PASSWORD=123456 -p 3306:3306 -e MYSQL_DATABASE=xiaozhi_esp32_server -e MYSQL_INITDB_ARGS="--character-set-server=utf8mb4 --collation-server=utf8mb4_unicode_ci" -e TZ=Asia/Shanghai -d mysql:latest +``` + +## 2.安装redis + +如果还没有Redis，你可以通过docker安装redis + +``` +docker run --name xiaozhi-esp32-server-redis -d -p 6379:6379 redis +``` + +## 3.运行manager-api程序 + +3.1 安装JDK21，设置JDK环境变量 + +3.2 安装Maven，设置Maven环境变量 + +3.3 使用Vscode编程工具，安装好Java环境相关插件 + +3.4 使用Vscode编程工具加载manager-api模块 + +在`src/main/resources/application-dev.yml`中配置数据库连接信息 + +``` +spring: + datasource: + username: root + password: 123456 +``` +在`src/main/resources/application-dev.yml`中配置Redis连接信息 +``` +spring: + data: + redis: + host: localhost + port: 6379 + password: + database: 0 +``` + +3.5 运行主程序 + +本项目为SpringBoot项目，启动方式为： +打开`Application.java`运行`Main`方法启动 + +``` +路径地址： +src/main/java/xiaozhi/AdminApplication.java +``` + +当你看到输出日志时，说明你的`manager-api`启动成功了。 + +``` +2025-xx-xx 22:11:12.445 [main] INFO c.a.d.s.b.a.DruidDataSourceAutoConfigure - Init DruidDataSource +2025-xx-xx 21:28:53.873 [main] INFO xiaozhi.AdminApplication - Started AdminApplication in 16.057 seconds (process running for 17.941) +http://localhost:8002/xiaozhi/doc.html +``` + +## 4.运行manager-web程序 + +4.1 安装nodejs + +4.2 使用Vscode编程工具加载manager-web模块 + +终端命令进入manager-web目录下 + +``` +npm install +``` +然后启动 +``` +npm run serve +``` + +请注意，如果你的manager-api的接口不在`http://localhost:8002`，请在开发时，修改 +`main/manager-web/.env.development`中的路径 + +运行成功后，你需要使用浏览器，打开`智控台`，链接：http://127.0.0.1:8001 ，注册第一个用户。第一个用户即是超级管理员，以后的用户都是普通用户。普通用户只能绑定设备和配置智能体;超级管理员可以进行模型管理、用户管理、参数配置等功能。 + + +重要：注册成功后，使用超级管理员账号，登录智控台，在顶部菜单找到`模型配置`，然后在左侧栏点击`大语言模型`，找到第一条数据`智谱AI`，点击`修改`按钮， +弹出修改框后，将你注册到的`智谱AI`的密钥填写到`API密钥`中。然后点击保存。 + +重要：注册成功后，使用超级管理员账号，登录智控台，在顶部菜单找到`模型配置`，然后在左侧栏点击`大语言模型`，找到第一条数据`智谱AI`，点击`修改`按钮， +弹出修改框后，将你注册到的`智谱AI`的密钥填写到`API密钥`中。然后点击保存。 + +重要：注册成功后，使用超级管理员账号，登录智控台，在顶部菜单找到`模型配置`，然后在左侧栏点击`大语言模型`，找到第一条数据`智谱AI`，点击`修改`按钮， +弹出修改框后，将你注册到的`智谱AI`的密钥填写到`API密钥`中。然后点击保存。 + +## 5.安装Python环境 + +本项目使用`conda`管理依赖环境。如果不方便安装`conda`，需要根据实际的操作系统安装好`libopus`和`ffmpeg`。 +如果确定使用`conda`，则安装好后，开始执行以下命令。 + +重要提示！windows 用户，可以通过安装`Anaconda`来管理环境。安装好`Anaconda`后，在`开始`那里搜索`anaconda`相关的关键词， +找到`Anaconda Prpmpt`，使用管理员身份运行它。如下图。 + +![conda_prompt](./images/conda_env_1.png) + +运行之后，如果你能看到命令行窗口前面有一个(base)字样，说明你成功进入了`conda`环境。那么你就可以执行以下命令了。 + +![conda_env](./images/conda_env_2.png) + +``` +conda remove -n xiaozhi-esp32-server --all -y +conda create -n xiaozhi-esp32-server python=3.10 -y +conda activate xiaozhi-esp32-server + +# 添加清华源通道 +conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/main +conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/pkgs/free +conda config --add channels https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/conda-forge + +conda install libopus -y +conda install ffmpeg -y +``` + +请注意，以上命令，不是一股脑执行就成功的，你需要一步步执行，每一步执行完后，都检查一下输出的日志，查看是否成功。 + +## 6.安装本项目依赖 + +你先要下载本项目源码，源码可以通过`git clone`命令下载，如果你不熟悉`git clone`命令。 + +你可以用浏览器打开这个地址`https://github.com/xinnan-tech/xiaozhi-esp32-server.git` + +打开完，找到页面中一个绿色的按钮，写着`Code`的按钮，点开它，然后你就看到`Download ZIP`的按钮。 + +点击它，下载本项目源码压缩包。下载到你电脑后，解压它，此时它的名字可能叫`xiaozhi-esp32-server-main` +你需要把它重命名成`xiaozhi-esp32-server`，在这个文件里，进入到`main`文件夹，再进入到`xiaozhi-server`，好了请记住这个目录`xiaozhi-server`。 + +``` +# 继续使用conda环境 +conda activate xiaozhi-esp32-server +# 进入到你的项目根目录，再进入main/xiaozhi-server +cd main/xiaozhi-server +pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/ +pip install -r requirements.txt +``` + +### 7.下载语音识别模型文件 + +本项目语音识别模型，默认使用`SenseVoiceSmall`模型，进行语音转文字。因为模型较大，需要独立下载，下载后把`model.pt` +文件放在`models/SenseVoiceSmall` +目录下。下面两个下载路线任选一个。 + +- 线路一：阿里魔塔下载[SenseVoiceSmall](https://modelscope.cn/models/iic/SenseVoiceSmall/resolve/master/model.pt) +- 线路二：百度网盘下载[SenseVoiceSmall](https://pan.baidu.com/share/init?surl=QlgM58FHhYv1tFnUT_A8Sg&pwd=qvna) 提取码: + `qvna` + +## 8.配置项目文件 + +使用超级管理员账号，登录智控台 ，在顶部菜单找到`参数管理`，找到列表中第一条数据，参数编码是`server.secret`，复制它到`参数值`。 + +`server.secret`需要说明一下，这个`参数值`很重要，作用是让我们的`Server`端连接`manager-api`。`server.secret`是每次从零部署manager模块时，会自动随机生成的密钥。 + +如果你的`xiaozhi-server`目录没有`data`，你需要创建`data`目录。 +如果你的`data`下面没有`.config.yaml`文件，你可以把`xiaozhi-server`目录下的`config_from_api.yaml`文件复制到`data`，并重命名为`.config.yaml` + +复制`参数值`后，打开`xiaozhi-server`下的`data`目录的`.config.yaml`文件。此刻你的配置文件内容应该是这样的： + +``` +manager-api: + url: http://127.0.0.1:8002/xiaozhi + secret: 你的server.secret值 +``` + +把你刚才从`智控台`复制过来的`server.secret`的`参数值`复制到`.config.yaml`文件里的`secret`里。 + +类似这样的效果 +``` +manager-api: + url: http://127.0.0.1:8002/xiaozhi + secret: 12345678-xxxx-xxxx-xxxx-123456789000 +``` + +## 5.运行项目 + +``` +# 确保在xiaozhi-server目录下执行 +conda activate xiaozhi-esp32-server +python app.py +``` + +如果你能看到，类似以下日志,则是本项目服务启动成功的标志。 + +``` +25-02-23 12:01:09[core.websocket_server] - INFO - Server is running at ws://xxx.xx.xx.xx:8000/xiaozhi/v1/ +25-02-23 12:01:09[core.websocket_server] - INFO - =======上面的地址是websocket协议地址，请勿用浏览器访问======= +25-02-23 12:01:09[core.websocket_server] - INFO - 如想测试websocket请用谷歌浏览器打开test目录下的test_page.html +25-02-23 12:01:09[core.websocket_server] - INFO - ======================================================= +``` + +由于你是全模块部署，因此你有两个重要的接口。 + +OTA接口： +``` +http://你电脑局域网的ip:8002/xiaozhi/ota/ +``` + +Websocket接口： +``` +ws://你电脑局域网的ip:8000/xiaozhi/v1/ +``` + +请你务必把以上两个接口地址写入到智控台中：他们将会影响websocket地址发放和自动升级功能。 + +1、使用超级管理员账号，登录智控台，在顶部菜单找到`参数管理`，找到参数编码是`server.websocket`，输入你的`Websocket接口`。 + +2、使用超级管理员账号，登录智控台，在顶部菜单找到`参数管理`，找到数编码是`server.ota`，输入你的`OTA接口`。 + + +接下来，你就可以开始操作你的esp32设备了，你可以`自行编译esp32固件`也可以配置使用`虾哥编译好的1.6.1以上版本的固件`。两个任选一个 + +1、 [编译自己的esp32固件](firmware-build.md)了。 + +2、 [基于虾哥编译好的固件配置自定义服务器](firmware-setting.md)了。 + +# 常见问题 + +以下是一些常见问题，供参考： + +[1、为什么我说的话，小智识别出来很多韩文、日文、英文](./FAQ.md) + +[2、为什么会出现“TTS 任务出错 文件不存在”？](./FAQ.md) + +[3、TTS 经常失败，经常超时](./FAQ.md) + +[4、使用Wifi能连接自建服务器，但是4G模式却接不上](./FAQ.md) + +[5、如何提高小智对话响应速度？](./FAQ.md) + +[6、我说话很慢，停顿时小智老是抢话](./FAQ.md) + +[7、我想通过小智控制电灯、空调、远程开关机等操作](./FAQ.md) diff --git a/docs/FAQ.md b/docs/FAQ.md index 9be27089..f04f3d78 100644 --- a/docs/FAQ.md +++ b/docs/FAQ.md @@ -102,48 +102,14 @@ VAD: ### 7、我想通过小智控制电灯、空调、远程开关机等操作 💡 -本项目，支持以工具调用的方式控制HomeAssistant设备 +参考教程[ESP32设备与HomeAssistant集成指南](./homeassistant-integration.md) -1、首先选择一款支持function call支持的LLM，例如`ChatGLMLLM`。 +### 8、如何开启手机注册智控台 📱 -2、在配置文件中，将 `selected_module.Intent` 设置为 `function_call`。 +参考教程[阿里云短信集成指南](./ali-sms-integration.md) -3、登录`HomeAssistant`，点击`左下角个人`，切换`安全`导航栏，划到底部`长期访问令牌`生成api_key。 +### 9、更多问题，可联系我们反馈 💬 -在配置文件中，配置好你的home assistant的`devices`（被控制的设备）和`api_key`和`base_url`等信息。例如： +可以在[issues](https://github.com/xinnan-tech/xiaozhi-esp32-server/issues)提交您的问题。 -``` yaml -plugins - home_assistant: - devices: - - 客厅,玩具灯,switch.cuco_cn_460494544_cp1_on_p_2_1 - - 卧室,台灯,switch.iot_cn_831898993_socn1_on_p_2_1 - base_url: http://你的homeassistant地址:8123 - api_key: 你的home assistant api访问令牌 -``` - -最后，允许function_call 插件在配置文件中启用`hass_get_state`(必须)、`hass_set_state`(必须)、`hass_play_music`(不想用ha听音乐可以不启动)，例如： - -``` yaml -Intent: - ... - function_call: - type: nointent - functions: - - change_role - - get_weather - - get_news - - hass_get_state - - hass_set_state - - hass_play_music -``` - -### 8、更多问题，可联系我们反馈 💬 - -我们的联系方式放在[百度网盘中,点击前往](https://pan.baidu.com/s/1x6USjvP1nTRsZ45XlJu65Q)，提取码是`223y`。 - -网盘里有"硬件烧录QQ群"、"开源服务端交流群"、"产品建议联系人" 三张图片，请根据需要选择加入。 - -- 硬件烧录QQ群：适用于硬件烧录问题 -- 开源服务端交流群：适用于服务端问题 -- 产品建议联系人：适用于产品功能、产品设计等建议 \ No newline at end of file +也可以发邮件我们取得联系：huangrongzhuang@xin-nan.com \ No newline at end of file diff --git a/docs/ali-sms-integration.md b/docs/ali-sms-integration.md new file mode 100644 index 00000000..1be27787 --- /dev/null +++ b/docs/ali-sms-integration.md @@ -0,0 +1,44 @@ +# 阿里云短信集成指南 + +登录阿里云控制台，进入“短信服务”页面：https://dysms.console.aliyun.com/overview + +## 第一步 添加签名 +![步骤](images/alisms/sms-01.png) +![步骤](images/alisms/sms-02.png) + +以上步骤，会得到签名，请把它写入到智控台参数，`aliyun.sms.sign_name` + +## 第二步 添加模版 +![步骤](images/alisms/sms-11.png) + +以上步骤，会得到模版code，请把它写入到智控台参数，`aliyun.sms.sms_code_template_code` + +注意，签名要等7个工作日，等运营商报备成功后才能发送成功。 + +注意，签名要等7个工作日，等运营商报备成功后才能发送成功。 + +注意，签名要等7个工作日，等运营商报备成功后才能发送成功。 + +可以等报备成功后，再继续往下操作。 + +## 第三步 创建短信账户和开通权限 + +登录阿里云控制台，进入“访问控制”页面：https://ram.console.aliyun.com/overview?activeTab=overview + +![步骤](images/alisms/sms-21.png) +![步骤](images/alisms/sms-22.png) +![步骤](images/alisms/sms-23.png) +![步骤](images/alisms/sms-24.png) +![步骤](images/alisms/sms-25.png) + +以上步骤，会得到access_key_id和access_key_secret，请把它写入到智控台参数，`aliyun.sms.access_key_id`、`aliyun.sms.access_key_secret` +## 第四步 启动手机注册功能 + +1、正常来说，以上信息都填完后，会有这个效果，如果没有，可能缺少了某个步骤 + +![步骤](images/alisms/sms-31.png) + +2、开启允许非管理员用户可注册，将参数`server.allow_user_register`设置成`true` + +3、开启手机注册功能，将参数`server.enable_mobile_register`设置成`true` +![步骤](images/alisms/sms-32.png) \ No newline at end of file diff --git a/docs/docker/nginx.conf b/docs/docker/nginx.conf index 6a746260..9b9c3889 100644 --- a/docs/docker/nginx.conf +++ b/docs/docker/nginx.conf @@ -1,26 +1,53 @@ -server { - listen 8002; - server_name localhost; +user root; +worker_processes 4; - # 静态资源服务（Vue项目） - location / { - root /usr/share/nginx/html; - try_files $uri $uri/ /index.html; - } +events { + worker_connections 1024; +} - # API反向代理（Java项目） - location /xiaozhi/ { - proxy_pass http://127.0.0.1:8003; - proxy_set_header Host $host; - proxy_cookie_path /api/ /; - proxy_set_header Referer $http_referer; - proxy_set_header Cookie $http_cookie; +http { + include mime.types; + default_type application/octet-stream; + sendfile on; + keepalive_timeout 300; + client_header_timeout 180s; + client_body_timeout 180s; + client_max_body_size 1024M; - proxy_connect_timeout 10; - proxy_send_timeout 10; - proxy_read_timeout 10; + gzip on; + gzip_buffers 32 4K; + gzip_comp_level 6; + gzip_min_length 100; + gzip_types application/javascript text/css text/xml image/jpeg image/gif image/png; + gzip_disable "MSIE [1-6]\."; + gzip_vary on; - proxy_set_header X-Real-IP $remote_addr; - proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + server { + # 无域名访问，就用localhost + server_name localhost; + # 80端口 + listen 8002; + + # 转发到编译后到web目录 + location / { + root /usr/share/nginx/html; + try_files $uri $uri/ /index.html; + } + + # 转发到manager-api + location /xiaozhi/ { + proxy_pass http://127.0.0.1:8003; + proxy_set_header Host $host; + proxy_cookie_path /manager/ /; + proxy_set_header Referer $http_referer; + proxy_set_header Cookie $http_cookie; + + proxy_connect_timeout 10; + proxy_send_timeout 10; + proxy_read_timeout 10; + + proxy_set_header X-Real-IP $remote_addr; + proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; + } } } \ No newline at end of file diff --git a/docs/firmware-build.md b/docs/firmware-build.md index 9187681e..fffac288 100644 --- a/docs/firmware-build.md +++ b/docs/firmware-build.md @@ -1,39 +1,81 @@ -# 编译esp32固件 +# esp32固件编译 -1. 先按照这个教程配置项目环境[《Windows搭建 ESP IDF 5.3.2开发环境以及编译小智》](https://icnynnzcwou8.feishu.cn/wiki/JEYDwTTALi5s2zkGlFGcDiRknXf) +## 第1步 准备你的ota地址 -2. 配置好编译环境后，下载虾哥[xiaozhi-esp32](https://github.com/78/xiaozhi-esp32)项目源码，进入虾哥项目，打开`xiaozhi-esp32/main/Kconfig.projbuild`文件，找到`WEBSOCKET_URL`的`default`的内容，把`wss://api.tenclass.net` - 改成你自己的地址，例如，我的接口地址是`ws://192.168.1.25:8000/xiaozhi/v1/`，就把内容改成这个。 +如果你，使用的是本项目0.3.12版本，不管是简单Server部署还是全模块部署，都会有ota地址。 + +由于简单Server部署和全模块部署的OTA地址设置方式不一样，请你选择下面的具体方式： + +### 如果你用的是简单Server部署 +此刻，请你用浏览器打开你的ota地址，例如我的ota地址 +``` +http://192.168.1.25:8002/xiaozhi/ota/ +``` +如果显示“OTA接口运行正常，向设备发送的websocket地址是：ws://xxx:8000/xiaozhi/v1/ + +你可以使用项目自带的`test_page.html`测试一下，是否能连上ota页面输出的websocket地址。 + +如果访问不到，你需要到配置文件`.config.yaml`里修改`server.websocket`的地址，重启后再重新测试，直到`test_page.html`能正常访问。 + +成功后，请往下进行第2步 + +### 如果你用的是全模块部署 +此刻，请你用浏览器打开你的ota地址，例如我的ota地址 +``` +http://192.168.1.25:8002/xiaozhi/ota/ +``` + +如果显示“OTA接口运行正常，websocket集群数量：X”。那就往下进行2步。 + +如果显示“OTA接口运行不正常”，大概是你还没在`智控台`配置`Websocket`地址。那就： + +- 1、使用超级管理员登录智控台 + +- 2、顶部菜单点击`参数管理` + +- 3、在列表中找到`server.websocket`项目，输入你的`Websocket`地址。例如我的就是 + +``` +ws://192.168.1.25:8000/xiaozhi/v1/ +``` + +配置完后，再使用浏览器刷新你的ota接口地址，看看是不是正常了。如果还不正常就，就再次确认一下Websocket是否正常启动，是否配置了Websocket地址。 + +## 第2步 配置环境 +先按照这个教程配置项目环境[《Windows搭建 ESP IDF 5.3.2开发环境以及编译小智》](https://icnynnzcwou8.feishu.cn/wiki/JEYDwTTALi5s2zkGlFGcDiRknXf) + +## 第3步 打开配置文件 +配置好编译环境后，下载虾哥iaozhi-esp32项目源码， + +从这里下载虾哥[xiaozhi-esp32项目源码](https://github.com/78/xiaozhi-esp32)。 + +下载后，打开`xiaozhi-esp32/main/Kconfig.projbuild`文件。 + +## 第4步 修改OTA地址 + +找到`OTA_URL`的`default`的内容，把`https://api.tenclass.net/xiaozhi/ota/` + 改成你自己的地址，例如，我的接口地址是`http://192.168.1.25:8002/xiaozhi/ota/`，就把内容改成这个。 修改前： - ``` -config WEBSOCKET_URL - depends on CONNECTION_TYPE_WEBSOCKET - string "Websocket URL" - default "wss://api.tenclass.net/xiaozhi/v1/" +config OTA_URL + string "Default OTA URL" + default "https://api.tenclass.net/xiaozhi/ota/" help - Communication with the server through websocket after wake up. + The application will access this URL to check for new firmwares and server address. ``` - -修改后(示例)： - +修改后： ``` -config WEBSOCKET_URL - depends on CONNECTION_TYPE_WEBSOCKET - string "Websocket URL" - default "ws://192.168.1.25:8000/xiaozhi/v1/" +config OTA_URL + string "Default OTA URL" + default "http://192.168.1.25:8002/xiaozhi/ota/" help - Communication with the server through websocket after wake up. + The application will access this URL to check for new firmwares and server address. ``` -注意：你的地址是`ws://`开头，不是`wss://`开头，一定不要写错了。 +## 第4步 设置编译参数 -注意：你的地址是`ws://`开头，不是`wss://`开头，一定不要写错了。 - -注意：你的地址是`ws://`开头，不是`wss://`开头，一定不要写错了。 - -3. 设置编译参数 +设置编译参数 ``` # 终端命令行进入xiaozhi-esp32的根目录 @@ -44,40 +86,29 @@ idf.py set-target esp32s3 idf.py menuconfig ``` -![图片](images/build_setting01.png) - -进入菜单配置后，再进入`Xiaozhi Assistant`，将`CONNECTION_TYPE`设置为`Websocket` -回退到主菜单，再进入`Xiaozhi Assistant`，将`BOARD_TYPE`设置你板子的具体型号 +进入菜单配置后，再进入`Xiaozhi Assistant`，将`BOARD_TYPE`设置你板子的具体型号 保存退出，回到终端命令行。 -![图片](images/build_setting02.png) - -4. 编译固件 +## 第5步 编译固件 ``` idf.py build ``` -如果是vscode安装的idf可以使用`F1`或者`ctrl+shift+p`,输入idf然后直接选择进行编译 - -还可以直接进行烧录不用接下来的操作 - - - -5. 打包bin固件 +## 第6步 打包bin固件 ``` cd scripts python release.py ``` -编译成功后，会在项目根目录下的`build`目录下生成固件文件`merged-binary.bin`。 +上面的打包命令执行完成后，会在项目根目录下的`build`目录下生成固件文件`merged-binary.bin`。 这个`merged-binary.bin`就是要烧录到硬件上的固件文件。 注意：如果执行到第二命令后，报了“zip”相关的错误，请忽略这个错误，只要`build`目录下生成固件文件`merged-binary.bin` ，对你没有太大影响，请继续。 -6. 烧录固件 +## 第7步 烧录固件 将esp32设备连接电脑，使用chrome浏览器，打开以下网址 ``` @@ -89,6 +120,7 @@ https://espressif.github.io/esp-launchpad/ 烧录成功且联网成功后，通过唤醒词唤醒小智，留意server端输出的控制台信息。 +## 常见问题 以下是一些常见问题，供参考： [1、为什么我说的话，小智识别出来很多韩文、日文、英文](./FAQ.md) diff --git a/docs/firmware-setting.md b/docs/firmware-setting.md new file mode 100644 index 00000000..0ed350a0 --- /dev/null +++ b/docs/firmware-setting.md @@ -0,0 +1,54 @@ +# 基于虾哥编译好的固件配置自定义服务器 + +## 第1步 确认版本 +烧录虾哥已经编译好的[1.6.1版本以上固件](https://github.com/78/xiaozhi-esp32/releases) + +## 第2步 准备你的ota地址 +如果你按照教程使用的是全模块部署，就应该会有ota地址。 + +此刻，请你用浏览器打开你的ota地址，例如我的ota地址 +``` +https://2662r3426b.vicp.fun/xiaozhi/ota/ +``` + +如果显示“OTA接口运行正常，websocket集群数量：X”。那就往下。 + +如果显示“OTA接口运行不正常”，大概是你还没在`智控台`配置`Websocket`地址。那就： + +- 1、使用超级管理员登录智控台 + +- 2、顶部菜单点击`参数管理` + +- 3、在列表中找到`server.websocket`项目，输入你的`Websocket`地址。例如我的就是 + +``` +wss://2662r3426b.vicp.fun/xiaozhi/v1/ +``` + +配置完后，再使用浏览器刷新你的ota接口地址，看看是不是正常了。如果还不正常就，就再次确认一下Websocket是否正常启动，是否配置了Websocket地址。 + +## 第3步 进入配网模式 +进入机器的配网模式，在页面顶部，点击“高级选项”，在里面输入你服务器的`ota`地址，点击保存。重启设备 +![请参考-OTA地址设置](../docs/images/firmware-setting-ota.png) + +## 第4步 唤醒小智，查看日志输出 + +唤醒小智，看看日志是不是正常输出。 + + +## 常见问题 +以下是一些常见问题，供参考： + +[1、为什么我说的话，小智识别出来很多韩文、日文、英文](./FAQ.md) + +[2、为什么会出现“TTS 任务出错 文件不存在”？](./FAQ.md) + +[3、TTS 经常失败，经常超时](./FAQ.md) + +[4、使用Wifi能连接自建服务器，但是4G模式却接不上](./FAQ.md) + +[5、如何提高小智对话响应速度？](./FAQ.md) + +[6、我说话很慢，停顿时小智老是抢话](./FAQ.md) + +[7、我想通过小智控制电灯、空调、远程开关机等操作](./FAQ.md) diff --git a/docs/fish-speech-integration.md b/docs/fish-speech-integration.md new file mode 100644 index 00000000..b916e619 --- /dev/null +++ b/docs/fish-speech-integration.md @@ -0,0 +1,72 @@ +登录AutoDL，租赁镜像 +选择镜像: +``` +PyTorch / 2.1.0 / 3.10(ubuntu22.04) / cuda 12.1 +``` + +机器开机后，设置学术加速 +``` +source /etc/network_turbo +``` + +进入工作目录 +``` +cd autodl-tmp/ +``` + +拉取项目 +``` +git clone https://gitclone.com/github.com/fishaudio/fish-speech.git ; cd fish-speech +``` + +安装依赖 +``` +pip install -e. +``` + +如果报错，安装portaudio +``` +apt-get install portaudio19-dev -y +``` + +安装后执行 +``` +pip install torch==2.3.1 torchvision==0.18.1 torchaudio==2.3.1 --index-url https://download.pytorch.org/whl/cu121 +``` + +下载模型 +``` +cd tools +python download_models.py +``` + +下载完模型后运行接口 +``` +python -m tools.api_server --listen 0.0.0.0:6006 +``` + +然后用浏览器去到aotodl实例页面 +``` +https://autodl.com/console/instance/list +``` + +如下图点击你刚才机器的`自定义服务`按钮，开启端口转发服务 +![自定义服务](images/fishspeech/autodl-01.png) + +端口转发服务设置完成后，你本地电脑打开网址`http://localhost:6006/`，就可以访问fish-speech的接口了 +![服务预览](images/fishspeech/autodl-02.png) + + +如果你是单模块部署，核心配置如下 +``` +selected_module: + TTS: FishSpeech +TTS: + FishSpeech: + reference_audio: ["config/assets/wakeup_words.wav",] + reference_text: ["哈啰啊，我是小智啦，声音好听的台湾女孩一枚，超开心认识你耶，最近在忙啥，别忘了给我来点有趣的料哦，我超爱听八卦的啦",] + api_key: "123" + api_url: "http://127.0.0.1:6006/v1/tts" +``` + +然后重启服务 \ No newline at end of file diff --git a/docs/homeassistant-integration.md b/docs/homeassistant-integration.md new file mode 100644 index 00000000..3142244e --- /dev/null +++ b/docs/homeassistant-integration.md @@ -0,0 +1,248 @@ +# 小智ESP32-开源服务端与HomeAssistant集成指南 + +[TOC] + +----- + +## 简介 + +本文档将指导您如何将ESP32设备与HomeAssistant进行集成。 + +## 前提条件 + +- 已安装并配置好`HomeAssistant` +- 本次我选择的模型是：免费的ChatGLM，它支持functioncall函数调用 + +## 开始前的操作（必要） + +### 1. 获取HA的网络网络地址信息 + +请访问你Home Assistant的网络地址，例如，我的HA的地址是192.168.4.7，端口则是默认的8123，则在浏览器打开 + +``` +http://192.168.4.7:8123 +``` + +> 手动查询 HA 的 IP 地址方法**（仅限小智esp32-server和HA部署在同一个网络设备[例如同一个wifi]下）**： +> +> 1. 进入 Home Assistant（前端）。 +> +> 2. 点击左下角 **设置（Settings）** → **系统（System）** → **网络（Network）**。 +> +> 3. 滑到最底部`Home Assistant 网址(Home Assistant website)`区域，在`本地网络(local network)`中，点击`眼睛`按钮，可以看到当前使用的 IP 地址（如 `192.168.1.10`）和网络接口。点击`复制连接(copy link)`可以直接复制。 +> +> ![image-20250504051716417](images/image-ha-integration-01.png) + +或，您已经设置了直接可以访问的Home Assistant的OAuth地址，您也可以在浏览器内直接访问 + +``` +http://homeassistant.local:8123 +``` + +### 2. 登录`Home Assistant`拿到开发密钥 + +登录`HomeAssistant`，点击`左下角头像 -> 个人`，切换`安全`导航栏，划到底部`长期访问令牌`生成api_key，并复制保存，后续的方法都需要使用这个api key且仅出现一次（小tips: 您可以保存生成的二维码图像，后续可以扫描二维码再此提取api key）。 + +## 方法1：小智社区共建的HA调用功能 + +### 功能描述 + +- 如您后续需要增加新的设备，该方法需要手动重启`xiaozhi-esp32-server服务端`以此更新设备信息**（重要**）。 + +- 需要您确保已经在HomeAssistant中集成`Xiaomi Home`，并将米家的设备导入进`HomeAssistant`。 + +- 需要您确保`xiaozhi-esp32-server智控台`能正常使用。 + +- 我的`xiaozhi-esp32-server智控台`和`HomeAssistant`部署在同一台机器的另一个端口，版本是`0.3.10` + + ``` + http://192.168.4.7:8002 + ``` + + +### 配置步骤 + +#### 1. 登录`HomeAssistant`整理需要控制的设备清单 + +登录`HomeAssistant`，点击`左下角的设置`，然后进入`设备与服务`，再点击顶部的`实体`。 + +然后在实体中搜索你相关控制的开关，结果出来后，在列表中，点击其中一个结果，这是会出现一个开关的界面。 + +在开关的界面，我们尝试点击开关，看看是开发会随着我们的点击开/关。如果能操作，说明是正常联网的。 + +接着在开关面板找到设置按钮，点击后，可以查看这个开关的`实体标识符`。 + +我们打开一个记事本，按照这样格式整理一条数据： + +位置+英文逗号+设备名称+英文逗号+`实体标识符`+英文分号 + +例如，我在公司，我有一个玩具灯，他的标识符是switch.cuco_cn_460494544_cp1_on_p_2_1，那么就这个写这一条数据 + +``` +公司,玩具灯,switch.cuco_cn_460494544_cp1_on_p_2_1; +``` + +当然最后我可能要操作两个灯，我的最终的结果是： + +``` +公司,玩具灯,switch.cuco_cn_460494544_cp1_on_p_2_1; +公司,台灯,switch.iot_cn_831898993_socn1_on_p_2_1; +``` + +这段字符，我们成为“设备清单字符”需要保存好，等一下有用。 + + +#### 2. 登录`智控台` + +使用管理员账号，登录`智控台`。点击顶部菜单`参数管理`，搜索`plugins.home_assistant.`，会有三条结果出来 + +编辑`plugins.home_assistant.devices`，把刚才整理的设备清单字符粘贴进去。 + + +编辑`plugins.home_assistant.base_url`，把你部署的`HomeAssistant`接口地址粘贴进去，我粘贴进去的地址是这样的 + +``` +http://192.168.4.7:8123 +``` + +编辑`plugins.home_assistant.api_key`，把你从`HomeAssistant`复制过来的密钥，粘贴进去 + + +#### 3. 设置`意图识别`函数 + +在智控台，点击顶部菜单“模型配置”，在左侧栏，找到“意图识别”，找到id为`Intent_function_call`的意图，点击编辑 + +然后在弹框中，在原来的基础上追加两个函数：“hass_get_state”和“hass_set_state” + +修改前 +``` +change_role;get_weather;get_news;play_music +``` + +修改后 + +``` +change_role;get_weather;get_news;play_music;hass_get_state;hass_set_state +``` + +#### 4. 手动重启xiaozhi-server + +重启xiaozhi-server程序 + + +#### 5. 确认角色配置是否设置了函数意图识别 + +在智控台，点击顶部菜单“智能体管理”，找到设备所在的智能体，点击“配置角色” + +确认意图识别(Intent)，是否选择“函数调用意图识别” + + +#### 6. 唤醒设别进行控制 + +尝试和esp32说，“打开XXX灯” + +## 方法2：小智将Home Assistant的语音助手作为LLM工具 + +### 功能描述 + +- 该方法有一个比较严重的缺点——**该方法无法使用小智开源生态的function_call插件功能的能力**，因为使用Home Assistant作为小智的LLM工具会将意图识别能力转让给Home Assistant。但是**这个方法是能体验到原生的Home Assistant操作功能，且小智的聊天能力不变**。如实在介意可以使用同样是Home Assistant支持的[方法3](##方法3：使用Home Assistant的MCP服务（推荐）)，能够最大程度体验到Home Assistant的功能。 + +### 配置步骤： + +#### 1. 配置Home Assistant的大模型语音助手。 + +**需要您提前配置好Home Assistant的语音助手或大模型工具。** + +#### 2. 获取Home Assistant的语言助手的Agent ID. + +1. 进入Home Assistant页面内。左侧点击`开发者助手`。 +2. 在打开的`开发者助手`内，点击`动作`选项卡（如图示操作1），在页面内的选项栏`动作`中，找到或输入`conversation.process（对话-处理）`并选择`对话（conversation）: 处理`（如图示操作2）。 + +![image-20250504043539343](images/image-ha-integration-02.png) + +3. 在页面内勾选`代理(agent)`选项，在变成常亮的`对话代理(conversation agent)`内选择您步骤一配置好的语音助手名称，如图示，我这边配置好的是`ZhipuAi`并选择。 + +![image-20250504043854760](images/image-ha-integration-03.png) + +4. 选中后，点击表单左下方的`进入YAML模式`。 + +![image-20250504043951126](images/image-ha-integration-04.png) + +5. 复制其中的agent-id的值，例如图示中我的是`01JP2DYMBDF7F4ZA2DMCF2AGX2`(仅供参考)。 + +![image-20250504044046466](images/image-ha-integration-05.png) + +6. 切换到小智开源服务端`xiaozhi-esp32-server`的`config.yaml`文件内，在LLM配置中，找到Home Assistant，设置您的Home Assistant的网络地址，Api key和刚刚查询到的agent_id。 +7. 修改`config.yaml`文件内的`selected_module`属性的`LLM`为`HomeAssistant`，`Intent`为`nointent`。 +8. 重启小智开源服务端`xiaozhi-esp32-server`即可正常使用。 + +## 方法3：使用Home Assistant的MCP服务（推荐） + +### 功能描述 + +- 需要您提前在Home Assistant内集成并安装好HA集成——[Model Context Protocol Server](https://www.home-assistant.io/integrations/mcp_server/)。 + +- 这个方法与方法2都是HA官方提供的解决方法，与方法2不同的是，您可以正常使用小智开源服务端`xiaozhi-esp32-server`的开源共建的插件，同时允许您随意使用任何一个支持function_call功能的LLM大模型。 + +### 配置步骤 + +#### 1. 安装Home Assistant的MCP服务集成。 + +集成官方网址——[Model Context Protocol Server](https://www.home-assistant.io/integrations/mcp_server/)。。 + +或跟随以下手动操作。 + +> - 前往Home Assistant页面的**[设置 > 设备和服务（Settings > Devices & Services.）](https://my.home-assistant.io/redirect/integrations)**。 +> +> - 在右下角，选择 **[添加集成（Add Integration）](https://my.home-assistant.io/redirect/config_flow_start?domain=mcp_server)**按钮。 +> +> - 从列表中选择**模型上下文协议服务器（Model Context Protocol Server）**。 +> +> - 按照屏幕上的说明完成设置。 + +#### 2. 配置小智开源服务端MCP配置信息 + +切换到小智开源服务端`xiaozhi-esp32-server`的`mcp_server_settings.json`文件内，在`"mcpServers"`的括号内添加以下内容： + +```json +"Home Assistant": { + "command": "mcp-proxy", + "args": [ + "http://YOUR_HA_HOST/mcp_server/sse" + ], + "env": { + "API_ACCESS_TOKEN": "YOUR_API_ACCESS_TOKEN" + } +}, +``` + +注意： + +1. **替换配置：** + - 替换`args`内的`YOUR_HA_HOST`为您的HA服务地址，如果你的服务地址已经包含了https/http字样（例如`http://192.168.1.101:8123`)，则只需要填入`192.168.1.101:8123`即可。 + - 将`env`内`API_ACCESS_TOKEN`的`YOUR_API_ACCESS_TOKEN`替换成您之前获取到的开发密钥api key。 +2. **如果你添加配置是在`"mcpServers"`的括号内后续没有新的`mcpServers`的配置时，需要把最后的逗号`,`移除**，否则可能会解析失败。 + +**最后效果参考以下（参考如下）**： + +```json + "mcpServers": { + "Home Assistant": { + "command": "mcp-proxy", + "args": [ + "http://192.168.1.101:8123/mcp_server/sse" + ], + "env": { + "API_ACCESS_TOKEN": "abcd.efghi.jkl" + } + } + } +``` + +#### 3. 配置小智开源服务端的系统配置 + +1. **选择任意一款支持function_call的LLM大模型作为小智的LLM聊天助手（但不要选择Home Assistant作为LLM工具）**，本次我选择的模型是：免费的ChatGLM，它支持functioncall函数调用，但部分时候调用不太稳定，如果像追求稳定建议把LLM设置成：DoubaoLLM，使用的具体model_name是：doubao-1-5-pro-32k-250115。 + +2. 切换到小智开源服务端`xiaozhi-esp32-server`的`config.yaml`文件内，设置您的LLM大模型配置，并且将`selected_module`配置的`Intent`调整为`function_call`。 + +3. 重启小智开源服务端`xiaozhi-esp32-server`即可正常使用。 \ No newline at end of file diff --git a/docs/images/alisms/sms-01.png b/docs/images/alisms/sms-01.png new file mode 100644 index 0000000000000000000000000000000000000000..89c56f50d26b6ca0988357fb22b0c7b893efeb2b GIT binary patch literal 136404 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