【教程】linux和windows环境下使用onedrive实现zotero云同步

一、linux onedrive安装及配置

这里只给出linux的，windows直接傻瓜操作安装登录即可。

由于财大气粗的微软大哥并没有给出linux的onedrive官方客户端，因此linux这里稍微曲折一些

1.1 安装

• 添加源

# 添加第三方源
wget -qO - https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_24.04/Release.key | gpg --dearmor | sudo tee /usr/share/keyrings/obs-onedrive.gpg > /dev/null

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/obs-onedrive.gpg] https://download.opensuse.org/repositories/home:/npreining:/debian-ubuntu-onedrive/xUbuntu_24.04/ ./" | sudo tee /etc/apt/sources.list.d/onedrive.list

• 安装

sudo apt-get update && sudo apt-get install onedrive

1.2 配置

• 启动

onedrive

之后终端上将给出一个访问链接，使用浏览器打开并登陆你的微软账户，将登陆后的跳转链接复制下来粘贴到终端上，回车确认。

• 同步

onedrive --sync

如果你的onedrive内容较多，这里会比较慢

• 配置自启动

systemctl --user enable onedrive
systemctl --user start onedrive
systemctl --user status onedrive

• 创建zotero同步文件夹

mkdir -p ~/OneDrive/Zotero_Storage

二、linux Zotero安装

• 官网下载：https://www.zotero.org/
• 解压

tar -xJvf Zotero-8.0.4_linux-x86_64.tar.xz

sudo mv Zotero_linux-x86_64 /opt/zotero

• 配置图标

sudo /opt/zotero/set_launcher_icon
ln -s /opt/zotero/zotero.desktop ~/.local/share/applications/zotero.desktop

三、windows Zotero安装

官网下载：https://www.zotero.org/

安装即可，不赘述。

四、翻译插件

4.1 安装插件

下载Zotero pdf翻译插件

https://github.com/windingwind/zotero-pdf-translate

选择最新的release,下载xpi格式的文件

tools -> Plugins ->setting -> "install Plugin from file"

选择xpi文件。

4.2 配置api

zotero-pdf-translate默认支持google，bing等工具进行翻译，还可以手动配置api key使用大模型进行翻译，这里我以deepseek为例。

Edit --> settings --> Translat --> Service

Translation Services选择ChatGPT,Secret输入deepseek api key

点击config,进行细化配置。

API: https://api.deepseek.com/chat/completions
Model: deepseek-chat
Temp: 0.2
Prompt:

	作为精通软件工程、具身智能与矿山自动化领域的学术顶级专家，请将以下学术文本从 ${langFrom} 翻译为流畅严谨的 ${langTo}。

翻译要求：
1. 准确传达专业术语。如遇到前沿的专有名词（如 World Models, ACT, Sim-to-Real 等）在中文语境下尚无标准定译，请直接保留英文。
2. 译文必须符合顶级学术期刊的表达习惯，长难句要符合中文逻辑，拒绝生硬的机翻味。

需要翻译的文本如下：
"""
${sourceText}
"""

请直接输出翻译结果，绝不要包含任何额外的解释、问候语或代码块符号。

Stream: 勾选

五、跨平台同步

这里windows和linux操作基本一致，不一致的地方我会单独说明。

登录并取消文件同步

5.1 windows

删除C盘下自动生成storage文件夹

C:\Users\用户名\Zotero\storage

确定你的onedrive下同步文件夹路径，创建链接

mklink /D "C:\Users\用户名\Zotero\storage" "C:\Users\用户名\OneDrive\Zotero_Storage"

5.2 linux

删除自动生成storage文件夹

rm -rf ~/Zotero/storage

创建软连接

ln -snf ~/OneDrive/Zotero_Storage ~/Zotero/storage

重启onedrive服务

systemctl --user restart onedrive

六、配置mcp

官方目前没有出mcp,但是民间大神有啊:https://github.com/54yyyu/zotero-mcp

简单记录一下使用方法(这里我主力是codex,其他agent方法相同).

• 启动zotero,edit -> settings -> advanced -> allow other...
  • 勾选后zotero启动后将在本地23119端口开发api,供外部软件调用

• 通过uv安装zotero mcp

uv tool install zotero-mcp-server
uv tool install --force "zotero-mcp-server[semantic]"

• codex全局配置

codex mcp add zotero --env ZOTERO_LOCAL=true -- zotero-mcp

# codex验证
codex mcp list

之后codex就可以肆无忌惮的访问你的zotero了