# 运行时服务接口

## 接口标准
- 接口类型：命令行接口
- 调用入口：`php think <command>`
- 返回形式：控制台文本输出、进程状态变化、运行时配置文件

## 接口列表

### `xadmin:worker`
- 说明：统一管理 HTTP 与队列常驻服务

```jsonc
{
  "action": "start", // 动作类型：`start`、`serve`、`stop`、`restart`、`reload`、`status`、`query`、`check`
  "target": "http", // 服务目标：`http`、`queue`、`all` 或具体服务名
  "host": "", // 可选，覆盖服务监听地址，仅单服务时有效
  "port": "", // 可选，覆盖服务监听端口，仅单服务时有效
  "daemon": false // 是否以守护进程方式运行
}
```

### `xadmin:queue`
- 说明：执行或清理系统队列任务

```jsonc
{
  "action": "clean", // 动作类型：`clean` 或 `dorun`
  "code": "" // 可选，指定任务编号；执行单任务时使用
}
```

### `config/worker.php`
- 说明：运行时服务配置接口，由发布命令生成到项目根目录

```jsonc
{
  "defaults": {}, // 默认运行参数、监控参数与内存限制
  "services": {
    "http": {}, // HTTP 服务配置
    "queue": {} // 队列服务配置
  }
}
```