@glasshome/widget-cli

中文文档
0.21.2发布于 2026/11/16MITES Module构建来源已验证近 30 天下载 3471

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

中文使用文档
文档目录6 节
  1. 安装
  2. 快速启动
  3. 图标
  4. 出版
  5. 文档
  6. 许可证

@ glasshome/ widget-cli (英语)

用于创建和管理部件的 CLI 格拉斯之家本地首个家庭助理仪表板 脚手架, 预览并发布 GlassHome 枢纽的部件; 见 部件开发指南 为了整个流动.

安装

bun add -g @glasshome/widget-cli

快速启动

# 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 部件工程中没有命令 。 在部件项目之外, 它启动创建向导 .

出版

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

# Then publish
glasshome-widget publish

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

文档

完整文件时间 glasshome.app/docs (英语)

许可证

麻省理工学院

版本与发布记录

@glasshome/widget-cli 共发布 96 个版本,首次发布于 2026/03/23;过去 12 个月发布了 96 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.21.2latest2026/11/16今天
0.21.12026/11/16今天
0.21.02026/11/079 天前
0.20.32026/11/0610 天前
0.20.22026/11/0610 天前
0.20.12026/11/0610 天前

关于 @glasshome/widget-cli 的常见问题

@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 和提交记录判断。