Qwen TTS WebUI Installer 启动与使用☍

在 qwen-tts-webui 文件夹中可以看到不同的 PowerShell 脚本。如果是 Windows 平台，右键 PowerShell 脚本，选择使用 PowerShell 运行后即可运行。如果是 Linux / MacOS 平台，请打开终端并使用pwsh命令去运行。

基础操作☍

启动 Qwen TTS WebUI☍

运行 launch.ps1 脚本。

更新 Qwen TTS WebUI☍

运行 update.ps1 脚本，如果遇到更新 Qwen TTS WebUI 失败的情况可尝试重新运行 update.ps1 脚本。

设置 Qwen TTS WebUI 启动参数☍

要设置 Qwen TTS WebUI 的启动参数，可以在和 launch.ps1 脚本同级的目录创建一个launch_args.txt 文件，在文件内写上启动参数，运行 Qwen TTS WebUI 启动脚本时将自动读取该文件内的启动参数并应用。

--api

启用 Hotpatcher 补丁系统☍

运行 launch.ps1 时添加 -Hotpatcher 可启用 Hotpatcher 补丁系统：

./launch.ps1 -Hotpatcher

也可以在 launch.ps1 同级目录创建 enable_hotpatcher.txt 文件启用。启用后，脚本会将 --hotpatcher 和 --hotpatcher-config <路径> 传给 Qwen TTS WebUI 启动命令。

默认配置路径固定为 launch.ps1 同级目录下的 patcher_config.json。如果启用 Hotpatcher 且该文件不存在，launch.ps1 会自动导出默认配置。使用 -HotpatcherConfig <路径> 指定配置文件时，脚本只使用指定路径，不会自动创建配置文件。

如果需要指定 Hotpatcher runtime 通信端口，可使用 -HotpatcherPort <端口>，或在 launch.ps1 同级目录创建 hotpatcher_port.txt 并写入端口号。端口范围为 1 到 65535，命令行参数优先于 hotpatcher_port.txt。

环境管理☍

进入 Qwen TTS WebUI 所在的 Python 环境☍

如果需要使用 Python、Pip、Qwen TTS WebUI 的命令时，请勿将 Qwen TTS WebUI 的 python 文件夹添加到环境变量，这将会导致不良的后果产生。

正确的方法是运行 terminal.ps1 脚本，这将打开 PowerShell 并自动执行 activate.ps1，此时就进入了 Qwen TTS WebUI 所在的 Python。

或者是在 Qwen TTS WebUI 目录中打开 PowerShell，在 PowerShell 中运行下面的命令进入 Qwen TTS WebUI Env：

./activate.ps1

这样就进入 Qwen TTS WebUI 所在的 Python 环境，可以在这个环境中使用该环境的 Python 等命令。

管理 Qwen TTS WebUI 的版本☍

运行 version_manager.ps1 脚本。

查看 Git / Python 命令实际调用的路径☍

# 查看 Git 命令调用的路径
(Get-Command git).Source

# 查看 Python 命令调用的路径
(Get-Command python).Source

# 查看其他命令的实际调用路径也是同样的方法
# (Get-Command <command>).Source