CLI
specola-core 就是 Core 进程。桌面应用会自动启动它;在校验配置、无界面机器或 systemd 服务中,你需要 自己运行它。
bash
specola-core -t --config my.toml # 校验后退出
specola-core --config my.toml # 运行参数
| 参数 | 含义 |
|---|---|
--config <文件> | 要加载的配置:绝对路径,或文件名(先在配置目录中查找,再在可执行文件所在目录查找) |
-t、--test-config | 加载并校验 --config,输出结果后退出,不启动 Core |
--data-dir <目录> | 便携模式:配置、缓存、日志和运行时文件都放在 <目录> 下,而不是用户目录 |
--ipc-endpoint <路径> | 本地控制 socket(Unix socket 或命名管道)的位置 |
--parent-pid <pid> | 该进程退出时 Core 也退出;供桌面应用使用 |
配置目录:Linux 为 ~/.config/specola/profiles/,macOS 为 ~/Library/Application Support/com.specola.Specola/profiles/,Windows 为 %LOCALAPPDATA%\Specola\profiles\。
-t 会像正常启动一样下载远程 provider 和规则集,因此也会检查它们是否可达。成功时输出 Config validation passed: <路径>;失败时输出 Config validation failed: 以及全部错误。
退出码
| 退出码 | 含义 |
|---|---|
0 | 成功 |
1 | 校验或启动失败,见输出信息 |
2 | 找不到配置文件或未指定 |
3 | 当前用户已有一个 Core 实例在运行 |