mirror of
https://github.com/whyour/qinglong.git
synced 2026-09-21 01:32:44 +08:00
57 lines
2.3 KiB
Markdown
57 lines
2.3 KiB
Markdown
# QingLong 3.0 Local 统一命令入口
|
||
|
||
Local Owner 管理制品提供统一的 `ql3` 入口，同时保留所有既有专用 binary。统一入口不
|
||
改变权限、command-file 或输出协议，只负责从同一安装制品的静态白名单启动精确命令。
|
||
|
||
```sh
|
||
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，因此文档
|
||
中的命令可以等价改写，例如：
|
||
|
||
```sh
|
||
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 显式运行：
|
||
|
||
```sh
|
||
ql3-service-bridge run \
|
||
--command-file /run/qinglong3-evidence/service-command.json
|
||
```
|
||
|
||
统一入口不会隐式 sudo、读取 root 文件或把 Owner command 转换为 bridge command。
|