跳到主要内容

Tags 管理

什么是 Tag Vocabulary？​

Tag Vocabulary（受控标签词表）是一个规范化的标签体系，用于对文献进行一致的标注。与 Zotero 原生的自由标签不同，受控词表中的标签遵循统一的命名规范，有利于统计和检索。

Facet（标签维度）​

每个标签属于一个 Facet（维度），目前支持以下维度：

Facet说明示例
field研究领域field:natural_language_processing
topic研究主题topic:transformer_architecture
method研究方法method:reinforcement_learning
model使用的模型model:gpt-4
ai_taskAI 任务类型ai_task:text_summarization
data数据集data:imagenet
tool工具tool:python
statusWorkflow 待办status:need-analysis

标签格式：^[a-z_]+:[a-zA-Z0-9/_.-]+$，最长 120 字符。

Vocabulary Tab（词表管理）​

在 Synthesis Workbench → Tags → Vocabulary 页面可以：

  • 查看：所有已定义的规范标签，显示状态、Facet、别名、使用次数
  • 新增：创建新的规范标签
  • 编辑：修改标签的元数据
  • 弃用：将标签标记为已弃用，可指定替代标签
  • 导入 JSON：从 JSON 文件导入标签词表（支持预览后再确认）
  • 导出 JSON：将当前词表导出为 JSON 文件

五个内建 workflow 状态会在插件启动时自动初始化。其 tag、facet、source、弃用状态和 replacement 不可修改或删除；note 仍可编辑，aliases 继续通过现有治理入口维护。自定义 status:* 与其他自定义词表项一样可完整管理。导入可以更新内建项的 note 和 aliases，但不能通过遗漏或身份改写移除、替换内建项。

Synthesis Tags 页面

标签状态：

  • active：活动中
  • deprecated：已弃用（有替代标签）
  • warning：警告（可能需要审查）

Staged Tab（待审批标签）​

tag-regulator 技能会自动分析文献元数据，生成受控标签建议，显示在 Staged 页面。

审批流程​

  1. 查看建议的标签列表
  2. 每个标签可以：
    • Promote（晋升）：将该标签加入规范词表
    • Discard（丢弃）：拒绝该建议
    • Clear Staged（清空待定）：批量丢弃所有建议

导入/导出格式​

标签词表支持 JSON 格式的导入导出（TagVocab 格式），方便：

  • 跨库迁移标签体系
  • 团队共享标签规范
  • 备份和版本管理

相关 Workflow​

status 是 workflow 待办 facet，不是阅读进度主轴；一篇文献可以有零个或多个状态。插件拥有以下定义：

  • status:need-metadata-curation
  • status:need-fulltext
  • status:need-markdown
  • status:need-analysis
  • status:need-deep-reading

用户不需要运行 Tag Bootstrapper 来创建它们。Tag Bootstrapper 只新增自定义词表项；标签规范化 可以审计普通受控标签，但不能在文献条目上添加或删除内建 workflow 状态。两者都不得根据论文主题、语言、元数据或正文推断内建状态。

事件添加到条目从条目清除
Search 新建条目固定加入 Markdown、Analysis、Deep Reading；按结果加入 Metadata/Fulltext—
Search 复用条目只加入本次结果明确需要的 Metadata/Fulltext—
Metadata Curator 成功或确认无需修改—Metadata Curator
MinerU 写入并附加 Markdown—Markdown、Fulltext
Literature Analysis 写入正式产物—Analysis
Literature Deep Reading 写入并附加 HTML—Deep Reading

失败、跳过、取消或尚未正式 apply 的运行不会清除状态。产物成功但状态清理失败时保留产物，并返回部分成功警告。用户手工添加 PDF 不会自动清除 status:need-fulltext。