mirror of
https://git.openapi.site/https://github.com/desirecore/registry.git
synced 2026-02-28 08:20:27 +08:00
79 lines
2.3 KiB
Markdown
79 lines
2.3 KiB
Markdown
# DesireCore Registry
|
||
|
||
DesireCore 官方应用商店与服务注册表数据仓库。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
.
|
||
├── README.md # 本文件
|
||
├── SCHEMA_VERSION # 数据格式版本（2.0.0）
|
||
├── manifest.json # 仓库元数据
|
||
├── apps/
|
||
│ └── <app-id>/
|
||
│ └── index.json # StoreApp 单个应用配置（含 install 字段）
|
||
├── mcp/
|
||
│ └── <service-id>/
|
||
│ └── index.json # RegisteredService 单个 MCP 服务（含 install + connection）
|
||
├── services/
|
||
│ └── <service-id>/
|
||
│ └── index.json # RegisteredService 单个 HTTP 服务
|
||
├── models/
|
||
│ ├── descriptors.json # ServiceDescriptor[] 模型能力描述符
|
||
│ └── categories.json # ServiceCategoryDescriptor[] 模型分类
|
||
└── ui-config/
|
||
├── app-categories.json # 应用分类配置
|
||
└── service-status.json # 服务状态 UI 配置
|
||
```
|
||
|
||
## 数据格式
|
||
|
||
每个应用/服务为独立目录，目录名即 ID，包含 `index.json` 单对象文件：
|
||
|
||
- `apps/<id>/index.json` → `StoreApp` schema（含 `install`）
|
||
- `mcp/<id>/index.json` → `RegisteredService` schema（含 `install` + `connection`）
|
||
- `services/<id>/index.json` → `RegisteredService` schema
|
||
- `models/descriptors.json` → `ServiceDescriptor[]` 数组
|
||
- `models/categories.json` → `ServiceCategoryDescriptor[]` 数组
|
||
|
||
## 添加新条目
|
||
|
||
以添加 MCP 服务为例：
|
||
|
||
```bash
|
||
mkdir mcp/my-service
|
||
cat > mcp/my-service/index.json << 'EOF'
|
||
{
|
||
"id": "my-service",
|
||
"name": "My Service",
|
||
"description": "服务描述",
|
||
"protocol": "mcp",
|
||
"status": "offline",
|
||
"origin": "registry",
|
||
...
|
||
}
|
||
EOF
|
||
```
|
||
|
||
## 同步策略
|
||
|
||
DesireCore 客户端会：
|
||
|
||
1. 启动时检查本地缓存（2 分钟 TTL）
|
||
2. 缓存过期时 `git fetch` 检查更新
|
||
3. 有更新时 `git pull` 并重建索引
|
||
4. 离线时使用本地缓存或内置 fallback 数据
|
||
|
||
## 贡献指南
|
||
|
||
1. Fork 本仓库
|
||
2. 在对应类型目录下创建以 ID 命名的子目录
|
||
3. 添加 `index.json`（单对象，遵循对应 Schema）
|
||
4. 提交 PR 并描述变更内容
|
||
5. 等待审核合并
|
||
|
||
## 镜像
|
||
|
||
- GitHub（主）: https://github.com/desirecore/registry.git
|
||
- git.hxr.so（镜像）: https://git.hxr.so/desirecore/registry.git
|