社区固件通知
本文档 QMK 部分引用的固件由社区维护。本页面描述了这意味着什么、它带来哪些风险，以及 SignalRGB 的支持范围涵盖什么。
关于社区维护的 QMK 固件
Section titled “关于社区维护的 QMK 固件”QMK（量子机械键盘）是一个开源键盘固件项目。SignalRGB 社区的一些成员独立维护 QMK 固件构建，与兼容的设备插件配合使用时，可以让 SignalRGB 控制不受官方支持的键盘。
本文档引用的固件并非由 SignalRGB 开发、构建、分发、审计、签名、测试或维护。这是独立社区成员的工作，他们不是 SignalRGB 的员工、承包商或代理人。从 SignalRGB 文档链接到社区仓库并不构成对该固件的认可、认证或保证。
如 SignalRGB 服务条款第 1.2 和 1.3 条所述，Whirlwind 不是用户与第三方硬件或软件提供商之间协议的一方，并且对与 SignalRGB 平台一起使用的第三方硬件或软件的性能、质量或兼容性不作任何保证。
在键盘上安装第三方固件在几乎所有情况下都会使该设备上的制造商保修失效。无论固件是否造成任何损害，也无论最终故障是否与固件相关，这都适用。SignalRGB 不提供硬件保修，无法对原始制造商拒绝服务的键盘进行赔偿、更换或维修。
失败的刷写——由电源中断、不兼容的构建、固件中的错误或刷写过程中的用户错误引起——可能使键盘暂时或永久无法使用。某些键盘可以通过引导加载程序恢复程序恢复；其他键盘则不能。
在刷写之前，请确认您的特定键盘型号是否有恢复路径以及该路径需要什么。
固件在您的设备上以特权级别运行，理论上可以观察按键操作、修改输入行为并通过 USB 进行通信。SignalRGB 没有对社区维护的固件进行安全审查。我们没有理由相信社区成员当前维护的固件构建是恶意的，但我们无法验证每个提交、分支或构建工件的完整性。
在刷写之前，您应该：
- 仅从原始维护者的仓库获取固件——而不是从重新托管或镜像站获取
- 在维护者提供校验和或签名的地方进行验证
- 在刷写来自不熟悉贡献者的构建之前，自己审查源代码，或依赖您信任的、已经审查过的人
兼容性和稳定性
Section titled “兼容性和稳定性”自定义固件可能会更改您的键盘向操作系统报告输入的方式。这可能会导致以下问题：
- 游戏反作弊系统，有时会标记非标准输入设备
- 期望特定键盘行为的无障碍软件
- 依赖标准 HID 描述符的操作系统功能
- 未来的 SignalRGB 更新、QMK 更新或制造商固件更新
不保证与各版本 SignalRGB 的兼容性。今天有效的固件构建可能在您的下一次 SignalRGB 更新、QMK 更新或操作系统更新后无法工作。随着时间的推移维护固件兼容性是您的责任。
SignalRGB 支持范围
Section titled “SignalRGB 支持范围”如 SignalRGB 服务条款第 10 条（免责声明）和第 11 条（责任限制）所述，SignalRGB 平台按”现状”提供，SignalRGB 的责任相应受到限制。
我们的支持团队无法协助解决：
- 由社区维护的固件引起或与之相关的问题
- 刷写程序、引导加载程序恢复或硬件故障排除
- 与键盘制造商关于保修失效的纠纷
- 与社区固件维护者的纠纷
- 因使用社区固件而导致的硬件损坏、数据丢失或安全事件
有关社区固件的技术问题应通过与您正在使用的特定仓库相关联的问题跟踪器或社区渠道，向该仓库的维护者提出。对于来自 SRGBmods 社区的固件，请使用 GitHub 问题跟踪器或 SignalRGB Discord 上的 QMK 频道。
QMK 和大多数 QMK 衍生项目在 GNU 通用公共许可证（GPL）下分发。如果您修改、再分发或基于社区固件进行构建，您有责任遵守适用的开源许可条款。这些义务存在于您和原始版权持有人之间；SignalRGB 不是这些许可证的当事方，也不执行这些许可证。
最后更新：2026年5月12日