# 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