USBToolBoxβ 使用手册

让USB映射更加简单

USBToolBox是一款跨平台（Windows和macOS）的USB端口映射工具，它允许您从这两种操作系统构建自定义注入驱动程序（kext）。本手册旨在详尽指导您如何安装、使用此工具，并理解其API接口，以及提供项目安装方法。

安装指南

Windows安装

• 推荐环境: Windows 10 或 11 (64位)，确保拥有完整功能体验。
• 下载: 前往Releases页面获取最新版Windows.exe。若遇到杀毒软件误报，请将应用白名单化或选择下载Windows.zip版本。

macOS安装

• 非推荐原因: 在macOS上可能缺乏如端口类型猜测等功能，且面对端口限制问题。建议使用专为macOS设计的USBMap替代。
• 下载: 若仍决定在macOS下使用，请下载macOS.zip版本。

使用注意事项

对于macOS用户，务必留意USB端口限制，并准备更新config.plist以适应新注入的kext。

项目使用说明

1. 下载对应操作系统版本。
2. 打开软件，视需求调整设置。
3. 点击“发现端口”，等待端口列表自动填充。
4. 按照指导插拔设备进行端口映射。在Windows，仅需一个USB 3.0设备即可；macOS则需分别用USB 2.0和3.0设备测试每个USB 3.0端口。
5. 映射完成后，进入“选择端口”界面，选定需要的端口并调整端口类型。
6. 按‘K’键生成kext文件。
7. 将生成的USB映射文件放入您的EFI/OC/Kexts目录，并更新config.plist配置。
8. 若使用USBToolBox kext，请同时更新到最新版本，并移除旧的UTBDefault.kext（名称待优化）。
9. 重启系统后，新的USB映射应生效。

API使用文档

请注意，当前文档未包含具体的API使用细节。USBToolBox主要通过图形界面操作，不直接公开API接口给最终用户。开发者层面的交互主要是通过源码分析或贡献代码来实现特定功能的定制。

项目安装方式

USBToolBox作为一款应用程序，其“安装”更多指下载解压后的直接运行。对于开发者或希望贡献代码的用户：

1. 克隆仓库: 使用Git命令git clone https://github.com/USBToolBox/tool.git下载项目源码。
2. 开发环境: 确保您的开发环境支持相应操作系统的应用开发，Windows下可能需要Visual Studio，macOS下则可能依赖Xcode。
3. 编译与运行: 根据源码中的说明，配置好编译环境后进行编译，之后可运行生成的应用程序。

维护与反馈

• 查看已知问题解决常见问题。
• 报告bug时，请通过提交新问题流程，详细描述情况。

本手册提供了USBToolBox的基本指引，深入使用过程中，更多高级特性和技巧有待于探索与实践。祝您使用愉快！