文本翻译

翻译转录（va_translate）

识别后自动翻译：内置 llama.cpp 与 Ollama 双引擎（默认 llama 路径）

版本：1.0.0

一、插件简介

------------------------------------------------------------------------

va_translate 是语音助手内置的「翻译转录」插件。识别得到的文本在

本地完成自动翻译，译文随原文一并展示、保存，实现"说完即译"。

处理链路为：

    语音识别完成 -> 文本后处理 -> 本地翻译（内置 llama / Ollama）-> 展示

翻译在本机完成，文本不出本地；内置 llama.cpp 千问模型为默认后端，

Ollama 可随时切换。

触发范围：作为宿主识别后处理的一环，对识别结果注入式自动翻译。

二、核心功能

------------------------------------------------------------------------

1. 识别后自动翻译

   - 识别结果完成后自动翻译，原文与译文一并展示；

   - 与「识别后自动翻译」总开关同步联动。

2. 双引擎可切换

   - 内置引擎：llama.cpp + 千问 qwen2.5-0.5b（默认路径）；

   - 外部引擎：Ollama（本地服务，可配置地址与 API Key）；

   - 默认使用 llama 路径，可在配置面板随时切到 Ollama。

3. 引擎行级配置

   - 每套引擎独立配置（启用 / 模型路径 / 端口 / API Key /

     目标语言 / 测试连接），切换不互相覆盖；

   - 目标语言可改，翻译按所选目标语言输出。

4. 连接自检

   - 引擎行内「测试连接」直接出结果与时间戳，失败原因可见。

5. 配置迁移

   - 首次加载自动迁移旧版本配置路径，行为无缝衔接。

三、引擎与技术实现

------------------------------------------------------------------------

  翻译后端     内置 llama.cpp（qwen2.5-0.5b-instruct，默认）/

               Ollama 本地服务（可选）

  默认路由     ActiveRowKey：默认 llama 路径；切换 Ollama 即改

               当前生效引擎行

  公共资源     `plugins/public/models/qwen2.5-0.5b-instruct-q4_k_m.gguf`

               + `plugins/public/llama/`（llama-server.exe、

               llama.dll、mtmd.dll），多插件共享同一份模型

  数据本地     llama 路径推理在本机完成，无网络请求（Ollama 仅

               访问本地配置的服务地址）

四、配置面板

------------------------------------------------------------------------

插件市场 -> va_translate -> 配置（每套引擎一行，提交/切换即生效）：

  llama 行       启用 / 模型路径 / 端口 / 测试结果

  Ollama 行      启用 / 服务地址 / 端口 / API Key / 测试结果

  目标语言       llama 行与 Ollama 行各自可配置目标语言

  连接自检       引擎行内「测试连接」+ 结果 / 时间戳回显

五、入口

------------------------------------------------------------------------

  语音指令        「打开翻译」「关闭翻译」

                  （manifest commands.voice，`plugin:va_translate:on/off`）

  插件市场        启停开关（启用后识别链路即注入翻译）

  热键            无

六、依赖与资源

------------------------------------------------------------------------

  模型            `plugins/public/models/qwen2.5-0.5b-instruct-q4_k_m.gguf`

                  （公共 models 目录，多插件共享）

  引擎库          `plugins/public/llama/`（llama-server.exe、

                  llama.dll、mtmd.dll）

  Ollama 模式    需本机已安装并运行 Ollama 服务（地址/端口可配）

  分发方式        插件包 zip（manifest + dll，模型走公共目录），

                  解压至 `plugins/` 重 启 即 加 载

七、系统要求

------------------------------------------------------------------------

  操作系统   Windows 10 x64 及以上

  内存       4GB 及以上（载入翻译模型时按需更高）

八、关于

------------------------------------------------------------------------

  所属软件   语音助手（VoiceAssistant）

  插件 ID    va_translate

  版本       1.0.0

  协议接口   plugin_sdk.h（api_version = 1）

  作者       研道人-江小东

  官网       https://3daoshan.com

  B 站主页   https://space.bilibili.com/3493128858241731

  邮箱       1719262421@qq.com

  版权信息   © 2026 研道人-江小东

  版权说明   本软件仅供学习交流使用。