跳转至

ual-cli 命令参考

生成来源:Server/ual_cli/ual_cli.py 的 argparse 定义。当前仓库未提供 console script,统一用 python Server/ual_cli/ual_cli.py <command> 调用。

全局参数

参数 类型 默认值 说明
--index Path to .ual/index.duckdb

build

Build/update the DuckDB index

参数 类型 默认值 说明
--project UE project root
--engine-cmd Path to UnrealEditor-Cmd.exe
--from-jsonl Ingest a Commandlet JSONL file
--demo flag Ingest bundled demo seed (no UE required)
--incremental flag Skip unchanged content_hash

lint-duplicates

Cosine self-join duplicate gate

参数 类型 默认值 说明
--threshold float 0.85
--diff-only flag Only assets added in this Git change

verify-references

Validate asset references in configs/scripts

参数 类型 默认值 说明
--scan-dirs Content/Abilities,Content/Script
--project Root for relative scan dirs

export-parquet

Export catalog as Parquet

参数 类型 默认值 说明
--out .ual/shared_catalog.parquet

self-test

Offline end-to-end check

(无参数)

退出码

命令 通过 拦截 环境错误
lint-duplicates 0 1(发现重复对) 2(索引缺失)
verify-references 0 1(发现断裂引用) 2(索引缺失)
build / export-parquet / self-test 0 1 2

门禁细节与 CI 接入见 ci-gates.md。