zard/ui 是一个 Angular 组件库，组件通过 CLI 以源码形式写入用户项目，没有可导入的运行时包，也不需要 npm install 组件。所有 CLI 命令需使用项目自身的包运行器：npx zard-cli、pnpm dlx zard-cli、yarn zard-cli 或 bunx zard-cli，具体取决于 components.json 中的 packageManager。
用途：管理 zard/ui 组件与项目，涵盖添加、组合、样式设置和调试基于 TailwindCSS v4 的 Angular UI，并提供项目上下文与组件选择指引。
主要能力：读取项目根目录的 components.json 获取配置（别名、baseUrl、图标族、包管理器、项目类型等）；通过 zard-cli add 安装组件及其依赖；通过注册表或 MCP 服务器查询组件 API；遵循 Angular 独立组件、OnPush、信号输入等约定；使用语义化 token 与变体而非原始类名；支持表单、图标、排版、组合等规则。
使用方式：先读取 components.json，无该文件则运行 init；检查已安装组件；通过注册表或 MCP 查找可用项；阅读真实 API 文档后再写代码；用 npx zard-cli add <name> 安装；检查生成文件。常用命令包括 npx zard-cli init、npx zard-cli add button card dialog、npx zard-cli add --all 等。
适用场景：Angular 项目中使用 zard/ui 构建界面，如设置页、仪表盘、表单、导航、覆盖层、反馈等。
限制：仅支持 Tailwind v4，无 tailwind.config.js；不得手写组件源码或从 GitHub 获取；不得编辑生成产物；旧注册表项目需使用迁移技能；部分事实如具体收费、平台支持等暂未提供。