Skip to content

Pulsewright v1.0.0

Choose a tag to compare

@yhjes2019 yhjes2019 released this 09 Nov 06:07

给你自己的 Obsidian 库做一次体检:九个标签页、一套自绘图表、一份能直接发出去的分享卡,全部在本地算完。

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

安装

插件还没上 Obsidian 社区市场,所以要手动放进库目录。下面两个包挑一个下载,都在本页底部的 Assets 里。

方式一:运行安装程序(Windows,最省事)

下载 Pulsewright-Setup-1.0.0.exe,双击运行。它会自动读出你电脑上所有 Obsidian 笔记库并列出来,选中一个点「安装到这个库」就装好了。

如果列表里没有你的库,点「浏览其他库…」自己选文件夹。装完打开 Obsidian → 设置 → 第三方插件 → 关掉「安全模式 / 受限模式」→ 启用 Pulsewright。Obsidian 已经开着的话按 Ctrl + R 重新加载。

没有数字签名,Windows SmartScreen 可能拦一下:点「更多信息」→「仍要运行」。安装器只做一件事——把三个文件复制进你选的库的 .obsidian/plugins/pulsewright/,不写注册表、不装服务、不改系统设置。

方式二:解压压缩包(Windows / macOS 通用)

下载 pulsewright-1.0.0.zip,解压得到一个 pulsewright 文件夹,里面是插件本体和一份《安装说明.txt》。

  1. 打开你的笔记库目录(就是放 .md 文件的那个文件夹)。
  2. 进 .obsidian/plugins/(没有 plugins 就自己新建一个)。
  3. 把整个 pulsewright 文件夹拖进去,最终长这样:<你的库>/.obsidian/plugins/pulsewright/manifest.json
  4. Obsidian → 设置 → 第三方插件 → 关掉「安全模式 / 受限模式」→ 启用 Pulsewright。

.obsidian 是隐藏文件夹。Windows 在资源管理器里勾「显示隐藏的项目」;macOS 在 Finder 里按 Cmd + Shift + .。
如果整个库都没有 .obsidian,先在 Obsidian 里点开一次「设置 → 第三方插件」,它会自动建出来。

方式三:自己拉源码

git clone https://github.com/yhjes2019/pulsewright.git
cp -r pulsewright <你的库>/.obsidian/plugins/pulsewright

Windows PowerShell:

Copy-Item -Recurse .\pulsewright "$env:USERPROFILE\Documents\你的库\.obsidian\plugins\pulsewright"

不需要 npm install,没有构建步骤,也没有任何第三方运行时依赖 —— 全文只有一句 require('obsidian')。

用 BRAT

装了 BRAT 的话,添加仓库地址 yhjes2019/pulsewright 即可,后续更新走 BRAT 的「Check for updates」。

卸载

禁用插件后删掉 .obsidian/plugins/pulsewright/ 目录。你的笔记一篇都不会少。

九个标签页

页签 它回答什么
看板 这个月我投入了多少?连续了几天?
知识地层 近 52 周,四种动作(写词 / 新建 / 内链 / 修订)各占多少
月相日历 每一天的月亮亮度=那天的强度
年度画像 一年里最好的那一天、最活跃的月份和星期
知识复盘 一份能直接贴进周报的 Markdown 周报
笔记地图 孤儿笔记、断链、标签云、目录分布
笔记洞察 我什么时候写、哪些笔记最该补、哪些标题快重复了
速记 面板里随手记,回车就存
数据 公式写在明面上,权重可改,CSV / JSON 一键导出

分享卡

数据页的「分享」卡可以导出 PNG 1080×1440 与同版 SVG,另可复制一段纯文本文案。卡上只有统计数字,不出现任何笔记标题或正文。

隐私

  • 全部本地计算,不联网、无授权码、无设备指纹、无账号。
  • 对 .md 只有 cachedRead,从不修改你的笔记正文。
  • 写操作只有两处:库里的 data.json,和你指定的数据目录(默认 Pulse/)。删掉即干净。

技术细节

  • 零运行时依赖,main.js 单文件。
  • 210 项单元测试 + node --check,GitHub Actions 在 Ubuntu / Node 20 跑 CI。
  • 界面全部自绘 CSS + 内联 SVG,不加载任何远程字体或图片。
  • 代码从零开始写,不基于任何其他插件。

MIT License © 2026 Luo