TBWinPE/RE Builder 设置

本教程涵盖了 TBWinPE/RE Builder 程序中可用的选项和设置。该程序用于创建 TBWinRE 和 TBWinPE 启动介质，以及更新已安装的 Windows 恢复环境 (WinRE)。

首次运行 TBWinPE/RE Builder 时，它将导入在同一文件夹中找到的任何现有 TBWinPE.cmd 或 TBWinRE.cmd 脚本设置。如果脚本启用了保存设置，则这些设置将被导入。

可以通过单击“项目类型”屏幕上的设置按钮或从“文件”菜单访问程序设置。

如需快速跳转到某个设置选项卡，请单击以下链接：

常规
程序路径
构建选项
语言
脚本
TBLauncher
BootIt
IFW WinRE
插件

常规

TBWinPE/RE Builder 的常规程序选项。

选项

如果许可格式看似有效，则跳过许可步骤：启用此选项后，如果导入或之前输入的 Image for Windows 许可信息格式看似有效，则跳过询问许可信息的向导步骤。

检查需求时忽略警告：启用此选项可忽略检查构建需求时发出的警告。向导将自动进行下一步。禁用此选项时，如果出现警告，您需要单击下一步才能继续。

允许 MakeDisk 使用大于 64GB 的 USB 驱动器：默认情况下，MakeDisk 不会显示大于 64GB 的 USB 驱动器。启用此选项可允许使用此类驱动器。重要提示：请务必小心选择正确的驱动器。

在 Windows 7 RE/PE 构建中下载并包含 USB 3 驱动器：启用此选项可让 TBWinPE/RE Builder 下载常用的 USB 3 驱动器，以便在基于 Windows 7 的构建（Windows 7 WinRE 和 Windows 7 AIK）中使用。如果禁用此选项，系统将不会提示您下载驱动器，且构建中将不包含这些驱动器（即使之前已下载）。

跳过已安装的 WinRE 状态检查：启用此选项可在支持时检查已安装的 WinRE 状态和内容。状态显示是普通 WinRE 还是 TBWinRE，以及包含的 Image for Windows 版本。注意：在使用旧版 TBWinPE/RE Builder 或 TBWinPE.cmd/TBWinRE.cmd 脚本创建的 WIM 文件中，可能无法获取详细信息。需要 Windows 8 或更高版本。

更新时保留 WinRE WIM 备份：启用此选项可在更新到较新 WIM 时保留现有 WinRE WIM 源文件的备份。备份将保存在 WinRE_Backup 文件夹中，并以 WIM 的版本详情命名。这允许您在较新版本出现任何问题时轻松切换回之前的 WIM。虽然旧版 Windows 很少更新安装的 WinRE，但当前版本可能会相当频繁地对其进行更新。要删除旧备份并释放磁盘空间，请单击 删除备份 链接。可以从列表中选择并移除可供删除的备份。默认情况下，将保留最近的四个备份，且这些备份不会出现在待删除列表中。如果您想设置自定义的保留备份数量，可以将 KeepWinREBackupsCount 选项添加到 [General] 部分的 TBWinPE.ini 中（例如： KeepWinREBackupsCount=8）。

启动 WIM

这些选项专门用于启动 WIM 文件，并适用于使用 GUI 启动 WIM 的情况（这些选项不会用于 /bootwim 命令行操作）。

提示重启：在系统配置为启动选定的 WIM 文件后，将提示重新启动系统。

强制重启：强制系统重新启动。如果您有未保存的文件，这可能会导致数据丢失。

忽略驱动器类型：忽略驱动器类型（允许不支持的驱动器类型）。不支持的驱动器类型可能无法成功启动 WIM。

匹配 Windows 驱动器盘符：尝试在启动 WIM 后的初始化期间匹配 Windows 驱动器盘符分配。请注意，某些驱动器（尤其是非固定类型的驱动器）可能仍会被分配不同的盘符。此外，如果启动后无法访问 Windows 分区（例如已加密），则某些驱动器可能不会被分配盘符，可能需要手动分配。此选项需要配置为使用 TBLauncher v1.21+ 的 TBWinRE/PE WIM（这些构建默认使用 TBLauncher）。

使用 BCD HIGHESTMODE 选项：启用此选项可在启动 WIM 文件时使用 BCD HIGHESTMODE 选项。这可能有助于某些系统使用更高或全分辨率，而不是受限于 1024x768 或其他较低分辨率。

DISM

如果支持则使用 DISM API：在支持的系统（Windows 7 或更高版本）上启用以使用 DISM API。使用 API 通常会缩短构建时间。无论启用还是禁用，功能都是相同的。

使用已安装的 DISM：启用此选项后，将使用已安装的 DISM 版本，而不是 WinPE AIK/ADK 文件中包含的 DISM。此选项仅影响 TBWinPE 构建（TBWinRE 始终使用已安装的 DISM），在可以成功创建 TBWinRE 构建但在尝试创建 TBWinPE 构建时出现 DISM 问题或错误的情况下，此选项可能会有所帮助。

使用 x64 DISM：在支持的系统上将使用 x64（64 位）版本的 DISM，而不是 x86（32 位版本）。启用此选项后，将禁用 DISM API 的使用。在可以使用 TBWinRE.cmd（或 TBWinPE.cmd）脚本成功创建构建，但在尝试使用 TBWinPE/RE Builder 创建构建时出现 DISM 问题或错误的情况下，此选项可能会有所帮助。

强制使用未签名驱动程序：启用此选项以允许将未签名的驱动程序添加到构建中。

在构建文件夹中保存日志 (DISM.log)：启用此选项可将 DISM 日志输出保存到构建文件夹中的 DISM.log 文件（DISM 日志输出将不会保存到 Windows 使用的默认日志中）。例如，如果支持人员要求提供日志，可以使用此选项获取单个构建的日志，而无需从默认日志中提取所需条目。如果禁用此选项，日志条目将保存到默认日志中。

启动时重置（清除）日志：启用此选项可在程序启动时清除 DISM 日志文件。此选项仅适用于构建文件夹中的 DISM.log 文件（默认的 Windows DISM 日志文件不会被重置）。如果禁用此选项，新的日志条目将以追加方式写入。

日志

创建日志文件：启用此选项可让程序创建 TBWinPE.log 文件。

程序启动时重置（清除）日志：启用此选项可在程序启动时清除日志文件。如果禁用此选项，新的日志条目将以追加方式写入。

要直接编辑 TBWinPE.ini 文件，请单击编辑 TBWinPE.ini链接。设置对话框将关闭，文件将在记事本中打开。如果您希望在关闭记事本后重新打开设置对话框，请在单击链接时按住 Shift 键。

程序路径

配置 TeraByte 程序的路径、TBWinPE 构建的 Windows AIK/ADK 源路径以及 TBWinRE 构建的 WinRE 源路径。

在大多数情况下，无需指定安装路径。但是，如果程序（或源）未被自动找到，或者您希望指定不同的位置，可以在此处进行操作。例如，如果您的计算机上有来自多个 AIK/ADK 安装的文件但未实际安装它们。

Image for Windows

将显示检测到的 Image for Windows 版本。

TeraByte OS Deployment Tool Suite (TBOSDT)

将显示检测到的 TBOSDT 版本。如果您使用的是“Professional for BootIt”版本，您可能需要在 BootIt 选项卡上输入您的许可详情。

Windows AIK 或 ADK（仅限 TBWinPE）

将显示检测到的 Windows AIK/ADK 源。留空则使用默认/安装路径。如果您输入了路径，可以通过单击检查路径链接进行检查。

WinRE 源（仅限 TBWinRE）

将显示 WinRE 源版本（如果找到）以及当前的源选择（已安装的或用户选择的 WIM）。您可以单击 查看详情 链接以查看当前所选源的 WIM 详情。建议使用已安装的源，因为这通常是最新的并提供最佳支持。但是，如果未找到已安装的 WinRE 或需要不同的版本，您可以浏览并选择备用 WIM。您还可以通过选择文件菜单，然后选择 搜索 WinRE... 项来在系统中搜索 WIM。任何选定的 WIM 都将经过检查，并显示警告或错误。

已安装的 WinRE（推荐）：选择使用已安装的 WinRE 作为源。

使用选定的 WinRE WIM 文件：选择使用选定的 WinRE WIM 文件作为源。如果可用，可以使用浏览...按钮下拉菜单强制浏览对话框在特定的构建文件夹中打开，否则它将在上次使用的位置打开。

重要提示：使用备用 WIM 时，根据版本和架构（Windows 和 WIM 均是如此），某些文件可能不可用。如果您创建此类构建，建议验证其是否能正常启动以及您需要的功能是否受支持。

启动文件：默认情况下，程序会自动选择要使用的启动文件。但是，如果存在启动问题，您可以使用此选项选择备用文件。在所选启动文件丢失或无效的情况下，程序将从可用的有效文件中进行选择。

允许用户选择的 WIM 替换已安装的 WinRE：启用此选项且正在使用用户选择的 WinRE WIM 时，更新或还原已安装 WinRE 的操作将使用选定的 WIM 将其替换。启用此选项时将显示确认消息。

重要提示：此选项旨在用于故障排除和修复目的，仅应在需要时启用。应注意避免无意中替换已安装的 WinRE WIM。

构建选项

选项

卸载 WIM 文件前暂停构建：启用此选项将在 TeraByte 修改完成之后、卸载 WIM 文件之前暂停脚本。这允许用户浏览 mount 子文件夹以验证内容或向构建中添加内容。

使用 startnet.cmd 控制程序启动：使用此选项使构建使用 startnet.cmd 文件来控制程序启动，而不是默认的 (winpeshl.ini)。命令提示符窗口将作为外壳程序 (Shell) 而不是 TBLauncher。您可以单击编辑链接来编辑该文件。使用的 startnet.cmd 文件保存在 config 文件夹中。

从光盘启动时启用“按任意键...”提示：此选项仅适用于 TBWinPE 构建。启用后，此选项将导致 TBWinPE CD 在启动前提示用户按任意键（就像 Windows 安装 CD/DVD 一样）。如果在几秒钟内未按键，计算机将正常从硬盘启动。

从“Drivers”文件夹添加驱动程序：启用此选项以包含 Drivers 文件夹中的任何驱动程序。如果禁用，Drivers 文件夹中的驱动程序将不包含在构建中。

添加已安装的存储驱动程序：启用此选项以将已安装的存储驱动程序添加到构建中。（将跳过某些标准驱动程序。）使用此选项可以避免需要手动将必要的驱动程序放入“Drivers”文件夹。在某些情况下，已安装的驱动程序在 WinPE/RE 环境中可能不受支持，仍需手动添加。请注意，正在创建的构建应与 Windows 版本相同（例如，创建 TBWinRE 构建，在 Windows 10 上使用 Windows 10 ADK 创建 TBWinPE 构建等）。

添加已安装的网络驱动程序：启用此选项以将已安装的网络驱动程序添加到构建中。（将跳过某些标准驱动程序。）使用此选项可以避免需要手动将必要的驱动程序放入“Drivers”文件夹。在某些情况下，已安装的驱动程序在 WinPE/RE 环境中可能不受支持，仍需手动添加。请注意，正在创建的构建应与 Windows 版本相同（例如，创建 TBWinRE 构建，在 Windows 10 上使用 Windows 10 ADK 创建 TBWinPE 构建等）。

优化 WIM 文件：启用此选项可在构建的 WIM 文件创建后对其进行优化/重新打包。如果源 WIM 文件之前被修改过，这可以减小文件大小。

添加 BitLocker 支持：包含用于添加 BitLocker 支持的 WinPE 包。此选项仅适用于使用 Windows ADK 源的 TBWinPE 构建（TBWinRE 构建默认包含 BitLocker 支持）。

UEFI 启动文件：选择用于构建的 UEFI 启动文件。如果目标系统启用了安全启动 (Secure Boot)，这一点非常重要。如果使用了错误的文件，可能需要禁用安全启动才能允许介质启动。

使用默认值：使用默认启动文件。对于未将默认文件替换为 Windows UEFI CA 2023 版本的系统，这些通常是 Microsoft Windows Production PCA 2011 版本。
自动选择：如果 BIOS 中已安装 Windows UEFI CA 2023 证书，则将选择该版本（如果可用）。
Windows UEFI CA 2023：使用 Windows UEFI CA 2023 文件版本（如果可用）。

屏幕

您可以选择一种标准分辨率，或直接输入任何 ChgRes 参数。请注意，Windows 8 或更高版本仅支持 32bpp 分辨率。默认使用 1024x768（建议使用 1024x768 或更高）。

重要提示：请注意，启动进入 WinPE 时支持的分辨率与 Windows 中的不同。某些系统可能仅支持极少数分辨率（UEFI 系统通常仅支持一种），且某些系统可能实际上并不支持列出的所有分辨率。在指定备用分辨率之前，您可以在启动到 TBWinPE 或 TBWinRE 时使用 TBLauncher 或 ChgRes 进行测试，以验证您要使用的分辨率在 WinPE 中是否有效（运行不带任何选项的 ChgRes 将显示用法信息）。

屏幕 DPI 可设置为使用默认值、96、120、144 或 192。这在使用无法被正确自动检测的 FHD/QHD/QFHD 显示器时很有帮助。

使用 BCD HIGHESTMODE 选项：启用此选项可在启动启动介质时使用 BCD HIGHESTMODE 选项。这可能有助于某些系统使用更高或全分辨率，而不是受限于 1024x768 或其他较低分辨率。

时区

从列表中选择所需的时区。

Wi-Fi

导出 Wi-Fi 配置文件：启用此选项以导出 Wi-Fi 配置文件供构建使用。配置文件包含连接到特定 Wi-Fi 网络所需的信息。对于系统配置文件，仅导出当前已连接或之前已连接且仍被系统保留的配置文件。请注意，高级/企业配置文件类型在 TBWinRE 环境中可能不受支持或无法正常工作。您可以选择同时导出系统配置文件和 Wi-Fi*.xml 配置文件、仅导出系统配置文件或仅导出 Wi-Fi*.xml 配置文件。

如果您希望手动包含配置文件，请将其导出为 .xml 文件，放入构建文件夹中，并命名为符合以下掩码的名称：Wi-Fi*.xml（例如 Wi-Fi-Profile1.xml）。当您需要包含不在创建构建的系统上的配置文件时，这会很有帮助。可以使用管理员命令提示符运行以下命令来导出配置文件（将 ProfileName 替换为正确的配置文件名称）：netsh wlan export profile name="ProfileName" key=clear

注意：Wi-Fi 选项和功能仅在 Windows 10 或更高版本的 TBWinRE 构建中受支持（建议使用最新版本的 Windows 10 或 Windows 11 以获得最佳支持）。此外，构建中需要包含所用 Wi-Fi 设备的相应驱动程序。默认包含一些驱动程序，但许多驱动程序并不包含在内（同样，建议使用最新版本的 Windows 10/11 以获得最新的内置驱动程序）。如果使用包含已安装驱动程序的选项不起作用，您需要手动将驱动程序添加到构建中。某些设备可能没有能在 WinRE 环境中正常安装和运行的驱动程序。

以明文形式导出配置文件密码：选择此选项以使用明文密码导出配置文件。这允许配置文件在连接时无需提示输入密码。如果不使用此选项，配置文件将以加密密码导出，该密码将在 Wi-Fi 初始化期间被清除。

在 Wi-Fi 初始化期间自动连接已连接的配置文件：启用后，TBLauncher 的 Wi-Fi 初始化将尝试连接到创建构建时已连接的导出配置文件。无论此选项状态如何，都可以手动连接配置文件。

鼠标

指针速度：从允许的范围内选择所需的指针速度。

提高指针精确度：选择以启用增强的精确度和加速度。

切换主要和次要按钮：选择以交换鼠标按钮。

注意：上述选项对应于标准的 Windows 鼠标设置，可能不适用于所有指针设备。即使设置相同，TBWinPE/RE 中的指针速度也可能与 Windows 中不同。这些设置也可从 TBLauncher 的“工具”菜单（鼠标设置...）中获得，并可在启动后进行调整。

光标类型：选择要使用的鼠标光标类型（如果不可用，将使用默认值）。选项包括“默认”、“Aero”、“Aero (XL)”、“黑色”和“黑色 (L)”。启动后也可以在 TBLauncher 中选择构建中可用的光标类型。默认情况下，构建中将包含 Aero 光标，并用于较大的默认尺寸。

大小：选择光标大小。启动后也可以在 TBLauncher 中选择光标大小。

语言

语言包

使用此选项安装语言包。您可以输入语言包名称或使用下拉菜单选择一个。请注意，必须指定有效的 AIK/ADK 源路径才能填充列表。选定的语言包将被安装并设置为默认语言。此选项仅适用于 TBWinPE 构建。

如果可用，添加语言字体支持包：几种语言有额外的字体支持包可用（例如 ja-jp）。启用此选项以包含该包（如果可用）。

输入区域设置

使用此选项将输入区域设置设为备用值。所选的区域设置必须受当前使用的语言包支持。

脚本

自定义初始化、运行和构建脚本。

可以在构建中启用这些脚本，以更轻松地处理自定义构建、初始化和自动化任务。InitScript 和 RunScript 在启动时从 TBLauncher 运行，并提供使用 startnet.cmd 脚本的替代方案。注意：不运行 TBLauncher 的使用 startnet.cmd 的自定义构建仍可以通过从 startnet.cmd 直接调用来使用这些脚本。

要使用这些脚本中的任何一个，请启用相关选项。单击编辑链接以编辑文件（这些文件保存在 config 文件夹中）。InitScript.cmd 和 RunScript.cmd 文件将被复制到构建的 \Windows\System32 文件夹中（启动后为 X:\Windows\System32）。

InitScript.cmd

此脚本将在显示 TBLauncher 之前运行，并且就在配置为自动启动的程序（例如 Image for Windows）之前运行。注意：如果此脚本必须在标准 WinPE 初始化完成后才能运行，请务必禁用 TBLauncher 的在后台运行初始化程序选项。

RunScript.cmd

此脚本将在启动时运行（如果使用了 InitScript.cmd，则紧随其后），并将取代配置为自动启动的程序（例如 Image for Windows）。注意：使用 autorun.cmd 的自定义构建需要从 RunScript.cmd 直接调用它才能使用，因为它不会自动运行（例如 call %TBDrive%\TBData\autorun.cmd）。

BuildScript

此脚本将在构建过程中运行，允许自动执行自定义构建操作。启用此选项后，您可以通过启用隐藏窗口选项来选择在脚本运行时隐藏命令提示符窗口（如果窗口被隐藏，则不应在脚本中使用需要用户交互的命令，因为将无法进行响应）。如果您选择隐藏窗口，还可以通过启用记录输出选项来选择记录脚本输出。有关使用 BuildScript 的示例以及可用环境变量的详细信息，请参阅以下知识库文章：向 TBWinPE/RE 构建添加程序.

TBLauncher

TBLauncher 的配置选项。

模式

此选项控制 TBLauncher 运行时自动启动哪个程序。有效模式为：

WinPE - 将运行 Image for Windows。这是默认设置。

WinRE - 如果找到，则运行系统恢复选项程序。否则运行 Image for Windows。

IFW - 使用指定的参数运行 Image for Windows。如果您想配置构建以自动运行 Image for Windows 并执行特定任务（例如创建备份或还原映像），此模式非常有用。注意：从 TBLauncher v1.17 开始，参数中指定的环境变量将被展开。

初始化

运行 WinPE 初始化：启用后，TBLauncher 在启动时运行 WinPE 初始化程序 (wpeinit)。禁用后，如有必要，您可以从 TBLauncher 的“文件”菜单手动运行它。禁用此选项可以加快启动速度。

运行网络初始化：启用后，TBLauncher 在启动时运行网络初始化。禁用后，如有必要，您可以从 TBLauncher 的“文件”菜单手动运行它。如果需要网络访问，则需要运行此项。禁用此选项可以加快启动速度。

运行 Wi-Fi 初始化：启用后，TBLauncher 在启动时运行 Wi-Fi 初始化。这仅在 Windows 10 TBWinRE 构建中受支持。如果启用了自动连接已连接配置文件的构建选项，TBLauncher 将尝试连接适用的配置文件。如果配置文件密码未以明文形式导出，系统将在尝试连接时提示您输入密码。注意：在初始化和第一次连接尝试期间可能会有长达两分钟的延迟（通常在一分钟左右）。

如果您需要重新连接或切换到不同的配置文件，可以通过 TBLauncher 的“工具”菜单使用导出的配置文件。如有必要，可以从 TBLauncher 的“文件”菜单再次运行初始化（在此过程中，已连接的配置文件将被断开）。

禁用防火墙：启用此选项以禁用 Windows 防火墙。这是在 Image for Windows 中使用多播所必需的。

在后台运行初始化程序：启用此选项可让 TBLauncher 在后台运行初始化程序，而不是在运行 Image for Windows 或系统恢复选项程序之前等待它们完成。根据系统的不同，在运行 Image for Windows 或系统恢复选项程序之前可能仍会有延迟。例如，如果您将 Image for Windows 设置为自动运行且它需要网络访问，您会希望禁用此选项，以便在 Image for Windows 运行时网络可用。

启动

启动后搜索 TBWinRE/PE 启动介质驱动器：启用后，TBLauncher 将在启动后搜索 TBWinRE/TBWinPE 启动介质驱动器。如果找到，则适用以下情况：

%TBDrive% 环境变量将被设置为启动介质的盘符，并可用于脚本、菜单项等。
如果驱动器上存在 \TBData\TBLauncher.ini 文件，则将使用该文件而不是内置的 INI 文件。请注意，由于初始化已经发生，替换文件中的初始化选项将不会被使用。但是，将使用模式选项和菜单项。
如果驱动器上存在 \TBData\autorun.cmd 文件，它将运行并覆盖模式设置。这允许轻松配置和使用自动运行脚本，而无需重新创建构建。单击编辑 autorun.cmd 以编辑文件。重要提示：使用自动运行脚本时应小心。根据脚本的不同，在错误的系统上运行或在不适用时运行可能会产生不良后果。

从 TBWinPE/RE Builder v1.15 和 TBLauncher v1.17 开始，每个构建都会分配一个唯一的构建 ID（默认为 GUID），并在搜索启动介质时匹配此 ID。以前，建议在使用此选项时仅将一个 TBWinRE/TBWinPE 启动介质连接到系统（正在启动的那个），因为搜索会在找到第一个匹配项时停止。如果启动时连接了多个使用相同 ID 的驱动器，仍然建议这样做。如果您需要恢复到旧的搜索方法，可以将 MatchBuildID=0 选项添加到 [Options] 部分的 TBLauncher.ini 中。如果您想指定自定义构建 ID 值，可以将 BuildID 选项添加到 [Options] 部分的 TBWinPE.ini 中（例如： BuildID=Office 2018-09）。请注意，构建 ID 值区分大小写。

由于 WinPE 初始化连接设备需要时间，搜索启动介质驱动器可能会使 TBLauncher 的启动速度减慢几秒钟。如有必要，您可以指定搜索启动驱动器的最大秒数（最多 20 秒，默认值为 8 秒）。如果搜索时间不够长，可能找不到驱动器，或者只能偶尔找到。

启动到启动文件（TBWinRE.bin 或 TBWinPE.bin）时，将无法找到实际的启动驱动器。这是因为在进行搜索时，它已不再作为驱动器存在。但是，如果连接了其他匹配的 TBWinRE/TBWinPE 启动介质，则会找到它。例如，如果您启动到启动文件并连接了匹配的自定义 TBWinRE UFD，它将被找到，并使用其中的 TBLauncher.ini 和 autorun.cmd。

搜索 TeraByte 程序的更新版本：启用此选项以搜索 TeraByte 程序的更新版本。启动后，如果启用，TBLauncher 将在指定的构建路径和默认安装路径中搜索 TeraByte 程序（Image for Windows、TBIView、TBIMount、TBIHD 和 TBOSDT）。如果找到较新版本，将使用该版本而不是构建中包含的版本（如果选择了该选项，将首先询问用户）。 重要提示： 建议在更新 Image for Windows 时更新启动介质。如果您依赖此选项，而包含更新版本的驱动器无法访问（例如空白、损坏等），搜索将失败，您可能无法使用构建中包含的旧版本访问备份。 注意：此搜索可以从 TBLauncher 的“工具”菜单手动执行。

运行讲述人：启动时运行讲述人辅助功能程序。这仅在基于 Windows 10 1703 或更高版本的 TBWinRE 构建中受支持。讲述人也可以从 TBLauncher 的“工具”菜单运行，或使用标准 Windows 快捷键 (Ctrl+WinKey+Enter) 运行。

运行屏幕键盘：启动时运行屏幕键盘辅助功能程序。这仅在 TBWinRE 中受支持，且需要 Windows 8.x/10。屏幕键盘也可以从 TBLauncher 的“工具”菜单运行。

选项

创建日志文件：创建 TBLauncher 日志文件（如果在普通 Windows 中运行 TBLauncher，则不创建日志文件）。

总在最前：保持 TBLauncher 窗口位于其他窗口之上。建议启用此选项。

鼠标悬停时打开：当鼠标移动到 TBLauncher 的关闭状态窗口上时将其打开（无需单击窗口）。注意：启用此选项也将启用总在最前。

鼠标离开时关闭：当鼠标离开 TBLauncher 的打开状态窗口时将其关闭。注意：此选项仅在启用鼠标悬停时打开时适用。

默认的关闭延迟为 1.5 秒。但是，当单击或激活另一个窗口时，TBLauncher 仍会正常关闭，无论延迟如何。如有必要，可以通过在 TBLauncher.ini 的 [Options] 部分为 MouseLeaveDelay 设置一个值来调整延迟。有效值为 1 到 40，每个值增加 250 毫秒（默认值为 6）。例如，如果您需要 3 秒的延迟，则应使用 MouseLeaveDelay=12。

关闭时透明：允许 TBLauncher 窗口在关闭（非活动）时透明。这在较小的屏幕上很有帮助，因为其他程序的输出通常会被 TBLauncher 遮挡。默认不透明（滑块位于最左侧）。

样式：设置用于 TBLauncher 窗口的样式。

默认：将使用默认样式。
小型：TBLauncher 在非活动时关闭为一个更小的窗口。
图标（左边缘）：TBLauncher 作为屏幕左边缘的图标启动栏运行，在非活动时折叠为几个像素宽。可以通过在窗口/菜单区域右键单击来访问程序的菜单。单击图标将启动相关程序。将鼠标悬停在图标上将显示带有项目名称的工具提示。

样式颜色：指定用于 TBLauncher 的颜色集。这些颜色影响 TBLauncher 的主菜单和其他几个区域，并非全彩色皮肤。

默认：使用默认颜色。
深灰色：使用深灰色背景和深色。
黑色：使用黑色背景和深色。

要显示的最大启动菜单项数量：设置 TBLauncher 中显示的最大启动菜单项数量。有效值为 6（默认）到 24。大于 6 的值将在启动和分辨率更改时进行调整，以显示以下各项中的较大者，最高不超过指定的上限：最小计数、实际菜单项数量、垂直分辨率所能容纳的数量。此设置也可以在启动后在 TBLauncher 中更改。

手动编辑 TBLauncher.ini

要直接编辑 TBLauncher.ini 文件，请单击编辑 TBLauncher.ini链接。程序将在记事本关闭后刷新选项。

自定义菜单项

可以通过手动编辑 TBLauncher.ini 文件（保存在 config 文件夹中）来添加菜单条目。更新 ItemCount 变量（在 [Menu] 部分）并为新项目添加一个部分（例如 [Menu_Item_11]）。指定 Name、Path、WorkingDir（如果适用）、Parameters（如果适用）以及 Icon 索引值（通常为 0）。您还可以通过指定文件路径来使用自定义图标（支持的文件类型：.ico、.exe、.dll）。请注意，虽然已指定，但图标索引值不适用于 .ico 文件。示例：
Icon=0,%TBDrive%\my icons\custom.ico
Icon=6,X:\Custom Program\program.dll

环境字符串将被展开（例如 %ProgramFiles%）。请注意，X: 是分配给已启动的 WinPE RAM 驱动器的盘符（如果您需要硬编码它）。

如果使用了启动后搜索 TBWinRE/PE 启动介质驱动器 (FindBootDrive) 选项，您还可以在菜单项路径中使用 %TBDrive% 环境变量来指定启动介质。这允许在启动前驱动器盘符未知的情况下，将便携式应用程序添加到驱动器中。

有关示例，请参阅文件中的现有菜单项。知识库文章向 TBWinPE/RE 生成版本添加程序中也有相关示例。

启动至 TBWinPE/RE 时使用键盘访问 TBLauncher

通常可以使用键盘上的 Alt-Tab 访问 TBLauncher。但是，如果 TBLauncher 设置为始终置顶，基于较新 Windows 11 WinPE/RE 版本的生成版本可能不会在 Alt-Tab 列表中循环显示 TBLauncher。要直接打开 TBLauncher，可以使用 WinKey+Tab 热键。

当 TBLauncher 处于活动状态时，要打开图标样式的 TBLauncher 菜单，可以使用 上下文菜单 键或 Shift-F10。

注意： 如果您希望使用 GUI 设置而不是手动编辑 TBLauncher.ini 文件，则在配置 TBWinPE/RE Builder 中提供的 TBLauncher 高级选项插件时，也可以使用以下选项。

屏幕截图选项

在 TBLauncher 主窗口中按 F12，或使用工具菜单中的 捕获屏幕截图 项（默认延迟 5 秒）即可进行屏幕截图。也可以使用全局热键 (Ctrl-PrnScr) 进行无延迟截图。文件保存在 X:\Screenshots 文件夹中（请在重启前将其复制到其他位置以进行保存）。

如有必要，可以通过编辑 TBLauncher.ini 文件（保存在 config 文件夹中）手动添加屏幕截图选项。选项必须位于 [Screenshot] 部分。

Delay=n - 截图前的延迟秒数 (2 - 10)（默认值为 5）。例如：Delay=7
RemoveLayered=0 - 默认情况下，在某些生成版本中，截图前会移除分层窗口样式，因为它们无法捕获分层/透明窗口。如果这导致了问题，可以使用此选项将其禁用。
Bmp=1 - 将屏幕截图保存为位图 (.bmp) 文件。默认格式为 PNG (.png) 文件，其体积要小得多。
Folder=path - 保存屏幕截图的文件夹路径。可以使用环境变量（例如 %TBDrive%）。指定的路径应当存在。
Hotkey=n - 默认全局热键为 Ctrl-PrnScr。如果这与其他功能冲突，还有其他几种选择：0=Ctrl-PrnScr, 1=PrnScr, 2=F9, 3=Ctrl-F9, 4=F11, 5=Ctrl-F11, 6=Ctrl-F12, 7=Ctrl-Alt-P。或者，可以通过指定修饰键和虚拟键代码来使用特定的组合键 (Hotkey=mod,code)。仅支持 Ctrl、Alt 和 Shift 修饰键。例如，Alt-F8：Hotkey=0x1,0x77

显示背景图像

作为针对某些 Windows 11 版本的 TBWinRE 生成版本无法正确更新背景图像问题的变通方法，TBLauncher 将显示背景图像。（在 TBLauncher 1.43+ 中，如果找到 winpe.bmp 文件则使用该文件，否则使用 winpe.jpg/winre.jpg 文件。以前的版本仅使用 winpe.bmp 文件。）如果需要，可以通过按住 Ctrl 并单击鼠标左键 (Ctrl-LMouse) 来关闭图像，或者在 TBLauncher 的程序设置中禁用该选项。要完全禁用此选项，请手动编辑 TBLauncher.ini 文件（保存在 config 文件夹中），并将 BackgroundImage=0 选项添加到 [Options] 部分。如果需要，可以使用 BackgroundImage=3 让 TBLauncher 无论 Windows 版本如何都显示背景图像。

其他自定义 / 高级选项

可以在 TBLauncher.ini 文件的 [Options] 部分指定以下选项。

RotateDisplay=n - 为支持该功能的系统指定要使用的显示旋转。

0 - 不尝试旋转（这是默认操作）。
1 - 使用默认显示方向。
2 - 旋转 90 度。
3 - 旋转 180 度。
4 - 旋转 270 度。

SingleClickLaunch=0 - 禁用图标样式中菜单项的单击启动（默认情况下，此样式启用单击启动）。

TooltipDelay=n - 指定图标样式中菜单项工具提示显示前的延迟（以毫秒为单位）。有效值为 0（禁用）、500 到 5000。默认值为 1500（1.5 秒）。例如，要将延迟设置为 1 秒：TooltipDelay=1000

AssignOpts=n - 这是一个位标志选项，用于控制 TBLauncher 在启动时是否尝试为未自动分配的驱动器盘符的分区分配盘符。如果未指定该选项或将其设置为 0（默认值），则不会尝试分配。将各值相加以启用多个选项。

1 - 为未分配的分区分配盘符（如果同时指定了位 2，则将覆盖位 2）。
2 - 仅当未启用 BootWIM 驱动器盘符匹配时才分配盘符。启用匹配时，未分配的分区可能会保持未分配状态。
4 - 仅为未分配的 Windows 分区分配盘符（必须同时设置值 1 或 2）。

WinREOpts=n - 这是一个位标志选项，用于控制 WinRE 特定操作（将各值相加以启用多个选项）。

1 - 不要将系统恢复选项添加到主菜单（将改为在工具菜单中显示）。
2 - 当指定或强制使用 WinRE 模式时，使用 WinPE 模式。WinRE 系统恢复选项程序不会在启动时自动运行 —— 除非手动运行，否则不会执行由其实现的操作。重要提示： 除非您了解其影响，否则请勿启用此选项。

WinPEOpts=n - 这是一个位标志选项，用于控制 WinPE 特定操作。

1 - 在正常 WinPE 模式启动时不要自动运行 Image for Windows。在任何其他情况下，IFW 仍将正常运行 —— 这仅影响未自动运行任何其他程序且默认运行 IFW 的启动情况。

BootIt

BootIt 的许可信息。如果已激活安装的 TBOSDT，许可应自动导入。

使用 BootIt Collection V2

使用 BootIt Collection V1 或 BootIt BM

BootIt 许可

输入您的 BootIt Collection 或 BootIt Bare Metal 产品密钥。当生成版本中包含适用于 BootIt 的 TBOSDT Pro 时，将使用此密钥。如果名称或产品密钥缺失或无效，运行 TBOSDT 时可能会提示您输入。

如果使用 BootIt Collection V2（或未找到 TBOSDT），则只会显示该许可的字段。否则，对于 BootIt Collection V1 或 BootIt Bare Metal 版本，您只需输入一个许可。例如，如果您购买了 BootIt Collection，请输入该许可并将 BootIt Bare Metal 字段留空。

如果您不包含适用于 BootIt 的 TBOSDT Pro，可以将这些字段留空。

如果未启用如果生成版本中包含适用于 BootIt 的 TBOSDT Pro 且许可似乎无效，则发出警告选项，则程序在检查生成要求时，如果许可似乎无效，将不会发出警告。

IFW WinRE

IFW WinRE 和 IFW BootWIM 生成版本的配置选项。

IFW WinRE 和 IFW BootWIM 是自定义的 TBWinRE 生成版本，旨在直接从 Image for Windows 启动，以在 Windows 之外执行自动化操作。例如，当尝试还原正在运行的 Windows 分区时，Image for Windows 将无法获取该分区的锁定。在这种情况下，如果用户选择重启，Image for Windows 将创建（或在必要时更新）自定义 TBWinRE 生成版本并启动进入该版本以执行还原。这些生成版本需要 Windows 7 或更高版本、Image for Windows 3.48+、TBWinPE/RE Builder 1.25+、TBLauncher 1.24+。建议使用当前版本（其最低版本要求可能高于此处列出的版本）。

IFW WinRE 将安装的 WinRE 更新为 TBWinRE 生成版本（如果可用空间较少，则可能是精简版），而 IFW BootWIM 是保存在 Builder 文件夹中的完整 TBWinRE 生成版本。由于这些生成版本的性质，一些程序和生成设置被强制设定为所需状态。其余设置将按照正常生成版本中的方式使用。

选项

使用 IFW BootWIM 模式：启用此项以在指定了 IFW WinRE 模式的情况下仍使用 IFW BootWIM 模式。这在不希望修改已安装的 WinRE、已安装的 WinRE 已损坏、IFW WinRE 构建失败或 IFW WinRE WIM 过大无法放入 WinRE 分区的情况下非常有用。

添加已安装的存储驱动程序：启用此项以在生成版本中包含已安装的存储驱动程序。此选项将覆盖等效的生成设置，并且默认启用。注意： 取决于 WinRE 分区上的可用空间量，向 IFW WinRE 生成版本添加驱动程序可能会导致 WIM 过大而无法放入。在这些情况下，可以禁用该选项（如果不需要驱动程序）或改用 IFW BootWIM。

添加已安装的网络驱动程序：启用此项以在生成版本中包含已安装的网络驱动程序。此选项将覆盖等效的生成设置，并且默认启用。注意： 取决于 WinRE 分区上的可用空间量，向 IFW WinRE 生成版本添加驱动程序可能会导致 WIM 过大而无法放入。在这些情况下，可以禁用该选项（如果不需要驱动程序）或改用 IFW BootWIM。

运行 WinPE 初始化：启用后，TBLauncher 会在启动时运行 WinPE 初始化程序 (wpeinit)。此选项将覆盖等效的 TBLauncher 设置，并且默认启用。

运行网络初始化：启用后，TBLauncher 会在启动时运行网络初始化。此选项将覆盖等效的 TBLauncher 设置，并且默认启用。如果任何自动化的 IFW WinRE 或 IFW BootWIM 操作需要（或可能需要）网络访问，则不应禁用此选项。

允许运行 InitScript：对于自定义生成版本，启用此项以允许在启动初始化期间运行 InitScript。默认情况下，此选项处于禁用状态，因为自定义内容可能会干扰执行自动化的 Image for Windows 操作。禁用时，脚本仍将包含在生成版本中，但 TBLauncher 不会在初始化期间运行它。

允许运行 BuildScript：对于自定义生成版本，启用此项以允许在生成过程中运行 BuildScript。默认情况下，此选项处于禁用状态，因为自定义内容可能会干扰执行自动化的 Image for Windows 操作。如果使用，脚本不应需要用户交互，以便可以无人值守地创建生成版本。

始终针对较新的程序版本 (IFW/TBOSDT) 重新生成：启用后（默认值），如果发现较新版本的 Image for Windows 或 TBOSDT，将重新生成 IFW WinRE 和 IFW BootWIM。建议保持此选项启用，以确保在启动前将当前版本包含在生成版本中。禁用此选项将防止在这些情况下重新生成，而是在启动后搜索较新的程序版本。如果找到，它们将被复制并替换旧版本。如果未找到，或者包含较新版本的分区无法访问（例如已加密），则将使用现有版本。 注意： 禁用此选项不会阻止由于最低程序版本要求而进行的重新生成。

针对较新的 WinRE 重新生成（仅限 IFW BootWIM）：启用此项以在发现较新版本的 WinRE 时强制重新生成 IFW BootWIM。

匹配 Windows 驱动器盘符：尝试在启动 WIM 后的初始化期间匹配 Windows 驱动器盘符分配。请注意，某些驱动器（尤其是非固定类型的驱动器）可能仍会被分配不同的盘符。此外，如果 Windows 分区在启动后无法访问（例如已加密），某些驱动器可能不会被分配盘符，并可能需要手动分配盘符。

忽略驱动器类型：忽略驱动器类型（允许不支持的驱动器类型）。不支持的驱动器类型可能无法成功启动 WIM。

备份

生成版本的备份可以保存到备用位置。对于自动化生成，如果找到且有效，备份可以自动恢复使用，而不是重新生成。这对于生成时间较慢的系统或恢复操作会导致当前生成文件丢失的系统（例如 WinRE 位于 Windows 分区上）很有帮助。 注意： 如果您还原了包含 Builder 文件的分区（例如还原了 Windows 分区），您可能需要在更新 Image for Windows 和 Builder 后启用该选项并设置备份文件夹，以便能够找到备份。

启用 WIM 文件的备份/恢复：启用此项以使用备份/恢复功能。还必须指定一个备份文件夹。例如，您可以使用保存 Image for Windows 备份镜像或其他备份文件的驱动器上的文件夹。

插件

插件的配置选项。有关使用、创建和测试插件的更多详细信息，请参阅 TBWinPE/RE Builder 插件手册。该手册也可以从程序的“帮助”菜单中打开。

插件提供了一种简便的方法，可以将文件、WinPE 包、驱动程序甚至兼容的程序包含到支持的生成类型中。当包含插件时，所选插件将在生成过程中运行。

启用开发者模式可为在生成过程中创建、测试和修改插件提供额外支持。有关使用开发者模式的信息，请参阅插件手册。

打开插件文件夹 按钮将打开该生成版本的插件文件夹。此文件夹包含可供该生成版本使用的插件。主文件夹中可以存在多个插件，但对于需要多个文件的插件，建议使用子文件夹，以便更好地组织文件并防止多个插件使用同名文件时出现问题。要删除插件，请删除插件的文件（或文件夹）并重新加载插件。也可以使用列表的上下文菜单删除插件。

重新加载插件 按钮将从插件文件夹中重新加载插件。如果进行了更改（编辑、添加、删除文件等），此功能非常有用。

创建插件 按钮将弹出一个对话框，用于输入插件的基本信息（名称、文件名、描述）并选择支持的生成模式/类型/架构。其他详细信息/设置、要求的版本等，需要通过编辑插件文件来添加到插件文件中。

下载插件（或 安装插件）按钮将允许从 TeraByte 网站下载（如果已启用）并安装插件。如果发现新版本，可以更新已安装的插件。当禁用下载插件时，可以使用 安装插件 按钮下拉菜单进行下载，而无需更改选项。

常规选项

在生成中包含插件：启用此项以在生成版本中包含所选插件。如果未启用此选项，所选插件将不会包含在生成版本中。

忽略警告：启用此项以在检查插件要求时忽略警告。警告包括错误和不支持的插件。基本上，如果插件未成功完成要求检查，它将触发警告（如果继续生成，该插件将被禁用且不被使用）。注意： 此选项会自动为无人值守生成启用。

重新加载插件前保存设置：启用此项可在重新加载插件前自动保存当前的插件设置。适用于手动和自动重新加载。注意： 如果取消设置对话框，已保存的设置将不会还原。

在编辑器中查看文本文件：启用此项可在文本编辑器中而不是内置查看器中查看文本文件（如日志、ReadMe 文件等）。默认情况下，使用记事本作为编辑器。

禁用下载插件：禁止从 TeraByte 网站下载插件。禁用下载后，只有已下载或程序附带的插件可供安装。

启用开发者模式 (DevMode)：启用开发者模式。这允许在生成过程中暂停要求检查和生成步骤，以便管理插件。此外，可以使用测试插件来辅助开发插件。必须至少启用一个插件，生成过程才能进入开发者模式。此选项通常仅在开发或测试插件时启用。有关使用开发者模式的信息，请参阅插件手册。注意： 此选项将为无人值守生成禁用。

要求检查成功时暂停 (DevMode)：启用此项可使生成在要求检查成功时暂停。默认情况下，生成仅在出现错误/警告时暂停。成功时暂停有助于访问测试插件，并允许逐个执行插件。

生成成功时暂停 (DevMode)：启用此项可使生成在插件的生成步骤成功时暂停。默认情况下，生成仅在出现错误时暂停。成功时暂停有助于访问测试插件，并允许逐个执行插件。

允许 TestReq 插件 (DevMode)：启用此项以允许在插件要求检查步骤期间访问 TestReq 插件。此插件可用于测试要求和代码，以辅助开发插件。由于运行此插件时尚未挂载生成版本，因此使用测试文件夹和注册表配置单元来允许测试大多数操作。

允许 TestBuild 插件 (DevMode)：启用此项以允许在生成步骤期间访问 TestBuild 插件。此插件可用于测试生成代码，并像普通插件一样拥有对当前生成版本的完全访问权限（包括挂载的 WIM 和 WIM 的注册表配置单元）。

重置 TestReq 注册表配置单元 (DevMode)：启用此项可在每次生成运行时重置/清除 TestReq 插件使用的注册表配置单元。这对于在已知/清除状态下测试注册表命令很有帮助。重置在每次启动插件要求步骤时进行。

重置 TestReq 文件夹 (DevMode)：启用此项可在每次生成运行时重置/清除 TestReq 插件使用的测试文件夹。这对于在已知/清除状态下测试文件/文件夹命令很有帮助。重置在每次启动插件要求步骤时进行。

运行测试插件后显示日志 (DevMode)：启用此项可在测试插件运行后自动显示其日志（适用于 TestReq 和 TestBuild）。这有助于在测试时快速查看结果，而无需每次都点击按钮查看日志。注意： 如果启用了 在编辑器中查看文本文件 选项，则此选项不适用。

检查要求时自动更新插件：启用此选项后，在为生成版本检查插件要求时，将自动更新已安装的插件。如果生成版本禁用了包含插件、生成版本中未包含任何已安装的插件或禁用了下载插件，则不会执行更新检查。此外，默认情况下，此检查每天仅执行一次。

插件

在列表中选择（勾选）要包含在生成版本中的插件。仅当启用了 在生成中包含插件 选项时，所选插件才会被包含。右键单击插件可使用更多选项（例如在列表中上移/下移等）。也可以使用拖放来排列插件顺序。插件将按照它们在列表中出现的顺序进行处理。

单个插件选项 / 所选插件的选项

允许开发者模式：启用此项以允许该插件使用开发者模式。如果禁用此项，即使启用了全局选项，该插件也会忽略开发者模式。

从安装的 WinRE 生成版本中排除：启用此项以从修改已安装 WinRE 的生成版本（UpdateWinRE、IFWWinRE）中排除该插件。此选项将覆盖插件的内部设置，允许您防止单个插件包含在这些生成类型中（例如，如果它们因 WIM 体积增大而导致生成无法成功完成）。

忽略警告：启用此项以忽略该插件的警告。如果启用，无论常规选项如何，该插件的错误和警告都将被忽略（警告仍会记录在日志中）。例如，如果不支持某个特定插件，您可以启用此选项以忽略警告，同时保持全局选项启用。

始终包含此插件：启用此项以始终在生成版本中包含此插件，即使禁用了 在生成中包含插件 常规选项。

打开文件夹 按钮将打开该插件的文件夹。

编辑插件 按钮将在编辑器中打开该插件（默认使用记事本）。

配置按钮打开插件的配置选项（如果没有可用选项，则该按钮将被禁用）。

创建插件

点击 创建插件 按钮即可访问此对话框，它提供了一种设置基本选项并创建新插件的简便方法。创建后，插件将添加到已安装列表中，并可根据需要进行编辑。

名称：输入插件的名称。

作者：输入插件作者/创建者的名称（例如个人姓名、公司名称等）。

插件文件：输入插件的文件名。默认情况下，它将保存在 Plugins 文件夹中。您也可以点击 浏览... 来选择子文件夹和文件名。

描述：输入插件的简短描述。

支持选项：选择插件将支持的生成模式、架构和生成类型。

注意： 如有必要，上述所有设置（以及更高级的设置）都可以在编辑插件文件时进行修改。

准备就绪后，点击创建按钮创建插件，或点击取消中止。

下载并安装插件

点击 下载插件（或 安装插件）按钮即可访问此对话框。如果启用了下载，将从 TeraByte 网站下载当前可用的插件列表。然后可以根据需要安装或更新插件。如果禁用了下载，您将只能安装已存在的插件（即之前下载的或程序附带的插件）。

更新已安装的插件：如果有更新版本可供安装，此选项将可用。当前安装的版本将被较新版本替换。

安装所选插件：选择仅安装所选插件（列表中勾选的插件）。如果选择了已安装的插件，它将被替换。

安装所有插件：选择安装所有可用插件。当前安装的插件将被替换。

注意： 下载并安装的插件与自定义/用户插件是分开的。如果您想修改其中一个插件，应将其复制到 Plugins 文件夹或子文件夹中，这样在更新时它就不会被替换。

如果插件有长描述或 ReadMe 文件，可以通过右键单击插件并选择所需操作来查看。

做出选择后，点击 安装插件（或 更新插件）按钮来安装（或更新）插件。