obsidian-i18n

---

Obsidian i18n 是一款专为 Obsidian 打造的本地化语言辅助工具，旨在帮助用户轻松翻译和汉化 Obsidian 的任意社区插件与个性化主题。

无需解包，无需懂代码！通过本插件首创的 AST 提取可视化编辑器 与 高并发大模型机器翻译引擎，任何人都能在一杯咖啡的时间内生成、维护并与社区分享属于自己的“官方级”汉化包，彻底消除晦涩难懂的语言障碍。

核心特性一览 (Highlights)

• 绝对安全的所见即所得：基于底层抽象语法树（AST）解析，无需触碰危险的源代码，像填写 Excel 行内表格一样直观地查漏补缺。
• 并发 AI 极速引擎：自由配置请求并发数与批处理量，内置本地翻译缓存库，翻译得越多，API 消耗费用越趋近于零。
• 首创账单防刺客系统：执行翻译动作前，面板将精准预估所需消耗的 Tokens 和对应的人民币/美元开销，所有成本完全透明。
• 翻译数据解耦与防丢失：您的译文库独立于目标插件保存。即使目标插件大版本更新或重装，您的中文翻译配置依然稳如泰山。

---

快速开始 (Getting Started)

下载与安装

由于目前插件尚未上架官方社区市场，我们为您提供以下两种安装方式：

方法一：使用 BRAT 安装（ 推荐）

使用 Obsidian42 - BRAT 可以方便地自动拉取本插件的后续更新，无需每次手动去下载压缩包。

1. 打开 BRAT 的设置页面，点击 Add Beta plugin。
2. 粘贴本仓库地址：https://github.com/eondrcode/obsidian-i18n
3. 安装完成后，在 Obsidian 的“第三方插件”列表中找到 Obsidian i18n 并将其启用。

方法二：纯手动安装

如果网络环境受限导致 BRAT 安装报错，您可以尝试手动载入：

1. 访问本插件的 Releases 发行页。
2. 下载最新版本的 obsidian-i18n.zip 压缩包。
3. 在您的笔记库中将其解压至 .obsidian/plugins/ 目录之下。 (确认目录结构为 .obsidian/plugins/obsidian-i18n/main.js)
4. 重启 Obsidian 并在设置中启用。

---

⚙️ 初始配置 (Initial Setup)

插件启用后，只需完成简单的环境配置，即可激活全自动机器汉化。

1. 配置语言模型 (Ai) ( 核心)

进入插件设置页，切换至 ”语言模型“ 选项卡。您可以建立多套配置方案（Profile）在不同的模型厂商之间切换。

• API 接口地址：填写模型服务商的请求路径（如官方的 https://api.openai.com/v1 或国内兼容代理地址）。
• API 密钥 (Key)：粘贴您的密钥。插件会将其安全地加密存储在本地。
• 模型型号：选择下拉菜单或手动输入模型标识符（如 gpt-4o 或 deepseek-chat）。
• 测试与诊断：填写完毕后，务必点击底部的 “立即测试”。插件内置的深度诊断机制会帮您排查连通性，直到展现_“连接成功”_字样。

2. 基础偏好与智能更新 (Basis)

强烈建议您切换至 “综合设置” 选项卡完成以下配置：

• 目标语言：设定为您最终想要输出的语种（例如填写：zh-cn）。
• 作者署名：留下您的昵称，将以此作为您后续打包译文的作者印记。
• 智能更新（强烈推荐）：开启后，当 Obsidian 检测到目标插件发布新版更迭时，i18n 插件会自动为您重新映射并自动应用本地原有的译文缓存，免去您重新翻译的无用功。

---

核心功能指南 (Core Features)

通过 Obsidian i18n，插件汉化不再是懂写代码的高端极客专属。

1. 可视化 AST 语言编辑器 (Visual Editor)

本工具摒弃了让用户修改 main.js 或多重嵌套 JSON 的危险行为，为您打造了最友好的数据修改体验：

• 智能深层提取 (Extract)：在“资源管理”主面板找到待汉化插件，点击。引擎会瞬间将深埋在逻辑流和前端框架里的展示文本剥离出来。
• 行内光速直写 (Inline Editing)：跳出繁琐的保存弹窗。点进右侧的“译文”单元格，打入中文，光标移开即刻自动保存录入，如同使用最现代的在线表格工具。
• 多维检索引擎：遇到包含上千行配置词条的庞然大物，利用上方顶部的全息搜索框，输入生词，即可穿透 节点类型 / 变量名称 / 原文 / 译文 瞬间锁定，同时使用下拉框可一键筛出“未翻译 (Untranslated)”项目进行突击攻坚。

2. 高并发机器翻译驱动 (AI Translation)

让大模型接管那千篇一律的体力劳动！

• 高并发批量翻译 (Batch)：前往编辑器的“Ai 语言模型面板”，针对海量的剩余英文字符，输入您偏好的处理“并发数”与“批次条目数”，点击翻译后，优雅地看着实时进度条拉满即可。
• 账单防刺客估价 (Token Estimation)：全网首创打消恐惧。在点击前，系统会通过底层试探立刻在面板告之：本次翻译将预计耗费您多少 Token 数，折算合共多少金额（例如 ≈ ¥0.15）！
• 本地化记忆缓存体系 (Memory Cache)：诸如 Settings, Cancel 这类 UI 词汇全靠重复利用。只要底层识别到该词曾经被您翻译过，它会主动在本地强硬阻断向上游 API 发出的扣款请求，实现零延迟、零费用的“秒翻”投喂。

3. 译文工作区统御与生态 (Workspace)

• 非破坏性注入 (Apply / Restore)：一键点击“应用”，译文数据将映射到底层文件。不用担心弄坏源文件，若遇报错崩溃插件失灵，立刻点击 “还原 (Restore)” 即可无损回滚至原始母语状态。
• 资源库生态 (Export / Import)：除了独善其身，更可兼济天下。点击“批量导出”生成轻小体积的汉化包 JSON 文件分享给群友；抑或是拿到社区大佬打磨的语料库并点击“导入译文”，一瞬融入您自己的专属知识库构建全中文语境。

---

❓ 常见问题排错 (FAQ)

Q1: 测试连接失败或翻译完全无进度？

• 首先通过设置页“立即测试”进行深度诊断。
• 若提示 401 请检查 API 密钥中的隐藏空格。若提示 429 则表示并发过高被厂商熔断或金额耗尽。
• 提示网络超时：如果是 OpenAI 等受限接口，请自备全局代理或更换为国内转发代理接口。

Q2: 提示 "插件重载失败/JavaScript 修订损坏"

如果在手动录入过程中，不小心误删除了源文中诸如 ${变量} 或 \n 之类属于代码范畴的控制符。应用后即会触发报错。请返回主界面狠狠点击 “还原 (Restore)” 按钮，系统会基于快照瞬间帮其秽土转生。

---

参与支持与鸣谢 (Support & Thanks)

每一个优雅特性的背后，都凝结着榨干最后业余时间的挣扎尝试。如果这款工具切实帮到了你的痛点，不妨让我们在虚拟的另一端感受到一点这实打实的回馈：

• 前往 爱发电 (Afdian) 请作者喝杯咖啡吧
• 您的每一次充电，都是支持我们在深夜继续死磕前沿解析方案的精神氮泵。我们会在插件内部置顶展出**「爱发电金主」**们的 ID 与徽章以作表彰！

如果您发现了任何稀奇古怪的 Bug、未兼容的目标插件或是提出脑洞大开的需求，请带上含有控制台错误截图的红字，前往 GitHub Issues 毫无保留地向我们开炮！