跳到主要内容

Workflow 介绍

什么是 Workflow？​

Workflow（工作流）是 Zotero Agents 的核心功能，它允许您将多个技能步骤组合成自动化的处理流水线。一个 Workflow 定义了一个完整的任务：从接收输入、处理数据、到输出结果。

Workflow 的结构​

workflow.json（清单文件）
├── manifest：声明元数据、版本、名称
├── parameters：定义可配置的参数
├── inputs：定义输入类型（附件、条目、笔记等）
├── validateSelection：声明式输入验证和过滤
├── hooks：JavaScript 钩子脚本（预检、构建请求、应用结果）
└── provider：指定需要的后端类型

输入单元类型​

类型说明
attachment条目的附件文件
parent选中条目的父条目
note笔记条目
workflow批量作用域

钩子系统（Hooks）​

Workflow 可以在执行的各个阶段运行自定义 JavaScript 脚本：

  • validateSelection：在 JavaScript hook 运行之前声明式地过滤和验证输入
  • preflight：检查已解析的输入单元，附加执行上下文，跳过、短路到 applyResult，或将一个输入扩展为多个请求单元
  • buildRequest：构建发送给后端的请求内容
  • normalizeSettings：规范化用户设置
  • applyResult：将后端返回的结果应用到 Zotero

三种执行方式​

Workflow 可以通过三种后端类型执行：

后端请求类型适用场景
Skill-Runnerskill.run.v1通用技能执行，支持交互模式
ACPacp.skill.run.v1ACP 后端的技能执行
Generic HTTPgeneric-http.request.v1HTTP API 调用

官方 Workflow 包​

官方 Workflow 以独立包的形式发布和安装，与插件本体解耦。安装方式：

  • 右键菜单 → Zotero Agents → 📦 安装官方 Workflow 包
  • 偏好设置中点击 安装官方 Workflow 包

官方包支持 stable / beta / dev 三个更新频道，插件启动时自动检查更新。

官方 Workflows​

插件附带了一系列官方 workflow，按功能分组：

📚 文献分析工具包​

Workflow用途输入后端文档
文献分析 ⭐从 PDF/MD 生成摘要、参考文献、引文分析。可级联标签规范化附件Skill-Runner详情
文献元数据整理查询、修正并补全 Zotero 条目的书目元数据父条目Skill-Runner详情
文献翻译带术语管理和质量门禁的学术文献翻译附件Skill-Runner详情
交互式文献解读与 AI 多轮对话深入理解文献，答案经验证门禁防幻觉附件Skill-Runner详情
深度阅读生成结构化精读 HTML 视图，支持翻译附件ACP详情
文献搜索与入库让 Agent 搜索学术文献并直接入库到 ZoteroworkflowACP详情
导出/导入文献包导出/导入含元数据、附件和笔记的 Zotero 条目便携式 ZIP 包父条目 / workflow无需后端详情
导出研究包从现有库和 Synthesis 上下文自动组装论文项目的只读研究包workflowSkill-Runner详情
标签审计扫描库中所有条目的受控标签词表合规性并报告workflow无需后端详情
Collection 文献收集器根据指定范围从现有文献库中筛选文献并加入 collectionworkflowACP详情
标签词表初始化与 AI 交互创建研究领域的受控标签词表workflowSkill-Runner详情
标签规范化基于受控词表规范化标签，推断新标签父条目Skill-Runner详情
导出/导入笔记导出或导入分析笔记，支持编辑后重新导入父条目无需后端详情

🛠️ 实用工具​

Workflow用途输入后端文档
MinerU PDF 解析调用 MinerU 服务解析 PDF 为 Markdown附件Generic HTTP详情
Topic 综合创建三步流水线创建主题综合分析与报告workflowACP详情
论文写作框架生成 Introduction / Related Work LaTeX 草稿workflowACP详情

🔧 调试工具​

Workflow用途后端文档
调试工具包Workflow 系统开发测试和诊断Skill-Runner详情

下一步​