如何用 obsidian-i18n 汉化 Obsidian 插件从可视化编辑器到 AI 翻译的完整上手路线【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18nobsidian-i18n 是运行在 Obsidian 桌面端的插件汉化工具用 AST 解析加 AI 翻译把插件中文化变成一张填表就能完成的事。读完本文你就能亲手交付第一份完整插件汉化。先从那个没有中文界面的插件说起晚上十点你终于装上了心仪已久的插件。安装零报错启用也顺利可等你点开设置页一行行英文选项像阅读理解一样摊在眼前。你开始挨个查词典五分钟后才搞清楚某个开关到底是开还是关又过了十分钟你在两个长得差不多的选项之间放弃了判断。你的需求其实很简单这个插件很好用我只是想让它说中文。obsidian-i18n 就是为这个场景而生的。它不要求你懂代码、不要求你解包插件更不需要你去改那些危险的原生文件。它像一位耐心的翻译助手帮你把插件里所有面向用户的文本找出来、翻译好、再安全地放回去。一句话说清 obsidian-i18n 是什么obsidian-i18n 是一个安装在 Obsidian 里的桌面端插件专门用来汉化或本地化为任意语言其他社区插件与主题。它和传统汉化方案最大的不同是全程不碰目标插件的源码通过 AST抽象语法树解析插件编译产物把按钮、提示、设置项这类展示文本抽离出来交给你或 AI 填写译文再以非破坏方式注入回去。译文数据独立保存随时可以一键还原。需要提醒的是它目前只支持 Obsidian 桌面端移动端暂不在支持范围内。首次配置最省事的做法装完直接走通一条线别急着研究每个设置项先让工具能跑起来一共四件事。装本体。推荐用 Obsidian42 - BRAT 插件来安装在 BRAT 设置里点击 Add Beta plugin粘贴 obsidian-i18n 的仓库地址安装后在第三方插件列表里启用即可以后的更新也由 BRAT 自动接管。如果网络受限就走手动路线从 Releases 下载 obsidian-i18n.zip解压到笔记库的 .obsidian/plugins/ 目录下确认目录里存在 main.js然后重启 Obsidian 并启用。配模型。进入设置 → 社区插件 → I18N → 语言模型填上服务商的接口地址、API Key 和模型型号点立即测试。这一步的目的是确认插件能连上大模型内置诊断会直接告诉你连接失败的环节测通了再继续。设偏好。切到综合设置把目标语言设为 zh-cn填一个作者署名会写进译文包的元数据。强烈建议顺手打开智能更新这样目标插件以后发布新版本时插件会自动重应用你已有的译文不用重翻一遍。开面板。点侧边栏的地球图标进入 i18n 管理中心。到这里工具链就绪可以开始第一份翻译了。能力地图按你的使用场景找钥匙不必记住所有按钮按场景来找就好。第一次用只想要中文界面。核心是可视化 AST 编辑器。进入某个插件后点提取引擎会自动解析出所有可翻译文本显示成一张带原文 / 译文列的表。点任意译文单元格就能改光标移开自动保存就像用在线表格一样。改完点应用插件界面立刻变成中文。想省时省钱把体力活交给 AI。AI 翻译引擎内置了 16 家服务商的接入配置从 OpenAI 兼容接口、Gemini、Ollama到 DeepSeek、通义、豆包等国内服务都有。批量翻译前会先给出预计 Token 数和费用确认后再发送已翻译过的字符串会命中本地缓存直接复用、不产生任何 API 请求。想协作、想分享走云端生态。本地译文可以导出成 .i18n.gz 归档文件发给别人也可以打开 Cloud 视图下载社区现成译文或把自己打磨好的译文发布到仓库并同步更新 metadata.json。✍️ 一次完整实战把常用插件彻底汉化下面用你笔记本里最常见的一个社区插件把整条流程走一遍。第一步锁定目标并提取。在管理中心顶部的插件标签里找到目标插件点提取 / Extract。引擎会解析它的 main.js把所有面向用户的文本抓进编辑器。这个过程不会修改源文件放心点。第二步让 AI 先翻译一遍。打开 AI 翻译面板设置并发数和批次条目数。点翻译前面板会先给出这次预计消耗的 Token 和折算金额确认无压力再开始。之后你会看到进度条一路拉满。第三步在表格里人工打磨。翻译完成后用顶部搜索框按节点类型、变量名、原文或译文定位条目。像 Settings、Cancel 这类高频词可以顺便检查译文是否统一遇到拿不准的短文本看一眼变量名就能判断它出现在哪个位置。第四步应用并验证。点应用 / Apply译文注入插件运行文件并自动重载。重启后确认界面无误就算完成了。如果界面出现异常点还原 / Restore秒回原始状态再定位问题条目。哪种翻译方式适合现在的你一张判断流程完全不想花钱 → 手动在表格里填或用 Ollama 跑本地模型。Ollama 默认地址是 http://localhost:11434连 API Key 都不用。想快、且手上已有某个模型服务的 Key → 选国内接口如 DeepSeek、通义、豆包通常延迟和费用都更友好。一个词都不想翻 → 打开 Cloud 视图找一份社区译文直接导入十分钟内完成汉化。批量翻译时提示 429 → 先降低并发数再降低批次大小逐级放行。目标语言不止中文→ 综合设置里把 language 改成 zh-tw、ja、fr 等语言码即可。最容易踩的几个坑以及绕开它们的姿势误删代码控制符。这是最常见的事故。译文里像 ${变量}、\n 这类符号属于代码的一部分删掉后应用会导致插件重载失败。遇到这种情况第一反应应该是点还原而不是继续排查。翻译时只动纯文本内容。API Key 里藏着空格。复制密钥时容易带上多余空格表现是连接测试报 401。重填一遍确认首尾干净。并发开太高被限流。服务商对并发请求有额度报 429 时先降并发再降批次一般就能恢复。以为移动端也能用。obsidian-i18n 目前仅支持桌面端 ObsidianObsidian Mobile 暂时无法使用。效果值不值用看得见的数字说话16 家服务商可接主流与国内模型基本全覆盖一个插件账号能配多套方案随时切换。缓存命中即零费用重复出现的界面词汇从本地记忆库直接取用不产生 API 请求翻得越多单价越低。发送前先报价翻译前面板会给出预计 Token 数与折算金额例如 ≈¥0.15杜绝翻译完才发现账单吓人。编辑即自动保存停止输入 500ms 后自动落盘配合自动保存开关误关编辑器也不丢内容。译文与插件解耦译文存在独立目录重装目标插件不影响翻译成果开启智能更新后插件升级也会自动重映射旧译文。 想继续深挖这里还有更多入口项目文档就在仓库的 docs/ 目录下快速开始、综合设置、AI 服务商配置、应用与还原、分享译文等主题都有对应页面。想看实现细节src/ 目录按模块拆得很清楚ai/ 是各服务商翻译实现manager/ 是提取、注入与备份等核心逻辑views/ 是可视化界面。遇到问题想反馈或想参与改进欢迎带上控制台报错截图去提 Issue想要为中文 Obsidian 生态出力把打磨好的译文发布到云端仓库就是最直接的贡献方式。想拉取源码参与共建克隆命令是 git clone https://gitcode.com/gh_mirrors/ob/obsidian-i18n具体协作方式可参考仓库内的贡献指南。结尾工具存在的意义obsidian-i18n 把汉化插件从少数极客的专利变成了一杯咖啡时间就能完成的小事。真正的好工具不会喧宾夺主——它安静地待在角落里让你永远不必为了语言放弃一个好用的工具。下一步行动建议今天可以做用 BRAT 装上 obsidian-i18n配好一个模型服务走通提取 → 翻译 → 应用全流程。本周可以完成挑一个你最常用的插件彻底汉化顺手整理一份个人术语表保证同一个词在全库中翻译一致。长期可以坚持每两周检查一次已汉化插件的更新把优质译文导出或发布到云端让更多人受益。【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考