用途:为 Obsidian 插件建立从保存到重载的亚秒级编辑—构建—测试循环。
主要能力:基于官方示例插件模板起步;用 esbuild 监听模式在源码变更时重建 main.js;将项目目录软链接进专用开发库,免去手动复制;通过 Ctrl+R(macOS 为 Cmd+R)或 Hot Reload 社区插件自动重载;用 Chrome DevTools 调试(Ctrl+Shift+I);用 vitest 配合 obsidian 模块 mock 做单元测试。
必要用法:需 Node.js 18+、npm、Git 和 Obsidian 桌面版,并准备独立开发库。克隆 https://github.com/obsidianmd/obsidian-sample-plugin.git 后 npm install;创建开发库并软链接插件目录(Windows 用 mklink /D 需管理员终端);运行 npm run dev 启动监听;在插件目录创建 .hotreload 文件以启用自动重载;安装 vitest 并创建 mocks/obsidian.ts 后运行 npx vitest run 或 npx vitest --watch。
适用场景:Obsidian 插件本地开发、调试与测试。
限制:资料未提供收费、价格、平台支持范围或性能保证;需自行准备开发库,避免使用真实笔记库。