zed-globalization

环境要求

• 可访问 GitHub Releases 的网络环境
• macOS / Windows / Linux，且与所下载包的架构（x86_64、aarch64/ARM64、Universal）匹配
• macOS 使用 Homebrew，或 Windows 使用 Scoop（可选，也可手动下载 DMG/ZIP）
• 如需自行运行翻译流水线：Python 环境与 pip
• 如需自行运行翻译流水线：OpenAI 兼容 API 的密钥

安装与启动步骤

1. 1按平台下载安装包

   打开 Releases 最新版页面，按操作系统与 CPU 架构下载对应的 dmg、zip、deb、rpm 或 tar.gz。

2. 2macOS 用 Homebrew 安装

   先添加 x6nux/zedg tap，再以 cask 安装稳定版；Homebrew 会自动按架构选包。

   brew tap x6nux/zedg
   brew install --cask zedg

   复制

3. 3Windows 用 Scoop 安装

   先添加 zedg bucket，再安装 zedg 包；ARM64 用户也可解压 zip 后直接运行 ZedG.exe。

   scoop bucket add zedg https://github.com/x6nux/scoop-zedg
   scoop install zedg

   复制

4. 4Linux 安装 deb/rpm

   在下载目录执行：deb 系用 dpkg 安装，rpm 系用 dnf 安装；tar.gz 则手动解压到 /usr/local。

   sudo dpkg -i *.deb
   sudo dnf install *.rpm

   复制

5. 5安装本地翻译工具

   如需自行运行翻译与构建流程，进入项目源码目录后执行 pip 安装（仅替换功能的基础模式）。

   pip install .

   复制

6. 6配置 AI 接口

   本地流水线需要 OpenAI 兼容 API：设置密钥、可选地址、模型与并发数，CLI 参数优先于环境变量。

   export AI_API_KEY=sk-xxxxxxxx
   export AI_BASE_URL=https://api.openai.com/v1
   export AI_MODEL=gpt-4o-mini
   export AI_CONCURRENCY=5

   复制

关键配置

如何确认成功

启动 ZedG 后，编辑器菜单与界面文案显示为简体中文，即表示安装并汉化成功。

常见问题

注意事项

• macOS 预览版（Pre-release）需要执行 brew tap x6nux，与稳定版 tap 不同，勿混用。
• Linux tar.gz 手动安装到 /usr/local，卸载时需删除 /usr/local/bin/zedg、/usr/local/lib/zedg 等目录并执行 sudo ldconfig。
• 所有命令请在对应下载/源码目录下执行，通配符 *.deb、*.rpm 只匹配该目录中的安装包。