Files
qinglong/docs/operations/ql3-local-cli.md
T

2.3 KiB
Raw Blame History

QingLong 3.0 Local 统一命令入口

Local Owner 管理制品提供统一的 ql3 入口,同时保留所有既有专用 binary。统一入口不 改变权限、command-file 或输出协议,只负责从同一安装制品的静态白名单启动精确命令。

ql3 --version
ql3 --help
ql3 task --help
ql3 readiness --help
ql3 deploy --help

常用映射如下:

统一命令 原专用 binary 用途
ql3 setup ql3-local-setup Fresh Local 存储与 Owner material 准备
ql3 readiness ql3-local-readiness schema 与运行时 readiness 检查
ql3 deploy ql3-local-deploy systemd/OpenRC/Compose 部署 ceremony
ql3 owner ql3-owner Owner bootstrap 与恢复
ql3 identity ql3-identity Identity 与 API credential 管理
ql3 policy ql3-policy Project 与 Policy 管理
ql3 audit ql3-audit 有界安全审计查询
ql3 secret ql3-secret Local Secret 管理
ql3 task ql3-task TaskDefinition 管理
ql3 trigger ql3-trigger Trigger 管理
ql3 workflow ql3-workflow Package Workflow 管理
ql3 approval ql3-approval 人工 Approval inspect/decide
ql3 package ql3-package Plugin Package 生命周期
ql3 prompt ql3-prompt Package Prompt 查询与执行
ql3 ai-feature ql3-ai-feature 可选 AI schema 激活/停用

其他可发现子命令由 ql3 --help 列出。子命令后的参数会原样传给专用 binary,因此文档 中的命令可以等价改写,例如:

ql3 deploy prepare \
  --command-file /secure/operator/qinglong3-deployment.json

ql3 task run \
  --command-file /secure/operator/task-create.json

不要用 eval、shell alias 或自行拼接 binary 路径包裹 ql3。dispatcher 自身不使用 shell 或 PATH,并拒绝未知、绝对或路径穿越形式的 command name。

ql3-service-bridge 刻意不作为 ql3 子命令。它属于 root service-manager authority 必须继续由 root operator 使用 root-owned 0600 command file 显式运行:

ql3-service-bridge run \
  --command-file /run/qinglong3-evidence/service-command.json

统一入口不会隐式 sudo、读取 root 文件或把 Owner command 转换为 bridge command。