MuiseDestiny/zotero-style · 上手攻略

  • 仓库：MuiseDestiny/zotero-style
  • 链接：https://github.com/MuiseDestiny/zotero-style
  • 分类：academic-writing / Zotero 插件
  • 作者：spark
  • 更新：2026-07-14

这是什么

zotero-style（中文社区里常叫 "Ethereal Style"）是作者 MuiseDestiny 用 windingwind/zotero-plugin-template 写出来的 Zotero 文献管理器样式增强插件。它在 Zotero 的条目列表（item table）上重做 / 新增一批「列」，把文献管理与阅读状态变成视觉化、可一眼扫的东西，包括：

  • Title 列背景按 PDF 的阅读时长上色，越深 = 你在这页停留越久。
  • Progress 列按每页标注字数映射进度条。
  • Read/Unread 列：未读粗体 / 已读不粗体。
  • Tags 列：从标题前面的标签独立出来。
  • #Tags 列：以 #xxx 前缀筛选标签，可定制显示规则（前缀 + 正则）。
  • Publication Tags 列：依据内置数据集（CCF、CSSCI、中科院分区、JCR、EI、各高校分级目录等约 30+ 套刊库）自动为条目生成"该刊物在我关心的评级里是什么等"的标签，比如显示为 SCI 一区、北核 这种 icon 化短语。

它不是论文检索 / 抓取插件，是把已经收进 Zotero 的库改造成"看完多少、读到哪、刊物够不够级别"的看板。

最新版本约 5.7.9（GitHub release）；社区 Zotero 插件市场另有 6.0.6 适配 Zotero 9（见正文"坑与注意"）。

解决什么问题

  • 在几百条文献里找出"哪些还没看 / 看一半"，通常要一个个点开 PDF；加了 Title 背景色 + Progress 列后直接看列表就行。
  • 写综述 / 投基金时，国内 C 刊、CCF-A、中科院分区、EI、各高校白名单各不相同；在每条目上手打标签工作量巨大；Publication Tags 列通过内置数据集自动给打签。
  • Zotero 列展示空间拥挤，标签塞在标题前面也丑；插件把标签/Tags/#Tags/期刊标签拆成独立列，可自由开关。
  • 字段显示/隐藏、列宽调整本来要去 Preferences 多次点击；Style 提供 Shift + P 的命令面板快捷改。

快速安装

Zotero 插件通用流程：

  1. 下载最新 .xpi（GitHub release 或 Gitee 镜像都可以，README 里给的 gitee 链接：https://gitee.com/MuiseDestiny/plugins/raw/master/zotero-style.xpi）。
  2. 打开 Zotero → 菜单 Tools → Add-ons（工具 → 插件）→ 右上角齿轮图标 → Install Add-on From File... → 选中 zotero-style.xpi。
  3. 安装完重启 Zotero。
  4. 之后更新一律走 Zotero 自带的更新机制（README 里强调"小版本不再发 GitHub Release，请用 Zotero 自己的更新"），否则你 GitHub 上手动覆盖反而容易装到不兼容版本。

中文视频教程（B 站）：https://www.bilibili.com/video/BV1ZP411p7ko/。 中文文档（Notion）：https://www.notion.so/Zotero-Style-bc2aebbbb6df4b7baa858e376e4fc5be。

核心用法

命令面板

打开 Shift + P（README 说「有时候也可能是 Shift + Tab + P」）调出 Style 命令面板，许多功能在此统一入口；列设置、生成脚本、统计操作都在里面。如果显示不全，可暂时禁用其他插件排除冲突。

自定义标签列（#Tags 列）

右键点击 #Tags 列 → 列设置。Prefix 字段支持：

#            # 显示所有 # 开头的标签，并去掉 # 前缀
/^#(.+)/     # 用正则匹配，(.+) 为实际显示文字，多个 (.+) 自动拼接

例如你想只显示以"important"开头的标签且大小写不敏感：

/^#important(.+)/i=$1

Publication Tags（期刊等级自动打签）

右键点击 Publication Tags 列 → 列设置 → Fields 里填写你要启用的数据集 ID，用英文逗号分隔（按 README 自带的内嵌示例，常用组合）：

sciif,sciBase,sci,ssci,pku,sciwarn,eii

完整可填字段有约 30 个，README 给的字段表（节选）：

Field 来源分级
ccf 中国计算机学会推荐目录（2019），A(T1) / B(T2) / C(T3)
swufe 西南财经大学期刊目录（2018），A+, A, B, C
cufe 中央财经大学期刊目录（2019），AAA, AA, A
ssci / sci JCR 分区-影响因子-2022，Q1~Q4
sciif easyScholar 将影响因子分级 5 档
jci JCI 指数，4 档
fdu 复旦国内期刊目录，A / B
sjtu 上海交大 SCISCIE A/B 档（2018.5）
xmu 厦门大学人文社科核心，「一类」单级
cssci CSSCI 来源 + 扩展版（2021-2022）
ruc 中国人民大学核心，A+, A, A-, B
cscd 中科院引文库，核心库 / 扩展库
swjtu 西南交大学术期刊分级，A++, A+, A, B+, B
uibe 对外经贸科研奖励外文核心，A, A-, B
pku 北大中文核心（2020 版）单级
xdu 西电高水平期刊，一类贡献度 / 二类贡献度
sdufe 山东财大学术期刊，特类 + A1, A2, B, C
eii EI 检索，单级
nju 南大超一流 / 学科群一流 / SCI A、B
zhongguokejihexin 中国科技核心（2021 版）单级
cqu 重庆大学分级，A（权威）/ B / C
hhu 河海大学分级，A/B/C
ajg ABS 2021（约 1700 种），4*/4/3/2/1
xju 新疆大学，五区
cug 中国地质大学，T1~T5
fms FMS 管理科学推荐，A(T1)/B(T2)/C/D
scu 四川大学分级，A/A-/B/C/D/E
utd24 互联网公开收集，单级
ft50 FT50 列表，单级
sciUp 中科院升级版（2022.12），1~4 区
sciBase 中科院基础版（2021.12），1~4 区
sciwarn 中科院预警名单（2021.12.31）
cju 长江大学自然科学高质量，T1/T2/T3
zju 浙江大学分级，国内一级学术 / 一级核心

重命名显示（Map 字段）

Map 字段用「键=值,」做字符串/正则替换，把默认标签转成你想要的简短标签。README 给的现成片段：

# SCI
SCI=, 
/SCIIF/=IF, 

# EI
EI检索=EI, 

# 把影响因子保留到 1 位小数
/^(\d+)\.(\d{1})\d*$/=$1.$2, 

# 中文
北大中文核心=北核, 

# 中科院预警
SCIWARN=🚫, 

# 中科院升级版（按学科）
/医学(\d+)区/=医$1, 
/生物学(\d+)区/=生$1, 
/农林科学(\d+)区/=农$1,

你还可以自建数据集，但 README 要求：在自定义数据集里必须自己填字段定义（"locate the custom field definition of the dataset and fill it in the Fields section"）。

阅读态可视化

  • Title 列背景色：插件依据你每页 PDF 的停留时间近似上色（读得越久颜色越深）。
  • Progress 列：依据每页标注字数近似进度。
  • Read/Unread：未读条目粗体，已读普通字重。两种方式标记已读：在条目右键 Style 提供的"标记已读"按钮，或者直接借 Zotero 自身的 RSS 已读按钮。

典型适用场景

  • 硕博士 / 科研新人：要按 CCF 或中科院分区筛会议/期刊，又不想每次跑去 easyScholar 查。
  • 国内投稿前自查：CSSCI、北大核心、南大 CSSCI、CSCD 等多目标验证时，一列同时显示多个评级。
  • 综述写作：快速定位"读过的 + 高分区的"那批文献。
  • 跨校科研合作：不同学校白名单不同；Publication Tags 多开几个 Fields 直接都打出来。
  • 长时间深度阅读：Title 颜色 + Progress 把"看到哪、看了多久"直观化。

坑与注意

  • Zotero 主版本兼容性最常出事：社区论坛（forums.zotero.org/discussion/131612）里有人反馈 Zotero 9.0.3 装 GitHub 上最新版 5.7.9 会被 Zotero 拦截（不兼容）；社区市场里有适配 Zotero 9 的 6.0.6 版——所以"开 Zotero 9 用户请走 Zotero 插件市场源"，不要手动抓 GitHub release 的最新版。
  • 小版本不在 GitHub release 发布：README 写明 "请用 Zotero 官方更新方式更新"——手动下 release 反而停在旧版。
  • 数据源时效：很多中文数据集停留在 2017~2022 年（如 pku 是 2020 版、sciUp/sciBase 是 2021/2022 版）。CSSCI、北大核心等官方在持续更新，本插件不会自动同步，评级可能落后一两年。
  • 多列冲突：Zotero 一次只能装有限个插件同时改 UI；Shift + P 面板打不开时，README 建议先禁掉其他同类型插件。
  • 不在 Zotero 内做检索/抓取：它只美化/标签化"已经在 Zotero 里的条目"——要找新论文还得配合 zotero-scihub 或茉莉花等抓取插件。
  • PDF 阅读时长上色是近似：依赖 Zotero 记录的阅读时长统计，并非"动鼠标时间"那种细粒度；快速翻页不会上色，目标是"提示哪里反复看"。
  • 数据源列表会动：README 字段表是文档快照，实际可用字段以插件 v5/v6 内 Fields 下拉里显示的为准。

与同类对比

Zotero 生态里改 UI/列的插件不少，常见组合：

  • 茉莉花 (jasmin) / zotero-scihub：解决"下不到 PDF"，与本插件互补。
  • Zotero PDF Translate：在 Zotero 内做翻译/摘要；和 style 一起装是高配。
  • ZotFile / Zotero Storage Scanner：管理附件/目录结构。
  • windingwind/zotero-better-notes：把笔记拉到独立管理面板，是"笔记派"，style 是"列派"。
  • l0o0/QuickLook for zotero 等：Mac 风格的快速预览。

Style 的独特处是把"中文分级数据集 + 阅读可视化 + 列级定制"压到一个插件里，对中文社科 / 国内投稿需求一键覆盖；纯英文用户更适合用 better-bibtex + zotero-pdf-translate + zotfile 那条线。

一句话推荐

要"用 Zotero 管中文文献 + 期刊评级一眼可见"的同学，zotero-style 几乎绕不开——前提是装对你 Zotero 版本对应的版（GitHub 站看版本号，社区市场拉 6.x），并接受分级数据滞后几年；纯英文文献管理需求不必强上。