[Share] 多选条目后提取指定标签的注释生成一个笔记

[mulei000]

Description

脚本功能：从所有选中的条目中提取指定 PDF 附件内带有指定标签的注释（转换为 HTML），并将所有内容合并到一个新的独立笔记中。

Event

None

Operation

Script

Data

/**
 * 脚本功能：从所有选中的条目中提取指定 PDF 附件内带有指定标签的注释（转换为 HTML），
 * 并将所有内容合并到一个新的独立笔记中。
 *
 * 使用说明：
 * 1. 选择一个或多个条目后运行此脚本（使用传入的 items 或 item 变量）。
 * 2. 弹窗依次提示输入新笔记的标题和要提取的注释标签。
 * 3. 脚本会先自动删除每个条目中已生成的、包含指定标签的提取注释笔记。
 * 4. 然后遍历每个条目，提取其 PDF 附件中带有该标签的注释，并在前面加上条目标题作为分块标题。
 * 5. 最后将所有提取到的注释内容合并生成一个新的独立笔记，并弹窗显示处理结果。
 */

// 仅对所有选中项执行一次
if (item) return;

const Zotero = require("Zotero");
const window = require("window");
const console = require("console");

// 使用传入的 items 或 item 变量
let selectedItems = [];
if (typeof items !== "undefined" && items.length > 0) {
  selectedItems = items;
} else if (typeof item !== "undefined") {
  selectedItems = [item];
} else {
  window.alert("请先选择要处理的文献");
  return;
}

// 弹窗提示输入新笔记的标题
let noteTitle = window.prompt("请输入新笔记的标题：");
if (!noteTitle) {
  noteTitle = "合并注释";
}

// 弹窗提示输入需要提取的注释标签
let annotationTag = window.prompt("请输入需要提取的注释标签：");
if (!annotationTag) {
  window.alert("未输入注释标签，操作终止");
  return;
}

// 提示用户开始处理
window.alert(`开始处理 ${selectedItems.length} 个条目，请稍候...`);

/**
 * 删除每个条目中已生成的、包含指定注释标签的提取注释笔记
 * 删除条件：笔记内容以 <div data-citation-items 开头且包含 annotationTag
 * @param {Array<Zotero.Item>} items - 选中的条目数组
 */
async function deleteIndividualAnnotationNotes(items, annotationTag) {
  for (let item of items) {
    const noteIDs = item.getNotes();
    for (let id of noteIDs) {
      let note = Zotero.Items.get(id);
      let noteHTML = note.getNote();
      if (noteHTML && noteHTML.startsWith('<div data-citation-items') && noteHTML.includes(annotationTag)) {
        Zotero.Items.trashTx(id);
      }
    }
  }
}

/**
 * 从单个条目中提取 PDF 附件中带有指定标签的注释，并转换为 HTML 格式。
 * 在提取的注释前加入条目的标题作为分块标题。
 * @param {Zotero.Item} item - 当前处理的条目
 * @returns {string} 当前条目的注释 HTML
 */
async function extractAnnotationsFromItem(item) {
  let annotationsHTML = "";
  let title = item.getField("title") || "无标题";
  annotationsHTML += `<h2>${title}</h2>\n`;
  const attachments = item.getAttachments();
  for (let attachmentId of attachments) {
    const attachment = await Zotero.Items.getAsync(attachmentId);
    // 仅处理 PDF 附件
    if (attachment.attachmentContentType === "application/pdf") {
      const annots = attachment.getAnnotations();
      if (annots && annots.length > 0) {
        for (let annot of annots) {
          // 检查注释标签，仅提取带有指定标签的注释
          if (annot.getTags && Array.isArray(annot.getTags())) {
            let tags = annot.getTags().map(tagObj => tagObj.tag);
            if (!tags.includes(annotationTag)) continue;
          } else {
            continue;
          }
          try {
            let annotJSON = await Zotero.Annotations.toJSON(annot);
            // 使用 serializeAnnotations 将注释转换为 HTML 格式
            let res = Zotero.EditorInstanceUtilities.serializeAnnotations([
              { ...annotJSON, attachmentItemID: annot.parentID }
            ]);
            annotationsHTML += res.html;
          } catch (error) {
            console.error("转换注释为 HTML 时出错:", error);
          }
        }
      }
    }
  }
  return annotationsHTML;
}

/**
 * 遍历所有选中的条目，将所有带有指定标签的注释内容合并到一个独立笔记中
 * @param {Array<Zotero.Item>} items - 选中的条目数组
 * @returns {Zotero.Item} 新创建的独立笔记
 */
async function combineAnnotationsIntoSingleNote(items) {
  let combinedHTML = "";
  // 在合并的内容最前面添加用户输入的笔记标题（作为一级标题）
  combinedHTML += `<h1>${noteTitle}</h1>\n`;
  for (let item of items) {
    try {
      let itemAnnotations = await extractAnnotationsFromItem(item);
      combinedHTML += itemAnnotations;
    } catch (error) {
      console.error(`处理文献 "${item.getField("title")}" 时出错:`, error);
    }
  }
  
  if (!combinedHTML) {
    window.alert("未找到任何符合条件的注释");
    return;
  }
  
  // 创建一个新的独立笔记（standalone note），使用第一个条目的库 ID
  let noteItem = new Zotero.Item("note");
  noteItem.libraryID = items[0].libraryID;
  noteItem.parentID = null;  // 独立笔记
  await noteItem.saveTx();
  
  // 将合并后的 HTML 内容设置到笔记中
  noteItem.setNote(combinedHTML);
  await noteItem.saveTx();
  
  return noteItem;
}

// 先删除每个条目中旧的、包含指定标签的提取注释笔记
deleteIndividualAnnotationNotes(selectedItems, annotationTag).then(() => {
  // 合并所有选中条目的注释到一个新笔记中
  combineAnnotationsIntoSingleNote(selectedItems).then((noteItem) => {
    if (noteItem) {
      let successMsg = "成功创建合并笔记: " + noteItem.getNoteTitle();
      console.log(successMsg);
      window.alert(successMsg);
    } else {
      window.alert("处理过程中未能创建合并笔记。");
    }
  });
});

Anything else

欢迎指导修改。

[mulei000]

[windingwind]

你自己代码里写了增加全局标记，防止多次执行