Skip to content

Pulsewright 1.0.2 · 按社区目录审核意见整改

Choose a tag to compare

@yhjes2019 yhjes2019 released this 09 Nov 09:28

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.css 25566 → 24960 字符。
  • 安装器为 C# WinForms 单文件(csc 编译,237056 B),三份插件文件以嵌入资源形式打包,运行时流式写出,不落地临时文件。

MIT License © 2026 Luo