一步步上手 Obsidian i18n给初学者的完整插件中文化体验【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n上个月我从社区装了一款做 PDF 标注的插件功能正合我意可打开设置页全是英文。就在我为 Highlight color、Export settings 这类术语翻词典的时候朋友提过的那款 Obsidian i18n 又浮上心头——它是专为 Obsidian 桌面端打造的插件汉化工具能在不改动插件代码的前提下把界面文字提取出来、翻译成中文、再应用回去。从一次失败的插件安装说起那天我花了二十多分钟对照翻译软件逐项配置勉强把插件跑了起来却还有两个选项到现在也没弄清是做什么的。更糟的是插件更新后界面又回到了英文之前查过的词全得重来一遍。后来我认真试了 Obsidian i18n才发现翻译插件界面这件事原来可以不用这么费劲。先认识一下这个工具Obsidian i18n 在插件的已安装列表里显示为 I18N当前版本 2.0.21仅支持桌面端。它解决的问题很具体Obsidian 社区插件几乎全是英文界面而它把翻译这件事本身交给机器去完成。和传统汉化手段相比它的思路完全不同——不修改插件的 main.js不依赖浏览器翻译那种粗糙结果而是先把文本拿出来翻译好再放回去。译文数据独立存放在自己的目录里插件大版本更新后还能继续复用这是它最打动我的一点。一个比喻讲清它的原理你可以把它想象成一位会读源码的翻译管家。管家拿到一本英文教材也就是插件的 main.js用荧光笔把所有面向读者的句子标出来整理成一张清单你在清单空白栏写上中文管家再把写好的中文小心翼翼地夹回书里。整个过程书页一页都没动过。背后的技术叫 AST即抽象语法树。插件会解析目标插件的编译产物根据变量赋值、函数参数、对象键名等位置信息把按钮文字、提示语、设置项这类面向用户的文本精准找出来。所以它能区分 Settings 是标题还是按钮也不会把代码逻辑误当作文本翻掉。十分钟跑通第一次安装在插件尚未上架官方市场之前最快能跑起来的两条路径如下。BRAT 安装先给 Obsidian 装上 Obsidian42-BRAT在其设置里点 Add Beta plugin按提示粘贴本插件仓库地址装好后在第三方插件列表里启用 Obsidian i18n。手动安装到发行页下载最新的 obsidian-i18n.zip解压到笔记库的 .obsidian/plugins/obsidian-i18n/ 目录确认里面存在 main.js重启 Obsidian 并启用。启用后再做两项基础配置第一笔翻译就能开工。打开 设置 → 社区插件 → I18N → 语言模型填写接口地址、API 密钥和模型型号。比如 DeepSeek 填 deepseek-chat如果本地跑着 Ollama地址填 http://localhost:11434不需要密钥。切到 综合设置把目标语言设为 zh-cn顺手开启智能更新这样以后目标插件升级时插件会自动重新套用你已有的译文。配置完记得点一下立即测试看到连接成功字样再继续能省去后面不少排查时间。打开翻译面板的第一印象点击侧边栏的地球图标进入 i18n 管理中心。左侧列出已安装的插件和主题右侧是操作区。我选了一个常用插件点进去点了提取 / Extract十几秒后一张表格出现在眼前原文、译文、节点类型、变量名四列几百条字符串整齐地躺在里面。让我意外的是编辑体验。点进译文单元格直接打字光标一离开就自动保存默认停止输入 500 毫秒后落盘连续改十几行毫无打断感。顶部搜索框能同时匹配原文、译文、变量名和节点类型还提供未翻译筛选把还没动的条目一键过滤出来。更省力的是 AI 翻译面板。正式发送请求前它先显示预计消耗的 Token 数和折算费用看完确认再开始不会稀里糊涂产生账单。像 Settings、Cancel 这类高频词第一次翻完会进入本地缓存之后再遇到直接零成本复用不再向 API 重复请求。完整走一遍插件汉化流程以翻译一个名为 Sample Plugin 的社区插件为例从目标到结果一共五步照着做就能复现。在管理中心顶部的插件标签里找到 Sample Plugin点击进入它的翻译工作区。点提取 / Extract等待 AST 引擎扫描完成可翻译文本全部进入编辑器。在 AI 面板设置并发数与批次条目数比如并发 3、每批 20 条确认费用预估后开始翻译。在表格里审阅重点检查被 AI 误翻的专有名词把不合适的单元格手动改掉。点应用 / Apply译文被注入插件的运行文件并自动重载回到设置页就能看到中文界面。如果应用后界面异常点旁边的还原 / Restore插件会基于应用前的备份把文件恢复原样再回来逐条排查问题字符串。容易翻车的几个地方小贴士 1代码符号别删。译文里的 ${variable}、\n 这类属于代码范畴的符号翻译时务必原样保留。删掉它们应用后可能触发重载失败。小贴士 2报错码先查这些。401 一般是密钥里有隐藏空格或填错429 说明并发太高被限流先把并发数降下来再减小批次。小贴士 3Ollama 不用密钥。本地模型的默认地址就是 http://localhost:11434填好地址即可别被必须填 Key吓住。小贴士 4未翻译不等于空。译文等于原文、只包含空白的条目也会被判定为未翻译批量处理前先过一遍筛选结果。用与不用的差别拿我自己的体验来比以前手动汉化一个中等插件得先解包找文本改完还要担心插件更新后一切重来现在从提取到应用一次顺畅操作几分钟内完成更新由智能更新兜底出错一键还原。差异大致是这样对比项自己硬翻用 Obsidian i18n找文本解包搜索 main.js一键提取翻译逐个查词典AI 批量 本地缓存维护插件更新后重来智能更新自动套用出错恢复容易改坏插件备份快照一键还原再往前走一步插件只是起点。同一套流程同样适用于主题翻译遇到没有结构化文本的场景还有正则编辑器兜底。翻译成果可以导出成汉化包 JSON 分享给朋友也可以从云端仓库直接下载别人维护好的译文导入后继续编辑使用。想把自己的成果回馈社区可以在共建生态里配置 Token 与仓库信息把本地译文发布上去。更深层的玩法藏在设置里AI 翻译的提示词模板支持自定义内置了 AST、正则、主题三类并发数、批大小、超时时间都能调支持的服务商或兼容接口目前有 16 家从 OpenAI 兼容接口、Gemini到 DeepSeek、通义、豆包都有覆盖。想了解细节官方文档在 docs/快速开始的完整流程在 docs/quickstart.mdxAI 服务商列表见 docs/configuration/ai-providers.mdx核心实现源码可以看 src/ai/。写在最后文章开头那款 PDF 标注插件现在用 Obsidian i18n 不到半小时就完成了汉化那两个没搞懂的选项也终于知道了含义。工具存在的意义本来就是让你忘掉工具本身——现在我装新插件的第一件事不再是打开词典而是直接翻到中文界面。【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 一步步上手 Obsidian i18n：给初学者的完整插件中文化体验
一步步上手 Obsidian i18n给初学者的完整插件中文化体验【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n上个月我从社区装了一款做 PDF 标注的插件功能正合我意可打开设置页全是英文。就在我为 Highlight color、Export settings 这类术语翻词典的时候朋友提过的那款 Obsidian i18n 又浮上心头——它是专为 Obsidian 桌面端打造的插件汉化工具能在不改动插件代码的前提下把界面文字提取出来、翻译成中文、再应用回去。从一次失败的插件安装说起那天我花了二十多分钟对照翻译软件逐项配置勉强把插件跑了起来却还有两个选项到现在也没弄清是做什么的。更糟的是插件更新后界面又回到了英文之前查过的词全得重来一遍。后来我认真试了 Obsidian i18n才发现翻译插件界面这件事原来可以不用这么费劲。先认识一下这个工具Obsidian i18n 在插件的已安装列表里显示为 I18N当前版本 2.0.21仅支持桌面端。它解决的问题很具体Obsidian 社区插件几乎全是英文界面而它把翻译这件事本身交给机器去完成。和传统汉化手段相比它的思路完全不同——不修改插件的 main.js不依赖浏览器翻译那种粗糙结果而是先把文本拿出来翻译好再放回去。译文数据独立存放在自己的目录里插件大版本更新后还能继续复用这是它最打动我的一点。一个比喻讲清它的原理你可以把它想象成一位会读源码的翻译管家。管家拿到一本英文教材也就是插件的 main.js用荧光笔把所有面向读者的句子标出来整理成一张清单你在清单空白栏写上中文管家再把写好的中文小心翼翼地夹回书里。整个过程书页一页都没动过。背后的技术叫 AST即抽象语法树。插件会解析目标插件的编译产物根据变量赋值、函数参数、对象键名等位置信息把按钮文字、提示语、设置项这类面向用户的文本精准找出来。所以它能区分 Settings 是标题还是按钮也不会把代码逻辑误当作文本翻掉。十分钟跑通第一次安装在插件尚未上架官方市场之前最快能跑起来的两条路径如下。BRAT 安装先给 Obsidian 装上 Obsidian42-BRAT在其设置里点 Add Beta plugin按提示粘贴本插件仓库地址装好后在第三方插件列表里启用 Obsidian i18n。手动安装到发行页下载最新的 obsidian-i18n.zip解压到笔记库的 .obsidian/plugins/obsidian-i18n/ 目录确认里面存在 main.js重启 Obsidian 并启用。启用后再做两项基础配置第一笔翻译就能开工。打开 设置 → 社区插件 → I18N → 语言模型填写接口地址、API 密钥和模型型号。比如 DeepSeek 填 deepseek-chat如果本地跑着 Ollama地址填 http://localhost:11434不需要密钥。切到 综合设置把目标语言设为 zh-cn顺手开启智能更新这样以后目标插件升级时插件会自动重新套用你已有的译文。配置完记得点一下立即测试看到连接成功字样再继续能省去后面不少排查时间。打开翻译面板的第一印象点击侧边栏的地球图标进入 i18n 管理中心。左侧列出已安装的插件和主题右侧是操作区。我选了一个常用插件点进去点了提取 / Extract十几秒后一张表格出现在眼前原文、译文、节点类型、变量名四列几百条字符串整齐地躺在里面。让我意外的是编辑体验。点进译文单元格直接打字光标一离开就自动保存默认停止输入 500 毫秒后落盘连续改十几行毫无打断感。顶部搜索框能同时匹配原文、译文、变量名和节点类型还提供未翻译筛选把还没动的条目一键过滤出来。更省力的是 AI 翻译面板。正式发送请求前它先显示预计消耗的 Token 数和折算费用看完确认再开始不会稀里糊涂产生账单。像 Settings、Cancel 这类高频词第一次翻完会进入本地缓存之后再遇到直接零成本复用不再向 API 重复请求。完整走一遍插件汉化流程以翻译一个名为 Sample Plugin 的社区插件为例从目标到结果一共五步照着做就能复现。在管理中心顶部的插件标签里找到 Sample Plugin点击进入它的翻译工作区。点提取 / Extract等待 AST 引擎扫描完成可翻译文本全部进入编辑器。在 AI 面板设置并发数与批次条目数比如并发 3、每批 20 条确认费用预估后开始翻译。在表格里审阅重点检查被 AI 误翻的专有名词把不合适的单元格手动改掉。点应用 / Apply译文被注入插件的运行文件并自动重载回到设置页就能看到中文界面。如果应用后界面异常点旁边的还原 / Restore插件会基于应用前的备份把文件恢复原样再回来逐条排查问题字符串。容易翻车的几个地方小贴士 1代码符号别删。译文里的 ${variable}、\n 这类属于代码范畴的符号翻译时务必原样保留。删掉它们应用后可能触发重载失败。小贴士 2报错码先查这些。401 一般是密钥里有隐藏空格或填错429 说明并发太高被限流先把并发数降下来再减小批次。小贴士 3Ollama 不用密钥。本地模型的默认地址就是 http://localhost:11434填好地址即可别被必须填 Key吓住。小贴士 4未翻译不等于空。译文等于原文、只包含空白的条目也会被判定为未翻译批量处理前先过一遍筛选结果。用与不用的差别拿我自己的体验来比以前手动汉化一个中等插件得先解包找文本改完还要担心插件更新后一切重来现在从提取到应用一次顺畅操作几分钟内完成更新由智能更新兜底出错一键还原。差异大致是这样对比项自己硬翻用 Obsidian i18n找文本解包搜索 main.js一键提取翻译逐个查词典AI 批量 本地缓存维护插件更新后重来智能更新自动套用出错恢复容易改坏插件备份快照一键还原再往前走一步插件只是起点。同一套流程同样适用于主题翻译遇到没有结构化文本的场景还有正则编辑器兜底。翻译成果可以导出成汉化包 JSON 分享给朋友也可以从云端仓库直接下载别人维护好的译文导入后继续编辑使用。想把自己的成果回馈社区可以在共建生态里配置 Token 与仓库信息把本地译文发布上去。更深层的玩法藏在设置里AI 翻译的提示词模板支持自定义内置了 AST、正则、主题三类并发数、批大小、超时时间都能调支持的服务商或兼容接口目前有 16 家从 OpenAI 兼容接口、Gemini到 DeepSeek、通义、豆包都有覆盖。想了解细节官方文档在 docs/快速开始的完整流程在 docs/quickstart.mdxAI 服务商列表见 docs/configuration/ai-providers.mdx核心实现源码可以看 src/ai/。写在最后文章开头那款 PDF 标注插件现在用 Obsidian i18n 不到半小时就完成了汉化那两个没搞懂的选项也终于知道了含义。工具存在的意义本来就是让你忘掉工具本身——现在我装新插件的第一件事不再是打开词典而是直接翻到中文界面。【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考