可视化 AST 编辑器：安全地翻译插件文本

在结构化表格中编辑插件译文，支持行内修改、搜索和未翻译筛选。

AST 编辑器处理的是已经提取出来的可翻译字符串，而不是目标插件源码。你不需要直接打开 main.js 搜索文本，插件会把命中的字符串显示成表格行。

​

AST 提取是怎么工作的

AST 是 Abstract Syntax Tree（抽象语法树）的缩写。Obsidian i18n 会解析目标插件的编译产物 main.js，再根据变量赋值、函数参数、对象键名和过滤规则，提取面向用户的文本。

提取结果和译文由 Obsidian i18n 独立保存，不直接写回目标插件目录。

​

如何提取字符串

1. 打开管理中心

   点击侧边栏地球图标，打开 i18n 管理中心。

2. 进入插件标签

   选择顶部的 插件 标签。

3. 执行提取

   点击 提取 / Extract。插件会解析对应插件的 main.js，再把命中的字符串送入 AST 编辑器。

提取完成后，表格会显示节点类型、变量名、原文和译文列。

​

如何编辑译文

点击译文列中的任意单元格即可修改。离开焦点后，内容会写回当前编辑器状态。开启自动保存时，停止编辑 500ms 后会自动触发保存；未开启时，需要点击保存按钮。

• 可以连续编辑多行
• 可以用搜索框筛选条目
• 可以只看未翻译条目

未翻译 筛选器会显示译文为空、只包含空白字符，或仍然等于原文的条目。

​

搜索与筛选

顶部搜索框会同时匹配：

维度	匹配内容
节点类型	例如 StringLiteral、TemplateLiteral
变量名	例如 settingTitle、buttonLabel
原文	源文本
译文	当前已填写的目标语言文本

什么是节点类型？

节点类型表示字符串在 AST 中的结构类别，例如普通字符串、模板字符串或 JSX 文本。

变量名有什么用？

变量名提供上下文，帮助你区分短文本在不同位置的实际用途。