第1步 获取 GenUI Skill

接入流程的第一步，是把开发框架装到本地。百度提供了 genui-app-builder 这个 skill 包，它把规范文档和命令行工具整合在一起。

下载与安装

• 下载地址：https://genui.baidu.com/genui/download/genui-app-builder.zip（实战版本为 v1.1.0，约 146KB，含 21 个文件）。
• 解压后放到你的技能目录，例如 .workbuddy/skills/genui-app-builder/。

关键目录结构

解压后必须保留构建产物的层级，不要拍平：

genui-app-builder/
├── SKILL.md              # 总路由入口
└── skills/
    ├── genui-creator/    # 规范与创作侧（含 references/）
    └── genui-toolkit/    # 工程侧（提供 genui CLI）

SKILL.md 是按 skills/genui-*/SKILL.md 这种相对路径去定位子 skill 的。如果你把它所有文件拍平到 skills/ 顶层，路由会失效，creator / toolkit 都加载不出来。

安装 genui 命令行工具

框架的工程能力来自一个 npm 包，需要全局安装：

npm install -g @cosui/genui-toolkit

实战环境中安装的是 v1.0.7（即 registry 上的最新版）。装好后验证：

genui --help

只要 genui --help 能正常打印，且子命令 preview / check / login / logout / list / publish 都可见，环境就就绪了。

环境要求

实战使用的环境为：Node v22.22.2 / npm 10.9.7 / Windows。Node 18+ 一般都能跑起来，建议用较新的 LTS 版本避免依赖问题。

小结

第一步的产出是：本地有了 genui-app-builder 规范包 + 全局可用的 genui CLI。接下来就可以正式创建应用了。