Repository navigation
Pulsewright 1.1.0 · 读的那一半
你的知识,有自己的脉搏。
前几版都在回答同一个问题:我写下的东西,最近怎么样了。 这一版换了个方向,去管读进来的东西——你 Zotero 里存下的那些文献,到底读懂了没有。
同一个内核,两个宿主。Obsidian 是你的库,Zotero 是你的读。两端的版本号从这一版起对齐,往后也一起发。
这一版在做什么
在 Obsidian 里,缺的是「我在意的事有没有断」;在 Zotero 里,缺的是「这篇我存了半年,还记不记得当初为什么存它」。
所以这一版把「精读」拆成七个问题,做成一个弹窗。按 1 到 7 走一遍,一篇文献就算读过一遍。
六问
七段,每段只问一件事:
- 这本文献讲了什么 —— 类型、期刊、年份、摘要,摘要长可以展开。
- 我为什么选它 —— 一个输入框。旁边的提示只给库里的事实:什么时候加进库的、归在哪个分类、带了哪些标签、有没有 PDF、库里有几篇跟它主题相近。
- 库里有相关的吗 —— 按词面相似度排序,给百分比,点一条跳过去。
- 有没有更优解 —— 拿相似度最高的那篇做对照:年份、类型、来源、有没有摘要,一行一行摆着。
- 读完还有哪些问题 —— 输入框,加一个「保存到子笔记」。
- 下一本该读什么 —— 从库里挑三篇,标出「同类型」「更新」。
- 你的阅读痕迹 —— 批注数、附件、最近改动。
答案写进这条文献自己的子笔记,开头带一个 <!-- 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。