# @glasshome/widget-cli 中文文档

规范地址：https://npmcn.com/package/%40glasshome/widget-cli/

版本：0\.21\.2
npm 元数据更新时间：2026-11-15T21:44:53.562Z
中文译文更新时间：2026-11-16T16:05:49.291Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40glasshome/widget-cli
原文对照：https://npmcn.com/package/%40glasshome/widget-cli/?lang=original
项目主页：https://github.com/glasshome/widget-cli#readme
源码仓库：https://github.com/glasshome/widget-cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：249 kB，56 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：13 个
- peer 依赖：vite ^7\.3\.1，playwright ^1\.40\.0
- 首次发布：2026-03-22T22:20:53.888Z
- 最新版本发布：2026-11-15T21:44:53.241Z
- 近 30 天下载量：3471（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：96（近 12 个月 96 个）

## 中文简介

用于创建和管理 GlassHome 部件的 CLI

## 安装

```sh
npm install @glasshome/widget-cli
```

也可以使用：`pnpm add @glasshome/widget-cli`、`yarn add @glasshome/widget-cli`、`bun add @glasshome/widget-cli`

## README

# @ glasshome/ widget-cli (英语)

用于创建和管理部件的 CLI [格拉斯之家](https://glasshome.app/)本地首个家庭助理仪表板 脚手架, 预览并发布 GlassHome 枢纽的部件; 见 [部件开发指南](https://glasshome.app/docs/widget-development) 为了整个流动.

## 安装

```bash
bun add -g @glasshome/widget-cli
```

## 快速启动

```bash
# Create a new widget project (interactive)
bunx @glasshome/widget-cli

# Or explicitly
bunx @glasshome/widget-cli create
```

## 图标

| 命令 | 说明 |
| --- | --- |
| `create` | 创建新部件工程( 未找到工程时默认) |
| `add` | 在现有工程中添加新部件 |
| `build` | 构建全部部件 |
| `connect <url>` | 连接运行中的仪表板进行现场测试 |
| `validate [name]` | 验证所有部件或特定部件 |
| `publish [hub-url]` | 选择并发布到 GlassHome 枢纽的部件 |
| `login [hub-url]` | 使用 GlassHome Hub 认证( 发布前需要) |
| `info [name]` | 显示部件元数据和捆绑信息 |
| `upgrade` | 将 @ glasshome/ widget- sdk 升级为最新版本 |

运行 `glasshome-widget` 部件工程中没有命令 。 在部件项目之外, 它启动创建向导 .

## 出版

```bash
# Login first (one-time)
glasshome-widget login

# Then publish
glasshome-widget publish
```

CLI 提示您选择一个部件, 选择一个版本的凸起, 然后构建并发布 。 每个部件都跟踪它自己的版本 `manifest.json`。 。 。 .

## 文档

完整文件时间 [glasshome.app/docs (英语)](https://glasshome.app/docs)

## 许可证

麻省理工学院

## 常见问题

### @glasshome/widget-cli 是什么？

用于创建和管理 GlassHome 部件的 CLI

### 如何安装 @glasshome/widget-cli？

在项目目录运行 npm install @glasshome/widget-cli，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vite（^7\.3\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 glasshome-widget，可以用 npx glasshome-widget 直接运行。

### @glasshome/widget-cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/glasshome\_\_widget-cli 是否存在。

### @glasshome/widget-cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @glasshome/widget-cli 可以商用吗？

@glasshome/widget-cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @glasshome/widget-cli 的下载量有多少？

根据 npm 官方下载统计，@glasshome/widget-cli 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,471 次，日均约 116 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @glasshome/widget-cli 还在维护吗？

最新版本 0\.21\.2 发布于 2026/11/16（今天）；至今共发布 96 个版本，其中过去 12 个月发布了 96 个；首次发布于 2026/03/23。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

