Repository navigation
Pulsewright 1.0.1 · 启动动画与流畅度优化
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