用于创建和管理部件的 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 的常见问题
@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 和提交记录判断。