技能市场 API

搜索、安装与管理 Agent 技能（SkillHub 基于 npm registry 分发）。

版本说明：路径为 /api/v1/skills 与 /api/v1/skills/marketplace/*（注意并非 /api/skillhub/*）。两者都提供。个人版下该组未挂载鉴权，仅做租户兜底 default。

---

GET /api/v1/skills/marketplace/search

在市场搜索可用技能。

查询参数： query（关键词，必填）、page、page_size。

curl "http://localhost:19824/api/v1/skills/marketplace/search?query=web%20search"

响应：

{
  "code": 0,
  "data": {
    "items": [
      {
        "id": "skill_web_search",
        "name": "Multi Search Engine",
        "description": "集成多搜索引擎的搜索技能",
        "version": "2.1.0",
        "author": "Lyncore Team",
        "category": "search",
        "downloads": 15280,
        "rating": 4.8,
        "tags": ["search", "web", "multi-engine"]
      }
    ],
    "total": 3
  },
  "message": "ok",
  "request_id": "req_abc123"
}

---

POST /api/v1/skills/marketplace/install

一键安装指定技能。

请求：

{ "name": "skill_web_search" }

安装后该技能可在对话与工作流中使用。

---

GET /api/v1/skills/marketplace/:name

获取市场技能的详细信息。

---

本地技能管理

方法	路径	说明
GET	/api/v1/skills	已安装技能列表
POST	/api/v1/skills	创建技能
GET	/api/v1/skills/:id	技能详情
PUT	/api/v1/skills/:id	更新技能
DELETE	/api/v1/skills/:id	删除技能
POST	/api/v1/skills/import	导入 SKILL.md / YAML
GET	/api/v1/skills/:id/export	导出技能

运行时没有增删外部 API/工具的热更新接口；技能与 MCP Server 通过 config.yaml 的 mcp_servers 段静态配置，重启生效。

---

错误码

场景	code	message
技能不存在	40400	技能不存在
已安装	40900	技能已安装，无需重复安装
未安装	40400	技能未安装，无法卸载