项目模型插件教程

项目模型插件负责定义“一个项目是什么”。它决定配置在哪里、文章从哪里读取、页面如何表示、主题如何选择、生成结果写到哪里以及用户使用哪些命令。

默认博客模型

默认插件可以选择类似 Hexo 的安排：_config.yml、source/_posts、source/about、source/categories、source/tags、source/archives、themes、scaffolds、plugins 和 public。这些名称来自插件本身，Host 完全不知道。

自定义模型

你可以把同一套 luox Host 改造成文档站模型：

docs-model/
├── docs/
├── layouts/
├── static/
└── site.toml

该插件可以注册 build、serve 和 publish，而不是 cl、g、d。只要清单声明命令，Host 就能启动它。

设计建议

项目模型应把 Document、Page、Route、Asset 和配置 schema 写入公开协议；不要让主题读取项目模型的私有数据库。提供迁移命令，允许旧目录升级。对不存在的目录给出可操作错误，不要静默生成空站点。