# 完整命令参考

CLI 1.2 命令、主要选项、结果与各流程参考。

需要 WU CLI `1.2.0`，应用 API 需要 WU Framework `4.0.0`。请检查 `wu --version` 和项目依赖。

```sh
wu --version
wu --help
```

各命令分别解析参数，选项与限制请参阅相应章节。npm 启动器选择二进制并管理 `wu update`。编译命令与契约工具按需使用项目中的 Node 依赖。

| 命令 | 契约与参考 |
| --- | --- |
| `wu create [name] --template <framework> --shell <framework>` | [创建项目](/zh-cn/docs/cli/create/)；无选项时启动向导。 |
| `wu add <framework> <name> [--no-install]` | [添加应用](/zh-cn/docs/cli/add/)。 |
| `wu install [--force]` | [安装依赖](/zh-cn/docs/cli/dependencies/)；别名 `wu i`。 |
| `wu dev [--port <n>] [--native\|--vite] [--open\|--no-open]` | 在同一 HTTP 源中 [开发](/zh-cn/docs/cli/development/)。 |
| `wu build [--native] [--no-pwa] [--budget-warn] [--jobs <n>] [--no-cache] [--sign <key.pem>]` | 将 [生产构建](/zh-cn/docs/cli/build/) 输出到 `dist/`。 |
| `wu serve [port] [--mode static\|spa]` | [预览生产构建](/zh-cn/docs/cli/serve/)；默认端口 `3000`。 |
| `wu doctor [--json] [--url <url>] [--entry <path>] [--route <path>] [--timeout <ms>] [--integrity] [--pubkey <file>]` | [诊断](/zh-cn/docs/cli/doctor/) 项目或已部署站点。 |
| `wu test [--browser] [options]` | [Node 或浏览器测试](/zh-cn/docs/cli/testing-mocks/)。 |
| `wu mock <contract.json> [options]` | [生成可编辑 mock 应用](/zh-cn/docs/cli/testing-mocks/)。 |
| `wu contracts types <files...> --out <file.d.ts>` | 为一个或多个版本 [生成类型](/zh-cn/docs/cli/contracts/)。 |
| `wu contracts check <old.json> <new.json> [--translators <module>] [--json]` | [比较契约](/zh-cn/docs/cli/contracts/) 与转换器覆盖范围。 |
| `wu pack <app> [--sign <key.pem>] [--out <file.wuapp>] [--version <version>] [--dist <dir>] [--json]` | [打包应用](/zh-cn/docs/cli/pack/)；`wu pack --keygen <key.pem>` 生成密钥。 |
| `wu upgrade [--dry-run] [--check] [--yes] [--json] [--force]` | [迁移清单与模板](/zh-cn/docs/cli/dependencies/)，不降低版本。 |
| `wu catalog [--json]` | [查看已安装 CLI 的目录](/zh-cn/docs/cli/templates/)。 |
| `wu info` | 显示有效配置。 |
| `wu update` | [更新启动器和二进制](/zh-cn/docs/cli/installation/)，不会改变项目依赖。 |
| `wu version` / `wu --version` / `wu -v` | 显示编译版本。 |
| `wu help` / `wu --help` / `wu -h` | 显示通用帮助；无参数执行 `wu` 具有相同效果。 |

`deploy`、`status`、`config`、`remove`、`init` 与 `preview` 不是 CLI 命令。通过托管服务发布 `dist/`，并在 `wu.config.json` 中配置项目。未知命令会报错；测试、契约与 doctor 的退出码见相应章节。