告别满屏英文用 obsidian-i18n 彻底完成 Obsidian 插件中文化【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18nobsidian-i18n 是一款装在 Obsidian 里的本地化插件专门解决社区插件和主题只有英文界面的问题。你不需要懂编程、不需要碰任何源代码跟着下面这条真实的经历走一遍大约三十分钟就能拥有第一个全中文界面的插件。一个让人想砸键盘的晚上晚上十一点你终于抽出时间整理笔记库装了一个口碑很好的社区插件。打开设置页从上到下扫过去Recursive、Rendering、Backup Threshold……每行英文都认识你但你不认识它。你掏出手机一个词一个词查查到一半连自己最初想调哪个功能都忘了。那个晚上你的 Obsidian 里躺着二十多个插件真正敢碰设置的不到三个。这不是你的问题是所有非英语用户每天都要面对的日常。而 obsidian-i18n 要做的就是把查词典这个动作从你的工作流里彻底拿掉。先弄清楚给插件翻译到底难在哪你可能以为插件界面中文化就是把文字翻译一遍填回去。但插件里的文字是写死在代码里的翻译它们绕不开一个现实你得先知道哪些文字是给用户看的、哪些是程序自己用的。传统的做法是改源代码——相当于为了给抽屉贴张中文标签先把整张抽屉拆开、重新上漆。风险高、更新一次就白干一次这不是普通人该干的事。obsidian-i18n 换了个思路。它底层用抽象语法树AST去解析插件的编译产物把面向用户显示的文本精准地挑出来放进一张像 Excel 一样的表格里。你只需要在这张表里填中文它再把中文盖到插件界面上。整个过程不修改插件本体译文和插件分开存放想还原随时可以掀掉。用大白话讲别人是拆机改造它是隔着一层玻璃贴标签。这也是它敢叫非侵入式翻译的原因。为什么说它是少走弯路的那条路在遇见 obsidian-i18n 之前很多人试过不少土办法。我把它们放在一起比了比方案门槛更新插件后风险手动改插件源码需要编程能力全部重来可能弄坏插件自己维护译文文件需要理解插件结构手动重对一遍容易漏翻浏览器翻译扩展不适用桌面软件无只能看不能改obsidian-i18n零代码开启智能更新自动沿用旧译文随时一键还原前三条路要么门槛高要么是死胡同。obsidian-i18n 把提取 → 翻译 → 应用 → 还原整合成了一条完整的流程这才是它真正值钱的地方你不需要知道插件内部长什么样只需要会点按钮、填中文。第一次成功从下载到第一个中文插件别急着看功能清单先跟我走完一遍完整动线你就明白它长什么样了。第一步把它装进 Obsidian。插件目前还没上架官方社区市场装法有两种。推荐用 BRAT先装好 Obsidian42 - BRAT 插件在它的设置里点 Add Beta plugin把 obsidian-i18n 的仓库地址粘进去等它拉取完去第三方插件列表找到 I18N 手动打开开关。不想折腾 BRAT 的话去 Releases 页下载obsidian-i18n.zip解压到笔记库的.obsidian/plugins/目录下文件夹名必须是i18n重启 Obsidian 再启用。装好后左侧边栏会出现一个地球图标点它进入i18n 管理中心。第二步配一个 AI 翻译服务。这一步是整个流程里最关键的一环。进入 设置 → 社区插件 → I18N → 语言模型你会看到一份服务商列表DeepSeek、智谱 GLM、Moonshot、通义千问、豆包、SiliconFlow……目前内置了 16 家主流服务商或兼容接口国内能用的一大半都在里面。选一个你手上已经有 API Key 的平台填好接口地址、密钥和模型型号然后务必点一下立即测试直到看到连接成功。顺便说一句如果你不想花钱也可以选 Ollama 在本地跑模型连密钥都不用填。第三步把全局参数设置好。切到综合设置标签目标语言填zh-cn这是最终输出的语种作者署名填你的昵称以后导出的译文包会带上你的名字最后打开智能更新——这是防后悔药以后目标插件更新版本时它会自动把你以前翻译过的内容重新映射到新版本上。第四步开始翻译第一个插件。回到管理中心在插件列表里点开你想汉化的那个插件点提取。引擎会扫描插件的编译产物把按钮、提示、设置项这些面向用户的文本全部抓进一张表格。你可能看到上百行英文别慌这就是你接下来要填的中文作业本。第五步让 AI 先干一遍粗活。打开 AI 翻译面板点击翻译之前面板会先显示这次大概要消耗多少 Token、折合多少钱——它甚至会在你确认前把账算给你看比如预计 ≈ ¥0.15。确认无误再开始。翻译过程中你会注意到一个细节Settings、Cancel这类高频词几乎是瞬间翻完的因为插件把翻过的词都缓存在本地了重复出现直接复用不花钱、不等待。第六步审阅并应用。翻译完成后点进任意译文单元格直接改字光标移开就自动保存。确认没问题点应用插件自动重载——从这一刻起你看到的就是中文界面了。如果觉得哪里不对随时点还原一秒回到原始状态。你可能已经猜到了整个过程没有任何一行代码。这就是非程序员也能用的底气。新手最容易踩的 5 个坑第一轮走下来你大概率会遇到几个坎。我提前替你踩过了绕开方法如下坑一测试连接一直失败。最常见的原因是复制 API 密钥时把空格也粘进去了。检查一下密钥前后有没有多余字符如果提示401几乎可以确定是密钥问题。坑二翻译到一半没动静了。提示429说明请求太密被服务商限流了。把 AI 面板里的并发数和批次大小调低一点重启任务就好。坑三网络超时。部分海外接口在国内直连不稳定换一个国内兼容的转发接口或者用上面提到的国内服务商问题通常会消失。坑四手滑删掉了不该删的符号。翻译时千万别动原文里${变量}或\n这类东西它们属于代码范畴。万一误删导致应用后插件报错别慌点还原立刻恢复原样再去修正出问题的条目。坑五以为翻译成果会丢。不会。译文独立保存在插件自己的目录里就算目标插件重装也不受影响。前提是你记得在综合设置里打开智能更新。玩熟了以后比会翻译更值钱的进阶玩法等你熟练了这些能力值得逐个解锁术语统一大型插件的设置项往往上百条翻译前先用搜索框筛选把同一个英文词的所有出现位置一次性统一译法避免同一个意思三种叫法。批量翻译调优并发数建议从 3 到 5 起步批次别贪大稳定比速度重要。把成果带出笔记库在管理中心的管理标签里可以导出.i18n.gz译文归档发给你同样被英文困扰的朋友他导入后直接就能用。反过来你也随时能导入别人做好的优质译文。给主题做汉化插件能翻译的不只是插件主题界面同样支持操作流程基本一致。沉浸翻译模式开启后插件会对界面元素做实时翻译适合那些你不想应用到底、只想临时看看效果的场景。想深入了解的话项目文档的docs/guides/目录里有完整的翻译流程说明AI 引擎的实现在src/ai/目录里也写得清清楚楚——不过以你现在的熟练度暂时还不需要翻到那一层。未来一周可以做的三件事第一件今天花三十分钟挑一个你最常用的插件完整走一遍上面那条动线把第一个中文插件做出来。第二件这周内把你笔记库里因为看不懂所以不敢碰的插件列一张清单逐个汉化每搞定一个就在清单上打个勾。第三件挑一个你最满意的译文包导出发给朋友。当你看到对方也装上中文界面时那种原来我也能帮上别人的感觉比翻译本身更让人上瘾。最后一句话送给你工具应该是读得懂你的那一个——既然它能记住你的语言就没必要让你去将就它的英文。【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
