Agent Marketplace

SKILL.md

# Agent Marketplace

Agent 市场系统，用于技能发现、评分、版本管理和交易。

## 功能特性

### 1. 技能目录
- 技能列表/搜索
- 分类标签
- 版本管理
- 依赖解析

### 2. 评分系统
- 用户评分
- 使用统计
- 质量指标
- 排行榜

### 3. 技能管理
- 发布/更新
- 下架/删除
- 版本控制
- 兼容性检查

### 4. 发现推荐
- 热门技能
- 个性化推荐
- 相关技能
- 新技能展示

### 5. 安装管理
- 一键安装
- 依赖自动解析
- 冲突检测
- 回滚支持

## 安装

```bash
npm install
```

## 使用方法

### 基础用法

```javascript
const { Marketplace } = require('./src');

// 创建市场实例
const marketplace = new Marketplace({
  registry: 'https://clawhub.com/registry',
  cacheDir: './.marketplace-cache'
});

// 搜索技能
const results = await marketplace.search({
  query: 'rag',
  category: 'data-processing',
  sort: 'rating'
});

// 获取技能详情
const skill = await marketplace.getSkill('yuyonghao-rag-retriever');
console.log(skill);

// 安装技能
await marketplace.install('yuyonghao-rag-retriever', { version: '0.1.0' });

// 评分
await marketplace.rate('yuyonghao-rag-retriever', {
  rating: 5,
  comment: 'Excellent skill for RAG!'
});
```

### 搜索技能

```javascript
// 基础搜索
const results = await marketplace.search({ query: 'rag' });

// 高级搜索
const results = await marketplace.search({
  query: 'retriever',
  category: 'data-processing',
  tags: ['rag', 'search'],
  minRating: 4.0,
  sort: 'downloads',
  limit: 10
});
```

### 获取排行榜

```javascript
// 热门技能
const trending = await marketplace.getTrending({ limit: 10 });

// 最高评分
const topRated = await marketplace.getTopRated({ limit: 10 });

// 新技能
const newest = await marketplace.getNewest({ limit: 10 });
```

### 版本管理

```javascript
// 获取所有版本
const versions = await marketplace.getVersions('yuyonghao-rag-retriever');

// 检查兼容性
const compatible = await marketplace.checkCompatibility(
  'yuyonghao-rag-retriever',
  '0.1.0'
);

// 解析依赖
const deps = await marketplace.resolveDependencies({
  'yuyonghao-rag-retriever': '0.1.0'
});
```

## API 参考

### Marketplace

#### Constructor
```javascript
new Marketplace(options)
```

Options:
- `registry`: 注册表 URL
- `cacheDir`: 缓存目录
- `timeout`: 请求超时

#### Methods
- `search(options)`: 搜索技能
- `getSkill(id)`: 获取技能详情
- `install(id, options)`: 安装技能
- `uninstall(id)`: 卸载技能
- `rate(id, rating)`: 评分
- `getTrending(options)`: 获取热门技能
- `getTopRated(options)`: 获取高评分技能

## 测试

```bash
npm test
```

## 配置选项

```javascript
{
  registry: 'https://clawhub.com/registry',
  cacheDir: './.marketplace-cache',
  timeout: 30000,
  retryAttempts: 3,
  cacheExpiry: 3600000  // 1 hour
}
```

## License

MIT