混元球 - 基于腾讯开源翻译模型混元的桌面翻译引擎 支持接入沉浸式翻译

[Hansah]

混元球 v1.02 （本地翻译 API + WebUI ）

第一次用 Github 发东西，请多多指教。

这是一个在 Windows 10/11 上本地运行的翻译服务（其他平台还在搓制中）：

• 后端：llama-server（ OpenAI 兼容 API ）
• 前端：内置 WebUI （浏览器访问）
• 模型：腾讯 Hunyuan-MT-1.5-1.8B GGUF （纯 CPU 可跑）

适用场景：

• 给「沉浸式翻译」提供本地翻译 API 用于翻译网页全文、油管字幕等
• 提供本地快速翻译 Web 界面
• 不占显存，不依赖显卡（ CPU 模式）

Github： https://github.com/siknet/HunyuanBall

下载地址（已经打包了 Q4 模型，开箱即用）： https://github.com/HunyuanBall/releases/download/v1.02/HYBall_Windows_x64_v1.0.2.zip

免梯子加速下载地址（感谢 Cloudflare ）：https://x.cqforest.com/gh/siknet/HunyuanBall/releases/download/v1.02/HYBall_Windows_x64_v1.0.2.zip

关于腾讯混元翻译模型：Hunyuan-MT-1.5-1.8B 模型

Tencent-HY-MT1.5-1.8B 支持 33 个语种互译以及 5 种民汉/方言，除了中文、英语、日语等常见语种，也包含捷克语、马拉地语、爱沙尼亚语、冰岛语等小语种。HY-MT1.5-1.8B 主要面向手机等消费级设备场景，经过量化，支持端侧直接部署和离线实时翻译，仅需 1GB 内存即可流畅运行，并且在参数量极小的前提下，效果超过了大部分商用翻译 API 。

在常用的中外互译和英外互译测试集 Flores200 、WMT25 以及民汉语言的测试集中，Tencent-HY-MT1.5-1.8B 全面超越中等尺寸开源模型和主流商用翻译 API ，达到 Gemini-3.0-Pro 这种超大尺寸闭源模型的 90 分位水平。在 WMT25 和民汉翻译测试集上，其效果仅略微差于 Gemini-3.0-Pro ，远超其他模型。

---

运行环境

• Windows 10 / Windows 11 （ 64 位）
• 首次运行建议安装：Microsoft Visual C++ Redistributable 2015–2022 （ x64 ）
  官方下载： https://aka.ms/vs/17/release/vc_redist.x64.exe Github Repo 里也有提供下载： https://github.com/siknet/HunyuanBall/blob/main/VC_redist.x64.exe

---

1. 把模型文件（.gguf）放到 models/ 目录（ 模型下载地址： https://huggingface.co/tencent/HY-MT1.5-1.8B-GGUF/blob/main/HY-MT1.5-1.8B-Q6_K.gguf ，可选 Q4/Q6/Q8 ）
   例如：models/HY-MT1.5-1.8B-Q4_K_M.gguf

2. 双击运行 HYBall.exe
   程序会在右下角托盘出现图标。

3. 如果开启了 WebUI ，本地浏览器访问（默认）：

   • 自带翻译界面：程序文件夹/webui/index.html
   • 标准 OpenAI 格式 API 地址：http://127.0.0.1:58088/

🛠️ 接入沉浸式翻译 (Immersive Translate)

请按照以下步骤，将本地服务接入沉浸式翻译插件：

1. 开启自定义服务

打开沉浸式翻译插件的 设置 -> 点击左侧边栏的 “翻译服务” -> 找到底部 “添加自定义翻译服务”选择 “OpenAI”。

2. 配置 OpenAI 接口

在弹出菜单中选择 **"OpenAI"**，并参照下方表格填写参数：

配置项目	填写内容
自定义名称	混元球 (HunyuanBall)
API KEY	hunyuan
自定义接口地址	http://127.0.0.1:58088/v1/chat/completions
每秒最大请求数	3 (若配置较高可调整至 4-8)
每次请求最大长度	600 (若配置较高可调整至 800-1200)
每次请求最大段落	3 (若配置较高可调整至 5-8)

• 如果你修改了程序的默认端口，请确保 接口地址 中的端口号同步更新。
• 其他选项建议保持默认状态，以获得最稳定的翻译效果。

---

如果配置后无法正常翻译，请检查：

1. 本地服务程序是否已启动并正常运行。
2. 之前的 Visual C++ 运行库 是否已按要求安装完成（否则服务可能无法加载）。
3. 端口 58088 是否被其他程序占用。