---
title: "CLI 命令参考"
description: "查询 Glass CLI 命令、应用包检查和本地信任文件格式。"
---

> Documentation Index
> Fetch the complete documentation index at: https://h5-app-docs.glass.tengyusmart.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI 命令参考

`@glass/cli` 提供 `glass` 命令。安装到项目后，从 npm script 或通过 `npx --no-install glass` 调用。

| 命令 | 输入与结果 |
| --- | --- |
| `glass create DIRECTORY` | 创建一个新的目录和 React/Vite 模板。目标目录须不存在。 |
| `glass dev [DIRECTORY]` | 启动 Vite。省略目录时使用当前目录。 |
| `glass build [DIRECTORY]` | 构建静态资源到项目的 `dist/`。 |
| `glass pack DIRECTORY OUTPUT --sequence N` | 校验清单与资源，生成未签名的应用包。使用发布方分配的正整数序号。 |
| `glass inspect PACKAGE` | 检查结构与完整性，显示应用身份、发布序号、清单摘要和是否带签名。 |
| `glass sign UNSIGNED OUTPUT --key PEM --key-id KEY_ID` | 使用外部 Ed25519 私钥签名。已存在的输出文件会被拒绝。 |
| `glass verify SIGNED --trust JSON` | 使用指定信任文件校验签名与发布者、应用范围。成功时输出 `verified: true`。 |

`inspect` 可以检查未签名包。包中有签名时，仍需执行 `verify` 核实该签名是否符合指定信任。眼镜以自身信任配置决定是否安装。

## 验签文件

向平台取得对应环境的公钥信任文件。每条记录含以下字段：

| 字段 | 内容 |
| --- | --- |
| `keyId` | 与包签名声明一致的键 ID。 |
| `publisherId` | 该键允许签名的发布者。 |
| `appIds` | 该键允许签名的应用 ID 列表。 |
| `publicKey` | Ed25519 公钥，SPKI DER 的 Base64 字符串。 |

记录放在顶层 `keys` 数组。签名私钥由授权签名方在项目外保存。

Source: https://h5-app-docs.glass.tengyusmart.cn/reference/cli/index.mdx