用途:为复杂 Obsidian 插件提供参考架构与最佳实践项目布局,适用于设计新插件、审查项目结构或建立开发规范。
主要能力:给出模块化 src/ 目录结构(commands、views、settings、services 分离);薄入口 main.ts 只做编排;命令注册表模式;视图管理器与生命周期(onOpen/onClose、leaf 管理);封装 vault 读写与元数据操作的服务层;带默认值与迁移的类型安全设置;基于 Obsidian CSS 变量的插件作用域样式;以及基于 Events 的状态管理。
使用方式:需熟悉 TypeScript 与 Obsidian API,具备可用构建管线(推荐 esbuild),并完成插件脚手架(manifest.json、package.json、tsconfig.json)。按步骤建立目录、编写薄入口、注册命令与视图、实现服务层、设置界面与样式。
限制与注意:资料未提供收费、价格、平台或效果信息。需避免循环依赖、运行时缺失类型、事件监听泄漏、升级丢失设置、CSS 冲突、视图重启不恢复、服务持有过期引用等问题;建议使用类型导入、this.registerEvent()、版本化设置、类名前缀与 onunload 清理。