Flipper Zero BadUSB 的 DuckyScript 语法高亮指南Notepad 用户自定义语言UDL安装与配置深度解析【免费下载链接】FlipperPlayground (and dump) of stuff I make or modify for the Flipper Zero项目地址: https://gitcode.com/GitHub_Trending/fl/Flipper本指南围绕当前仓库中 BadUSB/DuckyScript_UDL/ReadMe.md 与配套的 BadUSB/DuckyScript_UDL/userDefineLang.xml 展开讲解如何为 Notepad 安装 DuckyScript 语法高亮并逐项拆解 UDL 定义文件中的关键字分组、注释规则与配色样式。读完本文你将能在 Notepad 中流畅地阅读、编写和排查 Flipper Zero BadUSB 的 DuckyScript 脚本并学会结合仓库中的真实 payload 验证高亮效果、按需自定义语法规则。一、背景为什么 DuckyScript 需要专门的语法高亮Flipper Zero 的 BadUSB 功能以键盘模拟方式工作设备插入主机后伪装成 USB HID 键盘逐条回放预置的按键序列。这套按键序列使用的脚本语言就是 DuckyScript源自 Hak5 USB Rubber Ducky 生态。当前仓库的 BadUSB 目录汇集了海量 DuckyScript payload——从 Wi-Fi 密码提取、凭证抓取到系统侦察、各式恶搞脚本文件数量超过数百个是名副其实的脚本仓库。在纯文本状态下浏览这些脚本REM注释、STRING文本、DELAY延时和各类修饰键混在一起极易看花眼。而一套正确的语法高亮能让注释、指令、延时参数各归其位快速定位脚本的骨架——这对于筛选可复用的 payload、排查语法错误例如大小写写错、关键词拼错和向他人讲解脚本逻辑都极为重要。本仓库在 BadUSB/DuckyScript_UDL 目录下直接提供了现成的 UDL 定义文件由社区成员 B33m0 制作并提供开箱即用。二、安装步骤导入 userDefineLang.xml原文档给出的安装路径非常简洁完整步骤如下准备文件确认userDefineLang.xml已解压就位。本仓库中该文件位于 BadUSB/DuckyScript_UDL/userDefineLang.xml无需手动从压缩包解压。打开 UDL 管理窗口在 Notepad 主窗口中依次点击菜单Language - Define your language...。导入定义文件在弹出的对话框中点击Import按钮导航到userDefineLang.xml所在目录并选中该文件。确认加载双击或打开该 XML 文件等待 Notepad 解析完成。命名保存点击Save As按钮将语言名称保存为DuckyScript或任意你喜欢的名称。启用扩展名关联该 UDL 的默认脚本文件扩展名是.duck对应 XML 中extduck属性。保存为.duck后缀的文件会自动套用高亮。一个值得注意的细节本仓库 BadUSB 目录下的大量 payload 实际以.txt为后缀例如GoodUSB.txt、Wifi-Stealer_Discord.txt。如果希望这些.txt文件也能自动触发高亮可以在Define your language...对话框底部的扩展名字段中追加txt多个扩展名以空格分隔或在打开文件后手动从Language菜单选择DuckyScript临时套用。三、userDefineLang.xml 深度解析userDefineLang.xml采用 Notepad 标准的 UDL 2.1 格式udlVersion2.1根节点为NotepadPlus内部通过UserLang、Settings、KeywordLists、Styles四个层次完整描述了一门自定义语言的语法规则。下面逐层拆解。3.1 全局设置大小写敏感与折叠行为Global caseIgnoredno allowFoldOfCommentsno foldCompactno forcePureLC1 decimalSeparator0 /caseIgnoredno关键字匹配区分大小写。DuckyScript 规范中指令一律使用大写如REM、STRING、DELAY因此该设置能保证小写误写如delay、rem不会被误标成指令有助于发现拼写错误。allowFoldOfCommentsno与foldCompactno关闭注释折叠与紧凑折叠保持行级结构简单直接。其余forcePureLC、decimalSeparator为 UDL 内部标记保持默认即可。3.2 注释定义REM 指令的行级标记Keywords nameComments00REM 01 02 03 04/Keywords注释组将REM注册为注释起始标记对应样式表中的LINE COMMENTS样式。这与 DuckyScript 的语义完全一致REM开头的行是注释行用于书写作者、日期、目标平台等元信息。配合Keywords3分组中的REM注释行会获得独立的绿色样式与可执行指令形成视觉区分。3.3 关键字分组指令、键位与延时UDL 定义了 8 个关键字分组本文件实际使用前 3 组分组收录的关键字高亮样式Keywords1修饰键与系统键MENU APP WINDOWS GUI SHIFT ALT CONTROL CTRL方向键UPARROW DOWNARROW LEFTARROW RIGHTARROW UP DOWN LEFT RIGHT功能与编辑键BREAK PAUSE CAPSLOCK DELETE END ESC ESCAPE HOME INSERT NUMLOCK PAGEUP STRING PAGEDOWN F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 PRINTSCREEN SCROLLOCK SPACE TAB ENTER蓝色加粗Keywords2DEFAULTDELAY DEFAULT_DELAY DELAY红色加粗Keywords3REM绿色加粗斜体分组设计体现了 DuckyScript 的语言模型Keywords1 承载动作与键位语义STRING之后的文本会被原样键入其余均为修饰键GUI/SHIFT/ALT/CTRL和特殊键ENTER/TAB/F1…F11/方向键等。这些是高亮最频繁出现的词汇蓝色加粗使其在脚本中一眼可辨。Keywords2 承载时序控制语义DELAY控制单条指令后的停顿毫秒DEFAULTDELAY/DEFAULT_DELAY两种拼写均被收录用于设定脚本整体的默认延时。红色加粗使其从按键流中脱颖而出。Keywords3 承载注释语义REM作为注释起始关键字与 3.2 节的注释规则互相印证。需要特别指出的是 Keywords1 中键位清单的两个细节供使用者留意清单中收录了F1至F11以及一个单独的12标记但未收录F12。从仓库实际 payload 看功能键确实有使用需求如 BadUSB/SpamRickrollPayload.txt 第 81 行出现了F11。如果脚本需要F12高亮可在Define your language...的关键字列表中自行补入。APP与MENU两个键位同属菜单键语义均已覆盖。3.4 样式表配色与字体权重Styles段为每个语法元素分配前景色、背景色与字体样式fontStyle为位掩码0常规、1加粗、2斜体、3加粗斜体样式名前景色字体样式作用对象DEFAULT000000黑常规普通文本STRING内容、未匹配文本LINE COMMENTS008000绿加粗斜体REM注释行KEYWORDS10000FF蓝加粗修饰键、特殊键、STRING、功能键KEYWORDS2FF0000红加粗DELAY、DEFAULTDELAY、DEFAULT_DELAYKEYWORDS3008000绿加粗斜体REM关键字KEYWORDS4808080灰斜体已定义样式、未分配关键字可自行扩展其余样式000000常规数字、操作符、折叠标记等未启用元素三原色的直观映射——蓝 按键动作红 时间控制绿 注释说明——正是这套 UDL 的核心可用性价值。若想调整配色直接在Define your language...对话框的 Style 面板中修改对应样式的前景色即可。四、仓库实战对照真实 payload 中的高亮效果下面用本仓库 BadUSB 目录中的真实脚本对照第三节的关键字分组验证这套 UDL 的实际覆盖效果。4.1 REM 注释行绿色加粗斜体BadUSB/RickRoll (Basic).txt.txt) 开头是典型的注释元信息REM Author: OpenAI Assistant REM Date: 2022-12-27 REM Description: A simple Ruby Ducky script to play a Rick Roll video三行REM均落入注释/Keywords3绿色样式而 BadUSB/Wifi-Stealer_Discord.txt 则示范了更丰富的注释用法——REM Target: Windows 7/8/10/11、REM Supported Layout keyboard: US/FR/DE、REM Category: Grabber等把目标平台、键盘布局、脚本类别等元信息整齐排列在脚本头部。4.2 延时指令红色加粗时序控制是 BadUSB 脚本可靠运行的关键。同一份 BadUSB/RickRoll (Basic).txt.txt) 中DELAY 1000 GUI r DELAY 200 STRING powershell Start-Process https://www.youtube.com/watch?vdQw4w9WgXcQ DELAY 500 ENTERDELAY全部命中 Keywords2 红色加粗样式与蓝色按键指令形成节奏分明的阅读体验。而 BadUSB/Party_Parrot_Win.txt 第 6 行使用了DEFAULTDELAY 50验证了 Keywords2 对DEFAULTDELAY拼写的覆盖——该语法可在脚本开头统一设定每条指令间的默认等待时间避免逐行书写DELAY。4.3 修饰键与组合键蓝色加粗BadUSB/GoodUSB.txt 大量示范了修饰键组合ALT F4 ; 关闭当前窗口 ALT N ; 触发菜单项 N GUI r ; 打开运行对话框 LEFT ; 方向键导航ALT、GUI、LEFT等均命中 Keywords1。特别是ALT F4这类修饰键 功能键的组合写法两组蓝色加粗关键字连排让组合键意图一目了然。同一文件中还有STRING powershell.exe与ENTER交替出现覆盖了 Keywords1 中的STRING、ENTER。4.4 功能键与批量按键流蓝色加粗BadUSB/SpamRickrollPayload.txt 第 81 行的F11验证了功能键高亮而 BadUSB/265_4_Digit_Pin_BF.txt四位 PIN 码爆破脚本中包含数百行ENTER批量回放在高亮模式下可以明显看出同一种蓝色指令的密集循环结构便于审查脚本逻辑是否完整。五、验证、自定义与注意事项验证安装是否成功新建文件并输入以下最小脚本保存为test.duckREM Syntax highlight check DEFAULTDELAY 50 GUI r DELAY 500 STRING notepad.exe ENTER ALT F4预期效果第一行REM为绿色斜体DEFAULTDELAY、DELAY为红色加粗GUI、STRING、ENTER、ALT、F4为蓝色加粗。若全部符合说明 UDL 已正确加载。几个实用建议大小写敏感由于caseIgnoredno脚本必须使用大写指令才能获得高亮这正好作为拼写自查的手段——如果某条指令没有变蓝/变红多半是大小写或拼写有误。扩展名适配本仓库 payload 以.txt为主可在 UDL 扩展名字段补充txt.duck为推荐的新脚本后缀。按需扩展关键字如需要F12、FN等键位在Define your language...对话框的 Keywords 列表中追加即可Keywords4灰色样式预留了扩展分组的空间。只读使用仓库仓库中的 BadUSB/DuckyScript_UDL/userDefineLang.xml 是官方提供的现成定义建议直接复制到本机使用无需改动仓库内容。六、小结本仓库在 BadUSB/DuckyScript_UDL 下提供了一组开箱即用的 DuckyScript 编辑器支持安装指南ReadMe.md与完整语法定义userDefineLang.xml。通过Language - Define your language... - Import - Save As DuckyScript五步即可完成配置定义文件以蓝色键位/红色延时/绿色注释的三原色方案精确映射了 DuckyScript 的语言模型并以caseIgnoredno保证了语法自检能力。对照 BadUSB 目录中数百个真实 payload这套高亮方案能够显著提升脚本的阅读、筛选与排查效率——无论你是想快速寻找可复用的脚本还是准备自己编写第一条 BadUSB payload都值得先花一分钟把这块脚手架搭好。【免费下载链接】FlipperPlayground (and dump) of stuff I make or modify for the Flipper Zero项目地址: https://gitcode.com/GitHub_Trending/fl/Flipper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Flipper Zero BadUSB 的 DuckyScript 语法高亮指南：Notepad++ 用户自定义语言（UDL）安装与配置深度解析
Flipper Zero BadUSB 的 DuckyScript 语法高亮指南Notepad 用户自定义语言UDL安装与配置深度解析【免费下载链接】FlipperPlayground (and dump) of stuff I make or modify for the Flipper Zero项目地址: https://gitcode.com/GitHub_Trending/fl/Flipper本指南围绕当前仓库中 BadUSB/DuckyScript_UDL/ReadMe.md 与配套的 BadUSB/DuckyScript_UDL/userDefineLang.xml 展开讲解如何为 Notepad 安装 DuckyScript 语法高亮并逐项拆解 UDL 定义文件中的关键字分组、注释规则与配色样式。读完本文你将能在 Notepad 中流畅地阅读、编写和排查 Flipper Zero BadUSB 的 DuckyScript 脚本并学会结合仓库中的真实 payload 验证高亮效果、按需自定义语法规则。一、背景为什么 DuckyScript 需要专门的语法高亮Flipper Zero 的 BadUSB 功能以键盘模拟方式工作设备插入主机后伪装成 USB HID 键盘逐条回放预置的按键序列。这套按键序列使用的脚本语言就是 DuckyScript源自 Hak5 USB Rubber Ducky 生态。当前仓库的 BadUSB 目录汇集了海量 DuckyScript payload——从 Wi-Fi 密码提取、凭证抓取到系统侦察、各式恶搞脚本文件数量超过数百个是名副其实的脚本仓库。在纯文本状态下浏览这些脚本REM注释、STRING文本、DELAY延时和各类修饰键混在一起极易看花眼。而一套正确的语法高亮能让注释、指令、延时参数各归其位快速定位脚本的骨架——这对于筛选可复用的 payload、排查语法错误例如大小写写错、关键词拼错和向他人讲解脚本逻辑都极为重要。本仓库在 BadUSB/DuckyScript_UDL 目录下直接提供了现成的 UDL 定义文件由社区成员 B33m0 制作并提供开箱即用。二、安装步骤导入 userDefineLang.xml原文档给出的安装路径非常简洁完整步骤如下准备文件确认userDefineLang.xml已解压就位。本仓库中该文件位于 BadUSB/DuckyScript_UDL/userDefineLang.xml无需手动从压缩包解压。打开 UDL 管理窗口在 Notepad 主窗口中依次点击菜单Language - Define your language...。导入定义文件在弹出的对话框中点击Import按钮导航到userDefineLang.xml所在目录并选中该文件。确认加载双击或打开该 XML 文件等待 Notepad 解析完成。命名保存点击Save As按钮将语言名称保存为DuckyScript或任意你喜欢的名称。启用扩展名关联该 UDL 的默认脚本文件扩展名是.duck对应 XML 中extduck属性。保存为.duck后缀的文件会自动套用高亮。一个值得注意的细节本仓库 BadUSB 目录下的大量 payload 实际以.txt为后缀例如GoodUSB.txt、Wifi-Stealer_Discord.txt。如果希望这些.txt文件也能自动触发高亮可以在Define your language...对话框底部的扩展名字段中追加txt多个扩展名以空格分隔或在打开文件后手动从Language菜单选择DuckyScript临时套用。三、userDefineLang.xml 深度解析userDefineLang.xml采用 Notepad 标准的 UDL 2.1 格式udlVersion2.1根节点为NotepadPlus内部通过UserLang、Settings、KeywordLists、Styles四个层次完整描述了一门自定义语言的语法规则。下面逐层拆解。3.1 全局设置大小写敏感与折叠行为Global caseIgnoredno allowFoldOfCommentsno foldCompactno forcePureLC1 decimalSeparator0 /caseIgnoredno关键字匹配区分大小写。DuckyScript 规范中指令一律使用大写如REM、STRING、DELAY因此该设置能保证小写误写如delay、rem不会被误标成指令有助于发现拼写错误。allowFoldOfCommentsno与foldCompactno关闭注释折叠与紧凑折叠保持行级结构简单直接。其余forcePureLC、decimalSeparator为 UDL 内部标记保持默认即可。3.2 注释定义REM 指令的行级标记Keywords nameComments00REM 01 02 03 04/Keywords注释组将REM注册为注释起始标记对应样式表中的LINE COMMENTS样式。这与 DuckyScript 的语义完全一致REM开头的行是注释行用于书写作者、日期、目标平台等元信息。配合Keywords3分组中的REM注释行会获得独立的绿色样式与可执行指令形成视觉区分。3.3 关键字分组指令、键位与延时UDL 定义了 8 个关键字分组本文件实际使用前 3 组分组收录的关键字高亮样式Keywords1修饰键与系统键MENU APP WINDOWS GUI SHIFT ALT CONTROL CTRL方向键UPARROW DOWNARROW LEFTARROW RIGHTARROW UP DOWN LEFT RIGHT功能与编辑键BREAK PAUSE CAPSLOCK DELETE END ESC ESCAPE HOME INSERT NUMLOCK PAGEUP STRING PAGEDOWN F1 F2 F3 F4 F5 F6 F7 F8 F9 F10 F11 PRINTSCREEN SCROLLOCK SPACE TAB ENTER蓝色加粗Keywords2DEFAULTDELAY DEFAULT_DELAY DELAY红色加粗Keywords3REM绿色加粗斜体分组设计体现了 DuckyScript 的语言模型Keywords1 承载动作与键位语义STRING之后的文本会被原样键入其余均为修饰键GUI/SHIFT/ALT/CTRL和特殊键ENTER/TAB/F1…F11/方向键等。这些是高亮最频繁出现的词汇蓝色加粗使其在脚本中一眼可辨。Keywords2 承载时序控制语义DELAY控制单条指令后的停顿毫秒DEFAULTDELAY/DEFAULT_DELAY两种拼写均被收录用于设定脚本整体的默认延时。红色加粗使其从按键流中脱颖而出。Keywords3 承载注释语义REM作为注释起始关键字与 3.2 节的注释规则互相印证。需要特别指出的是 Keywords1 中键位清单的两个细节供使用者留意清单中收录了F1至F11以及一个单独的12标记但未收录F12。从仓库实际 payload 看功能键确实有使用需求如 BadUSB/SpamRickrollPayload.txt 第 81 行出现了F11。如果脚本需要F12高亮可在Define your language...的关键字列表中自行补入。APP与MENU两个键位同属菜单键语义均已覆盖。3.4 样式表配色与字体权重Styles段为每个语法元素分配前景色、背景色与字体样式fontStyle为位掩码0常规、1加粗、2斜体、3加粗斜体样式名前景色字体样式作用对象DEFAULT000000黑常规普通文本STRING内容、未匹配文本LINE COMMENTS008000绿加粗斜体REM注释行KEYWORDS10000FF蓝加粗修饰键、特殊键、STRING、功能键KEYWORDS2FF0000红加粗DELAY、DEFAULTDELAY、DEFAULT_DELAYKEYWORDS3008000绿加粗斜体REM关键字KEYWORDS4808080灰斜体已定义样式、未分配关键字可自行扩展其余样式000000常规数字、操作符、折叠标记等未启用元素三原色的直观映射——蓝 按键动作红 时间控制绿 注释说明——正是这套 UDL 的核心可用性价值。若想调整配色直接在Define your language...对话框的 Style 面板中修改对应样式的前景色即可。四、仓库实战对照真实 payload 中的高亮效果下面用本仓库 BadUSB 目录中的真实脚本对照第三节的关键字分组验证这套 UDL 的实际覆盖效果。4.1 REM 注释行绿色加粗斜体BadUSB/RickRoll (Basic).txt.txt) 开头是典型的注释元信息REM Author: OpenAI Assistant REM Date: 2022-12-27 REM Description: A simple Ruby Ducky script to play a Rick Roll video三行REM均落入注释/Keywords3绿色样式而 BadUSB/Wifi-Stealer_Discord.txt 则示范了更丰富的注释用法——REM Target: Windows 7/8/10/11、REM Supported Layout keyboard: US/FR/DE、REM Category: Grabber等把目标平台、键盘布局、脚本类别等元信息整齐排列在脚本头部。4.2 延时指令红色加粗时序控制是 BadUSB 脚本可靠运行的关键。同一份 BadUSB/RickRoll (Basic).txt.txt) 中DELAY 1000 GUI r DELAY 200 STRING powershell Start-Process https://www.youtube.com/watch?vdQw4w9WgXcQ DELAY 500 ENTERDELAY全部命中 Keywords2 红色加粗样式与蓝色按键指令形成节奏分明的阅读体验。而 BadUSB/Party_Parrot_Win.txt 第 6 行使用了DEFAULTDELAY 50验证了 Keywords2 对DEFAULTDELAY拼写的覆盖——该语法可在脚本开头统一设定每条指令间的默认等待时间避免逐行书写DELAY。4.3 修饰键与组合键蓝色加粗BadUSB/GoodUSB.txt 大量示范了修饰键组合ALT F4 ; 关闭当前窗口 ALT N ; 触发菜单项 N GUI r ; 打开运行对话框 LEFT ; 方向键导航ALT、GUI、LEFT等均命中 Keywords1。特别是ALT F4这类修饰键 功能键的组合写法两组蓝色加粗关键字连排让组合键意图一目了然。同一文件中还有STRING powershell.exe与ENTER交替出现覆盖了 Keywords1 中的STRING、ENTER。4.4 功能键与批量按键流蓝色加粗BadUSB/SpamRickrollPayload.txt 第 81 行的F11验证了功能键高亮而 BadUSB/265_4_Digit_Pin_BF.txt四位 PIN 码爆破脚本中包含数百行ENTER批量回放在高亮模式下可以明显看出同一种蓝色指令的密集循环结构便于审查脚本逻辑是否完整。五、验证、自定义与注意事项验证安装是否成功新建文件并输入以下最小脚本保存为test.duckREM Syntax highlight check DEFAULTDELAY 50 GUI r DELAY 500 STRING notepad.exe ENTER ALT F4预期效果第一行REM为绿色斜体DEFAULTDELAY、DELAY为红色加粗GUI、STRING、ENTER、ALT、F4为蓝色加粗。若全部符合说明 UDL 已正确加载。几个实用建议大小写敏感由于caseIgnoredno脚本必须使用大写指令才能获得高亮这正好作为拼写自查的手段——如果某条指令没有变蓝/变红多半是大小写或拼写有误。扩展名适配本仓库 payload 以.txt为主可在 UDL 扩展名字段补充txt.duck为推荐的新脚本后缀。按需扩展关键字如需要F12、FN等键位在Define your language...对话框的 Keywords 列表中追加即可Keywords4灰色样式预留了扩展分组的空间。只读使用仓库仓库中的 BadUSB/DuckyScript_UDL/userDefineLang.xml 是官方提供的现成定义建议直接复制到本机使用无需改动仓库内容。六、小结本仓库在 BadUSB/DuckyScript_UDL 下提供了一组开箱即用的 DuckyScript 编辑器支持安装指南ReadMe.md与完整语法定义userDefineLang.xml。通过Language - Define your language... - Import - Save As DuckyScript五步即可完成配置定义文件以蓝色键位/红色延时/绿色注释的三原色方案精确映射了 DuckyScript 的语言模型并以caseIgnoredno保证了语法自检能力。对照 BadUSB 目录中数百个真实 payload这套高亮方案能够显著提升脚本的阅读、筛选与排查效率——无论你是想快速寻找可复用的脚本还是准备自己编写第一条 BadUSB payload都值得先花一分钟把这块脚手架搭好。【免费下载链接】FlipperPlayground (and dump) of stuff I make or modify for the Flipper Zero项目地址: https://gitcode.com/GitHub_Trending/fl/Flipper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
