Final Fantasy XIV 国际服实时翻译助手。 FFTrans 是 Windows Electron 应用：读取游戏对话与过场字幕，调用所选翻译引擎，并通过悬浮窗显示；也可选配 Dalamud 插件，把原文与译文写回普通 NPC Talk 对话框。
Warning
读取游戏内存需要管理员权限。XIVLauncher、Dalamud 和其它第三方工具不符合 FFXIV 官方服务条款，可能带来账号风险；请自行判断并承担使用风险。
| 路径 | 作用 | 真实实现 |
|---|---|---|
| 游戏文本 | 自动捕获对话与过场字幕 | src/module/system/sharlayan-module.js |
| 原生双语 Talk（可选） | Node 与 Dalamud 通过本地命名管道通信 | src/module/system/dalamud-bridge.js、dalamud/FFTransDalamud/ |
| OCR | 框选屏幕区域后识别 / 翻译 | src/module/ipc/capture-ipc.js |
| 翻译 | NVIDIA、OpenRouter、Gemini、GPT、Kimi、OpenAI-compatible 自定义端点及传统翻译器 | src/module/translator/ |
| 朗读 | ElevenLabs、Fish Audio、MiMo、Speechify | src/module/translator/、src/module/system/tts-* |
| 模型对比 | 在设置中并排查看已配置引擎的译文和延迟 | src/html/config.js |
中文术语修正与自定义修正位于 src/data/text/ 和 src/module/fix/。Cloudflare Benchmark Lab 是仓库中的独立评测面，源码见 cloudflare-benchmark/。
- 从 Releases 下载 Windows 安装包。
- 先启动 FFXIV 并进入游戏，再以管理员身份启动 FFTrans。
- 在“设置 → 翻译”选择一个引擎；需要密钥的引擎请填入自己的 API Key。
- 保存后用设置中的测试入口验证连接，再回到游戏查看字幕。
需要 Windows、Node.js 与 npm。
git clone https://github.com/raydocs/fftrans.git
cd fftrans
npm install
npm start构建安装包：
npm run dist
# 输出目录：build/FFTrans 仍保管模型、API Key、词典和缓存；插件只处理当前可见原文与本地桥接数据，不获取翻译密钥。
powershell.exe -NoProfile -ExecutionPolicy Bypass -File scripts/build-dalamud.ps1
# 加 -Install 可复制到 XIVLauncher 开发插件目录当前边界与安装方法见 dalamud/FFTransDalamud/README.md。
npm run check:syntax
npm run lint
npm testDalamud 路径需要 Windows PowerShell / .NET 环境：
npm run test:dalamud
npm run test:all- 没有字幕：确认游戏已进入、FFTrans 以管理员身份运行；再使用“设置 → 系统”的字幕读取器修复入口。
- 翻译请求失败：先在所选引擎区域测试连接，检查 Key、模型名、网络与代理；可配置备用引擎。
- OCR 不准：提高截取区域文字尺寸 / 对比度，并在本地 Tesseract、Google Vision 或已配置的 AI 视觉之间切换。
- TTS 无声：先用当前引擎的试听验证授权；朗读失败不应阻断字幕显示。
API Key、refresh token 和 bearer token 都是凭据。不要贴进 issue、截图、日志或聊天记录；仓库中的配置 UI 会把凭据交给本地应用使用，但凭据生命周期仍由对应服务决定。
基于 winw1010/tataru-assistant，并使用 Electron、Sharlayan、Tesseract.js、Sharp 等组件。完整条款见 MIT License。