genui CLI 工作流

genui 命令行工具（来自 @cosui/genui-toolkit）贯穿了小工具从开发到上线的全流程。掌握它的子命令与约定，是高效交付的前提。

安装与验证

npm install -g @cosui/genui-toolkit
genui --help

实战环境为 v1.0.7（registry 最新）。genui --help 能打印出 preview / check / login / logout / list / publish 等子命令即就绪。

六大子命令

命令 作用
genui login 登录百度账号，获取发布凭证
genui logout 退出登录
genui list 列出已创建/已提交的应用
genui preview 本地起预览服务，核对布局
genui check 静态合规检查，退出码 0 才过
genui publish 提交审核（可加 --dry-run 预检）

推荐工作流

实战沉淀出一条稳定节奏：

1. 写代码
2. genui check            # 边写边跑，合规前置
3. genui preview --qr-image   # 截图核对布局（必带 --qr-image）
4. genui publish --dry-run    # 提交前预检素材规格
5. genui publish         # 正式提交审核

两个关键约定

  • preview 必带 --qr-image：不带可能导致预览/二维码异常，这是实战踩出来的约定。
  • 发布先 --dry-run 再正式：--dry-run 模拟提交、校验素材规格但不真正提交，确认全绿后再去掉它执行一次正式提交，避免无效提交占审核队列。

状态查看

提交后可用 genui list 查看应用状态，了解是否进入审核、审核结果如何。配合 genui login / logout 管理账号凭证。

小结

CLI 工作流一句话：check 管合规、preview 管布局、publish 走审核，且 preview 带 qr-image、publish 先 dry-run。把这条节奏固化成习惯，交付效率最高。