Skip to content

Pulsewright 1.0.1 · 启动动画与流畅度优化

Choose a tag to compare

@yhjes2019 yhjes2019 released this 09 Nov 07:51
· 0 commits to f4570d47ea4b7d35dd4648052534c895ca1d6aa8 since this release

Pulsewright 1.0.1 · 知识脉冲

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

一个把 Obsidian 库变成「可读的生命体征」的插件:贡献分、年度热力图、知识地层、月相日历、年度画像、知识复盘、笔记地图、笔记洞察、速记、分享卡。

全本地计算 · 零授权校验 · 只读笔记(不会改动你的任何一篇)。


这一版在做什么

1.0.0 已经能用,但打开时是「啪」一下全亮。这一版把「打开」这件事做成一段可以被感知的仪式:品牌标记先描出轮廓,标题与口号淡入,页签错峰浮起,卡片依次落位——大约 1.6 秒,之后完全静止。

同时把「顺滑」当正经事处理:切页签、换区间、翻月翻年、速记增删改,都不再重建整个外壳。


新增

  • 插件启动入场动画:品牌环 760ms 描边生长(pathLength="1" + stroke-dashoffset),脉冲折线延后 400ms 跟进;标题/口号 420ms 淡入上浮;九个页签按 26ms 错峰;正文卡片按 40ms 依次淡入。全程只用 opacity 与 transform,走 GPU 合成,不触发布局。
  • 安装器动画:窗口 260ms 淡入,logo 从 0.74 缩放到 1,标题→副标→口号→分隔线→列表→按钮→状态行依次上浮落位(680ms 收尾);点「安装到这个库」后进度条 460ms 缓入缓出推进,写盘完成后状态行变色并提示下一步。
  • /noanim 开关:安装器支持 /noanim 关闭全部动画;检测到远程桌面会话(SystemInformation.TerminalServerSession)时自动降级为无动画。

改进

  • 正文级重绘:新增 renderBodyOnly(),18 处整壳 render() 中 16 处改为只重建 .kp-body——切页签、换区间、换指标、翻月、翻年、翻周、速记的保存/搜索/编辑/删除、地图标签筛选、数据页重建。仅「换画风」与「刷新」保留整壳重建(它们本来就要换外壳类名或复位按钮文案)。
  • 搜索输入 rAF 合并:速记与地图的搜索框改为 requestAnimationFrame 合并,一帧内多次按键只重绘一次,光标位置与选区保持。
  • 指纹短路:viewSignature() 把 daily 六项汇总、笔记缓存条数、速记条数、当前页签/区间/指标/画风/设置版本拼成一个串;refresh() 发现指纹未变就直接返回,不再做无意义的 DOM 重建。
  • 滚动体验:.kp-body 加 scrollbar-gutter: stable(切换页签时不再因滚动条出现/消失而横向抖动)与 overscroll-behavior: contain(滚到底不把整个 Obsidian 一起带着滚)。
  • 过渡属性具名化:.kp-chip、.kp-btn、.kp-tab 从 transition: all 改为逐属性声明,避免无关属性变化也触发合成。

无障碍

  • 全站尊重 prefers-reduced-motion: reduce:系统开启「减少动态效果」后,入场动画、呼吸动画、描边生长全部关闭,描边直接归位,过渡归零。
  • 补 :focus-visible 焦点环,键盘 Tab 走页签时有清晰可见的落点。

安装

方式一:安装程序(推荐)

下载 Pulsewright-Setup-1.0.1.exe,双击运行,选中你的笔记库,点「安装到这个库」。装完打开 Obsidian → 设置 → 第三方插件 → 关掉「安全模式」→ 启用 Pulsewright。已经开着 Obsidian 的话按 Ctrl+R 重新加载。

静默安装(脚本/批量):Pulsewright-Setup-1.0.1.exe /silent "D:\你的库",日志写在 %TEMP%\pulsewright-setup.log。

方式二:压缩包

下载 pulsewright-1.0.1.zip,解压后把 pulsewright 整个文件夹放进 <你的库>/.obsidian/plugins/,再按上面的步骤启用。


技术细节

  • 测试:228 项单元测试全绿(node tests/kp_test.js ./main.js)。
  • 零依赖,无网络请求,无授权校验,不收集任何数据。
  • 新增纯函数 introDelay(i, step, base, cap)、viewSignature(o),均登记进 PURE 导出表。
  • 安装器为 C# WinForms 单文件(csc 编译,237568 B),三份插件文件以嵌入资源形式打包,运行时流式写出,不落地临时文件。

MIT License © 2026 Luo