Wisp Paper GitHub

本地优先的文献库

文献是你的,
判断也是你的。

Wisp Paper 把文献和 PDF 留在你的电脑上。按检索式成批导入,让助手逐篇读过,给出带原文依据的建议;每一篇收不收,由你确认。之后向文献库提问,回答里的出处点开就是那一页。

macOS、Windows、Linux · MIT 许可 · 不需要账号

Wisp Paper 的文献库页面:左侧是视图和标签,中间是文献列表,右侧是所选文献的详情和笔记。
图 1 文献库页面。左侧是视图和标签,中间是文献列表,右侧是所选文献的详情和笔记。

一次真实的运行:十五分钟,从空白到 313 篇

下面的数字和截图来自 2026 年 11 月 10 日在 macOS 上的一次运行,主题是植物单细胞与单核转录组测序。数据库每天在变,模型每次的回答也不一样,你照做时数字会有出入,步骤是一样的。

  1. 6条检索式助手拟的,逐条试检索
  2. 2条选用PubMed 和 Europe PMC 各一条
  3. 400篇取回每条取最新的 200 篇
  4. 45篇重复按 DOI、PMID、题目跳过
  5. 355篇待判断交给助手先读一遍
  • 已纳入 257符合筛选目标
  • 相关 52和主题有关,但不满足收录条件,留作参考
  • 证据不足 4摘要里看不出来,其中 2 篇没有摘要可读
  • 不相关 42不属于这个主题

确认时,257 篇已纳入和 42 篇不相关按建议整组采纳,剩下的 56 篇留着自己看:这些正是值得看一眼的。不相关的不再列出,列表里是 313 篇。

图 2 355 篇的去向。色条是助手 4 分 40 秒里给出的建议;它们只是建议,收录判断是之后由人确认的。

a配置模型

Wisp Paper 不自带模型。在「设置 › AI」里填一个你自己的模型服务:Claude API、OpenAI 兼容的 chat/completions,或 OpenAI 的 Responses。没有保存按钮,改了就存。助手、批量筛选、翻译可以各用一个模型,这次把翻译交给了一个不怎么思考的小模型。

设置里展开的模型条目:名称、接口、服务地址、模型、API Key、思考、代理。
图 3a 一个模型条目。右上角的「还缺 API Key」消失,说明可以用了。

b新建文献库

名称之外,写下主题:这个库收什么、关心什么问题。它不只是备注,助手拟检索式、判断收录、回答问题时都会读到,所以值得写具体。选一个标识色,之后这个库的强调色都是它。

新建文献库对话框:名称、主题和标识色。
图 3b 名称「植物单细胞转录组」,主题写了物种、器官、发育轨迹、胁迫响应和方法学问题。

c让助手拟检索式

助手为 PubMed 和 Europe PMC 各拟了三条取向不同的检索式,并立刻逐条试检索:数据库里命中多少篇,最新的几篇是什么。宽的那条命中上千篇,最新的结果里混着骨折愈合;方法学那条命中的几乎都是植物单细胞研究。看标题,不看检索式写得漂不漂亮。

助手拟出的检索式,每条带一句说明、检索式全文和试检索到的最新文献。
图 3c 6 条检索式,命中从 205 篇到 1212 篇。试检索不往文献库里写任何东西。

d保存并导入

选用 2 条,每条取回最新的 200 篇。两个数据库有 45 篇重叠,按 DOI、PMID、题目去重后是 355 篇,全部是「待判断」。这是有意的:先宽一些地导入,再逐篇判断。导错了,每一批都可以整批撤销。

检索与导入页:两条保存的检索式,各自的上次运行结果,以及下面的导入记录。
图 3d PubMed 新增 200 篇;Europe PMC 新增 155 篇,跳过已有的 45 篇。

e让助手筛选

写下筛选目标:什么样的文献应当收进这个库,什么样的不收。助手 8 篇同时读,有 PDF 读全文,这里都只有摘要。每一篇给出建议、理由,和一句逐字引自原文的依据。中途可以停,没读的留到下一轮。

筛选进行到 118 / 355:进度条、正在阅读的 8 篇,下面是已有建议的文献。
图 3e 进行到 118 / 355。进度条下面是正在读的 8 篇,读完的带着建议排进队列。

f确认收录判断

助手不会改任何一篇文献的收录判断,改的人只有你。点开一篇,看它的理由和依据,采纳或者另选。一组看过几篇、觉得靠谱之后,可以整组采纳,会先问一遍。

点开的一篇:助手认为单细胞蛋白质组研究不满足收录条件,建议「相关」,下面是引自摘要的原句和四个判断按钮。
图 3f 一篇单细胞蛋白质组研究:没有转录组数据,助手建议「相关」而不是「已纳入」。

g读翻译的摘要

摘要旁边的「显示译文」把题目和摘要在原位置换成译文,再点「显示原文」切回。打开之后,切到别的文献也会自动翻译。译过的保存在文献库里,同一段文字只请求一次。

文献详情:摘要上方是译文,题目译为「玉米根尖铁缺乏响应的单细胞转录解码」。
图 3g 译文显示在摘要的位置。目标语言和术语译法可以在设置里写。

h向文献库提问

在左侧的「助手」里提问。范围是当前列表的 313 篇:181 篇给了完整记录,放不下的 132 篇只给题目。助手先自己调用工具读了 5 篇直接比较两条技术路线的文献,再作答。它也写明了这几篇没有保存 PDF,所以这次不引页码:它只读了摘要。

助手的回答:一段总述,接着是物种和器官覆盖的表格,每格后面是 P 开头的出处;回答下面是出处列表。
图 3h 回答按 Markdown 排版,每个结论后面跟着出处;下面先列 8 个,其余的折起来。

这一篇,你怎么判断?

右边是那次运行里的一条真实建议。筛选目标写的是:收录实际产生或分析了单细胞、单核转录组数据的植物研究。这篇做的是单细胞蛋白质组。

助手建议的那个按钮是实心的,点它就是采纳;你也可以另选。

Single-cell proteomics of Arabidopsis leaf mesophyll reveals dynamic protein responses to water-deficit stress
建议:相关 · 把握 99%

研究以拟南芥叶肉细胞为对象,建立单细胞蛋白质组学流程,并分析水分亏缺胁迫下 117 个原生质体的蛋白丰度变化。摘要未报告实际产生或分析 scRNA-seq 或 snRNA-seq 数据,因此不满足收录条件,但其原生质体制备与植物单细胞胁迫响应研究具有参考价值。

“Here, we present a single-cell proteomics workflow for plant cells …”摘要

只读了摘要

还没有判断。在你点之前,这篇文献一直是「待判断」。

图 4 一条建议和四个按钮。理由后面那句原文是逐字引的,引不出原文的理由不会被当作依据。

接着做:九篇教程

上面是一次运行的梗概。每一步的截图和实际填的内容在第一篇教程里;之后的八篇各讲一件科研里的事,用的是同一个文献库。

全部教程:各篇讲什么、需要什么、要多久

为什么这样设计

七条我们自己照着做的规则。每一条后面写着它在产品里落在哪儿,可以去核对。

  1. 01

    文献是你的

    不需要账号,没有云端。每个文献库是「文档/WispPaper」下的一个文件夹,数据库、PDF 和自定义词条都在里面,可以单独备份,也可以整个拷到别处继续用。

    在产品里附件记的是相对于文献库文件夹的路径。哪些内容会离开本机、发给谁,在数据与隐私里逐条列出。

  2. 02

    助手提议,人来决定

    助手读得快,但收不收是你的判断。它给出建议、理由和把握,不改任何一篇文献的收录状态;整组采纳之前也会先问一遍。

    在产品里从命令行或 MCP 接进来的外部 agent 只能提建议(suggest_screening),没有一个工具能改写收录判断。

  3. 03

    说话要有出处,出处要能点开

    筛选的理由必须带一句逐字引自摘要或全文的原文,引不出来的不算依据。回答里的 [P3 p.5] 点开就是那篇文献的 PDF,跳到那一页,所引的句子在页面上高亮;找不到的时候会明说。

    在产品里没有 PDF 时助手只读得到摘要,它会说自己只读了摘要,不编页码。

    移除的文献库去了哪里?换一台电脑还能接着用吗?

    没有被删除。移除文献库或附件,只是把它移到同一目录下的 removed/ 。换电脑也可以:附件记的是相对路径,整个文件夹拷过去就能接着用 。

    P1 · 数据与隐私

    数据与隐私

    文献库在「文档/WispPaper」下,每个文献库一个文件夹,内含 library.json、wisp-paper.sqlite 和 papers/。

    被移除的文献库、附件,放在同目录下的 removed/(只移动,不删除)。

    附件在数据库里记的是相对于文献库文件夹的路径,所以整个文件夹可以拷到别处继续用。

    API Key 以明文保存在 settings.json。留空则读取环境变量。

    1
    图 5 点一下回答里的出处。这里右边是本项目的《数据与隐私》;在应用里,它是你存的 PDF。
  4. 04

    先鲸吞,再细读

    与其一开始就把检索式写得很窄、担心漏掉什么,不如先宽一些地成批导入,去重,让助手逐篇过一遍,把值得自己看的那几十篇留给你。我们管这个叫鲸吞法。

    在产品里每次导入是一个批次,可以整批撤销,处理过的文献会保留。保存的检索式可以每 6 小时、每天或每周自己运行。

  5. 05

    什么都不会真的丢

    移除一个文献库或附件,只是把它移到 removed/。删掉的文献进回收站,可以恢复。

    在产品里回收站里的文献还留在库里,继续挡住同一篇被再次导入:你判断过不要的,不会下次同步又回来。

  6. 06

    原生,不是网页

    整个界面由 Rust 和 GPUI 在 GPU 上绘制,没有 WebView,没有 Electron。PDF 用纯 Rust 的 hayro 渲染,不依赖系统的 PDF 库。

    在产品里浅色和深色两套界面,每个文献库有自己的标识色,快捷键都可以改。

  7. 07

    一张工具表,三个入口

    窗口里的助手、命令行、MCP 用的是同一张工具表。一条规则只写在一处,所以无论从哪里进来,能做的和不能做的是一样的。

    在产品里见下一节。

目前的边界

  • 还在早期,变化很快。
  • 助手的部分需要你自己的模型服务;API Key 以明文保存在本机的 settings.json。
  • 每次运行一条检索式,最多取回最新的 2000 篇;这次运行是在上限还是 200 篇的版本上做的。
  • Linux 版不会自己更新,只提示有新版本。
  • Linux 版没有签名,也没有在真机上测试过。

窗口之外:wisp 与 MCP

wisp 是不开窗口的入口,随安装包附带。它读写和应用同一个数据目录,应用开着时也能用。每个工具既是一个子命令,也是一个 MCP 工具,输出是 JSON。

命令行
$ wisp list_libraries
$ wisp list_papers -l 植物单细胞转录组 --query protoplast --limit 10
$ wisp search_fulltext "10x Genomics Chromium"
$ wisp read_fulltext <文献 ID> --page 3
$ wisp sync_searches   # 交给 cron、launchd 或任务计划程序
$ wisp help            # 命令一览
交给支持 MCP 的 AI 客户端
{
  "mcpServers": {
    "wisp-paper": {
      "command": "/path/to/wisp",
      "args": ["mcp"]
    }
  }
}
表 1 工具一览。带写的会改动文献库,wisp mcp --read-only 不提供它们。
list_libraries所有文献库的 ID、名称、主题和文献数量
library_status一个库的概况:各状态的数量、自定义词条
list_papers搜索、筛选、翻页,规则与界面上的列表相同
get_paper一篇文献的完整记录、词条和附件
search_fulltext在已保存的全文里找短语,返回页码和逐字片段
read_fulltext按页读取全文,一次最多 8 页
find_citations为一段文字逐句找出库里可能支持它的文献
search_online在 PubMed、Europe PMC、Crossref 或 arXiv 试运行一个检索式,不写入
list_searches保存的检索式
save_search写保存一个检索式
remove_search写删除一个检索式
run_search写运行并导入,已有的文献跳过,返回批次号
list_imports导入记录
undo_import写整批撤销一次导入,处理过的文献保留
sync_searches写运行到期的检索式
suggest_screening写为一篇文献提出收录建议;不改变收录判断,由你在筛选页确认

命令行与 MCP 的完整说明

下载 Wisp Paper

最新版本在发布页。

macOS

macOS 11 起,Apple 芯片或 Intel

WispPaper-v版本-macos-arm64.dmg

WispPaper-v版本-macos-x64.dmg

Developer ID 签名并经 Apple 公证。打开后把 Wisp Paper 拖进「应用程序」,直接运行。不确定是哪一种:苹果菜单 › 关于本机,写着 Apple M… 的是 Apple 芯片,写着 Intel 的是 Intel。

Windows

Windows 10 / 11,x64

WispPaper-v版本-windows-x64-setup.exe

WispPaper-v版本-windows-x64.zip

安装版装在当前用户名下,不需要管理员权限,开始菜单里有它。便携版解压后运行 WispPaper.exe,不写注册表。都带 Authenticode 签名,都能自动更新。

Linux

x64

去发布页下载

WispPaper-v版本-linux-x64.tar.gz

解压后运行 wisp-paper。没有签名,也没有在真机上测试过。

装好之后

  • 命令行工具 wisp 随包附带:Windows 和 Linux 在主程序旁边(安装版在 %LOCALAPPDATA%\Programs\Wisp Paper),macOS 在 Wisp Paper.app/Contents/MacOS/wisp。
  • 收集、整理、PDF 和导出不需要模型。提问、建库向导、筛选和翻译需要在「设置 › AI」里配置你自己的模型服务。
  • 发布页里的 SHA256SUMS 是各个文件的校验和。
从源码构建(需要 Rust;Windows 上还需要 MSVC 构建工具)
$ git clone https://github.com/xuzhougeng/WispPaper
$ cd WispPaper
$ cargo run --release