注册中心
注册中心是一个可选的 JSON API,提供精选的技能索引。启用后,query 和 find 命令会在查询配置源的同时额外查询注册中心。
| 字段 | 必填 | 默认值 | 说明 |
|---|---|---|---|
registry.enabled | 否 | false | 是否启用注册中心查询 |
registry.url | 否 | https://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/