一、什么是自定义指令

1. 功能价值

1.1 拓展RPA能力

开发者可以自行封装一些八爪鱼RPA官方未支持的指令，将自己常用的功能模块封装成一个指令，例某网站的数据获取

1.2 降低维护成本

开发者可以封装需要经常复用的流程片段，方便后期维护。假设A、B、C三个应用都需要用到登录淘宝功能，淘宝前端迭代时可能会影响这部分流程，如果不使用自定义指令，就得逐个修改应用，耗时耗力。但如果封装成指令进行引用，改动一处，剩余部分都会自动同步。

2. 使用场景

2.1 开发者通用角度

小八是一名有RPA搭建能力的小红书创作者，之前搭建了很多小红书相关的RPA应用，如小红书笔记采集、图文批量发布、评论采集。每个应用初始步骤都是登录模块，为了提升开发效率，他将小红书登录模块封装成指令库，然后在开发其他应用时就可以直接进行调用。后期登录逻辑有改动的话，他就可以只优化该指令库，其他用到这个指令块的RPA应用会直接更新。

2.2 企业开发者角度

小八是一名企业开发者，他经常会封装一些已有场景的自定义指令库，这些指令库都可以被企业内的成员使用

2.3 共享角度

小八将使用了自定义指令库的应用分享给其他人使用时，指令库可以自动加载，无需使用者额外操作

3. 常用定义

3.1 自定义指令

实现某个功能的可执行模块，如登录判断等。如下图所示，红框内均为自定义指令

3.2 指令库

多个功能类似的指令合集，可进行统一发布和版本管理。如下图所示，淘宝登录和小红书登录都是指令库

3.3 输入变量和输出变量

输入变量

指令的输入参数

选择此类型，后续用户使用到此指令时，会提醒他输入相关数据
如果需要设置输入提示、占位符等，可点击指令后方的“编辑”按钮

输出变量

指令的输出参数
这类变量会在指令运行结束后返回给用户

二、自定义指令

1. 使用全流程（流程图）

2. 具体案例

以开发“小红书”指令库为案例进行说明，该指令库包含环境初始化、登录状态判断、消息通知3个指令

2.1 新建指令库

切换到“指令库”--->点击“新建指令库”

2.2 开发指令库

以“消息通知”指令为例，其他指令开发方法相同。日常搭建过程中，消息通知有多种方式，例如在飞书群内通知、邮件通知等，下方案例采用邮件通知的形式。

新建自定义指令

点击“新增指令按钮”--->给指令重命名，命名为“消息通知”

定义输入、输出变量

- 消息通知：需要输入发件邮箱、发件授权码、收件邮箱，输出邮件发送状态

- 切换“变量”--->点击“新增自定义变量”按钮--->输入变量名、数据类型、默认值和变量类别

- 输入变量、输出变量创建完成示例图

指令搭建

与常规流程开发逻辑一致，即之前怎么搭建主流程、子流程，现在用同样的方式搭建自定义指令即可

指令界面编辑、预览

- 自定义指令信息编辑

可以设置自定义指令展示的图标、名称、描述等信息，如下图

- 自定义指令变量信息编辑

可以设置指令的输入输出参数的展示样式、显示名称、参数描述、控件类型、校验等；也可以调整参数的显示顺序，常规、高级设置；可以编辑指令在画布中显示的内容，可以调用变量

2.3 自定义指令显示与隐藏

鼠标hover想要操作的指令上，即可看到显示/隐藏图标，点击即可设置显示与否

2.4 指令库预览

指令库开发完成后，可以进行预览，预览的效果就是未来其用户使用时的效果

2.5 指令库发版

指令库开发完成或编辑完成后，点击“发版”，发版后就可以在其他应用/指令库引用

2.6 拓展指令

在指令列表中点击“扩展”-->选择个人/企业开发的指令库--->即可看到自己开发的或企业开发的指令库

三、指令库管理

指令库管理界面

新建/编辑指令库
查看指令库详情：可看到指令库中包含哪些指令

拷贝为副本
删除：删除指令库后会进入回收站，可以在回收站找回

四、指令管理

①新建自定义指令：和新建子流程交互一致
②指令库预览：可以查看当前指令库包含的指令及每个自定义指令的界面预览
③预览及编辑：可以编辑自定义指令的名称、描述、参数顺序、参数的名称、描述、控件设置等
④指令的显示设置：眼睛处于睁开的状态时，表示发版后其他应用/指令库可以使用该自定义指令；闭上时，在其他应用或者指令库编辑的时候，看不到该自定义指令

⑤变量的新增与引用关系查看，与流程一致

五、调用其他指令

为提高流程的复用性，当指令库中多个自定义指令中部分流程片段可以复用，就可以将它单独拿出来，设置为隐藏的自定义指令，然后在其他指令中进行调用

六、拓展指令

在应用和指令库中，都可以使用已封装好的指令库（不能自己调用自己）
自己发版的指令库和官方指令库都可以在此处进行查找和使用
找到目标指令直接拖入流程中即可
我的tab可查看当前应用/指令库用到的所有指令库，当指令库有更新时，会出现更新提醒，可以单个指令库更新、也可以进行批量更新

七、指令库加载

当应用打开/运行时，会自动安装需要的的指令库
当依赖个人开发的指令库的应用被分享时，接受应用的用户同时会获得指令库的使用权限，即在当前应用中可以使用该指令库，其他应用/指令库将无法获得该指令库
版本兼容规则：
- 安装指令库只可安装最新版本，由于存在已安装未更新的用户，因此所有版本需要保留，不提供安装入口
- 当已安装的指令库有依赖冲突时，遵循向上更新原则，即当依赖多个指令库的多个版本时，默认使用最新的那个版本