Enum Command 

pub enum Command {
    Make {
        make_command: MakeCommand,
    },
    Migrate {
        args: MigrateArgs,
    },
    MigrateStatus {
        path: String,
        db_type: String,
        show_sql: bool,
        url: Option<String>,
    },
    RouteList {
        format: String,
    },
    CacheClear {
        store: Option<String>,
    },
    Seed {
        path: String,
        db_type: String,
        show_sql: bool,
        url: Option<String>,
        class: Option<String>,
    },
    Scheduler {
        scheduler_command: SchedulerCommand,
    },
    OptimizeRoute,
    OptimizeConfig,
    OptimizeSchema,
    RouteClear,
    Plugin {
        plugin_command: PluginCommand,
    },
    Admin {
        admin_command: AdminCommand,
    },
    Serve {
        with_admin: bool,
        with_tenant: bool,
        with_data_scope: bool,
        addr: String,
        watch_config: bool,
        workers: Option<u16>,
        grace_timeout: Option<u16>,
        tls_cert: Option<PathBuf>,
        tls_key: Option<PathBuf>,
        access_log: bool,
        health: bool,
        no_health: bool,
    },
    ServeReload,
    ServeLogLevel,
}

顶层命令枚举

对齐 PHP think 的命令分组（make / migrate / route / cache）。

Variants

Make

代码生成命令组（make:migration / make:model / make:controller / make:guard / make:scaffold）

Fields

make_command: MakeCommand

make 子命令

Migrate

数据库迁移命令（migrate / migrate:status / migrate:rollback）

Fields

args: MigrateArgs

迁移子命令参数

MigrateStatus

迁移状态查询（对齐 PHP php think migrate:status）

Fields

path: String

迁移目录（默认 migrations）

db_type: String

数据库类型（默认 postgres，对齐 sz-orm DbType）

show_sql: bool

打印每个迁移的 SQL 内容

url: Option<String>

数据库连接 URL（启用在线模式，查询真实状态）

省略时为离线模式，所有迁移状态显示为 Pending*。

RouteList

路由列表（对齐 PHP php think route:list）

Fields

format: String

输出格式（table / json）

CacheClear

清空缓存（对齐 PHP php think cache:clear）

Fields

store: Option<String>

指定缓存存储名（默认清空所有）

Seed

数据填充（对齐 PHP php think db:seed）

从 seeds/ 目录加载 .sql 文件并执行。提供 --url 时连接数据库真实执行， 否则为离线模式（仅打印待执行内容）。

Fields

path: String

填充目录（默认 seeds）

db_type: String

数据库类型（默认 postgres，对齐 sz-orm DbType）

show_sql: bool

打印每个填充文件的 SQL 内容

url: Option<String>

数据库连接 URL（启用在线模式）

省略时为离线模式，仅打印待执行的 SQL。

class: Option<String>

指定填充器文件名（不含扩展名，如 001_users_seed）

省略时执行目录下所有 .sql 文件。

Scheduler

调度器命令组（scheduler:list / scheduler:run / scheduler:start）

Fields

scheduler_command: SchedulerCommand

scheduler 子命令

OptimizeRoute

生成路由缓存（对齐 PHP php think optimize:route）

收集路由元数据，序列化为 JSON 写入 runtime/cache/route_cache.json。

OptimizeConfig

生成配置缓存（对齐 PHP php think optimize:config）

扫描 config/ 目录，合并所有配置，序列化为 JSON 写入 runtime/cache/config_cache.json。

OptimizeSchema

生成数据表字段缓存（对齐 PHP php think optimize:schema）

读取 config/database.yml 数据库连接配置，生成 schema 缓存索引文件 （runtime/schema_cache.json + runtime/schema_cache.php）。 业务方运行时通过 SchemaCache::remember_schema() 填充具体字段信息。

RouteClear

清除路由缓存（对齐 PHP php think route:clear）

删除 runtime/cache/route_cache.json 文件。

Plugin

插件市场命令组（plugin search/install/publish/uninstall/update/list/login）

Fields

plugin_command: PluginCommand

plugin 子命令

Admin

Admin 后台管理插件命令组（admin migrate/list-routes/list-capabilities/init）

Fields

admin_command: AdminCommand

admin 子命令

Serve

启动 HTTP 服务（对齐 PHP php think run）

Fields

with_admin: bool

启用 admin 插件（加载 /api/admin/* 路由 + Capability 注册）

with_tenant: bool

启用 tenant_middleware（从 X-Tenant-Id Header 提取租户 ID）

with_data_scope: bool

启用 data_scope_middleware（注入数据权限上下文）

addr: String

监听地址（默认 0.0.0.0:8080）

watch_config: bool

启用配置热重载（监听 config/ 目录文件变更）

workers: Option<u16>

worker 线程数（默认 CPU 核心数，上限 1024）

grace_timeout: Option<u16>

优雅关闭超时秒数（默认 30，上限 300）

tls_cert: Option<PathBuf>

TLS 证书文件路径

tls_key: Option<PathBuf>

TLS 私钥文件路径

access_log: bool

启用访问日志中间件

health: bool

启用健康检查端点（默认启用）

no_health: bool

禁用健康检查端点

ServeReload

触发运行中的 serve 进程重载配置（Windows 替代 SIGUSR1/SIGHUP）

Unix 平台建议使用 kill -USR1 <pid> 或 kill -HUP <pid>。 首版仅输出提示信息，完整实现需后续版本支持。

ServeLogLevel

触发运行中的 serve 进程切换日志级别（Windows 替代 SIGUSR2）

Unix 平台建议使用 kill -USR2 <pid>。 首版仅输出提示信息，完整实现需后续版本支持。

Trait Implementations

impl Debug for Command

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl FromArgMatches for Command

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut<'b>( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

impl Subcommand for Command

fn augment_subcommands<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_subcommands_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

fn has_subcommand(__clap_name: &str) -> bool

Test whether Self can parse a specific subcommand