ramensoftware/windhawk-mods

项目介绍

这个仓库是 Windhawk 模组的官方集合。每个模组对应一个 .wh.cpp 文件，文件里既包含模组代码，也包含元数据，用来修改 Windows 应用或系统行为。仓库既服务于想找现成模组的用户，也服务于通过拉取请求提交或更新模组的开发者。

浏览与安装

模组可以在在线目录中查看，并通过 Windhawk 应用浏览和安装。使用流程是先打开模组目录挑选模组，再在 Windhawk 中完成安装。这个仓库本身是提交和审核模组的来源，不是主要的安装界面。

提交新模组

提交新模组需要创建一个拉取请求，且只包含一个文件：mods/<mod-id>.wh.cpp，其中 <mod-id> 要与模组文件中声明的 ID 一致。文件里的 github 元数据必须指向与拉取请求作者一致的 GitHub 主页。如果填写了 twitter 元数据，作者必须是该主页的所有者并能完成验证。没有声明许可证的模组按 MIT 许可证接收，第三方代码的许可证由作者自行负责。

更新模组时，只改动一个 mods/<mod-id>.wh.cpp 文件，并把 version 元数据改成更新的版本号。github 元数据仍需与拉取请求作者一致，因此只能更新自己最初提交的模组；要修改他人的模组，应把改动交给原作者，或作为新模组提交。提交信息会写入模组的更新日志。

编写与讨论

编写新模组的指南放在 Windhawk wiki 中。日常讨论在 GitHub Discussions 进行，也可以加入 Discord 频道实时交流。

使用约束

模组面向 Windows 上的 Windhawk 应用。提交时需要用与模组元数据匹配的 GitHub 身份，内嵌第三方代码的许可证由作者负责。仓库没有声明顶层许可证；未声明许可证的提交模组默认适用 MIT 条款。

HotRepo 点评

该仓库在 2026-11-03 当周的 C++ 周榜上有记录，新增 29 个 Star，最好名次为第 14。1,090 个 Star 对应 878 个 Fork，这个比例对模组集合来说比较突出，说明不少用户会复刻或改造源码，而不只是浏览目录。这也符合仓库作为单个 .wh.cpp 模组提交与审核中心的定位。

项目源码与说明