企业官网建设流程全解析

MiroFish 多语言 4 步切换：界面与智能体对话本地化完整指南

【免费下载链接】MiroFishA Simple and Universal Swarm Intelligence Engine, Predicting Anything. 简洁通用的群体智能引擎，预测万物项目地址: https://gitcode.com/GitHub_Trending/mi/MiroFish

界面全是英文，智能体回复还对不上

你八成也遇到过 MiroFish 这个情况：界面按钮是英文，你输入中文提问，智能体吐出来的报告却半中半英，读起来要边看边翻译。好消息是，MiroFish 多语言其实就两层——界面文案层和智能体对话层，而且两层读的是同一份语言配置源，理清楚一次就通了。

3 步切换界面语言

1. 启动服务后，在页面右上角找到语言按钮，它来自 LanguageSwitcher.vue 组件，每个主页面都有。
2. 点开下拉菜单，从中文、English、Español、Français、Português、Русский、Deutsch 里选一个。
3. 选择立即生效，并写入浏览器 localStorage，下次打开站点会自动加载该语言，不用再设。

翻译文件在哪：locale 文件一份管前后端

你会发现，界面文案和智能体的语言指令其实放在同一个目录里。locales/zh.json 和 en.json 就是 locale 文件（界面文案的翻译源文件），按 common 这类模块 key 组织；locales/languages.json 是语言注册表，每种语言登记两样东西：界面显示名，和一句给 LLM 的指令 llmInstruction，例如"请使用中文回答"。

前端 frontend/src/i18n/index.js 启动时会扫描 locales 目录自动注册语言包；后端 backend/app/utils/locale.py 也扫描同一目录加载翻译。所以新增一种语言，就是加一个 JSON 文件、再在注册表里补一条记录，前后端自动识别，不用改其他代码。

智能体回复用哪种语言，靠的不是语言识别模型：前端把当前语言写进每个请求的 Accept-Language 请求头，后端 get_locale() 读取它，各服务（报告、实体抽取等）在调用 LLM 前把对应的 llmInstruction 追加进系统提示词，生成的报告与回复就会按你选的语言输出。

排障：切完语言为什么还有文案没变

现象：切到英文后页面大部分变英文，个别按钮还是中文。原因：英文包缺了对应 key，vue-i18n 缺失时回退到中文 fallbackLocale。改哪里：在 locales/zh.json 里找到对应 key，照着补进 locales/en.json；后端 t() 函数同样回退中文，后端文案没变时按同样方式补 key 即可。

另一种常见情况是界面显示英文、智能体却回复中文，通常是请求没带 Accept-Language 头、或头里的值不在注册表中，get_locale() 直接按中文处理，检查 frontend/src/api/index.js 里的请求头赋值逻辑即可。

接下来可以做什么

先把界面切到英文完整跑一遍流程，观察实体抽取、模拟配置、报告各环节的语言表现；发现哪句措辞别扭，直接改 locale 文件里的文案。等以后需要注册表之外的语言，新增一个 JSON 文件就够了。

【免费下载链接】MiroFishA Simple and Universal Swarm Intelligence Engine, Predicting Anything. 简洁通用的群体智能引擎，预测万物项目地址: https://gitcode.com/GitHub_Trending/mi/MiroFish