vitorfs/parsifal · 上手攻略

  • 仓库：vitorfs/parsifal
  • 链接：https://github.com/vitorfs/parsifal
  • 分类：academic-writing
  • 作者：Tom
  • 更新：2026-08-27

是什么

Parsifal 是一款开源的 Web 应用，旨在辅助研究人员执行系统文献综述（Systematic Literature Review，SLR）。系统文献综述是一种规范的二次研究方法，按照 Kitchenham & Charters 提出的框架，包含规划（Planning）、实施（Conducting）、报告（Reporting） 三大阶段。Parsifal 在每个阶段提供结构化管理工具，帮助研究者管理搜索协议、筛选文献、提取数据、生成报告。

该项目托管于 GitHub，配套有在线平台 parsif.al，支持多研究者协作，适合地理上分布的研究团队共同参与同一综述项目。

技术栈： Python 3.9 + Django 4.1 + PostgreSQL 12 + Bootstrap 3.4 + jQuery 3.6。

解决什么问题

传统的系统文献综述存在三大痛点：

  1. 数据量大、筛选耗时：一次检索可能返回上千篇文献，靠人工逐篇筛选极易出错且效率低下。
  2. 协作困难：多位研究者并行筛选时，缺乏统一的纳入/排除标准和进度追踪机制。
  3. 可重复性不足：搜索策略、筛选逻辑难以完整记录，影响综述的透明性与可重复性。

Parsifal 将以上流程线上化，提供协议设计、文献导入、标题/摘要筛选、全文筛选、数据提取、报告导出等全链路支持。

快速安装

前提

  • Python 3.9+
  • PostgreSQL 12+（或使用 SQLite 作为轻量替代）
  • Git

步骤

# 1. 克隆仓库
git clone https://github.com/vitorfs/parsifal.git
cd parsifal

# 2. 创建虚拟环境
python3 -m venv venv
source venv/bin/activate

# 3. 安装依赖
pip install -r requirements/local.txt

# 4. 配置环境变量
cp .env.example .env
# 编辑 .env，设置 DATABASE_URL：
# SQLite 示例：
DATABASE_URL=sqlite:////tmp/parsifal.sqlite3
# 或 PostgreSQL：
DATABASE_URL=postgres://USER:PASSWORD@localhost:5432/parsifal

# 5. 执行数据库迁移
python manage.py migrate

# 6. 创建管理员账户
python manage.py createsuperuser

# 7. 启动本地服务器
python manage.py runserver

启动后访问 http://localhost:8000，用创建的管理员账号登录即可使用。

Docker 方式（非官方，需自行编写 Dockerfile）

如需 Docker 部署，可基于 Python 3.9 镜像构建，将上述启动命令写入 entrypoint，数据库使用外部托管的 PostgreSQL 或云数据库（如 Supabase、Neon）更省事。

核心用法

1. 创建系统文献综述项目

登录后点击 New Review，填写研究主题、描述等信息，平台会生成一个独立的工作空间。

2. 设计搜索协议（Protocol）

这是 SLR 的核心文档，包含： - 研究问题（PICO 格式等） - 搜索数据库（IEEE、PubMed、Scopus、Springer 等） - 搜索字符串（如 ("machine learning" AND "systematic review")） - 纳入/排除标准 - 筛选阶段定义（先标题摘要、再全文）

3. 导入文献

支持手动录入或批量导入（CSV 格式，~ 分隔的字段映射）。文献字段包括：标题、作者、年份、摘要、来源数据库等。

4. 双盲筛选

多名研究者可同时独立筛选同一批文献，平台记录每篇文献的纳入/排除决策及理由。系统自动计算Cohen's Kappa 等一致性指标，帮助评估筛选质量。

5. 数据提取

为每篇纳入文献填写预设的提取字段（如研究方法、样本量、主要结论等），提取模板可自定义。

6. 导出报告

支持导出符合 PRISMA 规范的流程图数据及筛选结果报告。

典型适用场景

场景 说明
硕士/博士论文 学位论文需要规范的 SLR 流程，Parsifal 提供完整的文档化管理
跨机构合作综述 团队成员分布各地，在线协作避免版本冲突
元分析（Meta-analysis）准备 数据提取功能为后续统计合成打好基础
课程教学 教师布置 SLR 作业时，用 Parsifal 追踪学生进度

坑与注意

⚠️ 活跃度低：该仓库近年来更新频率较低（Stars 510，周增 0），部分依赖版本可能过时，安装前建议确认 Python 3.9 + Django 4.1 兼容性。

⚠️ 无内置全文获取：Parsifal 管理筛选流程，但不提供文献 PDF 下载或自动获取功能，仍需手动下载后上传。

⚠️ 数据库要求：生产环境建议用 PostgreSQL，SQLite 适合本地演示但不支持多用户并发写入。

⚠️ 缺乏 API：Django 后端目前没有对外 REST API，无法与其他研究工具（如 Zotero、RIS 文献管理器）自动同步，需手动导出 CSV 中转。

⚠️ PRISMA 流程图需手动编辑：导出数据后仍需用官方 PRISMA Flow Diagram 工具绘制最终图。

⚠️ 无英文以外语言界面：前端 UI 暂不支持多语言，中文用户需接受英文界面。

与同类对比

工具 类型 特点 适合谁
Parsifal 开源 Web 应用 轻量、协作友好、无需服务器 学术团队、中小综述
Covidence 商业 SaaS 集成化程度高、大量用户 有经费的高校研究团队
Rayyan 商业 SaaS（免费版有限） AI 辅助筛选、快速上手 快速筛选场景
SR-DRAGON 开源/学术工具 全流程覆盖、学术背景强 医学/临床系统综述
Zotero + 插件 开源文献管理 免费、插件生态丰富 个人研究者

Parsifal 的核心优势是完全开源且免费，协作功能在同类开源工具中相对完善；但相比 Covidence 等商业平台，自动化程度较低。

一句话推荐结论

学术研究者执行系统文献综述时，若需要多人协作、无经费限制且偏好开源方案，Parsifal 是值得一试的轻量选择，尤其适合 SaaS 工具门槛过高的学生或小团队；主流商业化场景仍推荐 Covidence。