Zotero Collection Color Menu Plugin / Zotero 文件夹颜色菜单插件

Zotero Collection Color Menu 是一个用于给 Zotero collection / 文件夹添加本地颜色标识的独立插件。它面向文件夹数量很多、层级很深、需要快速区分不同项目或主题的 Zotero 文库。

这个插件的重点是增强 Zotero 左侧文件夹树的视觉辨识度：它不修改文献条目内容，也不修改 Zotero collection 元数据，只把颜色作为本机显示偏好保存。

主要功能

文件夹右键颜色菜单

插件会在 Zotero 左侧文件夹的右键菜单中添加 文件夹颜色 子菜单。选中某个 collection 后，可以直接通过右键菜单设置颜色或清除颜色。

颜色菜单只在真实 collection / 文件夹节点上显示。文库根目录、回收站、重复条目、未分类条目、搜索等虚拟节点不会显示颜色设置菜单，避免误操作。

简洁的文件夹背景色

设置颜色后，插件会在 Zotero 左侧 collection tree 中为对应文件夹名称区域添加柔和背景色。颜色不会在文件夹名前额外插入符号或空格，保持文件夹名称本身干净。

这种方式适合给重要项目、常用主题、待整理文件夹或阶段性工作区做视觉标记。

5 个高区分度预设颜色

插件内置 5 个差异明显、便于快速识别的颜色：

• 红色
• 金色
• 绿色
• 蓝色
• 紫色

颜色项在菜单中带有对应颜色的小方块图标，选择时更直观。当前已设置的颜色会在菜单项前显示勾选标记。

清除颜色

如果某个文件夹不再需要标记，可以在同一个 文件夹颜色 子菜单中点击 清除颜色。清除后，该文件夹会恢复 Zotero 默认显示样式。

本地偏好保存

颜色设置保存到 Zotero 本地偏好中。插件会记录 collection ID 与颜色 ID 的对应关系，并在 Zotero 启动后重新应用到左侧文件夹树。

颜色信息不会同步到 Zotero 云端，也不会写入文献条目、附件、笔记或 collection 元数据。

快速使用

1. 在 Zotero 左侧文件夹树中右键一个 collection / 文件夹
2. 打开 文件夹颜色 子菜单
3. 选择 红色、金色、绿色、蓝色 或 紫色
4. 左侧文件夹名称区域会立即显示对应背景色
5. 如果要取消标记，右键同一文件夹并选择 清除颜色

颜色与显示规则

颜色范围

当前版本只提供 5 个预设颜色。颜色数量保持克制，目的是避免标记过多后反而降低辨识度。

旧版颜色兼容

从旧版升级时，旧的橙色、黄色、青色、粉色和灰色会自动映射到最接近的新颜色：

• 橙色、黄色 -> 金色
• 青色 -> 蓝色
• 粉色 -> 红色
• 灰色 -> 紫色

显示位置

颜色只应用于 Zotero 左侧 collection tree 的文件夹名称区域。插件不会改变条目列表、PDF 阅读器、标签面板或其他 Zotero 区域。

行为边界

• 只支持 collection / 文件夹节点
• 不支持文库根目录、回收站、重复条目、未分类条目、搜索等虚拟节点
• 不修改文献条目标题、作者、年份、DOI、标签、附件或笔记
• 不修改 Zotero collection 元数据
• 颜色是本机显示偏好，不会同步到 Zotero 云端
• 卸载插件后，Zotero 左侧文件夹树会恢复默认样式

设置说明

当前版本没有单独设置页，核心配置在源码 collection-color-menu-plugin.js 的 config 中：

• prefKey: "collectionColorMenu.colors"：保存 collection 颜色映射的 Zotero 本地偏好键
• menuLabel: "文件夹颜色"：右键菜单名称
• clearLabel: "清除颜色"：清除颜色菜单项
• palette：5 个预设颜色的名称、强调色和背景色
• legacyColorAliases：旧版颜色到新版 5 色方案的映射

Logo

插件内置一个简洁的文件夹配色图标，图标主体是 collection / 文件夹形状，并用 5 个色块表示可选颜色。

安装

1. 在 Zotero 中打开 工具 -> 插件
2. 点击右上角齿轮
3. 选择 Install Add-on From File...
4. 选择构建好的 .xpi
5. 重启 Zotero

安装文件：

• dist/zotero-collection-color-menu-plugin-0.1.4.xpi

构建 XPI

在插件目录运行：

bash build.sh

构建产物会出现在：

• dist/zotero-collection-color-menu-plugin-0.1.4.xpi

兼容性

• Zotero 7、8、9

当前 manifest 明确标记为兼容 Zotero 7.0 到 9.*。