主题
运行时与通信
三种插件承载方式
资源插件不需要执行代码,适合主题模板、CSS、JS、图片、字体和语言包。它们通过清单和资源 manifest 被项目模型消费。
WASM 插件适合跨平台的 Markdown、代码高亮、图片处理和索引能力。它拥有清晰的内存边界,并可以由 Host 限制文件和网络权限。
独立 executable 适合需要完整运行时的 TypeScript SSR、Python 工具、GitHub 部署器和复杂构建器。最终发布包只包含打包后的 executable。
Core Bus
需要跨插件通信时使用 Core Bus 的 topic、subscriber 和 JSON payload。Core 不解释 topic 的博客含义。插件 SDK 应将常用 topic 包装成 Parser、Theme、Asset 和 PageProvider API,减少手写字符串错误。
日志与错误
插件的标准输出用于协议结果时不能混入日志;日志写标准错误。错误应该包含插件 ID、命令、阶段、文件和修复建议。长任务需要支持退出码、超时和取消。