首页/新闻资讯/正文详情

如何为 Better DeepSeek 贡献新语言:轻量级 i18n 本地化系统完整指南

发布时间:2026/11/21 3:10:47 来源:云帆数科 栏目:资讯中心
如何为 Better DeepSeek 贡献新语言:轻量级 i18n 本地化系统完整指南
【免费下载链接】better-deepseekA powerful browser extension that supercharges DeepSeek Chat with custom tooling, persistent memory, and seamless project scaffolding. Generate and download files, run Python in-browser, create PowerPoint and Excel documents, build multi-file projects as ZIP archives, and manage custom skills and characters.项目地址https://gitcode.com/gh_mirrors/be/better-deepseek点击查看免费下载Better DeepSeek是一款为 DeepSeek Chat 注入超能力的浏览器扩展内置了一套轻量级 i18n 本地化系统所有界面文案存放在src/locales/下的 JSON 文件中组件通过一个t()函数按键路径取词缺失翻译自动回退英文。如果你想为它贡献新语言德语、日语、韩语……只需要翻译一个 JSON 文件——不需要写任何框架代码。本文将带你从零走通新增语言的完整流程。一、i18n 系统是如何工作的30 秒读懂核心设计Better DeepSeek 没有引入任何重型国际化库整个系统只由两部分构成组成位置作用语言数据src/locales/每个语言一个 JSON 文件en.json、zh-cn.json、tr.json、ru.json、fa.json管理器src/lib/i18n.svelte.js基于 Svelte 5 响应式状态的I18nManager对外导出t()函数t()的取词逻辑见 i18n.svelte.js 中的t(path, vars)点路径解析t(settings.save)会逐层走进 JSON 的messages.settings.save英文回退当前语言缺这个 key 时自动去第一个语言en取值保底兜底哪里都没有就显示 key 路径本身保证界面永不空白模板变量插值值里的{{version}}、{{count}}、{{date}}等占位符会在运行时替换成动态内容。语言文件在构建时被自动收集import.meta.glob(../locales/*.json)见 i18n.svelte.js——这意味着你只需在src/locales/下放好新文件它就会自动出现在设置面板的语言下拉框和自动检测逻辑中无需改动任何注册代码。二、新增语言完整流程6 步贡献指南1. 环境准备克隆仓库并安装依赖git clone https://gitcode.com/gh_mirrors/be/better-deepseek cd better-deepseek npm install2. 创建语言文件把 src/locales/en.json 复制为src/locales/{code}.json其中{code}使用 ISO 639-1 语言代码如de、fr、ja。注意带地区变体的写法例如简体中文是zh-cn参见现成的 src/locales/zh-cn.json。文件顶层结构保持两段式{ updatedAt: 2026-05-20T00:00:00Z, messages: { common: { save: Speichern, cancel: Abbrechen } } }其中updatedAt请填当天日期ISO 8601 格式它是远程更新机制判断新旧版本的关键字段别忘改。3. 翻译规则只翻值不翻键这是整个贡献流程中最重要的一条⚠️键名keys永远不翻译messages内的嵌套结构必须与en.json完全一致模板变量如{{version}}连同花括号原样保留但可以在句子里调整位置以符合本语言语序——例如 en.json 中version: v{{version}}部分值包含strong等行内 HTML界面用{html ...}渲染必须原样保留复数不用复杂规则而是拆成不同 key如filesUploaded与filesUploadedShort翻译时按各自 key 处理即可。以简体中文文件为例common区块的翻译对照如下zh-cn.jsonKeyenzh-cncommon.saveSave保存common.cancelCancel取消common.workingWorking...处理中…4. 在语言文件中注册语言名称所有语言文件都有messages.language区块里面存每种语言的本族名。你在每个语言文件里都要为新语言加一行例如在en.json中见 en.jsonlanguage: { en: English, tr: Türkçe, de: Deutsch }而新语言文件de.json里则用德语写其他语言的名字en: Englisch。这一步完成后新语言才会显示在设置面板的下拉选择器中渲染逻辑见 SettingsPanel.svelte使用i18n.getNativeName(code)展示本族名。5. 构建并测试npm run build在浏览器中加载dist-chrome目录下的未打包扩展打开设置面板的语言区域切换到你的新语言。所有走了t()的界面字符串都应显示为你的翻译。6. 运行自动校验提交翻译提交前务必运行内置的本地化校验脚本npm run check-locales该脚本scripts/check-locales.js会递归对比所有语言文件与基准文件en.json输出彩色报告Missing Keys红色en.json有而你文件里没有的键——必须补译Extra Keys青色你文件里有但en.json已删除的过时键——可以安全清理。全部通过后提交 PR包含你的新语言文件 更新后的src/locales/en.json。如果不熟悉 Git/PR也可以把翻译好的 JSON 文件附在 Issue 中并注明语言名称维护者会代为处理。三、翻译时最容易踩的 4 个坑结合 LOCALIZATION.md 官方指南整理成速查表常见错误正确做法翻译了键名save改成了保存只改值key 是代码定位翻译的标识符漏掉模板变量{{version}}被删变量连同花括号原样保留可调整位置丢掉了值里的 HTML 标签strong等标签必须保留界面依赖它们渲染格式漏改updatedAt日期每次修改都更新为当天否则远程更新不会拉取到你的翻译另外注意并非所有字符串都需要翻译——直接发给 AI 模型的内容如自动指令是刻意保持英文的遇到这类 key 保留原样即可。四、远程语言更新翻译合并后用户秒级生效Better DeepSeek 最贴心的设计之一翻译更新不需要用户升级扩展版本。机制如下扩展启动时以及用户在设置面板点击Check for Language Updates按钮时SettingsPanel.svelte 中checkLanguageUpdates()会向后台发送BDS_UPDATE_LANGUAGES消息后台会拉取仓库main分支上最新的语言文件后台 src/background/index.js 中的handleLanguageUpdate()逐个对比远程与内置文件的updatedAt时间戳远程更新才替换并写入chrome.storage.local持久化重启浏览器也不丢失前端启动时通过i18n.loadUpdatedLocales()把更新热加载进内存storage.js设置面板里的Reset to Factory Languages按钮可一键还原为内置翻译调用 i18n.svelte.js 的resetLocales()。所以对译者来说PR 一旦合并进main用户点一下检查语言更新就能用上你的新翻译——这就是为什么updatedAt字段如此关键。五、语言是怎么被选中的同步模式与手动模式了解用户端的行为有助于你理解自己翻译的展示效果。设置面板中的Sync extension language with browsersettings.syncLocale开关控制两种模式自动同步默认忽略手动选择每次页面加载按优先级自动检测——DeepSeek 的NEXT_LOCALEcookie跟随 DeepSeek 网页端的语言设置浏览器的navigator.language回退到第一个可用语言English。手动模式关闭同步后下拉框中选中的语言会持久化到chrome.storage.local之后每次加载都沿用。自动检测逻辑运行在 i18n.svelte.js 的init()中扩展启动时触发其他标签页设置变更时也会同步。你的语言文件放进src/locales/后自动检测与手动选择器都会自动包含它无需额外适配。六、贡献前自检清单 ✅提交 PR 前逐条确认文件名使用正确的 ISO 639-1 代码位于 src/locales/updatedAt已更新为当天日期结构、键名与 src/locales/en.json 完全一致模板变量{{...}}与 HTML 标签全部保留所有语言文件的messages.language都注册了新语言的本族名npm run check-locales通过无 Missing Keys 完整文档参考LOCALIZATION.md。 语言文件位置src/locales/当前收录 en、zh-cn、tr、ru、fa 共 5 种语言单文件约 1500 行。 校验工具源码scripts/check-locales.js i18n 核心实现src/lib/i18n.svelte.js翻译一个 JSON 文件就能让全世界使用者在自己的语言里打开 Better DeepSeek。上手门槛极低欢迎贡献你的第一种语言赞分享【免费下载链接】better-deepseekA powerful browser extension that supercharges DeepSeek Chat with custom tooling, persistent memory, and seamless project scaffolding. Generate and download files, run Python in-browser, create PowerPoint and Excel documents, build multi-file projects as ZIP archives, and manage custom skills and characters.项目地址https://gitcode.com/gh_mirrors/be/better-deepseek点击查看免费下载相关推荐DiffRhythm技术探索基于潜在扩散模型的端到端全长歌曲生成实践指南DiffRhythm技术探索基于潜在扩散模型的端到端全长歌曲生成实践指南 技术架构解析 DiffRhythm中文名谛韵是一款基于潜在扩散模型Laten人工智能深度学习媒体生成音乐生成音频模型推理服务预训练专业虚拟化管理指南使用virt-manager高效掌控KVM、Xen和LXC虚拟机专业虚拟化管理指南使用virt manager高效掌控KVM、Xen和LXC虚拟机 virt manager是一款基于libvirt的图形化虚拟化管理工具为5分钟掌握B站视频下载bilidown终极使用指南5分钟掌握B站视频下载bilidown终极使用指南 还在为无法离线观看B站优质内容而烦恼吗bilidown作为一款专业的哔哩哔哩视频下载工具让你轻松保存任桌面应用后端上一篇为什么Passkey登录必须HTTPSopenGym的WebAuthn约束完整理解指南下一篇TypeUI generate命令全流程实操从交互式问答到生成专属设计系统附--dry-run安全模式用法创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

相关推荐

MAS 激活怎么选:Win11 永久激活与 Office 激活的 4 条路线指南
MAS 激活怎么选:Win11 永久激活与 Office 激活的 4 条路线指南

MAS 激活怎么选:Win11 永久激活与 Office 激活的 4 条路线指南 【免费下载链接】Microsoft-Activation-Scripts Open-source Windows and Office activator featuring HWID, Ohook, TSforge, and Online KMS activation methods, along with advanced troubleshooti… · 2026/11/21 5:59:31

Mac 当主机,Linux 当服务器(20)故障排查实战——凌晨两点的磁盘告警
Mac 当主机,Linux 当服务器(20)故障排查实战——凌晨两点的磁盘告警

Mac 学 Linux 入门(20):故障排查实战——凌晨两点的磁盘告警 摘要:凌晨两点被告警叫醒,是什么体验?这篇完整复盘一次真实故障:从 df -h 看到根分区 93%,用 du -sh 一层层钻到 Nginx 日志,再用 tail + awk 揪出「疯狂刷接口的那个 IP」——结果发现是小林自己上周忘关的… · 2026/11/21 5:59:31

Obsidian替代方案SwarmVault:如何把散落笔记变成可查询、可复利的RAG知识库
Obsidian替代方案SwarmVault:如何把散落笔记变成可查询、可复利的RAG知识库

【免费下载链接】swarmvault The local-first LLM Wiki: open-source knowledge graph builder, RAG knowledge base, and agent memory store. Built on Andrej Karpathys pattern. An Obsidian alternative for personal knowledge management, AI second brain, and durable… · 2026/11/17 2:13:47

工地太忙根本没时间复习考试?南京电工证哪里考全攻略来了
工地太忙根本没时间复习考试?南京电工证哪里考全攻略来了

工地太忙根本没时间复习考试?南京电工证哪里考全攻略来了 工地太忙根本没时间复习考试?别急,南京电工证哪里考,其实没那么复杂,关键是方法对了,流程懂了,时间也能“挤”出来。今天就从【南京电工证哪里考】入手,讲清楚整个流程,让你省心省力办证,还… · 2026/11/21 5:59:18

浙江省建筑特种工考证保姆级教程:工地太忙也能一次过
浙江省建筑特种工考证保姆级教程:工地太忙也能一次过

浙江省建筑特种工考证保姆级教程:工地太忙也能一次过 工地太忙根本没时间复习考试,这几乎是每个建筑特种工的真实写照。尤其是像浙江省这样的建筑大省,特种工证几乎是进工地的“入场券”。但很多人因为工作忙、复习时间少,对考试内容一知半解,最终要么挂… · 2026/11/21 5:59:18

江西考电工证多少钱真实经历告诉你怎么复审延期
江西考电工证多少钱真实经历告诉你怎么复审延期

江西考电工证多少钱真实经历告诉你怎么复审延期 证书过期了不知道怎么复审延期,这事儿我可太懂了。前两天我一个在南昌做电工的朋友,就因为没及时复审,被公司临时安排去换证,结果耽误了项目进度,差点被甲方扣了半个月的工资。他说他根本不知道江西考电工… · 2026/11/21 5:59:18

东川低压电工证培训多久拿证 实操考试心里没底怕挂科?全攻略来了
东川低压电工证培训多久拿证 实操考试心里没底怕挂科?全攻略来了

东川低压电工证培训多久拿证 实操考试心里没底怕挂科?全攻略来了 你是不是也在担心实操考试心里没底怕挂科?东川低压电工证培训到底要多久拿证?这些问题困扰着很多准备报考低压电工证的小伙伴。别急,今天咱们就来聊聊东川低压电工证培训的全过程,让你从… · 2026/11/21 5:59:18

电工证不复审有影响吗?考前押题怎么用更有效
电工证不复审有影响吗?考前押题怎么用更有效

电工证不复审有影响吗?考前押题怎么用更有效 之前考的证在外省能不能转过来?这个问题困扰了不少在外地打工的电工朋友,尤其是像信阳房建工程这样的从业者,很多都是从老家出来打工,证件怎么转、怎么用,成了他们最关心的问题。今天就来聊聊… · 2026/11/21 5:59:18

官方回应来了!淘宝上的电工证怕考不过白交培训费?南阳学员的真实经历告诉你
官方回应来了!淘宝上的电工证怕考不过白交培训费?南阳学员的真实经历告诉你

官方回应来了!淘宝上的电工证怕考不过白交培训费?南阳学员的真实经历告诉你 怕考不过白交培训费?这事儿真不是夸张,我去年帮一个南阳卧龙区的朋友打听特种作业证的事儿,人家培训费交了8000块,结果考试挂了,补考又花了1000多,最后气得直接退费… · 2026/11/21 5:58:18

长春初级电工证怎么考?通过率揭秘全在这里
长春初级电工证怎么考?通过率揭秘全在这里

长春初级电工证怎么考?通过率揭秘全在这里 之前考的证在外省能不能转过来?这几乎是每个想从事电工工作的人都会问的问题。特别是那些在外地打拼多年、手里握着一张“外地电工证”的人,到了长春想继续干这一行,第一反应就是“我的证能用吗?”。今天我们就… · 2026/11/20 16:18:19

国内电工证报考条件与考试时间
国内电工证报考条件与考试时间

低压电工证怎么考?学历不高也能报名,官方报名入口全在这 你是不是经常听说“电工证是入行门槛”,但又担心自己学历不够、经验不足,根本报不了名?别急,今天就带你从零了解【国内电工证】的报考流程、考试内容,还有怎么在 官方报名入口… · 2026/11/20 18:25:07

电工作业时如何断电?电子证书到底能不能全国通用?
电工作业时如何断电?电子证书到底能不能全国通用?

电工作业时如何断电?电子证书到底能不能全国通用? 实操考试心里没底怕挂科,特别是电工作业时如何断电这一操作,不仅关系到你能不能拿到证书,更关系到以后能不能顺利上岗。很多人觉得这不过就是“断个电”,但其实这里面的门道可不少,稍有不慎就可能出错… · 2026/11/20 17:56:32

电工证征求意见2026河南最新政策怎么应对?学历不高也能考!
电工证征求意见2026河南最新政策怎么应对?学历不高也能考!

电工证征求意见2026河南最新政策怎么应对?学历不高也能考! 你是不是也担心自己学历不高, 怕报不上名 ?尤其是像焦作水利工程这样的从业者,常年在一线作业,但证书却成了晋升、转岗、接项目的关键门槛。 2026河南最新政策… · 2026/11/21 0:00:17

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来
电工证征求意见怎么填?含金量高不高?济源电工朋友看过来

电工证征求意见怎么填?含金量高不高?济源电工朋友看过来 不知道去哪报名怕被中介坑,电工证征求意见填错了不仅白费钱,还可能影响后续考试和工作。最近很多济源的电工朋友都在问: 电工证征求意见怎么填… · 2026/11/21 0:00:17

房建企业特种工考前押题怎么找?别让培训费打了水漂
房建企业特种工考前押题怎么找?别让培训费打了水漂

房建企业特种工考前押题怎么找?别让培训费打了水漂 怕考不过白交培训费?房建企业特种工考试难度高、题型多,很多人报名后才发现没有合适的复习资料,最终考试落榜,白白浪费了时间和金钱。别担心,掌握【考前押题】的技巧,能让你事半功倍,顺利通过考试。… · 2026/11/21 0:00:17

双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试
双极步进电机控制实战:DRV8818PWPR与PIC18F86K22驱动调试

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:45

STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析
STM32F207ZG + DRV8818PWPR 步进电机驱动实战解析

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:25:54

DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案
DRV8818PWPR+dsPIC30F4013工业级双极步进电机控制方案

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views … · 2026/11/20 10:26:03

了解更多?预约专属演示

我们的顾问将为您一对一讲解产品与方案

企业微信二维码