扩展市场 API

扩展市场的搜索、安装和发布接口。

扩展市场 API

扩展市场 API 提供扩展的搜索、安装、卸载和发布功能，支持 Skill 和 Plugin 两类扩展。

搜索扩展

GET /api/marketplace/search

查询参数：

参数	类型	说明
`query`	string	搜索关键词
`type`	string	扩展类型：`skill` 或 `plugin`
`category`	string	分类筛选
`tags`	string	标签筛选，多个标签用逗号分隔

响应示例：

{
  "items": [
    {
      "id": "code-review-skill",
      "name": "代码审查技能",
      "type": "skill",
      "author": "openvort",
      "version": "1.2.0",
      "description": "自动化代码审查，支持多语言",
      "tags": ["code-review", "quality"],
      "downloads": 1580
    }
  ],
  "total": 12
}

获取扩展详情

GET /api/marketplace/:id

响应示例：

{
  "id": "code-review-skill",
  "name": "代码审查技能",
  "type": "skill",
  "author": "openvort",
  "version": "1.2.0",
  "description": "自动化代码审查，支持多语言",
  "readme": "# Code Review Skill\n...",
  "content_hash": "sha256:a1b2c3d4...",
  "created_at": "2025-01-15T10:00:00Z",
  "updated_at": "2025-03-01T08:30:00Z"
}

安装扩展

POST /api/marketplace/install

请求体：

{
  "id": "code-review-skill",
  "version": "1.2.0"
}

安装完成后扩展立即生效，无需重启服务。

卸载扩展

DELETE /api/marketplace/:id

卸载后相关功能立即停用。

发布扩展

POST /api/marketplace/publish

以 multipart/form-data 格式上传扩展包（ZIP 格式）：

字段	类型	说明
`bundle`	file	ZIP 扩展包文件
`type`	string	扩展类型：`skill` 或 `plugin`

扩展包需包含 manifest.json 描述文件。发布后经审核通过即可在市场中搜索到。

查看已安装扩展

GET /api/marketplace/installed

响应示例：

{
  "items": [
    {
      "id": "code-review-skill",
      "name": "代码审查技能",
      "type": "skill",
      "version": "1.2.0",
      "installed_at": "2025-02-20T14:00:00Z",
      "has_update": true,
      "latest_version": "1.3.0"
    }
  ],
  "total": 3
}