#5907 怎样将mac中的pyvideotrans升级到最新版本

macOS 下 pyVideoTrans 源码部署的用户请执行以下步骤升级：

1. 打开终端，进入 pyVideoTrans 源码目录（即 sp.py 所在目录）。

2. 拉取最新代码：

   git pull

   若当初不是通过 git 克隆下载，而是直接下载的压缩包，则需要重新下载最新版源码并解压覆盖。

3. 更新 Python 依赖包：

   uv sync

   如需包含全部扩展（如 Whisper.net、WebUI），执行：

   uv sync --all-extras

4. 启动软件：

   uv run sp.py

如果遇到依赖安装失败，可尝试使用国内镜像加速：

uv sync --index https://mirrors.aliyun.com/pypi/simple/

请查阅相关文档：

• MacOS/Linux 安装部署

若当初不是通过 git 克隆下载，而是直接下载的压缩包，则需要重新下载最新版源码并解压覆盖。如果是这种方式，接下来如何操作

针对通过压缩包方式部署的 macOS 版 pyVideoTrans，升级步骤如下：

1. 备份配置文件（可选但推荐）：将旧版 pyvideotrans 目录内的 videotrans/ 文件夹下的 params.json、cfg.json、codec.json、ass.json 复制到安全位置，以便覆盖后恢复设置。
2. 下载最新源码：访问 GitHub 发布页 或直接克隆压缩包，下载最新版本（如 https://github.com/jianchang512/pyvideotrans/archive/refs/heads/main.zip）。
3. 替换文件：将下载的压缩包解压，把解压后的 pyvideotrans-main 文件夹内的所有内容（覆盖旧版目录中所有文件）。注意：不要将整个文件夹直接复制，而是将内部文件合并覆盖到旧版 pyvideotrans 根目录。
4. 还原配置：将之前备份的 JSON 文件放回 videotrans/ 目录。

5. 更新依赖：在终端进入 pyvideotrans 目录执行：

   uv sync

   如需包含全部扩展，执行：

   uv sync --all-extras

6. 启动软件：

   uv run sp.py

完成上述步骤后，软件即升级至最新版本。如果遇到依赖安装失败，可尝试使用国内镜像加速：

uv sync --index https://mirrors.aliyun.com/pypi/simple/

在文件夹中，没找到codec.json、ass.json两个文件

codec.json（硬解码缓存）和 ass.json（硬字幕样式缓存）是在使用相关功能后自动生成的，如果没有使用过对应功能则不会存在，这属于正常现象。升级时无需备份这两个文件，仅需备份以下关键配置即可：- params.json（API 密钥与偏好设置）- cfg.json（高级选项与系统设置）若这两个文件也不存在，则直接跳过备份步骤。覆盖旧版文件后，运行软件时会自动重新生成所需文件。请放心按之前步骤操作。

Last login: Sat Jul 18 19:49:28 on ttys001
a1-6@MacBook-Pro-2 ~ % uv sync --all-extras
zsh: command not found: uv
a1-6@MacBook-Pro-2 ~ %

系统未安装 uv 包管理器，请先执行以下命令安装：`bash
curl -LsSf https://astral.sh/uv/install.sh | sh

安装完成后，关闭并重新打开终端，再次进入 pyVideoTrans 目录执行：```bash
uv sync --all-extras

若在国内安装失败，可尝试使用国内镜像安装：

curl -LsSf https://mirrors.aliyun.com/uv/install.sh | sh

安装成功后，继续后续升级步骤。