东方仙盟神识FACLAW功能说明书

一、功能概述

东方仙盟神识FACLAW功能主要用于加载特定的神识规则，并提供一个聊天界面与神识进行交互。通过该功能，用户可以输入指令，系统会根据加载的规则进行处理并给出相应的回复。同时，会将交互记录显示在聊天面板中。

二、核心函数与调用格式

1. $cq.system_intent_loadskill

$cq.system_intent_loadskill(microhybirdappsn);

该函数用于加载神识规则。首先会根据传入的 `microhybirdappsn` 生成一个本地模板名称，检查本地是否已存在该模板对应的神识规则。若不存在，则向指定的接口发送请求获取规则，并将其存储到本地；若已存在，则直接使用本地规则，并向另一个接口发送统计请求。

2. $cq.系统_神识_加载

$cq.系统_神识_加载(microhybirdappsn);

该函数是对 `$cq.system_intent_loadskill` 的封装，调用它会执行相同的加载神识规则操作。

3. $cq.系统_神识_start

$cq.系统_神识_start(options);

该函数用于启动神识聊天界面。若指定的界面元素不存在，则创建聊天界面，并绑定相关事件。若传入的 `options` 长度大于 1，则调用 `$cq.system_intent_loadskill` 加载规则。

4. fams_intent_embed_sendMsg

fams_intent_embed_sendMsg();

该函数用于处理用户发送的消息。获取用户输入的消息，添加到聊天记录中，调用 `fams_nlu` 进行指令转换和处理，并根据处理结果添加相应的回复消息。

5. fams_intent_embed_add_msg

fams_intent_embed_add_msg(msg, param, isme);

该函数用于向聊天记录中添加消息。根据传入的消息内容、参数和消息发送方（用户或神识），创建相应的聊天项并添加到聊天内容区。

三、参数说明

1. $cq.system_intent_loadskill 参数

2. $cq.系统_神识_start 参数

3. fams_intent_embed_add_msg 参数

四、返回值

- `$cq.system_intent_loadskill`：无明确返回值，主要是执行加载规则和发送请求的操作。 - `$cq.系统_神识_加载`：同 `$cq.system_intent_loadskill`，无明确返回值。 - `$cq.系统_神识_start`：无明确返回值，主要是创建聊天界面并绑定事件。 - `fams_intent_embed_sendMsg`：无明确返回值，主要是处理消息并添加到聊天记录。 - `fams_intent_embed_add_msg`：无明确返回值，主要是向聊天记录中添加消息。

五、使用示例

1. 使用 $cq.system_intent_loadskill 示例

const microhybirdappsn = "your_app_sn";
$cq.system_intent_loadskill(microhybirdappsn);
                

2. 使用 $cq.系统_神识_加载 示例

const microhybirdappsn = "your_app_sn";
$cq.系统_神识_加载(microhybirdappsn);
                

3. 使用 $cq.系统_神识_start 示例

const options = "your_app_sn";
$cq.系统_神识_start(options);
                

4. 使用 fams_intent_embed_sendMsg 示例

fams_intent_embed_sendMsg();
                

5. 使用 fams_intent_embed_add_msg 示例

const msg = "Hello";
const param = "test_param";
const isme = true;
fams_intent_embed_add_msg(msg, param, isme);
                

六、注意事项

• 在调用 `$cq.system_intent_loadskill` 时，确保网络连接正常，以便能够从服务器获取神识规则。
• 若 `fams_nlu` 未正确加载，`fams_intent_embed_sendMsg` 函数会提示“神识没有启动”。
• 在使用 `fams_intent_embed_add_msg` 时，注意传入的参数类型和含义，确保消息能够正确显示。