Skip to content

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 实例在运行