Skillppx logo

zotero-write

通过脚本安全编辑本地Zotero数据库，支持标签、注释与元数据修改。

已扫描
适合谁
科研人员、学术写作者
不适合谁
无本地Zotero数据库者、不熟悉命令行操作者
国内可用性
需网络配置。可能需要网络配置或第三方服务可访问。
安装难度
新手友好（★☆☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

openclaw skills install @lyononthemoon/zotero-write
下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Zotero Write Skill

用于写入、标记、注释和编辑本地 Zotero SQLite 数据库。

数据库与安全

  • 数据库路径：E:\Refer.Hub\zotero.sqlite
  • ⚠️ 安全提示：执行任何写入操作前，请务必使用 --backup。备份文件将保存至 E:\Refer.Hub\backups/
  • 必要要求：写入数据库前，请关闭 Zotero 应用程序
  • 规则：未使用 --backup 时禁止运行写入操作 —— 脚本会拒绝执行

脚本文件

  • scripts/write_items.py — 所有写入操作的主脚本

使用方法

0. 始终先进行备份

py -3 scripts/write_items.py --backup "E:\Refer.Hub\zotero.sqlite"

此命令将在写入前创建一个带时间戳的备份文件。请始终优先执行此步骤。

1. 为论文添加标签

首先通过 zotero-browse 技能获取目标条目的键（item key），然后执行：

py -3 scripts/write_items.py --backup "E:\Refer.Hub\zotero.sqlite" \
  --add-tag ZL42EGES "NAFLD" "FGF15" "silymarin"

2. 为论文添加笔记

py -3 scripts/write_items.py --backup "E:\Refer.Hub\zotero.sqlite" \
  --add-note ZL42EGES "这篇论文表明 FGF15 是水飞蓟素抗 NAFLD 作用的关键介导因子。"

3. 更新字段（元数据）

更新标题

py -3 scripts/write_items.py --backup "E:\Refer.Hub\zotero.sqlite" \
  --set-field ZL42EGES title "新标题"

更新发表日期

py -3 scripts/write_items.py --backup "E:\Refer.Hub\zotero.sqlite" \
  --set-field ZL42EGES date "2024"

更新期刊名称

py -3 scripts/write_items.py --backup "E:\Refer.Hub\zotero.sqlite" \
  --set-field ZL42EGES publicationTitle "期刊名称"

更新 DOI

py -3 scripts/write_items.py --backup "E:\Refer.Hub\zotero.sqlite" \
  --set-field ZL42EGES DOI "10.1234/example"

4. 创建新的 Zotero 条目

py -3 scripts/write_items.py --backup "E:\Refer.Hub\zotero.sqlite" \
  --new-item journalArticle \
  --title "示例标题" \
  --authors "John Doe" "Jane Smith" \
  --date "2024" \
  --journal "Nature Medicine" \
  --doi "10.1038/s41591-024-0001-z"

5. 列出所有可用字段名

py -3 scripts/write_items.py --list-fields

6. 查看条目完整信息（编辑前）

py -3 scripts/write_items.py --item-info ZL42EGES

可用字段

运行 --list-fields 可查看全部字段。常见字段如下：

fieldName说明
title论文标题
creators作者（新建条目时使用 --authors）
date出版日期（格式为 YYYY 或 YYYY-MM-DD）
publicationTitle期刊名称
DOI数字对象标识符
url网页链接
abstractNote摘要
tags标签（建议使用 --add-tag 添加）
volume卷号
issue期号
pages页码范围
publisher出版社
ISBNISBN 编号
ISSNISSN 编号
journalAbbreviation期刊缩写

条目类型

创建新条目时，可选择以下类型之一：

  • journalArticle（默认用于论文）
  • book
  • bookSection
  • conferencePaper
  • thesis
  • report
  • webpage
  • note

工作流程：为论文添加标签

  1. 使用 zotero-browse 技能查找论文的附件键（attachment key）
  2. 先执行 --backup
  3. 添加标签：
   py -3 scripts/write_items.py --backup "E:\Refer.Hub\zotero.sqlite" \
     --add-tag ZL42EGES "NAFLD" "FGF15" "biomarker"
  1. 确认备份已成功生成于 E:\Refer.Hub\backups/

重要注意事项

  • 备份自动触发：使用 --backup 时会自动创建备份 —— 请始终启用
  • 标签匹配采用精确字符串比对；区分大小写
  • 设置已有值的字段将覆盖原有内容
  • 笔记将以子项形式附加到父条目上
  • 新建条目将分配一个随机的 8 字符 Zotero 键
  • 写入完成后，Zotero 将在下次启动时同步更改
L
@lyononthemoon

已收录 1 个 Skill

相关推荐