本教程将带你从下载安装开始，逐步掌握 Windhawk 的所有核心功能。无论你是初次接触系统定制的新手，还是希望深入了解高级用法的老用户，都能在这里找到所需内容。
在开始使用 Windhawk 之前，请确保你的系统满足以下基本要求。Windhawk 设计为对系统友好，但仍需要正确的环境才能正常工作。
Windhawk 的安装过程非常简单，整个流程不到一分钟。请按照以下步骤操作：
安装完成后，Windhawk 会自动启动。首次运行时，主界面会显示欢迎页面与简要介绍。关闭欢迎页后，你将看到主界面，主要包含以下几个部分：
Windhawk 主界面采用经典的侧边栏 + 内容区布局。左侧为功能导航栏，右侧为对应内容区域。所有操作都可以通过图形界面完成，无需任何命令行操作。
现在让我们来安装第一个模组，体验 Windhawk 的核心功能。我们以最受欢迎的"Windows 11 任务栏样式器"为例。
随着你安装的模组越来越多，管理它们就变得重要。Windhawk 提供了完整的模组管理功能，让你可以轻松控制每一个模组。
在"已安装"页面，每个模组右侧都有一个开关。点击开关可以快速启用或禁用模组，无需卸载。禁用后模组的所有改动会立即失效，但模组文件保留在本地，下次启用时无需重新下载。
每个模组都可以有自己的设置选项。点击模组卡片上的"设置"按钮，会打开该模组的配置面板。所有设置项都通过图形化控件呈现，包括开关、下拉框、滑块、颜色选择器等。修改后即时生效，无需重启。
如果某个模组不再需要，可以点击"卸载"按钮将其完全移除。卸载过程会自动清理所有相关文件与设置，不会留下任何残留。卸载后对应的系统改动会立即恢复原状。
掌握基础操作后，以下进阶技巧能让你更高效地使用 Windhawk，发挥它的全部潜力。
Windhawk 支持将当前所有模组的启用状态与设置导出为 JSON 配置文件。这对于在多台电脑间同步配置、备份当前设置、或与他人分享自己的定制方案非常有用。在"设置"页面找到"导出配置"按钮即可生成配置文件。
某些复杂模组可能依赖其他模组才能正常工作。Windhawk 会自动检测依赖关系，安装时提示用户一并安装依赖项。卸载时也会警告如果其他模组依赖此模组。这种机制避免了因依赖缺失导致的故障。
如果某个模组导致系统异常，可以通过 Windhawk 的"安全模式"快速禁用所有模组。在系统托盘的 Windhawk 图标上右键，选择"安全模式"，所有模组会立即禁用。确认系统恢复正常后，再逐个排查有问题的模组。
Windhawk 不仅是使用者工具，也是一个完整的模组开发平台。如果你是开发者，可以为任何 Windows 程序编写自己的定制模组。
开发 Windhawk 模组需要以下工具：Visual Studio 2022（或更高版本） with C++ 工作组、Windhawk SDK（通过 Visual Studio 扩展安装）、Git（用于从 GitHub 克隆示例项目）。
一个标准的 Windhawk 模组包含以下文件：metadata.toml（模组元数据）、main.cpp（模组主代码）、wh_mod_settings.h（设置架构定义）。模组通过 Windhawk SDK 提供的 API 与目标程序交互，可以拦截函数、修改 UI、注入逻辑等。
Windhawk 提供完整的热重载调试支持。修改代码后保存，Windhawk 会自动重新加载模组，无需重启目标程序。开发完成后，可以通过 GitHub Pull Request 将模组提交到官方仓库，经过审核后即可对全球用户发布。
以下是新手最常遇到的问题与解决方案。如果你遇到的问题不在此列表，请访问完整的 常见问题页面。
扫描二维码，手机访问下载页面 · 永久免费
