Zotero ChatGPT插件开发指南：从零构建文献管理AI助手

11次阅读

共计 1586 个字符，预计需要花费 4 分钟才能阅读完成。

开发环境配置
安装 Node.js（建议 v16+）和 npm
下载 Zotero 开发者插件模板（可通过 git clone https://github.com/zotero/zotero-plugin-template 获取）
安装必要依赖：npm install -D @zotero/types web-ext
SDK 核心模块解析
Zotero.Item：文献条目操作核心类
Zotero.Translate：支持文献元数据抓取
Zotero.HTTP：内置网络请求工具

REST API 直接调用

async function queryChatGPT(prompt) {
  const response = await Zotero.HTTP.request(
    'POST',
    'https://api.openai.com/v1/chat/completions',
    {
      headers: {'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        model: "gpt-3.5-turbo",
        messages: [{role: "user", content: prompt}]
      })
    }
  );
  return JSON.parse(response.responseText);
}

SDK 封装方案对比
官方 openai 包（推荐）：npm install openai
第三方 wrapper：如chatgpt-api

文献元数据处理

function getSelectedItems() {const items = Zotero.getActiveZoteroPane()
    .getSelectedItems();
  return items.map(item => ({title: item.getField('title'),
    authors: item.getCreators()
      .map(c => `${c.lastName}, ${c.firstName}`),
    abstract: item.getField('abstractNote')
  }));
}

Prompt 工程示例

function buildSummaryPrompt(item) {
  return ` 请用中文为以下学术文献生成摘要：\n\n` +
    ` 标题: ${item.title}\n` +
    ` 作者: ${item.authors.join(';')}\n` +
    ` 摘要原文: ${item.abstract || '无'}`;
}

缓存机制实现

const cache = new Map();

async function getCachedResponse(prompt) {if(cache.has(prompt)) {return cache.get(prompt);
  }
  const response = await queryChatGPT(prompt);
  cache.set(prompt, response);
  return response;
}