注册中心

注册中心是一个可选的 JSON API,提供精选的技能索引。启用后,queryfind 命令会在查询配置源的同时额外查询注册中心。

字段必填默认值说明
registry.enabledfalse是否启用注册中心查询
registry.urlhttps://xskill.gcli.cn/skills.json注册中心地址

URL 解析规则:

  • 裸域名或以 / 结尾 → 自动补全 /skills.json
  • 路径末尾含文件扩展名(如 .json)→ 原样使用
  • 空值或无效协议 → 回退内置默认地址

去重规则(URL 归一化后比较,本地优先):

  • 注册中心源的 URL 与已配置源的 URL 相同 → 跳过(以本地配置为准)。
  • 注册中心源与已配置源同名但 URL 不同 → 视为两个不同仓库,注册中心条目正常合并。query 中注册中心条目的源名称置空(显示为 -),find 中显示为该源的 URL。
  • 无冲突 → 正常显示。
  • Skill 级去重:仅在 URL 相同时跳过整个源。URL 不同时,即使 skill 名称相同也保留两条。

示例:

# 启用注册中心
xskill config --set registry.enabled=true

# 使用自定义注册中心地址(裸域名)
xskill config --set registry.url=https://example.com

# 使用自定义注册中心地址(带路径)
xskill config --set registry.url=https://example.com/api/v1/