Repository navigation
Pulsewright 1.0.2 · 按社区目录审核意见整改
Pulsewright 1.0.2 · 知识脉冲
你的知识,有自己的脉搏。
一个把 Obsidian 库变成「可读的生命体征」的插件:贡献分、年度热力图、知识地层、月相日历、年度画像、知识复盘、笔记地图、笔记洞察、速记、分享卡。
全本地计算 · 零授权校验 · 只读笔记(不会改动你的任何一篇)。
这一版在做什么
这一版没有新功能。它是为了进 Obsidian 社区市场,照着目录审核的 11 项检查逐条改的。
审核结果里 4 项直接通过(网络请求、读库、写库、依赖),剩下 7 项建议和警告,能改的全改了。改的都是那种「不影响你自己用,但会让审核卡住、或者让装插件的人犯嘀咕」的地方。
改进
- 命令 ID 去掉插件前缀:
open-pulsewright→open、rescan-pulsewright→rescan、export-pulsewright-csv→export-csv、export-pulsewright-json→export-json、pulsewright-memo→memo、pulsewright-map→map、pulsewright-insight→insight。Obsidian 自己会补上pulsewright:前缀,命令面板里显示的名字不变。 - manifest 名称改纯英文:
Pulsewright · 知识脉冲→Pulsewright。社区目录里一万多个插件,名称含非 ASCII 字符的一个都没有。 - 描述结尾改用半角句号:中文的
。换成.,符合目录的格式要求。 - README 补齐完整英文介绍:之前只有一小节开发说明,审核判为「没有英文文本」。现在英文节从 2.9K 字符扩到 18K,逐个说明九个页签、分享卡、评分公式、十三项设置、隐私边界、已知限制。
修复
- 10 处
!important清零:原来的写法是「先用动画,再用@media (prefers-reduced-motion: reduce)全部!important覆盖成 0」。改成把动效声明放进@media (prefers-reduced-motion: no-preference)——系统开启「减少动态效果」时那一段根本不匹配,自然不需要覆盖。效果一样,代码干净一半。 - 删死代码:
.kp-logo与@keyframes kp-breathe是早期版本留下的,全仓库无引用。
无障碍与隐私(回应审核的两条行为提示)
- Clipboard:插件只往剪贴板写,从不读。三处调用分别是「导出 Markdown」「复制分享文案」「复制分享卡文案」,都是你主动点按钮才触发。
- Vault Enumeration:为了统计贡献分和构建笔记地图,插件需要遍历库里的 Markdown 文件路径。这些路径只在本机内存里参与计算,不写日志、不发网络、不落任何缓存文件。
.obsidian、.trash、templates三个目录默认排除,你还可以在设置里追加要排除的目录。
安装
方式一:安装程序(推荐)
下载 Pulsewright-Setup-1.0.2.exe,双击运行,选中你的笔记库,点「安装到这个库」。装完打开 Obsidian → 设置 → 第三方插件 → 关掉「安全模式」→ 启用 Pulsewright。已经开着 Obsidian 的话按 Ctrl+R 重新加载。
静默安装(脚本/批量):Pulsewright-Setup-1.0.2.exe /silent "D:\你的库",日志写在 %TEMP%\pulsewright-setup.log。
方式二:压缩包
下载 pulsewright-1.0.2.zip,解压后把 pulsewright 整个文件夹放进 <你的库>/.obsidian/plugins/,再按上面的步骤启用。
方式三:社区目录
已经提交审核,通过之后可以直接在「设置 → 第三方插件 → 浏览」里搜到。
技术细节
- 测试:228 项单元测试全绿(
node tests/kp_test.js ./main.js)。 - 零依赖,无网络请求,无授权校验,不收集任何数据。
- 新增
package-lock.json(lockfileVersion: 3,零依赖,只有根包一条),让构建可复现。 - 新增
.github/workflows/release.yml:Release 发布后自动跑测试、对main.js/manifest.json/styles.css生成 GitHub artifact attestation(构建来源可验证),再上传到 Release。 styles.css25566 → 24960 字符。- 安装器为 C# WinForms 单文件(
csc编译,237056 B),三份插件文件以嵌入资源形式打包,运行时流式写出,不落地临时文件。
MIT License © 2026 Luo