文档导航
快速开始 安装运行 免费API获取 配置说明 使用方法 性能表现 故障排除 更多玩法 常见问题

使用文档

详细的使用指南，帮助您快速上手 VRChat LLM翻译器

快速开始

VRChat LLM翻译器是一个帮助你在 VRChat 中与外国朋友交流的工具。它可以将你输入的语言翻译成其他语言，并通过 OSC 发送到 VRChat。

核心功能
  • 智能LLM翻译：基于AI技术的高质量翻译
  • 多语言界面：支持中、英、日、韩四种语言
  • 自动发送控制：可选择自动或手动发送

双击运行

方式 1: 使用打包的 EXE 文件（推荐）

  1. 从下载页面获取最新版本的 VRChat LLM翻译器
  2. 将文件放在任意位置（例如桌面）
  3. 双击运行即可
首次运行时，应用程序会自动在以下位置创建必要的文件：
  • 配置文件: C:\Users\系统用户名\vrchat_text_LLM\config\
  • 日志文件: C:\Users\系统用户名\vrchat_text_LLM\logs\

免费 API 获取指南

为了帮助用户快速体验翻译功能，我们推荐以下目前能免费使用的 API 服务：

硅基流动

注册即送2000W Token

  • 官网: siliconflow.cn
  • API端点:
    复制端点
  • 获取密钥: 硅基流动
  • 注册奖励: 通过上方链接注册送2000W Token
  • 支持模型: 多个不同模型可选
注册即送，额度丰富，模型多样
火山方舟

参加协作奖励计划

  • 官网: volcengine.com
  • API端点:
    复制端点
  • 获取密钥: 火山方舟
  • 奖励: 每天每个模型 50W Token
  • 支持模型: 多个不同模型可选
参加奖励计划，每日免费额度丰富
专用翻译模型

Doubao-Seed-Translation(火山引擎)

配置信息：
  • 翻译端点:
    复制翻译端点
  • 模型类型: 选择"翻译模型"
  • 支持语言: 28种语言互译
使用说明：
  • 在软件中选择"翻译模型"类型
  • 设置源语言（可留空自动检测）
  • 设置目标语言（必填）
  • 专为翻译优化，质量更高

配置说明

1. LLM API 配置

在"设置"标签页中配置你的 LLM API：

  • API 地址: 复制上述推荐服务的API端点
  • API 密钥: 从对应平台获取的密钥
  • 模型: 填入使用的模型名称
  • 最大Token数: 控制响应长度（建议1024-2048）
  • 温度: 控制输出的随机性（建议0.3-0.7）

2. OSC 设置

  • OSC IP: 默认为 127.0.0.1（本地）
  • OSC 端口: 默认为 9000
  • 点击"连接 OSC"按钮建立连接

3. 输入设置

  • 自动发送时间: 设置倒计时秒数（默认3秒，语音模式直接发送）
  • 自动发送开关: 控制是否自动发送信息

4. 提示词管理

在"提示词管理"标签页中：

  • 可以创建、编辑、删除自定义提示词
  • 在主界面选择要使用的提示词
  • 提示词使用 {text} 占位符（可不加）

5. 翻译模型说明

  • 新建配置后将模型类型修改为翻译模型。
  • 输入目标语言代码保存，回到主界面选择它。
  • 仅支持 Doubao-Seed-Translation 模型
  • 豆包官网：https://www.volcengine.com/product/doubao

使用方法

基本使用流程
  1. 启动应用程序
  2. 在设置中配置LLM API
  3. 连接OSC
  4. 在输入框中输入中文
  5. 等待自动发送或点击"立即发送"
高级功能
  • 自定义提示词

界面说明

  • 主界面: 文本输入、提示词选择、发送控制
  • 设置页面: OSC配置、LLM配置、语言设置
  • 提示词管理: 创建和管理自定义提示词
  • 输出历史: 查看翻译历史和错误信息

更多玩法

VRChat LLM翻译器不仅仅是翻译工具，通过强大的LLM处理能力，还能实现各种有趣的文本风格转换。

风格转换功能

通过自定义提示词，你可以让AI将你的话转换成各种有趣的说话风格，为聊天增添更多乐趣。

风格示例：
猫娘语气

将普通对话转换成可爱的猫娘说话方式

复制示例提示词：
复制提示词
转换示例：
输入：晚安 睡觉了
输出：要睡觉了喵~好困呢，晚安喵~
输入：我喜欢你
输出：最喜欢你啦喵~好想一直和你贴贴喵~
输入：早上好
输出：早上好呀喵~今天也是元气满满的一天呢喵~
如何使用风格转换
  1. 创建自定义提示词：在"提示词管理"标签页中创建新的提示词
  2. 设计转换指令：在提示词内容中描述你想要的风格转换效果
  3. 使用占位符：在提示词中使用 {text} 作为输入文本的占位符
  4. 测试效果：在主界面选择你的自定义提示词并测试效果
  5. 分享乐趣：在VRChat中使用转换后的有趣文本与朋友互动
创意提示

你可以创建任何你想要的风格：正式商务、可爱萝莉、霸道总裁、文艺青年等等。发挥创意，让AI帮你打造独特的说话风格！

社交互动新体验

通过风格转换功能，你可以：

  • 角色扮演：快速切换不同角色的说话方式
  • 增加趣味：让日常对话变得更加有趣
  • 语言学习：体验不同的表达方式和语言风格
  • 创意表达：用独特的方式表达想法
  • 社交破冰：有趣的说话方式更容易交朋友
  • 个性展示：展现你的创意和幽默感

故障排除

  • 检查是否被杀毒软件拦截
  • 尝试以管理员身份运行
  • 确保系统为Windows 10/11 64位
  • 检查是否有足够的磁盘空间

  • 删除 C:\Users\用户名\vrchat_text_LLM\config\ 目录
  • 重新启动程序会自动创建默认配置
  • 检查配置文件是否有写入权限

  • 确保VRChat已启动并启用OSC
  • 检查IP地址和端口设置
  • 确认防火墙没有阻止连接
  • 尝试重启VRChat和程序

  • 检查API密钥是否正确
  • 确认API地址格式正确
  • 检查网络连接
  • 验证API账户余额
  • 尝试使用测试连接功能

常见问题

Q: 首次运行时需要做什么？

A: 只需双击运行EXE文件，应用程序会自动创建所有必要的目录和配置文件。

Q: 配置文件在哪里？

A: 配置文件存储在 C:\Users\系统用户名\vrchat_text_LLM\config\ 目录中。

Q: 可以把EXE文件放在任意位置吗？

A: 可以！EXE文件可以放在任意位置，配置和日志始终存储在用户目录中。

Q: 如何更改语言？

A: 在"设置"标签页的"语言设置"中选择语言，然后重启应用程序。

性能表现

资源使用情况(仅限参考)

使用场景 内存占用 CPU占用 说明
空闲状态 45 MB 1.0% 程序启动后未进行操作
正常使用 55 MB 3.0% 频繁的聊天翻译使用
重度使用 70 MB 5.0% 高频使用（不含语音识别）
语音识别模式 670 MB 6% 启用语音识别功能(含软件)
性能特点
  • 内存效率: 比同类翻译工具节省60-70%内存（不含语音识别）
  • CPU效率: 间歇性使用，不会持续占用系统资源
语音识别功能说明

语音识别功能基于浏览器内核实现，启用时会显著增加内存使用：

  • 额外内存需求: 约600MB（浏览器内核开销）
  • 经过测试能正常使用的浏览器: EDGE、Chrome
  • 按需使用: 可根据需要开启或关闭语音功能，或使用输入法进行语音输入

文件位置

类型 位置 说明
程序文件 用户指定位置 VRChat_LLM_Converter.exe
配置文件 C:\Users\用户名\vrchat_text_LLM\config\ settings.json, prompts.json
日志文件 C:\Users\用户名\vrchat_text_LLM\logs\ app_YYYYMMDD_HHMMSS.log