Skip to content

Pulsewright 1.1.0 · 读的那一半

Latest

Choose a tag to compare

@yhjes2019 yhjes2019 released this 17 Nov 14:44
· 1 commit to main since this release

Pulsewright 1.1.0 · 读的那一半

你的知识,有自己的脉搏。

前几版都在回答同一个问题:我写下的东西,最近怎么样了。 这一版换了个方向,去管读进来的东西——你 Zotero 里存下的那些文献,到底读懂了没有。

同一个内核,两个宿主。Obsidian 是你的库,Zotero 是你的读。两端的版本号从这一版起对齐,往后也一起发。


这一版在做什么

在 Obsidian 里,缺的是「我在意的事有没有断」;在 Zotero 里,缺的是「这篇我存了半年,还记不记得当初为什么存它」。

所以这一版把「精读」拆成七个问题,做成一个弹窗。按 1 到 7 走一遍,一篇文献就算读过一遍。

六问

七段,每段只问一件事:

  1. 这本文献讲了什么 —— 类型、期刊、年份、摘要,摘要长可以展开。
  2. 我为什么选它 —— 一个输入框。旁边的提示只给库里的事实:什么时候加进库的、归在哪个分类、带了哪些标签、有没有 PDF、库里有几篇跟它主题相近。
  3. 库里有相关的吗 —— 按词面相似度排序,给百分比,点一条跳过去。
  4. 有没有更优解 —— 拿相似度最高的那篇做对照:年份、类型、来源、有没有摘要,一行一行摆着。
  5. 读完还有哪些问题 —— 输入框,加一个「保存到子笔记」。
  6. 下一本该读什么 —— 从库里挑三篇,标出「同类型」「更新」。
  7. 你的阅读痕迹 —— 批注数、附件、最近改动。

答案写进这条文献自己的子笔记,开头带一个 <!-- pulsewright-six --> 标记。不另建库,不另存一份,跟着 Zotero 同步走——换台电脑,答案还在。重开面板会自动读回来。

一篇接一篇

面板右上角有「‹ 上一篇 / 下一篇 ›」,按文献列表当前的排序走。先把列表按年份排好,就是一条自然的阅读路线;翻到头会告诉你到头了,不会绕回去。

四个入口:工具菜单、条目右键、条目工具栏的脉搏图标、Ctrl+Shift+6。都要先在列表里选中一条文献。

端点

Zotero 7 到 10 都能装。它没有官方插件目录,只能手动装 .xpi——工具 → 插件 → 齿轮 → Install Plugin From File。

它直接调 Zotero 自己的条目接口,不走 HTTP,不开端口,不联网。和 Obsidian 端一样,代码里没有发请求的那几行。

性能

这一版没加多少新东西,主要是把该省的省掉。

  • 定时扫描读到零变更时,不再重写一遍索引文件。真库 306 篇实测:冷扫 2.9 秒,无变更 3 毫秒。
  • 每个视图记住自己的滚动位置,切回来还在原处。
  • Zotero 批量导入时,索引重建合并成停顿后的一次,不再每加一条重建一遍。
  • 十一个视图渲染合计 67.9 ms,最慢的看板 13.7 ms。

安装

Obsidian:三个文件放进 .obsidian/plugins/pulsewright/,或者下 zip 解压,或者直接跑 Pulsewright-Setup-1.1.0.exe。

Zotero:下 pulsewright-1.1.0.xpi 装进去。装好后工具菜单里会多一项「六问」。

技术细节

  • 零依赖。两端共用一份纯 JS 内核(分词、相似度、健康分、时间区间),界面各写各的——两个宿主的界面模型差得太远,硬套一个壳只会两边都别扭。
  • 测试:Obsidian 289 项、Zotero 93 项,全绿。
  • 计算全在本机。Obsidian 端全文只有一句 require('obsidian'),没有 fetch、XMLHttpRequest、requestUrl,也没有任何一个 http 地址。
  • 协议 MIT,作者 Luo。