LyncoreLyncore
Lyncore

技能市场 API ​

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

版本说明：本地技能管理路径两版一致（/api/v1/skills）；市场路径两版不同——企业版走 /api/v1/skills/marketplace/*，个人版走 /api/v1/marketplace/*（含连接器 connectors 与同步 sync 全套）。注意并非 /api/skillhub/*。个人版 /api/v1/skills（列表）未挂载鉴权，仅做租户兜底 default。

企业版：/api/v1/skills/marketplace/* ​

在市场搜索可用技能。

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

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

响应：

json
{
  "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 ​

一键安装指定技能。

请求：

json
{ "name": "skill_web_search" }

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

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

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

个人版：/api/v1/marketplace/* ​

个人版市场路由组前缀为 /api/v1/marketplace（需鉴权），除技能外还覆盖连接器（connectors）与市场同步（sync）。

方法路径说明
GET/api/v1/marketplace/skills市场技能列表
GET/api/v1/marketplace/skills/*id技能详情
POST/api/v1/marketplace/skills/install一键安装技能
GET/api/v1/marketplace/connectors连接器列表
GET/api/v1/marketplace/connectors/*id连接器详情
POST/api/v1/marketplace/connectors/install安装连接器
POST/api/v1/marketplace/connectors/custom注册自定义连接器
DELETE/api/v1/marketplace/connectors/*id卸载连接器
GET/api/v1/marketplace/installed已安装清单
GET/api/v1/marketplace/sync/status同步状态
POST/api/v1/marketplace/sync/trigger触发同步

个人版市场请求在已登录时走 Hub 代理（需鉴权）；未登录时降级为公开只读端点。

本地技能管理（两版一致） ​

方法路径说明
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 段静态配置，重启生效。

错误码 ​

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