DeerFlow多语言支持：中文界面切换与自定义语言包从 0 到 1
项目地址: https://gitcode.com/GitHub_Trending/de/deer-flow 你用中文提研究问题，界面和文档却全是英文？DeerFlow 内置了多语言支持：界面可以在简体中文和英文之间一键切换，应用内文档同时提供中英文两套版本，首次访问还会自动识别浏览器语言。下面这条路径很短，跟着做几步就能把界面切成中文。
🌐 多语言支持能做什么
- 界面与设置：菜单、按钮、提示信息共两套语言包，
zh-CN（简体中文）和en-US（英文），在设置页随时切换。 - 应用内文档：中文文档在
frontend/src/content/zh/，英文在frontend/src/content/en/，两套内容并行维护。 - 内容理解：query、指令用你习惯的语言写就行，DeerFlow 不强制某种语言。
- 暂时做不到的：官方注册的语言只有中英两种，默认是英文；多语言标题生成等能力仍在完善中，尚未完全就绪。
整套多语言配置的入口在 frontend/src/core/i18n/ 目录，想看"去哪改"可以从这里开始。
三步切换中文界面
第 1 步：克隆仓库并启动。如果还没装，先执行：
git clone https://gitcode.com/GitHub_Trending/de/deer-flow
cd deer-flow
make docker-init # 首次运行拉取沙箱镜像
make docker-start
第 2 步：进入设置页，点击"设置" → "外观" → "语言"，在下拉框选择"中文"，界面立即刷新为简体中文，无需重启。
第 3 步：验证。随便翻几个页面确认菜单和提示已汉化。如果你的浏览器语言就是 zh-CN，其实第 2 步都可以省——DeerFlow 首次访问会用 navigator.language 自动检测并记住选择。
新增一种语言要改哪几个文件
想给语言下拉框加一门新语言（比如法语），实际操作中需要动这几个位置：
frontend/src/core/i18n/locales/
├── en-US.ts # 现成英文语言包
├── zh-CN.ts # 现成中文语言包，可复制为模板
└── types.ts # Translations 类型，定义所有需翻译的字段
locales/目录下新语言包：复制zh-CN.ts改字段值即可，结构别动。translations.ts与locale.ts：注册新的加载器，并把语言 ID 加进SUPPORTED_LOCALES、按需调整DEFAULT_LOCALE。- contracts/ui_locales.v1.json：语言清单契约，界面可选列表以它为准，记得同步。
- 文档侧：
frontend/src/content/下新增对应语言目录，参考现成的 frontend/src/content/zh/。
常见坑：切了语言为什么不生效
语言选择存在名为 locale 的 cookie 里（有效期一年），改了不生效时优先清掉这个 cookie 或换无痕窗口。另外注意：只在语言包里加了翻译、没在 SUPPORTED_LOCALES 注册的语言，下拉框里根本不会出现，也不会被加载。
💡 多语言研究实用建议
- 同一 query 用中英文各提交一次，对比两路检索结果，常常能挖到单一语言漏掉的信息。
- 遇到生僻术语，先让 DeerFlow 翻译成目标语言再深入检索，命中率更高。
- 长期在某类语料里做研究，就把浏览器语言设为对应语言，首次访问会自动匹配，省得每次手动切。
- 发现翻译不通顺，或想排期一门新语言？直接去 issue 区反馈，多语言标题生成功能也欢迎一起验证。
收尾
DeerFlow 的多语言支持让不同语言背景的人都能用自己的语言提问和读报告。去把界面切成中文试试，想要的新语言也值得去 issue 区留个言。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
