从 PyPI 安装

pipx install PyProxySwitch
# 或安装到当前 Python 环境
python -m pip install PyProxySwitch

安装后运行 pyproxyswitch 启动图形界面。目前没有无头 CLI。

从 Git 仓库安装

git clone https://github.com/kder/PyProxySwitch.git
cd PyProxySwitch
python -m venv .venv
# Windows PowerShell
.venv\Scripts\Activate.ps1
python -m pip install -e .
pyproxyswitch

开发时可将安装命令改为 python -m pip install -e ".[dev]"。直接运行仓库中的 PyProxySwitch.py 不是受支持的启动方式。

正式发布资产

不使用 Git 时,请从 Releases 下载 Windows 便携 zip、wheel 或 sdist,或者直接使用 PyPI。GitHub 自动生成的 “Source code” 压缩包不包含完整 Git 版本元数据,不应当作免安装便携版使用。

验证安装

python -m pyproxyswitch --version
# 预期输出:PyProxySwitch 4.0.5

旧网站提供的 3.5.x 及更早安装包依赖已经淘汰的第三方代理后端,不代表当前架构。新部署请使用 4.0.5 或更高版本。

升级

升级代码后重新执行安装命令。4.0.1 的用户配置位于操作系统用户目录,升级安装不会写入或覆盖已有 PPS.confproxy.txt;仍建议在重要变更前自行备份。