【第三方插件】Instant AI Translator — 即时 AI 翻译
在 MarginNote 中划词即译：AI 翻译、AI 单词解释、词典查询与发音，一站式搞定阅读中的语言障碍。
最新版本：v0.7.6 ｜ 最低支持：MarginNote 4.2.3 ｜ 作者：ChuanLchuan
插件下载：instant-ai-translator-v0.7.6.mnaddon (148.9 KB)
一、功能简介
| 功能 | 说明 |
|---|---|
| 划词即译 | 在阅读/笔记中选中文字，自动弹出翻译卡片，无需任何额外操作 |
| AI 翻译 | 单词、句子、段落均可翻译，支持 5 种目标语言（简中 / 繁中 / 英 / 日 / 韩） |
| AI 解释 | 单词深度解析：音标、释义、常用词组、例句（带翻译）、相关词汇、词根词缀分析，Markdown 结构化呈现 |
| 词典查询 | 单词快速查词，支持有道 / 必应 / 海词 / 金山词霸四本词典，也可直接改用 AI 解释 |
| 机器翻译 | 新增支持百度、阿里、腾讯、火山、小牛等机器翻译服务，可作 AI 翻译的补充或备用 |
| 发音朗读 | 美式 / 英式口音可选；查词自动发音；AI 解释后也可自动朗读 |
| 打字机效果 | 翻译 / 解释结果逐字显示，阅读体验更流畅（可关闭） |
| 搜索与历史 | 内置搜索框，可快捷查询单词或句子；自动保存历史记录（可设置保存数量），便于回顾 |
| 重新生成 | 点击可让 AI 重新翻译或解释；长按可快速切换模型重新生成 |
| 查词切换 | 工具栏一键切换查词服务（词典 / AI 解释），适应不同查询需求 |
| 添加卡片 | 一键将查词或翻译结果保存为 MarginNote 卡片，支持自定义卡片颜色 |
| 上下文支持 | 在 Prompt 中使用 {context} 变量，可获取当前页面单词首次出现位置的上下文，提升翻译精准度 |
| 图钉固定 | 点击图钉按钮可将卡片固定在屏幕任意位置，取消则点击卡片外自动关闭 |
| 配置导入/导出 | 支持导出/导入插件配置，方便多设备同步 |
| 双击复制 | 双击结果卡片任意位置自动复制内容 |
二、支持的 AI 模型及机器翻译
基于 OpenAI Chat Completions 兼容协议，内置主流提供商，开箱即用：
- OpenAI
- DeepSeek
- Kimi（Moonshot）
- 智谱 GLM
- 阿里云百炼 Qwen
- SiliconFlow
- Ollama Cloud
- 蚂蚁百灵
也可以填写任意兼容 Base URL，接入自建或其他服务。
关闭思考模式可显著加快响应。
模型路由：翻译和 AI 解释可以分别指定不同的提供商与模型。
机器翻译服务：支持百度、阿里、腾讯、火山、小牛等，服务开通方法见此处。
三、安装方法
- 下载最新版安装包
instant-ai-translator-vX.X.X.mnaddon； - MarginNote主页“三条杠” \rightarrow 插件 \rightarrow 导入。（可能需要先在设置中开启“允许加载未经认证的插件”）
四、快速开始（3 步）
- 打开设置面板：IAT→ 设置；
- 添加提供商：选择一个预设提供商（如 DeepSeek / OpenAI），填入你的 API Key 即可；也可自定义 Base URL；
- 选择模型：在"模型路由"里为「翻译」和「AI 解释」分别选好模型，开始使用。
如需使用机器翻译，在设置中开启并填入对应服务的密钥即可。
五、日常使用
- 翻译：划选任意文本 → 卡片自动显示 AI 翻译结果；
- 查词：划选单个单词 → 默认走词典查询（设置里可改为 AI 解释；设置“设置触发翻译的单词数”后可查询词组；点击工具栏左侧的“三条杠”可快速切换查词服务；点击机器人按钮可快速切换AI解释）；
- 发音：点击结果中的
美 / 英 按钮朗读；设置"查词自动发音"后划词即读； - 卡片操作：拖拽标题栏移动，拖右下角缩放，双击卡片复制内容，点击图钉固定，随时关闭；
- 历史与搜索：点击搜索图标可快速查词或查看历史记录；
- 重新生成：点击结果区的刷新按钮让 AI 重新生成；长按该按钮可切换模型；
- 添加卡片：点击卡片上的“+”按钮，将当前结果保存为 MarginNote 卡片（颜色可在设置中预设）。
六、常用设置一览
| 设置项 | 说明 |
|---|---|
| 目标语言 | 翻译输出语言（简中 / 繁中 / 英 / 日 / 韩） |
| 查词服务 | 有道 / 必应 / 海词 / 金山词霸 / AI 解释 |
| 发音口音 | 美式 / 英式 |
| 打字机效果 | 结果逐字显示开关 |
| 结果字号 | 小 / 中 / 大三档 |
| 主题 | 浅色 / 深色 |
| AI 解释模板 | 可自定义输出格式（支持 {text}、{context} 占位符），一键恢复默认 |
| 触发翻译的单词数 | 仅当选中单词数大于设定值时触发翻译，便于查词组短语 |
| 卡片颜色 | 预设添加卡片时的默认颜色 |
| 历史记录数量 | 设置保存的查询记录条数 |
| 配置导入/导出 | 一键备份或恢复所有设置，方便多设备同步 |
七、隐私说明
- 你的 API Key 仅保存在本机（MarginNote 插件数据目录），不上传任何第三方服务器；
- 翻译 / 查词文本仅发送到你自行配置的 AI 提供商或词典服务；
- 插件完全开源，可自行审查代码。
八、其他
- 之前因为用 Translate for Zotero 很顺手，所以用 AI 复刻了这个插件到 MN。
- 本插件开发完全由 AI 完成，Kimi K3 完成初版开发，DeepSeek 完成细节修改。本人完全是编程小白，后续如果有什么问题和建议，我会尽力和 AI 沟通改进。
欢迎大家尝试使用！
更新日志
2026-8-20 v0.7.6
体验优化
1. 优化AI服务商设置页的排版，并支持手动排序，会同步更新到长按”重新生成“按钮时出现的模型列表。
2. 优化单词制卡的排版。
3. 修复点击脑图空白处时重复出现的弹窗。
4. 修复连续查询同一单词，查词失败的问题。
2026-8-15 v0.7.6
体验优化
1. 修复AI解释制卡时，排版混乱的问题。
2026-8-15 v0.7.5
新功能
1. 新增{context}变量，可在prompt使用，用于获取上下文。（上下文会定位到当前页面单词首次出现的位置）
2. 新增支持选中摘录内容进行查词/翻译。（插件会优先识别标题）
3. 新增“添加卡片”功能，可一键将查词/翻译结果保存为卡片。设置中可设定卡片颜色。
4. 新增“触发翻译的单词数”设置项，只在选中单词数大于设定值时触发翻译。现在可以查词组短语了。
1. 修复点击脑图空白区无法关闭卡片的问题。
2026-8-14 v0.7.4
体验优化
1. 机器翻译结果适配打字机效果。
2. 卡片高度可随打字机效果逐渐增大。
2026-8-12 v0.7.2
新功能
1. 新增查词服务——金山词霸。
体验优化1. AI服务测试可以显示延迟信息。
2. 必应、海词、金山查词结果按词性归类。
3. AI 翻译预置 prompt 更新。
4. 移除「固定图钉位置」设置项，开启图钉后默认不再更随划词位置。
2026-8-12 v0.7.1
体验优化
1. 修复使用手指、Apple Pencil长按“重新生成”按钮时，无法显示模型列表的问题。
2026-8-11 v0.7.0
新功能1. 新增搜索功能，可以快捷搜索查词。
2. 新增历史记录功能，可以查看历史查过的单词，翻译过的句子。设置中可设置保存数量。
3. 新增“重新生成”按钮，点击可让AI重新生成，长按可切换模型重新生成。
4. 新增查词快速切换按钮，点击工具栏最左侧的“三条杠”可切换查词服务和AI解释。
5. AI翻译和AI解释结果支持markdown公式渲染。
1. 将查词和AI翻译开关分开，可独立控制开启和关闭。
2. 移除工具栏复制按钮，改为在结果卡片内连击两次自动复制。
2026-8-11 v0.6.0
新功能1. 新增配置导入/导出功能，方便多设备用户同步配置。
2. 移除关闭按钮，点击卡片以外的地方，卡片自动关闭。同步增加“图钉”按钮，可以将卡片位置固定。
3. 新增、替换多个图标，插件风格更统一。
4. 默认prompt、卡片高度等小优化。
，不知道是不是塞给AI的提示词有点长，AI解释速度有点慢
已更新
哈哈哈，不客气，我也是小白啦，都是指挥AI干的