项目结构

目录结构

.
├── components          # 组件数据目录
│   ├── alert         # 示例组件目录
│   │   └── doc.md    # 组件文档文件
│   └── examples.json  # 组件示例文件
├── metadata.json       # 元数据文件
└── package.json        # npm 包配置文件

主要文件说明

package.json

{
  "name": "@jzone-mcp/antd-components",
  "version": "1.0.0",
  "description": "Ant Design Components Monitoring Platform",
  "main": "index.js",
  "scripts": {
    "start": "node index.js",
    "extract": "./bin/extract-docs.js"
  },
  "dependencies": {
    "@jzone-mcp/utils": "^1.0.0",
    "express": "^4.18.2"
  }
}

components/components-index.json

[
  {
    "name": "alert",
    "dirName": "alert",
    "title": "Alert 提示框",
    "subtitle": "用于重要信息的提示"
  },
  {
    "name": "button",
    "dirName": "button",
    "title": "Button 按钮",
    "subtitle": "页面中的按钮元素"
  }
]

components/alert/doc.md

## Alert 提示框

### 描述
Alert 组件用于在页面中显示重要信息的提示，支持成功、警告、错误和信息四种类型。

### 使用方法
```javascript
<Alert message="内容" type="success|warning|error|info" />

API

示例代码

<Alert message="操作成功" type="success" />
<Alert message="注意事项" type="warning" />

## 缓存机制

为了提高系统的响应速度和效率，MCP 采用了缓存机制。每次请求组件信息时，系统会首先检查缓存中是否存在该数据。如果存在，则直接返回缓存中的数据；如果不存在，则从数据源读取数据并更新到缓存中。

具体流程如下：

```mermaid
flowchart LR
    Request[组件请求] --> CacheCheck{缓存检查}
    CacheCheck -->|存在| ReturnCache[返回缓存数据]
    CacheCheck -->|不存在| ReadFile[读取文件]
    ReadFile --> ProcessData[处理数据]
    ProcessData --> UpdateCache[更新缓存]
    UpdateCache --> ReturnData[返回数据]

文档抽取和发布机制

为了保持文档的最新性，MCP 提供了定期和手动触发文档抽取和发布的功能。默认情况下，系统会在每周一晚上 10 点自动执行该流程。

具体流程如下：

flowchart TD
    A[开始] --> B[触发条件]
    B --> |每周一晚上 10 点| C[自动触发]
    B --> |手动触发| D[手动触发]

    C --> E[设置环境变量]
    D --> E
    E --> F[克隆 Ant Design 仓库]
    F --> G[获取版本信息]

    G --> G1[获取 Ant Design 版本]
    G --> G2[获取已抽取数据版本]

    G1 --> H[检查更新]
    G2 --> H

    H --> |输出调试信息| I[显示版本信息]

    H --> J{版本一致？}
    J --> |是| K[结束流程]
    J --> |否| L[创建动态分支]

    L --> M[生成 Ant Design 变更日志]
    M --> N[抽取文档数据]
    N --> O[提交并推送更改]

    O --> P[发布 npm 包]
    P --> Q[创建 PR]

    Q --> R{已有 PR 吗？}
    R --> |是| S[记录现有 PR]
    R --> |否| T[创建新 PR]

    S --> K
    T --> K

通过上述机制，MCP 确保了组件信息的实时性和准确性。