故障排查

Core 找不到

确认 luox_core.dll 与 luox.exe 同目录且架构一致。Linux 和 macOS 检查动态库名称和搜索路径。

找不到命令插件

确认 plugins 下存在插件目录、plugin.json、commands 字段和发布入口。Host 不会猜测命令，也不会内置 g。

找不到主题

主题由项目模型插件选择。检查 theme 名称、主题目录、模板路径和主题资源。

页面为空

检查 source 目录是否含有支持的文件、Front Matter 是否正确、页面插件是否安装，以及主题是否声明对应 layout。

部署失败

先运行 dry-run，检查仓库、分支和 Git 凭据。默认插件不会自动 push。