## **系统运行原理** 自美系统采用多进程消息队列管理模式运行,各模块和插件均为独立进程运行互不干扰。进程间采用消息通知方式通信。 ## **系统结构说明** 自美系统集高度可定制和灵活偶合模式设计,每一个模块都可以独立运行和协作运行,插件也可以理解为一个特有功能的模块。除了一些特有功能模块,系统自带集合了几大内置功能,分别如下: 一、 语音唤醒模块; 二、语音录音模块; 三、语音识别模块; 四、语音合成模块; 五、屏幕显示模块; 六、微信小程序通信模块; 七、外设万能开关通信模块; 等七大基本模块,每一个模块都有提供供插件使用的插口,接下来章节将逐一讲解。 ## **插件结构说明** 一、**插件位置:** 自美插件位于当前系统目录:`./python/plugin/`目录下,如果您采用[镜像安装](1144905)方式安装的自美系统,那么插件目录就是:`/keyicx/python/plugin/`下,一个插件一个目录,如: ``` /keyicx/python/plugin/Chat(聊天机器人插件) /keyicx/python/plugin/Music(音乐插件) ``` 二、**插件组成:** 自美系统是由*.py(插件入口文件) + config.json(插件配置文件)组成,如音乐插件是由: ``` /keyicx/python/plugin/Music/config.json (配置文件) /keyicx/python/plugin/Music/Music.py (入口文件) ``` 如下图所示: ![](http://qiniucn.16302.com/f78b1287a0f9ecf2ac5c021f8ae0b23b) 三、**插件命名约定** > 插件命名约定可简单说叫:四名一致 1、插件文件夹名称; 2、config.json配置文件名中的`name`插件名称键值; 3、插件入口文件`.py`(也可以叫插件基本文件)名; 4、插件入口文件中的起始类名:`class 插件名称` 每一个插件必须保持以上四个位置处名称一致并且在插件文夹中唯一,否则都会导致插件不能正常启动和运行。 ---------- **以上插件规则可参考自美系统插件目录下系统自带插件写法体会。**