命令行参考 (CLI Reference)
zero-native 命令行界面（CLI）提供了项目脚手架搭建、校验、打包和调试等功能工具。
基础命令
| 命令 | 描述 |
|---|---|
zero-native init [path] --frontend <next|vite|react|svelte|vue> | 使用指定的前端框架初始化一个 zero-native 新项目。若省略路径参数，则在当前目录下搭建项目。 |
zero-native dev --binary <path> | 启动应用，并使用受管理的开发服务器托管前端项目（需要提供 --binary 参数）。 |
zero-native doctor | 检查宿主系统环境、WebView、清单（Manifest）和 CEF 环境。 |
zero-native cef install | 下载、准备并校验适用于 macOS 的 CEF 运行时环境。 |
zero-native cef path | 打印默认或配置的 CEF 目录路径。 |
zero-native cef doctor | 仅检查 CEF 的目录结构布局。 |
zero-native validate [app.zon] | 根据清单模式定义校验 app.zon 文件是否合法。 |
zero-native package | 将应用打包以进行分发。 |
zero-native bundle-assets [app.zon] [assets] [output] | 将构建好的前端静态资源复制到编译输出中。 |
zero-native package-windows | 针对 Windows 的打包快捷命令。 |
zero-native package-linux | 针对 Linux 的打包快捷命令。 |
zero-native package-ios | 针对 iOS 的打包快捷命令。 |
zero-native package-android | 针对 Android 的打包快捷命令。 |
zero-native automate <command> | 与自动化服务器进行交互。 |
zero-native skills list | 列出内置的 AI 代理人能力技能（Skills）。 |
zero-native skills get <name> [--full] | 输出内置的 AI 代理人能力技能的具体内容。 |
zero-native version | 打印当前 zero-native 命令行工具的版本。 |
zero-native skills 子命令
| 子命令 | 描述 |
|---|---|
skills list | 列出当前安装的 CLI 中内置的所有 AI 技能。 |
skills get core | 为 AI 代理输出 zero-native 应用构建开发指南。 |
skills get automation | 为 AI 代理输出运行应用时所需的自动化交互指南。 |
skills get --all [--full] | 输出所有未隐藏的技能；如果添加 --full 参数，还将包含自带的参考和模板文件。 |
zero-native cef 参数标志
| 参数 | 描述 |
|---|---|
--dir | CEF 安装目标目录。默认是位于 third_party/cef 下对应当前主机的平台目录。 |
--version | 待下载的 CEF 二进制版本。默认是 zero-native 锁定的已测试版本。 |
--source | prepared 或 official。默认是 prepared，它会从 GitHub Releases 下载 zero-native 的免 CMake 运行时包。 |
--download-url | 覆盖预制运行时的发布地址，或者在使用 --source official 时覆盖官方 CEF 主机地址。 |
--allow-build-tools | 允许高级官方 CEF 安装路径调用本地编译工具来构建 libcef_dll_wrapper。 |
--force | 重新下载并强制替换目标目录。 |
在 zero-native 运行时发布版本尚不存在前，需要从源码构建 CEF 的核心维护者应使用 tools/cef/build-from-source.sh。对于普通应用开发者，命令行默认的 zero-native cef install 安装路径仍是免 CMake 编译的快速路径。
zero-native package 参数标志
| 参数 | 描述 |
|---|---|
--target | 目标发布平台（macos, linux, windows, ios, android） |
--manifest | app.zon 描述清单文件的路径 |
--output | 打包后的输出结果存放路径 |
--binary | 编译生成的二进制文件路径 |
--assets | 前端静态构建资源（Assets）的目录路径 |
--optimize | 代码优化等级 |
--web-engine | 临时覆盖 app.zon 中的引擎配置（可设为 system 或 chromium） |
--cef-dir | 临时覆盖 app.zon 中的 CEF 运行时分发路径 |
--cef-auto-install | 临时允许在打包 Chromium 应用期间自动下载并安装预备好的 CEF 运行时 |
--signing | 签名模式：none (无), adhoc (临时的), 或 identity (使用签名证书标识) |
--identity | 代码签名证书的标识名称 |
--entitlements | 签名授权凭证（Entitlements）文件的路径 |
--team-id | 苹果开发者团队团队 ID（Team ID） |
--archive | 创建一个适合分发的压缩包归档文件 |
zero-native dev 参数标志
| 参数 | 描述 |
|---|---|
--binary (必填) | 编译好的应用二进制文件路径 |
--manifest | app.zon 清单文件路径（默认是 app.zon） |
--url | 覆盖 app.zon 中配置的前端开发服务器 URL |
--command | 覆盖开发服务器启动命令（使用空格分隔） |
--timeout-ms | 等待开发服务器就绪的超时毫秒数（默认使用 app.zon 中指定的值，或 30000 毫秒） |
zero-native automate 子命令
| 子命令 | 描述 |
|---|---|
automate list | 列出当前正在运行并启用了自动化的应用 |
automate snapshot | 转储当前应用状态的快照数据 |
automate screenshot | 对应用当前界面进行截屏 |
automate reload | 重新加载 WebView 页面 |
automate wait | 等待快照数据中出现 ready=true 状态 |
automate bridge <json> | 发送桥接控制命令（使用 zero://inline 源） |
环境变量 (Environment Variables)
| 变量名 | 描述 |
|---|---|
ZERO_NATIVE_FRONTEND_URL | 前端开发服务器的 URL 地址（供 frontend.sourceFromEnv 读取） |
ZERO_NATIVE_FRONTEND_ASSETS | 应用级别的约定，用于指示应加载预构建的本地资产 |
ZERO_NATIVE_LOG_DIR | 覆盖指定的日志输出保存目录 |
ZERO_NATIVE_LOG_FORMAT | 日志输出格式类型：可为 text (纯文本) 或 jsonl (JSON Lines) |