主题
API 参考
API 文档描述 luox 的稳定接入点——Core C ABI、Bus 消息协议、插件生命周期和安全边界。这些接口不包含博客语义;文章、页面、主题和部署协议由项目模型插件和 SDK 定义。
何时需要读这一章
- 你在编写原生插件(C/C++/Rust),需要直接调用
luox_core.dll的导出函数。 - 你在实现新的语言 SDK,需要理解字符串所有权和错误码约定。
- 你在调试插件间通信,需要了解 topic、payload 和队列行为。
- 你在评估插件安全性,需要理解权限模型和 dry-run 约定。
如果你只是使用现有插件和主题写博客,不需要读这一章——直接看用户指南即可。
各节说明
| 章节 | 内容 | 适合读者 |
|---|---|---|
| Core C ABI | 导出函数、参数类型、内存规则 | C/C++/Rust 插件作者 |
| Bus 与 Payload | topic、subscriber、JSON payload、大小限制 | 所有插件作者 |
| 插件生命周期 | Host 如何发现、加载、启动和退出插件 | SDK 维护者 |
| 错误、日志与权限 | 错误格式、日志规范、权限声明、dry-run | 插件作者、审核者 |
核心边界速查
text
luox_core.dll 只知道:
topic、subscriber、payload、字符串、版本
luox_core.dll 不知道:
文章、页面、主题、CSS、Markdown、GitHub这行边界是理解所有 API 设计决策的钥匙。如果你发现某个函数似乎"应该"理解博客但拒绝这么做——那不是 bug,是架构。