heren-design-cli

heren-design-web-vue 知识查询和项目分析 CLI 工具，专为 AI 代码助手优化。

功能

• 组件知识查询：查询 hr-* 和 hrd-* 组件的 Props、Events、Slots、方法和示例代码
• 项目分析：扫描项目中 heren-design-web-vue 的使用情况，检查规范问题
• 项目诊断：检查 heren-design 的安装和配置
• MCP 集成：作为 MCP 服务器与 AI 助手集成

安装

npm install -g heren-design-cli

命令

组件知识查询

hrdc list                         # 列出所有组件
hrdc list --category business     # 按分类过滤

hrdc info hr-button               # 查询组件 API
hrdc info hrd-page-layout --detail # 查看完整 API

hrdc doc hr-form                  # 获取完整文档
hrdc demo hr-dialog               # 列出所有示例
hrdc demo hr-dialog basic         # 获取指定示例代码
hrdc info Button                  # 也支持 PascalCase 组件名

项目分析

hrdc usage [dir]                  # 扫描组件使用统计
hrdc lint [target]                # 检查规范问题
hrdc doctor                       # 诊断项目配置
hrdc env                          # 收集环境信息

接口相关

hrdc api-resolve <url> --project-path <path> --format json
hrdc api-probe <url> --project-path <path> --format json

说明：

• 研发场景下可直接通过 CLI 使用接口解析与探测能力，无需先配置 MCP
• api-resolve / api-probe 是普通 CLI 入口，复用现有 heren_api_resolve / heren_api_probe 主逻辑
• 相对路径场景优先结合项目代理配置与环境解析

MCP 服务器

hrdc mcp                          # 启动 MCP 服务器

Claude Desktop 配置（~/.claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "heren-design": {
      "command": "hrdc",
      "args": ["mcp"]
    }
  }
}

全局选项

--format <format>   # 输出格式：json、text、markdown（默认：text）
--lang <lang>       # 输出语言：en、zh（默认：zh）
--data-version <v>  # 指定内置元数据版本，如 1.8.0
--detail            # 显示详细信息
-V, --cli-version   # 显示 CLI 版本

组件命名

• 基础组件（hr- 前缀）：hr-button、hr-input、hr-select、hr-form、hr-table、hr-dialog、hr-pagination、hr-tabs、hr-tree
• 业务组合组件（hrd- 前缀）：hrd-page-layout、hrd-search-bar

更新组件数据

组件元数据存储在版本化文件中，例如 data/1.8.0.json。CLI 只读取合法 semver 文件名的元数据，不再读取 data/components.json 或项目本地 web-types.json。

# 从源码提取
npm run extract -- --source <heren-design-web-vue 源码路径>

# 精简提取，不生成 doc、demos、changelog、faq
npm run extract:lite -- --source <heren-design-web-vue 源码路径>

版本选择优先级：

1. --data-version <version> 或 HEREN_DESIGN_VERSION
2. 当前项目安装的 heren-design-web-vue 版本
3. 当前项目 package.json 中声明的 heren-design-web-vue 版本
4. data/ 目录中的最高内置版本

如果没有精确版本文件，CLI 会选择不高于目标版本的最接近元数据；只有没有任何低版本可选时才回退到最高内置版本。

开发

npm run build        # 构建
npm run dev          # 监视模式
npm run test         # 运行测试
npm run typecheck    # 类型检查

License

MIT