Flipper Zero 刷 Unleashed 固件完整指南：从刷机到装插件只需三步

【免费下载链接】unleashed-firmwareFlipper Zero Unleashed Firmware项目地址: https://gitcode.com/GitHub_Trending/un/unleashed-firmware

车库门、庭院灯、卷帘门各要一个遥控器，出门总得掏对的那一个。把 Flipper Zero 刷上 Unleashed 固件，再往 SD 卡里丢几个社区 FAP 插件，这些零散需求就能收进同一台小设备里。

🧭 它是什么：社区维护的自定义固件

Unleashed 固件是 Flipper Zero 的社区维护分支：它基于官方固件代码，API 保持兼容，你之前装的应用和 FAP 插件不需要为它做任何改动，同时额外加入了更多 Sub-GHz 协议、红外扩展、NFC 解析器和桌面自定义选项。

🚀 三步跑起来：刷固件、装 FAP、跑脚本

1. 刷机：离线更新包最省心

准备一样东西就够：一张插好设备的 SD 卡，加一根 USB 线。先到项目 Releases 页下载最新稳定版flipper-z-f7-update-版本号.tgz，解压后得到f7-update-版本号文件夹。

接着把这个文件夹放进 SD 卡根目录新建的update文件夹里，最终路径长这样：

update/f7-update-x.x.x/

把 SD 卡插回设备，用文件浏览器进入该目录，打开update.fuf，全程不要断电。刷完后打开设置，能看到自定义设备名等新选项，主菜单也多了几个社区应用，说明固件生效了。

2. 装第一个 FAP 插件

FAP（Flipper App Package）本质是带元数据的 ELF 可执行文件，可以理解为"应用安装包"。从社区插件包下载.fap文件，放进 SD 卡的apps目录，按 Back 键还能建子文件夹分类存放。

回到设备重新进一次文件管理器或重启，主菜单就会多出新应用。装好后点开确认图标和名称正常，就算完成。

3. 跑第一个脚本：五行的 JS 应用

不想写 C 的话，JavaScript 是最低门槛的路径。在 SD 卡上新建apps/Scripts文件夹，建一个first_app.js，内容如下：

print("start"); delay(1000); print("1");

用 qFlipper 把文件拖进去，在设备上走 Apps → Scripts，选中运行。屏幕上会按节奏依次出现 start、1、2、3，这就是 Flipper 上最简单的应用形态。

📡 场景进阶

一个按键位管五件事：Sub-GHz 遥控映射

把车库门、庭院灯等 Sub-GHz 信号绑到五个按键上，是 Unleashed 里很实用的玩法。打开 Sub-GHz Remote 应用，按 Back 选 New map file，为每个按键挑一个信号文件，保存后打开这个映射文件，按对应键就能发出对应信号。滚码设备要按 SubGHzCounterMode.md 配好计数器模式，不然发几次就失步了。

在电脑上调试脚本

脚本调试时来回看设备屏幕很麻烦。用 USB 连上电脑，进入 CLI 后直接运行：

js /ext/apps/Scripts/first_app.js

print 的输出会出现在电脑终端里，而不是设备屏幕上，边改边跑效率高很多。

⚠️ 四个常见坑：现象、原因与解法

1. 现象：刷机后背光不亮。原因：误开了为 RGB 改装机准备的背光模式。解决：进 Settings → LCD & Notifications → RGB mod settings 关掉它。
2. 现象：Web 更新时点 Connect 没反应。原因：qFlipper 或其他 Flipper Lab 网页占着设备连接。解决：全部关掉后只用一个 Chromium 内核浏览器重新连接。
3. 现象：主菜单里看不到刚装的 FAP。原因：文件没放在 SD 卡apps目录，或插件与固件版本不匹配。解决：核对目录和.fap后缀，从当前固件版本对应的 Release 取配套插件包，重启后刷新。
4. 现象：更新后桌面、PIN 等设置变回默认。原因：设置文件结构变化时会自动重置，并非每次更新都发生。解决：重新配置一遍，并查看 CHANGELOG.md 确认哪一版改了结构。

📚 下一步往哪学

先读 HowToInstall.md 把安装流程过一遍，再翻 AppsOnSDCard.md 搞懂 FAP 的加载和版本规则，之后就可以照着 js_your_first_js_app.md 写自己的脚本了。仓库里的applications_user目录留给自定义应用，配合构建工具fbt还能把你的代码直接编译成 FAP 推到设备上。刷机前先备份 SD 卡里存着的射频与 NFC 数据，日常也只在合规场景下使用设备。

你最想第一个装上的是哪类插件？

【免费下载链接】unleashed-firmwareFlipper Zero Unleashed Firmware项目地址: https://gitcode.com/GitHub_Trending/un/unleashed-firmware