CLI 参考
thurgio [OPTIONS] [COMMAND]
全局参数
| 参数 | 环境变量 | 默认值 | 说明 |
|---|---|---|---|
-c, --config <FILE> | — | thurgio.yaml | 配置文件路径。sibling YAML 与模板目录相对其所在目录解析 |
-r, --root <DIR> | ROOT | 当前目录 | 工作根目录（进程 chdir 到该目录；数据库与输出相对路径均按它解析） |
-h, --help | — | — | 帮助 |
-V, --version | — | — | 版本 |
全局参数必须放在子命令之前：thurgio -r . build（thurgio build -r . 会报错）。
子命令总览
| 命令 | 别名 | 说明 | 文档 |
|---|---|---|---|
build | b | 更新 + 渲染 + 写盘；--watch 监听重建 | build |
serve | s | 启动 HTTP/TLS API 服务器 | serve |
init | i | 生成最小可用配置脚手架 | init |
check | c | 校验配置并打印摘要与逐项检查结果 | check |
diff | d | 输出文件 diff 或订阅节点级 diff | diff |
config | cfg | 配置声明文件备份 / 回滚 / 列表 | config |
upgrade | u | 检查 GitHub Releases 新版本 | upgrade |
generate | g | 生成 shell 补全脚本 | generate |
version | V | 打印版本信息 | version |
不带子命令直接运行 thurgio 只加载配置后退出（可用于验证解析是否成功）。
命令的初始化需求
各命令对环境的依赖不同（排错时有用）：
| 阶段 | 命令 |
|---|---|
| 不需要 logger/配置 | generate, version |
| 只需要 logger | init |
| 只需要 root 目录 | config（备份/回滚在坏配置下也能运行） |
| 完整初始化（配置 + 数据库 + 渲染器 + 熔断器恢复） | build, check, diff, serve, upgrade |
启动流程细节见 app。
环境变量
所有带环境变量的参数遵循同一优先级：命令行 > 环境变量 > 默认值/配置值。完整清单见配置指南。