HackBGRT：UEFI系统下的Windows启动徽标定制工具全解析

项目核心价值：重新定义UEFI启动体验

为什么选择HackBGRT而非系统自带工具？

HackBGRT为UEFI系统提供了深度定制能力，让你突破Windows官方限制，打造专属启动画面。与传统工具相比，它具备三大优势：支持高分辨率图片显示、提供细粒度配置选项、保持系统启动安全性（通过shim签名验证）。

哪些场景最适合使用这个工具？

无论是打造个性化PC、企业设备品牌化，还是技术学习（深入理解UEFI启动流程），HackBGRT都能满足需求。特别适合：

• 装机爱好者展示个性徽标
• 系统管理员批量定制企业设备
• 开发者学习UEFI应用开发

⚙️ 技术前提：确保你的主板支持UEFI启动模式（非传统BIOS），且已关闭Secure Boot（部分场景可通过shim签名绕过）。

---

文件功能图谱：掌握项目的"五脏六腑"

如何通过3个核心文件掌控项目？

项目根目录/
├── Makefile          # 编译指挥官：控制整个项目的构建流程
├── src/main.c        # 启动大脑：程序入口点，协调所有功能模块
└── config.txt        # 配置中枢：自定义启动行为的控制中心

⚠️ 新手常见误区：直接修改二进制文件试图更换徽标，这会导致签名验证失败。正确做法是修改配置文件指向新图片后重新编译。

解密藏在目录深处的关键组件

项目根目录/src/        # 源代码基地
  ├── efi.c            # UEFI接口适配器：负责与固件交互
  ├── config.c         # 配置解析器：解读config.txt的设置
  └── util.c           # 工具函数库：提供图片处理等辅助功能

项目根目录/gnu-efi/    # UEFI开发工具箱：提供标准UEFI函数支持
项目根目录/shim-signed/ # 安全启动通行证：包含微软签名的引导程序

📂 文件依赖关系：main.c → config.c（读取配置）→ efi.c（执行显示）→ splash.bmp（目标图片），形成完整的功能链条。

---

配置实战指南：3步打造专属启动画面

核心配置参数决策树

需要自定义图片？
├─ 是 → 设置image参数（默认值：splash.bmp）
│  ├─ 推荐值：使用1024×768像素24位BMP格式图片
│  └─ 极端场景：最大支持屏幕分辨率，但会延长启动时间
└─ 否 → 保持默认值或删除此行

系统启动有异常？
├─ 是 → 设置enable-overwrite=false（禁用覆盖模式）
└─ 否 → 保持enable-overwrite=true（默认值）以确保显示优先级

手把手修改配置文件

// 项目根目录/config.txt
# 基础图片配置（必选）
image=custom-logo.bmp  # 替换为你的图片路径

# 高级显示控制（可选）
enable-overwrite=true  # 推荐值：true（优先显示自定义徽标）
position=center        # 可选：left/center/right
timeout=3              # 默认3秒，极端场景可设为0（快速跳过）

🔧 实战小贴士：修改配置后执行make clean && make重新编译，通过make install部署到ESP分区。测试阶段建议先备份原有ESP分区文件。

---

从代码到启动：完整工作流程解析

启动过程的"幕后英雄"们

1. 引导加载：shim-signed目录下的引导程序首先运行，通过UEFI安全验证
2. 配置读取：src/config.c中的config_load()函数解析config.txt
3. 图片处理：src/util.c的load_bmp()函数将图片转为UEFI可用格式
4. 显示输出：src/efi.c的efi_draw_image()函数控制图形显示
5. 流程交接：完成显示后，src/main.c的boot_next()函数移交启动权

💡 调试技巧：遇到启动失败时，检查src/main.c中的错误处理逻辑，特别关注efi_main()函数的返回值判断。

常见问题解决方案

• 徽标不显示：确认config.txt中image路径正确，且图片格式符合要求
• 启动变慢：减小图片分辨率或降低timeout参数值
• 安全启动冲突：使用shim-signed目录下的签名文件，或在BIOS中关闭Secure Boot

⚠️ 注意：修改UEFI相关文件有风险，操作前务必备份ESP分区（通常是EFI系统分区）。建议使用工具如diskpart或第三方分区软件进行备份。

---

扩展与定制：超越基础功能

如何添加新的配置参数？

1. 在src/config.h中定义新参数变量
2. 在src/config.c的config_parse_line()中添加解析逻辑
3. 在src/main.c中使用新参数控制相应功能
4. 更新config.txt注释说明新参数用法

高级开发建议

• 研究src/efilib目录下的库函数，扩展硬件适配性
• 通过修改src/sbat.c实现SBAT级别安全控制
• 参考Doxyfile配置生成完整代码文档（执行doxygen Doxyfile）

📌 开发资源：项目根目录下的README.efilib提供了EFI库的详细使用说明，是扩展开发的重要参考。

---

项目演进与维护

版本更新追踪

通过CHANGELOG.md文件可以查看完整更新历史，重点关注：

• 重大版本的API变更（如config.txt格式修改）
• 安全相关修复（特别是shim-signed目录文件更新）
• 新硬件支持情况（在src/efi.c中添加的设备适配代码）

贡献代码指南

1. Fork项目并创建特性分支
2. 遵循src目录下现有代码风格（特别是efi.c中的UEFI函数命名规范）
3. 添加必要的注释和文档
4. 通过Makefile编译测试（支持交叉编译，详见README.md）

🔖 许可证提示：项目采用MIT许可证（见LICENSE文件），允许商业使用，但需保留原作者版权声明。