让 Obsidian 插件秒变中文界面Obsidian i18n 国际化插件的零代码汉化全攻略【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18nObsidian i18n 是一款专为 Obsidian 打造的插件国际化工具它用「不碰源代码」的 AST 解析技术和 AI 翻译引擎让你在不需要任何编程基础的情况下把满屏英文的社区插件一键变成顺眼的中文界面。这篇指南会从真实场景讲起带你走完从安装、配置、翻译到分享的完整闭环。从一句看不懂说起一个晚八点后的真实场景晚上八点你终于决定认真整理自己的知识库兴冲冲装上一个好评如潮的社区插件。结果打开设置面板映入眼帘的是 Backlink、Graph View、Property 这类半懂不懂的术语再往下还有一串缩写和滑块你只能靠猜。这不是你的问题而是绝大多数 Obsidian 插件的现状——默认只提供英文界面。而 Obsidian i18n 想解决的正是这件事把翻译插件从极客专属技能变成普通用户十分钟就能搞定的日常操作。问题不大但积少成多为什么插件汉化值得认真对待单独看一个插件看不懂只是个小麻烦。但三个麻烦叠加起来体验就会明显变差理解靠猜设置项描述含糊勾错选项、填错配置是常事出了问题都不知道是哪一步导致的探索靠勇气功能按钮看不懂很多人干脆只用最基础的那两三个功能插件价值被严重浪费维护靠折腾今天翻译好了明天插件更新之前的成果可能又要重来一遍如果用传统方式解决通常只有三条路但每条都不好走方案门槛风险直接改插件源码需要懂代码插件一更新就失效还可能改坏文件用网页翻译工具无只能翻界面翻不了插件内部设置找人代做汉化包依赖他人更新慢、不匹配自己的版本Obsidian i18n 走的是第四条路让工具自己完成提取、翻译、注入和更新你只负责在最后审一眼结果。思路完全不同它凭什么敢说不碰源代码Obsidian i18n 的核心思路可以总结成一句话翻译数据与插件本体彻底分离。它底层基于抽象语法树AST技术会像拆零件一样把插件运行文件里面向用户的文本逐一挑出来展示在一张类似 Excel 的表格里。你改的是这张表而不是任何一行原始代码。改完之后点击应用译文才被注入到插件运行文件里觉得不对再点还原立刻回到应用前的状态。如果用一个生活化的比喻传统汉化像在一本打印好的书上用涂改液改字改完书就脏了而 Obsidian i18n 像给书配了一副翻译眼镜——书还是那本书戴上眼镜看到的就是中文。两条安装路径十分钟内把插件装进 Obsidian目前插件尚未上架官方社区市场但安装并不麻烦有两条路可选路径一BRAT 安装推荐先安装并启用 [Obsidian42 - BRAT] 插件打开 BRAT 设置点击Add Beta plugin粘贴 Obsidian i18n 的仓库地址并确认回到第三方插件列表找到Obsidian i18n并启用用 BRAT 的好处是后续插件更新时它能自动拉取新版本不用每次手动折腾。路径二纯手动安装访问插件 Releases 页面下载最新的obsidian-i18n.zip解压到笔记库的.obsidian/plugins/目录下确认目录结构为.obsidian/plugins/obsidian-i18n/main.js重启 Obsidian在设置中启用提示Obsidian i18n 是桌面端专用插件仅支持 Windows / macOS / Linux依赖桌面文件系统的读取与注入能力移动端暂时无法使用。开箱前的三个小设置决定后面的翻译体验启用插件后别急着翻译先花两分钟完成三件事能让后面的体验顺畅很多。1. 配置 AI 服务商进入设置 → 社区插件 → I18N → 语言模型选项卡填写API 接口地址官方地址或国内兼容代理均可粘贴API 密钥插件会本地加密存储选择或输入模型型号比如gpt-4o-mini、deepseek-chat点击立即测试看到连接成功字样再继续2. 设置目标语言切到综合设置选项卡把目标语言填成zh-cn简体中文这是译文最终输出的语种。3. 打开智能更新同样在综合设置里建议开启智能更新。开启后当目标插件发布新版本时插件会自动把之前翻译好的内容重新映射并应用上去避免更新一次、重翻一次的重复劳动。四个核心模块拆解编辑器、AI 引擎、注入与共享像填表格一样翻译可视化 AST 编辑器这是整个插件体验最好的一块。点击管理中心里的目标插件再点提取 / Extract引擎会把藏在代码里的所有界面文本剥离出来按节点类型、变量名称、原文、译文分列展示。点击任意译文单元格直接输入光标移开即自动保存没有弹窗打断顶部搜索框支持按原文、译文、变量名、节点类型多维度检索用下拉框筛出未翻译条目集中火力逐条攻克让大模型干苦力高并发 AI 翻译引擎面对上千条待翻译词条纯手打不现实AI 引擎就是为此设计的支持16 家主流服务商OpenAI 兼容接口、Gemini、DeepSeek、智谱 GLM、Kimi、通义千问、豆包、Groq、硅基流动、OpenRouter 等也支持 Ollama 本地模型默认地址http://localhost:11434无需密钥可自由设置并发数与批次条目数边跑边看实时进度内置本地缓存库Settings、Cancel这类高频词汇翻译过一次之后下次直接命中缓存不再向 API 发起请求等于零费用秒翻最贴心的是费用预估点击翻译前面板会先告诉你预计消耗多少 Token、折合多少钱比如≈ ¥0.15心里有底再动手不怕账单刺客。随时能后悔应用与还原机制翻译成果独立保存在.obsidian/plugins/i18n/translations/目录下与目标插件完全解耦。应用前会自动创建备份遇到问题随时还原 / Restore回到原始状态。就算以后重装目标插件你的译文数据也不会丢。让成果流动起来导入、导出与云端共享在管理中心管理标签可以把译文导出为.i18n.gz归档文件发给朋友直接导入也可以在 Cloud 视图配置 GitHub Token 后把本地译文发布到自己的仓库让更多人用上你的翻译进阶用户还可以在管理中心 → 自动化里开启后台探测让插件定期扫描社区仓库里的新译文并自动匹配应用。亲手走一遍把一个英文插件改成中文界面的完整流程理论说再多不如实操一遍。下面是完整七步打开管理中心点击 Obsidian 侧边栏的地球图标或通过命令面板执行打开 i18n 面板的命令选定目标在插件标签里搜索并点击想汉化的插件提取文本点击提取 / Extract等待引擎扫描完成表格里出现所有可翻译文本AI 批量翻译打开 AI 面板先看费用预估再设置并发与批次点击翻译 / Translate人工审阅逐个检查译文特别留意${变量}这类占位符和\n转义符有没有被误删应用译文点击应用 / Apply插件会把译文注入运行文件并自动重载目标插件验证效果重启 Obsidian检查界面是否正常显示中文有异常就点还原 / Restore回到原始状态排查完整的分步说明可以在项目文档 docs/quickstart.mdx 与 docs/guides/translate-a-plugin.mdx 中找到。新手最容易踩的四个坑附官方解法坑 1连接测试失败翻译毫无进度提示401多半是 API 密钥里有隐藏空格检查一下提示429并发开太高被厂商限流先降低并发数再降低批次条目数提示超时OpenAI 等海外接口需要自备代理或换成国内兼容接口坑 2误删了代码控制符导致插件重载失败手动编辑译文时如果不小心把${变量}或\n这类属于代码范畴的内容删掉应用后就会报错。解法很简单回到管理中心狠狠点击还原 / Restore系统会基于备份瞬间恢复原始状态。坑 3更新插件后翻译不见了别慌。译文数据是独立保存的只要在综合设置里开启了智能更新插件启动时会自动检测目标插件版本变化并重新应用已有译文。坑 4不知道译文到底存在哪译文文件保存在.obsidian/plugins/i18n/translations/元数据在metadata.json备份在.obsidian/plugins/i18n/backups/。想手动导出或迁移去这两个地方找就对了。常见疑问快问快答Q1没有 AI 密钥这个插件还能用吗完全能。AI 翻译只是加速手段你可以全程手动在 AST 编辑器、正则编辑器或主题编辑器里填写译文。Q2翻译会弄坏我的插件吗应用前会先创建备份如果应用后插件重载失败当前实现会自动恢复备份并还原原始状态。主题翻译同样有备份与还原机制。Q3插件支持翻译主题吗支持。主题有自己的编辑器与 AI 面板流程与插件翻译一致。Q4同一个服务商可以配置多套参数吗可以。每个服务商都能创建多套 profile独立保存 URL、API Key、模型和价格字段方便在不同模型间切换。Q5怎么提前知道要花多少钱AST、正则、主题三个编辑器的 AI 面板都会在发送请求前显示预计 Token 数、预计费用与输入输出单价。尾声从使用工具到参与共建Obsidian i18n 的价值不只是让你看懂插件它更像一把钥匙——把本地化这件事的门槛降到普通用户也能推开。翻译得越多你积累的本地缓存越丰富后续成本越低导出分享给他人一个插件的中文体验就会被放大到整个社区。如果你对它的实现细节感兴趣AI 服务商配置表在 src/ai/constants.ts翻译核心逻辑在 src/ai/AI 翻译的完整能力说明见 docs/features/ai-translation.mdx。今天就可以做三件事用 BRAT 或手动方式装好 Obsidian i18n配置一个 AI 服务商把目标语言设为zh-cn挑一个最常用的英文插件走完提取 → 翻译 → 审阅 → 应用全流程当你发现某个插件悄悄变成了中文界面会忍不住感叹原来让工具适应人而不是人适应工具才是知识管理该有的样子。【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
