Zotero 7 升级后 zotero-style 插件失效：期刊标签与阅读进度条修复指南
【免费下载链接】zotero-styleEthereal Style for Zotero项目地址: https://gitcode.com/GitHub_Trending/zo/zotero-style
升级 Zotero 7 后重启，zotero-style 的期刊标签列空了、标题背景进度条没了、图谱视图不出现。这三类失效分别对应三个原因：版本不匹配、EasyScholar secretKey 缺失、列功能默认关闭。先看速查表定位，再按模块修复。
📋 速查表：先定位再动手
| 现象 | 最常见原因 | 去哪改 |
|---|---|---|
| 插件列全部消失 | 安装版本与 Zotero 7 不兼容 | 核对 addon/manifest.json |
| 期刊标签列空白 | EasyScholar secretKey 未填 | 插件设置 |
| Progress 列看不到 | progressColumn 默认关闭 | 列设置 |
| 阅读进度条空白 | 存储方式未重新选择 | 插件设置 storage 项 |
| 图谱不出现 | graphView 默认不自动显示 | function.graphView.enable |
先核对第一行。版本不对时，后面所有设置都没有意义。
🩺 核对插件版本与 Zotero 7 是否兼容
addon/manifest.json 中strict_min_version为6.999、strict_max_version为7.0.*，即仓库当前构建支持 Zotero 7；而 release 页里的 2.6.7 是 Zotero 6 版本，两个构建不能混用。
- Zotero 6 装 2.6.7，Zotero 7 装最新 release
- 版本不符时 Zotero 可能直接拒绝加载插件，也可能加载了但列不出现
- 装好后重启，确认"设置 → 插件"中出现 Style 项，再做后续步骤
需要自行构建时，clone 仓库后运行npm run start-z7（或start-z6）启动带调试的 Zotero，可执行路径要提前写在zotero-cmd.json（由 scripts/zotero-cmd-default.json 复制改名）：
git clone https://gitcode.com/GitHub_Trending/zo/zotero-style🔖 修复期刊标签列空白
Publication Tags 列不内置期刊数据，而是每次向 EasyScholar 接口请求期刊分区。src/modules/utils.ts 里的逻辑很直接：secretKey 为空就返回 -1，整列空白。升级后这是"期刊标签不显示"最常见的原因。
修复步骤：
- 设置 → 插件 → Style，填入 EasyScholar secretKey
- 在期刊标签列的"列设置"中确认
Fields字段（默认sci, sciif5, eii） - 用
Map做标签改名或裁剪，支持正则，例如SCIIF=IF、北大中文核心=北核 - 字段全表（sci、ccf、cssci、sciBase、sciUp 等）见 README 的 Publication Tags 一节
注意：列空白也可能是 easyscholar.cc 域名网络不通，先验证网络再怀疑配置。
📊 恢复阅读进度条
进度条有两种形态，数据源相同——每页的readingTime（阅读时长/批注字数），由 src/modules/progress.ts 按透明度量化渲染：
- 标题背景进度条（titleColumn）：颜色越深代表该页停留越久
- Progress 列：展示每页批注字数，默认关闭（addon/prefs.js 中
progressColumn.enable=false），需在"列设置"中勾选
数据本身存在两处之一：默认写入 Zotero 笔记（storage.in=note），或你指定的zoterostyle.json（storage.in=file）。升级后进度条"变空"按顺序查：
- 插件设置中确认存储方式；file 方式要重新用 "Select File" 指向原 JSON，界面会提示重启
- 对应列已在"列设置"中勾选
- 进度数据是读出来的——重装后需要重新阅读/批注 PDF 才会累积
🗂️ 标签、评级与图谱功能逐项排查
- Tags / #Tags 列：#Tags 把
#开头的标签以文本直接渲染，前缀与匹配规则可在列设置里改成正则 - Rating 列：默认开启，点一下直接评级
- View Group：把一组列显隐方案存成视图，左键切换、长按刷新
- Graph View：默认启用（function.graphView.enable=true）但不自动弹出（graphView.show=false），点工具栏按钮打开
- Nested Tags：层级标签可部分替代集合树；删除标签前有不可逆提示
各模块的列注册集中在 src/hooks.ts 的 onStartup 中，某一列没出现时可先看对应create*是否抛错。
🔁 长期维护：下次升级不丢数据
- 升级主程序前，把包含 readingTime 的
zoterostyle.json或对应笔记一并备份 - Zotero 大版本更新后，先确认 release 页有对应兼容版本再安装，不要拿 Z6 的 xpi 硬装 Z7
- 改过的列颜色、透明度等偏好对应 addon/prefs.js 中的
extensions.zotero.zoterostyle.*，记录一份重装后照抄即可恢复
【免费下载链接】zotero-styleEthereal Style for Zotero项目地址: https://gitcode.com/GitHub_Trending/zo/zotero-style
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
