添加 翻译插件服务配置文档，更新magic文档 (#331)

* 添加 翻译插件服务配置文档，更新magic文档

* 添加百度，阿里等国内常用翻译引擎

* 更新magic文档，添加视频及教程链接

---------

Co-authored-by: Northword <[email protected]>

.github/CODEOWNERS

@@ -27,10 +27,11 @@ user-guide/                              @zotero-chinese/document-maintainer
 user-guide/plugins/style.md              @Chikit-L
 user-guide/plugins/zotero-gpt.md         @Chikit-L
 user-guide/plugins/zotero-scihub.md      @Chikit-L
-user-guide/plugins/translate.md          @windingwind
+user-guide/plugins/translate/            @windingwind
 user-guide/plugins/better-notes.md       @windingwind
 user-guide/plugins/linter.md             @northword
 user-guide/plugins/jasminum.md           @l0o0
+user-guide/plugins/magic.md              @l0o0
 user-guide/faqs/update-translators.md    @Chikit-L @jiaojiaodubai @wakewon
 user-guide/faqs/word-addon.md            @northword @wakewon
 user-guide/faqs/plugins.md               @wakewon @jiaojiaodubai

.vitepress/sidebar.ts

@@ -85,9 +85,22 @@ export const sidebar = {
         { text: "Easier Citation", link: "/user-guide/plugins/easier-citation" },
         { text: "茉莉花", link: "/user-guide/plugins/jasminum" },
         { text: "Linter", link: "/user-guide/plugins/linter" },
-        { text: "Magic", link: "/user-guide/plugins/magic" },
+        { text: "Magic 全文翻译", link: "/user-guide/plugins/magic" },
         { text: "Style", link: "/user-guide/plugins/style" },
-        { text: "翻译", link: "/user-guide/plugins/translate" },
+        {
+          text: "翻译插件",
+          collapsed: true,
+          items: [
+            { text: "插件介绍", link: "/user-guide/plugins/translate/index" },
+            { text: "接口申请：阿里", link: "/user-guide/plugins/translate/aliyun" },
+            { text: "接口申请：百度", link: "/user-guide/plugins/translate/baidu" },
+            { text: "接口申请：火山", link: "/user-guide/plugins/translate/volcengine" },
+            { text: "接口申请：腾讯", link: "/user-guide/plugins/translate/tencent" },
+            { text: "接口申请：微软", link: "/user-guide/plugins/translate/microsoft" },
+            { text: "接口申请：小牛", link: "/user-guide/plugins/translate/niutrans" },
+            // { text: "常见问题", link: "/user-guide/plugins/translate/faqs" },
+          ],
+        },
         { text: "Awesome GPT", link: "/user-guide/plugins/zotero-gpt" },
         { text: "SCI Hub", link: "/user-guide/plugins/zotero-scihub" },
         { text: "蒲公英", link: "/user-guide/plugins/tara" },

user-guide/plugins/magic.md

@@ -1,7 +1,27 @@
 # Magic for Zotero
 
-::: info Todo
+Magic for Zotero 是一款付费的全文翻译插件，不过你可以免费七天[全功能试用](https://magiczotero.feishu.cn/wiki/T45PwelQai7e1wkvGMNcXMIZnFe?fromScene=spaceOverview)。
 
-见：<https://wiki.magiczotero.top/>
+## 视频资料
 
-:::
+### 简单介绍
+
+<!-- markdownlint-disable -->
+<div style="display: flex; justify-content: center;">
+    <iframe src="//player.bilibili.com/player.html?isOutside=true&aid=113129220479633&bvid=BV1yK4be1EeP&cid=25843467371&p=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" style="width: 640px; height: 360px;"></iframe>
+</div>
+<!-- markdownlint-enable -->
+
+### 详细视频说明
+
+<!-- markdownlint-disable -->
+<div style="display: flex; justify-content: center;">
+    <iframe src="//player.bilibili.com/player.html?isOutside=true&aid=113537192101298&bvid=BV1opBxYqEj2&cid=26959875660&p=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" style="width: 640px; height: 360px;"></iframe>
+</div>
+<!-- markdownlint-enable -->
+
+以上视频转载自 B 站 UP 主：[想给星星取名字](https://space.bilibili.com/36192808)。
+
+## 使用文档
+
+详细使用文档请参考：[Magic for Zotero 文档](https://magiczotero.feishu.cn/wiki/X1hbwUoWtiI9Ybk7zIpcmgnHnIe?fromScene=spaceOverview)。

user-guide/plugins/translate/aliyun.md

@@ -0,0 +1,62 @@
+# 阿里翻译接口申请及配置
+
+## 1. 翻译接口申请
+
+打开 [阿里翻译](https://www.aliyun.com/product/ai/alimt?spm=5176.19720258.J_8058803260.278.e9392c4a5eczxp) 页面，点击立即开通，在登录页面，使用支付宝扫码登录。
+
+::: tip
+
+注意，如果第一次开通，可能会提示你需要进行实名认证，按照提示进行认证即可。
+
+:::
+
+![开通页面](../../../assets/images/zotero-plugin-translate/aliyun-1.png)
+
+使用支付宝扫码登录：
+
+![扫码页面](../../../assets/images/zotero-plugin-translate/aliyun-2.png)
+
+扫码成功后，跳转到控制台（如果未跳转到控制台，请访问），分别有两个接口，按照需求进行开通：
+
+1. 通用版，支持全球 214 种语言互译，采用最先进的神经网络翻译模型，适用于日常沟通、出国旅行等应用场景。
+2. 专业版，电商、社交、医疗 3 大领域积累千万级双语语料和百万专业领域双语术语，推出多个专业领域翻译引擎。
+
+![通用版与专业版](../../../assets/images/zotero-plugin-translate/aliyun-3.png)
+
+下面以专业版为例，直接点击立即开通：
+
+![申请开通](../../../assets/images/zotero-plugin-translate/aliyun-4.png)
+
+![开通完成](../../../assets/images/zotero-plugin-translate/aliyun-5.png)
+
+你可以在 [控制台 - 服务开通与管理](https://mt.console.aliyun.com/service) 里查看已开通的服务：
+
+![查看服务](../../../assets/images/zotero-plugin-translate/aliyun-6.png)
+
+把鼠标移动到右上角，点击下面的 AccessKey 管理：
+
+![获取密钥](../../../assets/images/zotero-plugin-translate/aliyun-7.png)
+
+点击继续使用 AccessKey：
+
+![子账户开通提示，可以不必开通](../../../assets/images/zotero-plugin-translate/aliyun-8.png)
+
+如果后面忘记了 AccessKey 或发生泄露，可以重新在这申请一个新的：
+
+![下载密钥](../../../assets/images/zotero-plugin-translate/aliyun-9.png)
+
+## 2. Zotero 翻译引擎设置
+
+打开「Zotero 设置」，转到「翻译」选项卡，在「翻译服务」里选择「阿里」，按照 `AccessKey ID#AccessKey Secret` 格式，输入到「密钥」中。注意这里的 `AccessKey ID` 和 `AccessKey Secret` 从你上面下载的 csv 文件里查看。
+
+![翻译插件设置窗口](../../../assets/images/zotero-plugin-translate/aliyun-10.png)
+
+打开一篇英文 PDF，使用阿里的引擎，试试划词翻译正常不。有中文输出说明配置正常。
+
+![测试配置是否成功](../../../assets/images/zotero-plugin-translate/aliyun-11.png)
+
+## 3. 翻译使用量查看
+
+阿里云的翻译流量会每月更新，请不要超过每月的使用额度，不然会自动产生扣费。免费额度快用光了，请切换到其他引擎，查看具体的使用量，到 [控制台 - 监控统计](https://mt.console.aliyun.com/monitor) 查看。
+
+![翻译使用量查看](../../../assets/images/zotero-plugin-translate/aliyun-12.png)

user-guide/plugins/translate/baidu.md

@@ -0,0 +1,119 @@
+# 百度翻译接口申请和配置
+
+百度翻译和垂直领域翻译免费额度：
+
+- [通用翻译](https://fanyi-api.baidu.com/product/111)：完成个人认证可升级使用高级版服务，提供基础文本翻译服务，支持自定义术语翻译功能。**每月 100 万字符免费**，QPS 为 10，单次最长请求 6000 字符，支持 28 个常见语种。
+- [垂直领域翻译](https://fanyi-api.baidu.com/product/12): 开通并认证后，即享**每月 50 万免费字符**。目前已开通学术论文、生物医药、信息技术、金融财经、机械制造、网络文学（仅支持中英）、新闻资讯、人文社科（仅支持中英）、航空航天、法律法规、合同共 11 个垂直领域。
+
+以上接口，超出部分按 49 元/百万字符计费，垂直领域接口申请成功后的提示：高级版是每月 100W 字符。
+
+## 1. 账号注册
+
+直接访问 [https://fanyi-api.baidu.com/product/11](https://fanyi-api.baidu.com/product/11)，如果未登录，点击右上角登录。没百度账号的同学，就直接新注册一个。
+
+![登录按钮](../../../assets/images/zotero-plugin-translate/baidu-3.png)
+
+网页上直接列出了通用文本翻译和领域翻译，这两个就是常说的百度翻译和百度垂直领域翻译。这两个的区别是：
+
+- 免费额度不同，垂直领域相比通用文本翻译免费额度少，每月只有 50W
+- 精细度不同。为了提升特定领域机器翻译的准确度，百度翻译针对多个垂直领域模型进行了优化，特定领域术语翻译相较于通用文本翻译 API 结果更为准确，句式更加符合该行业特点。
+
+目前已开通科技电子、水利机械、生物医药等 3 个垂直领域，不过只有生物医药支持中英互译，剩下两个只支持中文到英文。建议生物医药相关专业的同学，可以试试使用垂直领域翻译接口。
+
+访问 [https://fanyi-api.baidu.com/product/11](https://fanyi-api.baidu.com/product/11)，直接点击下方立即使用：
+
+![开通通用文本翻译API](../../../assets/images/zotero-plugin-translate/baidu-4.png)
+
+点击之后可能出现验证（手机或实名制认证），请按照说明进行验证，提升免费额度。
+
+![实名认证窗口](../../../assets/images/zotero-plugin-translate/baidu-5.png)
+
+然后需要注册成为百度翻译开发者，请选择个人开发者，并如实填下方表格中的信息。
+
+![个人开发者注册表格](../../../assets/images/zotero-plugin-translate/baidu-6.png)
+
+选择下方高级版，每月 100W 免费额度。
+
+![选择高级版](../../../assets/images/zotero-plugin-translate/baidu-7.png)
+
+## 2. 百度翻译（通用文本翻译）接口申请
+
+访问 [https://fanyi-api.baidu.com/choose](https://fanyi-api.baidu.com/choose) ，选择通用文本翻译，点下一步：
+
+![通用文本翻译API开通](../../../assets/images/zotero-plugin-translate/baidu-8.png)
+
+![开通高级版](../../../assets/images/zotero-plugin-translate/baidu-9.png)
+
+![申请认证](../../../assets/images/zotero-plugin-translate/baidu-10.png)
+
+应用名称是必填的，其他随意写。最后点击提交申请。
+
+![提交申请](../../../assets/images/zotero-plugin-translate/baidu-11.png)
+
+![开通成功后的个人页面](../../../assets/images/zotero-plugin-translate/baidu-12.png)
+
+上图是开通成功后的页面。
+
+## 3. 百度垂直领域（领域翻译）接口申请
+
+打开这个网页 [https://fanyi-api.baidu.com/choose](https://fanyi-api.baidu.com/choose)，选择领域翻译，点下一步：
+
+![垂直领域翻译接口开通](../../../assets/images/zotero-plugin-translate/baidu-13.png)
+
+![申请表格](../../../assets/images/zotero-plugin-translate/baidu-14.png)
+
+![垂直领域翻译接口开通成功后的个人页面](../../../assets/images/zotero-plugin-translate/baidu-15.png)
+
+[https://fanyi-api.baidu.com/api/trans/product/desktop?req=field](https://fanyi-api.baidu.com/api/trans/product/desktop?req=field) 垂直领域的后台界面，上面有对应的使用明细。
+
+## 4. 接口密钥查询
+
+打开 [https://fanyi-api.baidu.com/api/trans/product/desktop](https://fanyi-api.baidu.com/api/trans/product/desktop)，可以在最下面看到配置使用的 APP ID 和密钥。
+
+![接口密钥查看页面](../../../assets/images/zotero-plugin-translate/baidu-16.png)
+
+垂直领域翻译还需要一个领域参数，具体领域信息如下：
+
+| 支持传入值 | 描述         | 支持语言方向                          |
+| ---------- | ------------ | ------------------------------------- |
+| it         | 信息技术领域 | 中文（简）-> 英语、英语 -> 中文（简） |
+| finance    | 金融财经领域 | 中文（简）-> 英语、英语 -> 中文（简） |
+| machinery  | 机械制造领域 | 中文（简）-> 英语、英语 -> 中文（简） |
+| senimed    | 生物医药领域 | 中文（简）-> 英语、英语 -> 中文（简） |
+| novel      | 网络文学领域 | 中文（简）-> 英语                     |
+| academic   | 学术论文领域 | 中文（简）-> 英语、英语 -> 中文（简） |
+| aerospace  | 航空航天领域 | 中文（简）-> 英语、英语 -> 中文（简） |
+| wiki       | 人文社科领域 | 中文（简）-> 英语                     |
+| news       | 新闻资讯领域 | 中文（简）-> 英语、英语 -> 中文（简） |
+| law        | 法律法规领域 | 中文（简）-> 英语、英语 -> 中文（简） |
+| contract   | 合同领域     | 中文（简）-> 英语、英语 -> 中文（简） |
+
+以上信息参考 [百度开发文档](https://fanyi-api.baidu.com/product/123)。
+
+这里假设我申请到的 APP ID 为 `12345`，密钥为 `abcde`，选择生物医药领域为 `medicine`。介绍如何在 Zotero 翻译插件中设置。
+
+### 4.1 百度翻译设置
+
+![翻译插件设置窗口](../../../assets/images/zotero-plugin-translate/baidu-18.png)
+
+提示窗口点 OK：
+
+![弹窗提示](../../../assets/images/zotero-plugin-translate/baidu-19.png)
+
+![密钥填写处](../../../assets/images/zotero-plugin-translate/baidu-20.png)
+
+这里填入 `12345#abcde`。
+
+### 4.2 百度垂直领域（领域翻译）设置
+
+![垂直领域密钥设置窗口](../../../assets/images/zotero-plugin-translate/baidu-21.png)
+
+![密钥填写处](../../../assets/images/zotero-plugin-translate/baidu-22.png)
+
+密钥处填入 `12345#abcde#medicine`。
+
+## 5. 接口测试
+
+这里以百度垂直领域引擎为例进行测试，在 Zotero 中打开一篇英文 PDF，划词翻译，如下图正常翻译，就说明配置正常。
+
+![配置翻译服务](../../../assets/images/zotero-plugin-translate/baidu-23.png)

user-guide/plugins/translate/index.md

@@ -0,0 +1,43 @@
+# Translate for Zotero
+
+::: tip
+
+深度适配 Zotero 阅读器的翻译插件。
+
+:::
+
+- 项目主页：[https://github.com/windingwind/zotero-pdf-translate](https://github.com/windingwind/zotero-pdf-translate)
+- 下载地址：
+  - [GitHub Release](https://github.com/windingwind/zotero-pdf-translate/releases)
+  - [Zotero 中文社区插件商店](https://zotero-chinese.com/plugins/#search=translate)
+
+Zotero PDF Translate 是由 @windingwind 开发的，用于文献管理软件 Zotero 的翻译插件。它完全开源、免费，主要功能有：
+
+- 划词翻译（自动/手动）
+- 标题、摘要翻译与源文本/翻译结果显示切换
+- 批注翻译（自动/手动）
+- 支持 15+ 种翻译服务与 4+ 种字典服务
+- 自定义翻译侧栏 UI，支持同时使用多种翻译引擎
+
+插件深度集成了 Zotero 文献阅读功能。
+
+## 国内常用翻译引擎
+
+我们收集整理了一些国内常用的翻译引擎，这些带密钥的翻译引擎，同知网，海词等相比，更加稳定，大批量和频繁使用时不容易出错。
+
+| 引擎名称     | 免费额度                                             | 参考文档                                                           | 备注                                                                  |
+| ------------ | ---------------------------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------- |
+| 小牛翻译     | 新注册获得 100W，用完为止                            | [小牛翻译接口申请及配置](/user-guide/plugins/translate/niutrans)   | 免费用户 QPS=5，字段长度最大为 5000                                   |
+| 百度翻译     | 每月免费 100W                                        | [百度翻译接口申请和配置](/user-guide/plugins/translate/baidu)      | QPS=10，超出部分 49 元/百万字符                                       |
+| 百度垂直领域 | 每月免费 50W                                         | [百度翻译接口申请和配置](/user-guide/plugins/translate/baidu)      | 对生物医药领域有优化 QPS=10                                           |
+| 腾讯翻译     | 每月免费 500W                                        | [腾讯翻译接口申请和配置](/user-guide/plugins/translate/tencent)    | 每月免费额度非常多 QPS=5，翻译太快，容易报错，超出部分 58 元/百万字符 |
+| 彩云小译     | 新用户注册会获得 100 万字的免费翻译额度,有效期一个月 |                                                                    | 39 元/百万字符                                                        |
+| 火山翻译     | 每月免费 200 万字符流量                              | [火山翻译接口申请及配置](/user-guide/plugins/translate/volcengine) | QPS=10，超出部分 49 元/百万字符                                       |
+| 阿里翻译     | 每月免费 100 万字符流量                              | [阿里翻译接口申请及配置](/user-guide/plugins/translate/aliyun)     | QPS=50，超出部分 50 元/百万字符                                       |
+| 微软翻译     | 每月免费 200W 流量（新用户前 12 个月才有）           | [微软翻译接口申请及配置](/user-guide/plugins/translate/microsoft)  | 超出部分 10 美元/百万字符                                             |
+
+::: tip
+
+如果你使用科学上网，可以试试直接使用谷歌（Google）翻译服务。
+
+:::