# 使用指南
扩展(Extension)-自定义脚本是一种支持用户⾃定义的Python脚本，在Lyrebird运行的过程中，于后台并行地工作。
无需搭建工程和前端开发，自定义脚本可灵活、轻巧、便捷、准确的对消息总线频道中的数据进行分析和校验。
自定义脚本默认支持三种类型：
- 请求修改器(Modifier): 如为请求添加Header Key、修改请求的Param等
- 请求检查器(Checker): 如可通过检查器监听网络请求频道，检测网络请求中的图片大小是否满足预期，或检测是否重复请求了同一个接口等
- 其他(Other): 未分类或者综合应用
可在脚本中使用全局变量ExtensionCategory(String类型)人为指定Extension类型
可以在Lyrebird运行过程中随时开启或关闭自定义脚本，即插即用，方便灵活。
展开Extension标签可查看当前运行的自定义脚本，按组别聚合。 Activated Tab展示已激活的Extension, Deactivated Tab展示未激活的Extension
如果需要高级的检查和展示，可使用自定义插件开发实现更复杂的场景和功能。
# 载入自定义脚本
运行时携带的自定义脚本存放在默认路径~/.lyrebird/checkers下。对自定义脚本的新增、修改、删除，可在默认目录下操作文件。
当默认目录中没有可用的自定义脚本时，会自动载入示例脚本。目前提供的示例脚本如下：
| Filename | Type | Description |
|---|---|---|
| img_size.py (opens new window) | 检查器 | 检查网络请求中图片大小是否超出限制 |
| duplicate_requests.py (opens new window) | 检查器 | 检查在某段时间内是否有重复的网络请求 |
| add_request_param.py (opens new window) | 修改器 | 在Request中添加Param |
| add_response_header.py (opens new window) | 修改器 | 在Response中添加Header Key |
此外，Lyrebird支持使用在启动时指定需要加载的脚本。
lyrebird --script [filename] --script [filename]
# 捕获报警
在获取到数据后，便可对该数据进行检验和处理。当发现异常数据时，Lyrebird会在通知中心展示报警信息。
报警中可携带检查出的异常信息，也可以携带消息总线中其它频道的消息作为辅助信息，以丰富报警信息。
第一个检查器 →