> ## Documentation Index > Fetch the complete documentation index at: https://rpa.bazhuayu.com/helpcenter/llms.txt > Use this file to discover all available pages before exploring further. # 自定义指令讲解 > 讲解八爪鱼 RPA 自定义指令与指令库的价值、创建流程、管理分组、显示/隐藏/发版/调用机制，以及版本兼容与加载规则。 ## 一、什么是自定义指令 ### 1. 功能价值 #### 1.1 拓展RPA能力 开发者可以自行封装一些八爪鱼RPA官方未支持的指令，将自己常用的功能模块封装成一个指令，例某网站的数据获取 #### 1.2 降低维护成本 开发者可以封装需要经常复用的流程片段，方便后期维护。假设A、B、C三个应用都需要用到登录淘宝功能，淘宝前端迭代时可能会影响这部分流程，如果不使用自定义指令，就得逐个修改应用，耗时耗力。但如果封装成指令进行引用，改动一处，剩余部分都会自动同步。 ### 2. 使用场景 #### 2.1 开发者通用角度 小八是一名有RPA搭建能力的自媒体创作者，之前搭建了很多某社媒平台相关的RPA应用，如笔记采集、图文批量发布、评论采集。每个应用初始步骤都是登录模块，为了提升开发效率，他将某社媒平台登录模块封装成指令库，然后在开发其他应用时就可以直接进行调用。后期登录逻辑有改动的话，他就可以只优化该指令库，其他用到这个指令块的RPA应用会直接更新。 #### 2.2 企业开发者角度 小八是一名企业开发者，他经常会封装一些已有场景的自定义指令库，这些指令库都可以被企业内的成员使用 #### 2.3 共享角度 小八将使用了自定义指令库的应用分享给其他人使用时，指令库可以自动加载，无需使用者额外操作 ### 3. 常用定义 #### 3.1 自定义指令 实现某个功能的可执行模块，如登录判断等。如下图所示，红框内均为自定义指令 ![自定义指令 示意图 1](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-01.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=cbeff0dd81311c7b887a86a5f1d58676) #### 3.2 指令库 多个功能类似的指令合集，可进行统一发布和版本管理。如下图所示，紫鸟控制台操作和亚马逊卖家后台都是指令库 ![自定义指令 示意图 2](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-02.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=42c2ceb4858fd448eafc7e11bad7ab71) #### 3.3 输入变量和输出变量 * 输入变量 * 指令的输入参数
![自定义指令 示意图 3](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-03.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=76566ecd95b0087b5bd3cda58dc991dc) ![自定义指令 示意图 4](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-04.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=08c506a714b6a8b5c06f925e8f7533eb)
* 选择此类型，后续用户使用到此指令时，会提醒他输入相关数据 * 如果需要设置输入提示、占位符等，可点击指令后方的“编辑”按钮
![自定义指令 示意图 5](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-05.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=26e28da6236d0fbfda0fdca1258d825a) ![自定义指令 示意图 6](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-06.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=461dab9626a08b1c3bd1d64eb6e03296)
* 输出变量 * 指令的输出参数 * 这类变量会在指令运行结束后返回给用户 ![自定义指令 示意图 7](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-07.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=8040c966c21c467963d66fcb921a0594) ## 二、自定义指令 ### 1. 使用全流程（流程图） ![自定义指令 示意图 8](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-08.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=226f00b8a8417bc3123327de950b74ef) ### 2. 具体案例 以开发“日期选择”指令库为案例进行说明，该指令库包含多种不同类型的日期选择框，例纯年月日、纯时分秒等。 #### 2.1 新建指令库 切换到“指令库”--->点击“新建指令库” ![自定义指令 示意图 9](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-09.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=1cefae77e0509ecb3181ef4c0697ea58) #### 2.2 开发指令库 以“日历日期选择器一（web）”指令为例，其他指令开发方法相同。日常处理网页自动化，日历日期选择框有多种样式，现在我们选择其中一种做演示。 * 新建自定义指令 点击“新增指令按钮”--->给指令重命名，命名为“日历日期选择器一（web）” ![自定义指令 示意图 10](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-10.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=707fe398d6ac37b5f2ea1561ab5ab459) * 定义输入、输出变量 * 选择指定日期：需要输入网页对象、日期时间、元素\_年、元素\_月、年月日相似元素组 * 切换“变量”--->点击“新增自定义变量”按钮--->输入变量名、数据类型、默认值和变量类别
![自定义指令 示意图 11](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-11.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=a2a41d95e7866f96a09485a06eaf5f5a) ![自定义指令 示意图 12](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-12.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=8d3f518e637a2ea313ce87f515ff85a0)
* 输入变量创建完成示例图 ![自定义指令 示意图 13](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-13.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=d1a39a8be92f93b33d4120856af53181) * 指令搭建 与常规流程开发逻辑一致，即之前怎么搭建主流程、子流程，现在用同样的方式搭建自定义指令即可 ![自定义指令 示意图 14](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-14.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=fcf43db5700a666b804675dc902de8aa) * 新建子流程 当单个自定义指令的实现逻辑较为复杂时，可以拆分成多个子流程进行处理，和写应用一样，子流程间变量共用； 当指令库中多个指令的实现逻辑之间有流程复用时，建议继续使用”调用隐藏指令“的方式；当单个指令的实现逻辑中有部分流程复用时，可以使用子流程
![自定义指令 示意图 15](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-15.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=49377cc0be81bea971f8fd4aaa437b77) ![自定义指令 示意图 16](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-16.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=e784515491372412b79fddba23da86f2)
* 指令界面编辑、预览 * 自定义指令信息编辑 可以设置自定义指令展示的图标、名称、描述等信息，如下图
![自定义指令 示意图 17](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-17.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=9c866e3f8dc0e03a9ed80f233f3b37f6) ![自定义指令 示意图 18](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-18.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=d4cbb5e1199a326f11d212f61446fffe)
* 自定义指令变量信息编辑 可以设置指令的输入输出参数的展示样式、显示名称、参数描述、控件类型、校验等；也可以调整参数的显示顺序，常规、高级设置；可以编辑指令在画布中显示的内容，可以调用变量
![自定义指令 示意图 19](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-19.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=3417828552a2c3030d6ef0c8561f8a90) ![自定义指令 示意图 20](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-20.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=8f60079086a86b4155c2fc8245e28c91)
#### 2.3 自定义指令创建副本 用户开发完一个自定义指令后，需要再开发一个类似的指令。鼠标右键选中需要的指令，点击”创建副本“后，会出现同名指令的副本。以这种方式创建的自定义指令，“流程、元素、图片、变量、输入输出参数”设置会与之前的自定义指令完全相同。 ![自定义指令 示意图 21](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-21.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=c9a0fc728b38efa69062321dd8b1e2b6) #### 2.4 自定义指令显示与隐藏 鼠标hover想要操作的指令上，即可看到显示/隐藏图标，点击即可设置显示与否 ![自定义指令 示意图 22](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-22.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=e852297bfce8af7f52dbbe717c80de97) #### 2.5 指令库预览 指令库开发完成后，可以进行预览，预览的效果就是未来其用户使用时的效果
![自定义指令 示意图 23](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-23.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=ade598e01da0866714f651b32c930dec) ![自定义指令 示意图 24](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-24.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=104c96b01346b4979ac052b486b10cde)
#### 2.6 指令库发版 指令库开发完成或编辑完成后，点击“发版”，发版后就可以在其他应用/指令库引用
![自定义指令 示意图 25](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-25.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=954c22ec6e439a78c03c5efa6db88960) ![自定义指令 示意图 26](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-26.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=4be67ec5638726481bf4b173fdbe2cc5)
#### 2.7 拓展指令 在指令列表中点击“扩展”-->选择个人/企业开发的指令库--->即可看到自己开发的或企业开发的指令库 ![自定义指令 示意图 27](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-27.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=84f9fb1d09fb05611c75a9fbae260534) ## 三、指令库管理 ![自定义指令 示意图 28](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-28.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=1d5b48476c4b54f0b12a9507657f8d75) ### 指令库管理界面 * 新建/编辑指令库 * 查看指令库详情：可看到指令库中包含哪些指令 ![自定义指令 示意图 29](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-29.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=0e0d721fc1b88d098a3c82a46b44aa8c) * 拷贝为副本 * 删除：删除指令库后会进入回收站，可以在回收站找回 ### 指令库分组 当指令库比较多时，可以对指令库进行分组存放 * 新建分组
![自定义指令 示意图 30](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-30.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=6c65fa62982980ec74fc275a4b10dc36) ![自定义指令 示意图 31](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-31.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=d59f37d8d9edf6c2b0777f3b7fe585eb)
* 将指令库移动到分组 ![自定义指令 示意图 32](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-32.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=ffbc5179bc0770ccf5b2824190adc74c) ### 直接发版 v2.4以下版本需在指令库内部（即编辑页面）发版，v2.4及以上版本支持直接在指令库列表页发版 ![自定义指令 示意图 33](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-33.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=6d0d8e3ada85970b57454e20f7eea7d3) ### 复制到企业 当从个人版升级到企业版时，可以将个人版开发的指令库一键迁移到企业版 ## 四、指令管理 ![自定义指令 示意图 34](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-34.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=3a93a0ac6bbca593f33f4cb3466f77b0) * ①新建自定义指令：和新建子流程交互一致 * ②指令库预览：可以查看当前指令库包含的指令及每个自定义指令的界面预览 * ③预览及编辑：可以编辑自定义指令的名称、描述、参数顺序、参数的名称、描述、控件设置等 * ④指令的显示设置：眼睛处于睁开的状态时，表示发版后其他应用/指令库可以使用该自定义指令；  闭上时，在其他应用或者指令库编辑的时候，看不到该自定义指令 ![自定义指令 示意图 35](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-35.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=262c11aa603407458f1dadf42c8b88b7) * ⑤变量的新增与引用关系查看，与流程一致 ## 五、调用其他指令 ![自定义指令 示意图 36](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-36.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=cbb515a8db6e945e55d69af8eb4b34ab) * 为提高流程的复用性，当指令库中多个自定义指令中部分流程片段可以复用，就可以将它单独拿出来，设置为隐藏的自定义指令，然后在其他指令中进行调用 ## 六、拓展指令 ![自定义指令 示意图 37](https://mintcdn.com/bazhuayu-rpa-docs/_RDb9BnNZXQtuOjR/helpcenter/guides/custom-commands-guide/images/custom-instructions-37.png?fit=max\&auto=format\&n=_RDb9BnNZXQtuOjR\&q=85\&s=17f948b1640cd9b34c327a1be17a393e) * 在应用和指令库中，都可以使用已封装好的指令库（不能自己调用自己） * 自己发版的指令库和官方指令库都可以在此处进行查找和使用 * 找到目标指令直接拖入流程中即可 * 我的tab可查看当前应用/指令库用到的所有指令库，当指令库有更新时，会出现更新提醒，可以单个指令库更新、也可以进行批量更新 ## 七、指令库加载 * 当应用打开/运行时，会自动安装需要的的指令库 * 当依赖个人开发的指令库的应用被分享时，接受应用的用户同时会获得指令库的使用权限，即在当前应用中可以使用该指令库，其他应用/指令库将无法获得该指令库 * 版本兼容规则： * 安装指令库只可安装最新版本，由于存在已安装未更新的用户，因此所有版本需要保留，不提供安装入口 * 当已安装的指令库有依赖冲突时，遵循向上更新原则，即当依赖多个指令库的多个版本时，默认使用最新的那个版本 > [!NOTE] > > 使用过程中遇到问题？前往 [八爪鱼RPA 开发者社区问答板块](https://rpa.bazhuayu.com/community/questions) 提问，获取官方与社区帮助。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.