用途:帮助开发者构建 Logseq 插件,使用 @logseq/libs SDK。
核心概念:Logseq 插件运行在沙箱 iframe 中,通过 RPC 桥与主应用通信。每个插件需要含 logseq 字段的 package.json 清单;用 logseq.ready(main) 初始化生命周期。
上手:可用 assets/template/(基础 TS)或 assets/template-react/(React + Vite)脚手架;安装依赖 npm install @logseq/libs;用 Vite 等打包器构建 JS/TS;在 Logseq 中进入 Settings -> Plugins -> Developer Mode,选择 Load unpacked plugin 加载插件目录。
常见工作流:注册命令用 logseq.Editor.registerSlashCommand 或 logseq.App.registerCommandPalette;读取内容用 logseq.Editor.getCurrentPageBlocksTree(),写入用 logseq.Editor.insertBlock(parentBlockId, content),查询用 logseq.DB.datascriptQuery(query);UI 用 logseq.provideUI 注入 HTML 或 logseq.showMainUI 显示全屏应用,主题使用 Logseq CSS 变量(如 --ls-primary-background-color)保持一致。
资源:API 参考见 references/api.md,示例见 references/examples.md(含思维导图、斜杠命令等模式)。
限制:资料未提供具体版本要求、兼容性、收费或性能数据。