零基础如何给 Obsidian 插件汉化Obsidian i18n 上手全攻略【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18nObsidian i18n 是一款专为 Obsidian 桌面端设计的插件汉化工具它通过可视化 AST 编辑器和大模型翻译引擎让没有任何编程基础的普通用户也能把英文插件与主题界面轻松变成中文。这篇文章从新手最常问的五个问题出发帮你一步步走完安装、配置、翻译、应用、分享的完整流程读完即可直接上手。先问自己五个问题用过 Obsidian 的人大概都有这样的体验插件装得越多英文界面就越多。Dataview、Templater、Kanban……一个个都好用可设置面板里密密麻麻的英文总让人心里发怵。于是脑海里冒出一串问号我不会写代码也能给插件汉化吗听说改插件文件容易把功能弄坏安全吗插件一更新我的翻译是不是就白做了用 AI 翻译会不会偷偷烧掉我的 API 余额翻译好了能分享给朋友一起用吗接下来我们就用这五个问题当路标把 Obsidian i18n 从头到尾逛一遍。问题一不懂代码也能汉化能而且像填表格一样简单先说结论汉化插件这件事在 Obsidian i18n 出现之前确实是高手的活现在则像在表格里填一列数据那样轻松。它的秘密武器叫 AST抽象语法树。你可以把插件编译后的 main.js 想象成一本精装书AST 解析就像给这本书做索引卡片——它只把书里给读者看的句子也就是界面文本挑出来摆在你面前绝不改动书的正文。所以即使完全不懂编程你也能放心操作。具体到操作上只需要四步点击侧边栏的地球图标打开 i18n 管理中心在插件标签里找到想汉化的插件点击提取 / Extract等待文本被自动抓取在表格里逐条查看和修改译文。提取出来的内容会按节点类型、变量名、原文、译文四列整齐排好。点击任一译文单元格就能直接输入光标移开即自动保存跟用在线表格一个手感。遇到词条上千的大型插件顶部搜索框可以同时按原文、译文、变量名过滤还能一键只看未翻译的条目专攻漏网之鱼。问题二怎么装两步安装加三分钟配置就够了Obsidian i18n 目前还没上架官方社区市场但有两条成熟的安装路径任选其一即可。路线一用 BRAT 自动管理推荐。先在社区插件里搜索并启用 Obsidian42 - BRAT然后在 BRAT 设置里点击Add Beta plugin粘贴插件仓库地址安装完成后回到已安装插件列表找到名为 I18N 的插件手动打开开关。BRAT 的好处是后续插件更新时会自动拉取省心省力。路线二手动解压。如果网络环境不太配合可以到项目 Releases 页面下载 obsidian-i18n.zip解压到笔记库的.obsidian/plugins/目录下确认最终结构是.obsidian/plugins/i18n/main.js重启 Obsidian 后启用。注意文件夹名必须是 i18n它对应插件的真实 ID。装好之后做一次三分钟热身配置语言模型进入设置 → 社区插件 → I18N → 语言模型填入服务商的接口地址、API 密钥和模型型号然后点击立即测试。插件内置了深度诊断机制会帮您把连通性问题排查得明明白白直到看到连接成功。综合设置把目标语言设为 zh-cn简体中文填上你的作者署名并强烈建议打开智能更新开关。这里有个贴心提醒插件在 Obsidian 里显示的名称是 I18N而文档和社区里更常叫它 Obsidian i18n两者是同一个东西别找错门。问题三上百条英文要翻到什么时候交给 AI还带防刺客账单这是 Obsidian i18n 最让人安心的部分它内置了大模型翻译引擎而且把花钱这件事做得明明白白。先报价再干活。点击翻译按钮之前AI 面板会先给出本次翻译预计消耗的 Token 数和折算费用比如≈ ¥0.15。看完报价再决定动不动手彻底告别一觉醒来余额没了的恐惧。支持的服务商相当全面。目前内置了 16 家主流服务商或兼容接口包括 OpenAI 兼容接口、Gemini、DeepSeek、智谱 GLM、Kimi、通义、豆包、Groq、Ollama 等。同一个服务商还能创建多套配置方案Profile方便在不同模型之间切换。如果你有本地显卡用 Ollama 甚至可以做到完全免费、零联网。翻译得越多越便宜。插件内置本地翻译缓存凡是翻译过的词条再次遇到会直接命中缓存秒回不再向 API 发起请求。像 Settings、Cancel 这种高频 UI 词汇翻一次之后就是零成本复用。并发可控。你可以在 AI 面板设置并发数和批次大小实时查看进度条。万一厂商返回 429请求过频先降低并发数再降低批次大小即可。如果你连 API 密钥都不想配也完全没问题——AST 编辑器支持纯手动填写译文只是慢一点而已。问题四翻译会不会把插件弄坏有备份还能一键还原这是很多新手最担心的点可以放心Obsidian i18n 采用非破坏式注入译文数据与插件本体分开存放应用翻译时不会改动插件源码本身。执行应用 / Apply时插件会先自动创建备份快照再把译文映射到目标插件的运行文件里万一应用后界面异常点击还原 / Restore就能基于快照无损回到翻译前的状态跟游戏里的读档一样简单。翻译数据与插件解耦还带来一个隐藏福利即使目标插件大版本更新甚至重装你的译文库依然独立保存。配合前面提到的智能更新插件更新后它会自动重新映射并应用旧译文不需要重新翻译第二遍。唯一要注意的是手动编辑时千万别删掉原文里的${变量}或\n这类代码控制符它们属于书页页码而不是正文句子。万一不小心动了还原按钮就是你的后悔药。问题五翻译成果只能自己用导出分享还能云端共建辛辛苦苦翻完一个插件只留在自己电脑里太可惜了。Obsidian i18n 提供了完整的分享链路本地导出在管理中心的管理标签里可以把译文打包成 .i18n.gz 归档文件随手发给朋友对方导入即可使用。云端共享在综合设置里配置好云端仓库后管理中心会直接展示可下载的云端版本通过云图标进入 Cloud 视图还能浏览社区目录、按仓库探索资源。发布共建配置好 GitHub Token 后可以在 Cloud 管理中心把你的译文源发布到仓库让别人也能下载到你的成果成为社区生态的一环。进阶玩法汉化这件事还能玩出花基础流程跑通之后你还可以试试这些进阶技巧术语统一翻译前先列一张个人术语表把 Backlink、Graph View 这类高频词定下统一译法再用搜索功能批量替换保证整个插件口吻一致。正则编辑器补漏有些文本藏在复杂逻辑里AST 抓不到可以切到正则编辑器用规则补漏官方文档 docs/features/regex-editor.mdx 有详细说明。主题也能翻不只是插件CSS 主题的界面文本同样支持提取、翻译、应用与还原整套流程完全复用。不用 AI 也流畅没有 API Key 时纯手动模式依然好用特别适合词条不多的小插件。更完整的分步教程可以参考官方文档 docs/quickstart.mdx 和 docs/guides/translate-a-plugin.mdx。动手前先记住这几条避坑提示连接失败或 401多半是 API 密钥里混进了隐藏空格检查后再测试。429 报错并发太高被厂商熔断或账户余额不足降低并发即可。网络超时OpenAI 等受限接口需要自备代理或换用国内兼容转发接口。只支持桌面端Obsidian i18n 依赖桌面端的文件系统能力iOS / Android 移动端暂不支持。翻译文件在哪译文保存在.obsidian/plugins/i18n/translations/下备份在backups/目录随时可以手动查看。今天就能开始的三件事读到这里你已经掌握了完整的汉化地图。现在就可以做这三件事装好 Obsidian i18n用 BRAT 方式完成安装并填好你的第一个 AI 服务商配置挑一个最常用的英文插件走一遍提取 → 翻译 → 应用 → 还原体验的完整流程建一张个人术语表为下一个小插件定好统一译法。如果你在项目中发现了 Bug或者有脑洞大开的想法也欢迎带着控制台错误截图去提交反馈。随着项目持续迭代更多语言支持、更强的智能翻译和更完善的云端协作已经在路上了。让你的每一个插件都变成顺手的中文工具就从今天开始。【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考