Obsidian i18n排错清单10个常见问题的快速解决方案大全【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18nObsidian i18n 是一款专为 Obsidian 打造的插件国际化工具支持用 AST 编辑器和大模型 AI 批量汉化插件与主题。本文是一份 Obsidian i18n 排错清单按“安装 → AI 连接 → 提取翻译”的顺序整理了 10 个最常见的问题及快速解决方案帮你避开绝大多数汉化过程中的坑 ⚡一、安装类问题插件不见了或加载失败问题 1用 BRAT 安装后插件列表里看不到 I18N原因BRAT 只负责下载文件不会自动启用插件。解决方案到 Obsidian 的设置 → 第三方插件列表中找到I18N手动打开开关即可。问题 2手动安装后插件加载失败原因目录结构不对。手动安装对结构要求非常严格常见错误是压缩包多套了一层文件夹。解决方案确认解压后严格满足以下结构同时目录下必须同时存在main.js、manifest.json和styles.css文件夹名必须是i18n.obsidian/plugins/i18n/main.js .obsidian/plugins/i18n/manifest.json .obsidian/plugins/i18n/styles.css更多安装细节可参考 docs/help/troubleshooting.mdx 与 docs/help/faq.mdx。二、AI 连接类问题看懂 4 个常见错误码插件在设置 → 语言模型标签页内置了深度诊断功能点击“测试连接”会逐项检查接口、鉴权、模型、JSON 模式与真实翻译诊断逻辑见 src/utils/ai/connectivity-tester.ts报告弹窗见 src/settings/ui/diagnostic-modal.ts。遇到以下错误码时对照处理即可问题 3401 Unauthorized密钥无效原因API Key 无效或粘贴时带了前后空格。解决方案删除 Key 重新粘贴再执行一次测试。若提示401优先怀疑隐藏空格和 Key 过期。问题 4404 Not Found接口地址错误原因Base URL 写错了不是服务商要求的 API 根路径。解决方案检查接口地址是否填写正确。各服务商的默认地址和模型名可参考 docs/configuration/ai-providers.mdx。问题 5429 Too Many Requests被限流原因账号触发了频率限制或额度耗尽通常是并发开得太高。解决方案先调低编辑器 AI 面板中的并发数llmConcurrencyLimit再重试如果仍不行检查账户余额。问题 6Timeout 超时或 Network / SSL 错误解决方案分两种情况如果是AI 服务连接超时调高 AI 面板中的llmTimeout或换响应更快的模型 / 服务商如果是GitHub 资源下载报网络错误到综合设置 → 加速节点换一个可用的代理节点下拉里提供了多个直连与代理选项。节点选项说明见 docs/configuration/general-settings.mdx。三、提取与翻译类问题问题 7提取不到任何字符串原因插件与主题的提取机制不同各有各的依赖条件。解决方案插件AST 提取依赖目标插件目录里的main.js。如果main.js不存在比如插件没装完整提取不会生成结果。先检查插件安装是否完整或改用 Regex 模式排查主题当前主题提取器只读取theme.css里的/* settings */块。如果主题没有这个块或块内缺少name、title、description、label等字段就不会生成条目——这类主题目前无法提取属于已知限制。问题 8译文里的模板变量如${name}丢了原因手动录入或 AI 翻译时${变量}、\n等代码控制符被误删或改坏。解决方案在编辑器中搜索对应原文把缺失的占位符补回去。应用前务必确认变量、括号和转义字符完好——这一点非常重要直接关联下一个问题。问题 9点击应用后提示“插件重载失败”原因译文破坏了源文件语法目标插件加载崩溃。解决方案不用慌插件在应用前会自动创建备份应用失败时自动回滚到原始状态备份逻辑见 src/manager/backup-manager.ts你的源插件不会损坏。回到编辑器检查最近修改的译文行重点看问题 8 提到的占位符修好后重新应用即可。四、进阶问题问题 10本地导入译文失败原因导入文件格式不对。管理中心的导入入口优先对应管理导出的.i18n.gz归档文件如果你导入的是.json需要确认它来自旧版管理导出格式。解决方案优先使用官方导出的.i18n.gz文件旧版.json可能不被识别属于已知兼容范围问题。加分项插件更新后译文怎么办如果你已汉化的插件发布了新版本不必重新翻译。开启综合设置 → 智能更新automaticUpdate后插件启动时会检测目标插件的版本变化并自动把原有译文重新应用上去。注意该开关默认为关闭状态建议提前打开。总结排错顺序一张表症状快速对策参考装完看不到插件手动启用 I18Ndocs/help/troubleshooting.mdx加载失败检查目录结构是否为plugins/i18n/main.jsdocs/help/troubleshooting.mdx401 / 404 / 429查 Key 空格 / 查 Base URL / 降并发docs/configuration/ai-providers.mdx超时 / SSL 错误调高llmTimeout换加速节点docs/configuration/general-settings.mdx提取不到字符串检查main.js/ 主题settings块docs/help/troubleshooting.mdx应用后重载失败自动已回滚检查占位符后重试src/manager/backup-manager.ts按这份 Obsidian i18n 排错清单逐项对照绝大多数汉化问题都能在几分钟内定位解决。如果以上步骤都不能解决你的问题建议附上开发者控制台的错误信息到项目 Issues 区反馈。【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Obsidian i18n排错清单：10个常见问题的快速解决方案大全
Obsidian i18n排错清单10个常见问题的快速解决方案大全【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18nObsidian i18n 是一款专为 Obsidian 打造的插件国际化工具支持用 AST 编辑器和大模型 AI 批量汉化插件与主题。本文是一份 Obsidian i18n 排错清单按“安装 → AI 连接 → 提取翻译”的顺序整理了 10 个最常见的问题及快速解决方案帮你避开绝大多数汉化过程中的坑 ⚡一、安装类问题插件不见了或加载失败问题 1用 BRAT 安装后插件列表里看不到 I18N原因BRAT 只负责下载文件不会自动启用插件。解决方案到 Obsidian 的设置 → 第三方插件列表中找到I18N手动打开开关即可。问题 2手动安装后插件加载失败原因目录结构不对。手动安装对结构要求非常严格常见错误是压缩包多套了一层文件夹。解决方案确认解压后严格满足以下结构同时目录下必须同时存在main.js、manifest.json和styles.css文件夹名必须是i18n.obsidian/plugins/i18n/main.js .obsidian/plugins/i18n/manifest.json .obsidian/plugins/i18n/styles.css更多安装细节可参考 docs/help/troubleshooting.mdx 与 docs/help/faq.mdx。二、AI 连接类问题看懂 4 个常见错误码插件在设置 → 语言模型标签页内置了深度诊断功能点击“测试连接”会逐项检查接口、鉴权、模型、JSON 模式与真实翻译诊断逻辑见 src/utils/ai/connectivity-tester.ts报告弹窗见 src/settings/ui/diagnostic-modal.ts。遇到以下错误码时对照处理即可问题 3401 Unauthorized密钥无效原因API Key 无效或粘贴时带了前后空格。解决方案删除 Key 重新粘贴再执行一次测试。若提示401优先怀疑隐藏空格和 Key 过期。问题 4404 Not Found接口地址错误原因Base URL 写错了不是服务商要求的 API 根路径。解决方案检查接口地址是否填写正确。各服务商的默认地址和模型名可参考 docs/configuration/ai-providers.mdx。问题 5429 Too Many Requests被限流原因账号触发了频率限制或额度耗尽通常是并发开得太高。解决方案先调低编辑器 AI 面板中的并发数llmConcurrencyLimit再重试如果仍不行检查账户余额。问题 6Timeout 超时或 Network / SSL 错误解决方案分两种情况如果是AI 服务连接超时调高 AI 面板中的llmTimeout或换响应更快的模型 / 服务商如果是GitHub 资源下载报网络错误到综合设置 → 加速节点换一个可用的代理节点下拉里提供了多个直连与代理选项。节点选项说明见 docs/configuration/general-settings.mdx。三、提取与翻译类问题问题 7提取不到任何字符串原因插件与主题的提取机制不同各有各的依赖条件。解决方案插件AST 提取依赖目标插件目录里的main.js。如果main.js不存在比如插件没装完整提取不会生成结果。先检查插件安装是否完整或改用 Regex 模式排查主题当前主题提取器只读取theme.css里的/* settings */块。如果主题没有这个块或块内缺少name、title、description、label等字段就不会生成条目——这类主题目前无法提取属于已知限制。问题 8译文里的模板变量如${name}丢了原因手动录入或 AI 翻译时${变量}、\n等代码控制符被误删或改坏。解决方案在编辑器中搜索对应原文把缺失的占位符补回去。应用前务必确认变量、括号和转义字符完好——这一点非常重要直接关联下一个问题。问题 9点击应用后提示“插件重载失败”原因译文破坏了源文件语法目标插件加载崩溃。解决方案不用慌插件在应用前会自动创建备份应用失败时自动回滚到原始状态备份逻辑见 src/manager/backup-manager.ts你的源插件不会损坏。回到编辑器检查最近修改的译文行重点看问题 8 提到的占位符修好后重新应用即可。四、进阶问题问题 10本地导入译文失败原因导入文件格式不对。管理中心的导入入口优先对应管理导出的.i18n.gz归档文件如果你导入的是.json需要确认它来自旧版管理导出格式。解决方案优先使用官方导出的.i18n.gz文件旧版.json可能不被识别属于已知兼容范围问题。加分项插件更新后译文怎么办如果你已汉化的插件发布了新版本不必重新翻译。开启综合设置 → 智能更新automaticUpdate后插件启动时会检测目标插件的版本变化并自动把原有译文重新应用上去。注意该开关默认为关闭状态建议提前打开。总结排错顺序一张表症状快速对策参考装完看不到插件手动启用 I18Ndocs/help/troubleshooting.mdx加载失败检查目录结构是否为plugins/i18n/main.jsdocs/help/troubleshooting.mdx401 / 404 / 429查 Key 空格 / 查 Base URL / 降并发docs/configuration/ai-providers.mdx超时 / SSL 错误调高llmTimeout换加速节点docs/configuration/general-settings.mdx提取不到字符串检查main.js/ 主题settings块docs/help/troubleshooting.mdx应用后重载失败自动已回滚检查占位符后重试src/manager/backup-manager.ts按这份 Obsidian i18n 排错清单逐项对照绝大多数汉化问题都能在几分钟内定位解决。如果以上步骤都不能解决你的问题建议附上开发者控制台的错误信息到项目 Issues 区反馈。【免费下载链接】obsidian-i18n项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-i18n创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考