安装与连接
安装 Jadense in Zotero，连接攻玉账号或自有模型服务，在熟悉的文献阅读环境中开始 AI 协作。
Jadense in Zotero 将攻玉学术的 AI 能力带到 Zotero：阅读外文时翻译选段，理解论文时生成总结与批注，遇到复杂图片时直接提问，还能把文献导入攻玉学术继续整理。
第一次使用 Zotero？
可先阅读可选的 Zotero 介绍，了解文献库、PDF 阅读器和插件安装方式。已经熟悉 Zotero 的用户可以直接开始以下步骤。
安装插件
获取安装包
打开 Jadense in Zotero 插件详情页，按页面提供的下载或获取方式取得 .xpi 安装包，并确认它支持你正在使用的 Zotero 版本。
下载方式、兼容范围和版本说明以该页面为准。以下帮助按当前插件界面说明操作。
导入并启用
在 Zotero 菜单栏选择 工具 → 插件，点击齿轮图标，选择 Install Plugin From File…，打开下载的 .xpi 文件并确认安装。也可以将 .xpi 直接拖入插件管理窗口，这是 Zotero 官方提供的安装方式。
在列表中确认 Jadense in Zotero 处于启用状态；若出现重启提示，按提示重启 Zotero。
打开攻玉工作台
选择 工具 → Jadense → 打开攻玉工作台。看到 对话、翻译历史、文献解析、连接攻玉、上手指南 等入口，就可以开始配置。
选择 AI 接入方式
| 接入方式 | 适合你，如果…… | 如何开始 |
|---|---|---|
| 攻玉账号 | 希望直接选择攻玉提供的模型，并使用积分、签到和文献导入 | 按下方步骤连接账号 |
| 自有模型服务（BYOK） | 已有可用的 AI 服务地址、API 密钥与模型，希望继续使用自己的服务 | 前往 配置自有模型 |
BYOK 可独立用于 AI 功能；签到、查看攻玉积分和导入攻玉收藏夹仍需要连接攻玉账号。
连接攻玉账号
创建连接令牌
在插件中打开 连接攻玉 → 连接配置，点击 生成 / 更新令牌 前往攻玉网页端。登录后，进入 设置 → 集成 → 连接 Jadense in Zotero。
为连接填写便于识别的名称，例如“办公室 Zotero”，选择有效期，再点击 生成 Token。Token 是用于连接账号的授权令牌，网页只在创建成功后完整显示一次，请立即复制。
保存令牌并确认账号
回到插件的 连接配置，点击 攻玉令牌 旁的 编辑，粘贴令牌并点击 保存。随后打开 用户信息，确认显示的是你要使用的攻玉账号及订阅方案。
请妥善保管令牌，不要将它放入文献、对话或反馈截图中。需要更换电脑或停止授权时，可在攻玉的集成设置中管理连接。
选择模型并试用
点击工作台底部的设置图标，在 功能配置 中为所需功能选择可用模型。打开一篇本地 PDF，选中一段文字并点击 智能翻译；看到译文后，就完成了第一次使用。