convez.ai
Skill
Dylan-kc

zotero-remark-skill

Dylan-kc/zotero-remark-skill

Ver no GitHub
InicialPluginScore · de 0 a 100

Claude Code skill for batch adding remarks to Zotero items based on abstracts

Instalação

$npx convez-ai Dylan-kc/zotero-remark-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 meses
Versão
—
Issues abertas
0
Contribuidores
2

README

A tradução para o português deste README ainda está na fila.

Zotero Remark

Claude Code Skill — 批量为 Zotero 文献添加简记

根据文献摘要自动生成一句话总结,并可为筛选后的文献添加摘要翻译、研究话题相关度评级和关键词标签。

默认只添加 remark:;当提示词明确要求摘要翻译时,会为英文文献额外生成中文摘要翻译,并紧跟在 remark 后写入 translate:。

功能

  • 从指定文件夹批量提取 Zotero 文献
  • 读取每篇文献的摘要(abstractNote)
  • 根据摘要内容生成一句话总结
  • 写入条目的"简记"(remark 字段)
  • 可选:当用户明确要求摘要翻译时,为英文摘要追加中文 translate 字段
  • 可选:根据用户给出的参考话题,用 ⭐ 至 ⭐⭐⭐⭐⭐ 评价筛选文献的相关度
  • 可选:为每篇指定文献提取 2–5 个关键词,并添加独立的 #关键词 标签
  • 更新评级时只替换旧星级,添加关键词时保留并去重所有原标签
  • 支持分批处理(20 或 50 条),避免 API 频率限制

适用场景

当你需要对大量 Zotero 文献进行整理、归类、生成阅读笔记时使用。例如:

  • "帮我处理 xxx 文件夹中的文献"
  • "为这个文件夹的文献添加简记"
  • "批量处理 zotero 文献"
  • "根据摘要生成一句话总结"
  • "帮我处理 xxx 文件夹中的文献,并给英文文章加上摘要翻译"
  • "为这个文件夹添加 remark,同时 translate 英文摘要"
  • "把筛选好的文献进行评级,参考话题为:企业创新战略如何影响分析师预测"
  • "再给这些文献加上标签,每篇提取 2–5 个关键词"

前置条件

1. 安装 pyzotero

/opt/anaconda3/bin/python -m pip install pyzotero

2. 配置 Zotero API 凭证

在项目根目录创建 .env 文件:

ZOTERO_LIBRARY_ID=你的用户ID
ZOTERO_API_KEY=你的API密钥
ZOTERO_LIBRARY_TYPE=user  # 或 group

获取方式:

3. 安装 Skill

将 zotero-remark 文件夹放到项目的 .claude/skills/ 目录下:

项目/
├── .claude/
│   └── skills/
│       └── zotero-remark/
│           ├── SKILL.md
│           └── scripts/
│               └── update_ratings_tags.py
└── .env

使用方式

在 Claude Code 中直接描述需求,例如:

"帮我处理『无形资产/readability』文件夹中的文献,每次处理 30 条"

Claude 会自动:

  1. 连接到你的 Zotero 账户
  2. 定位目标文件夹
  3. 逐条读取文献摘要
  4. 判断用户是否明确要求摘要翻译
  5. 生成一句话总结
  6. 写入 remark 字段;如用户要求翻译,则对英文文献追加 translate 字段
  7. 如用户给出参考话题并要求评级,只对指定或已筛选文献添加 1–5 星标签
  8. 如用户要求关键词标签,为同一批文献各添加 2–5 个 #关键词 标签

Remark 格式

Remark 存储在 Zotero 条目的 extra 字段中,格式为:

remark: 这里是一句话总结的内容

如果用户明确要求摘要翻译,英文文献会写成:

remark: 这里是一句话总结的内容
translate: 这里是英文摘要的中文翻译

未明确要求摘要翻译时,默认不会添加 translate:。

处理记录

文件夹文献数状态
readability(L4XWH5DI)20 篇✓ 已完成
相生相克-关系(8PLDEHRT)62 篇✓ 已完成

已知问题

  • Zotero API 每页返回 100 条,zot.collections() 和 zot.collection_items() 默认只返回第一页,需要循环分页获取全部数据
  • 部分文献可能没有摘要(abstractNote),这些文献会跳过处理

技术细节

  • Python 路径: /opt/anaconda3/bin/python
  • API: Zotero Web API v3
  • Remark 位置: item['data']['extra']
  • 中英文处理: 无论原文是中文还是英文,remark 均用中文生成
  • 可选摘要翻译: 仅当用户明确要求时,对英文摘要生成中文翻译并以 translate: 写入 remark 后一行
  • 相关度评级: 星级作为 Zotero tags 中的独立标签;每篇仅保留一个星级
  • 关键词标签: 每个关键词以独立 #关键词 写入 Zotero tags,保留其他原标签

License

MIT

Ver o original no GitHub

Bom para

Relacionados