# DesireCore Registry

DesireCore 官方应用商店与服务注册表数据仓库。

## 目录结构

```
.
├── README.md                    # 本文件
├── SCHEMA_VERSION               # 数据格式版本（2.0.0）
├── manifest.json                # 仓库元数据
├── apps/
│   ├── index.json               # StoreApp[] 应用列表（v2: 含 install 字段）
│   └── apps.json                # [旧版兼容] 应用列表
├── mcp/
│   └── index.json               # RegisteredService[] MCP 服务（含 install + connection）
├── services/
│   ├── index.json               # RegisteredService[] HTTP 服务
│   ├── services.json            # [旧版兼容] 所有服务（MCP + HTTP 混合）
│   ├── descriptors.json         # [旧版兼容] → models/descriptors.json
│   └── categories.json          # [旧版兼容] → models/categories.json
├── models/
│   ├── descriptors.json         # ServiceDescriptor[] 模型能力描述符
│   └── categories.json          # ServiceCategoryDescriptor[] 模型分类
└── ui-config/
    ├── app-categories.json      # 应用分类配置
    └── service-status.json      # 服务状态 UI 配置
```

## v2 新增

- **`mcp/index.json`**：MCP 服务独立目录，每个条目包含 `install`（安装方式）和 `connection`（连接配置）
- **`models/`**：AI 模型描述符从 `services/` 移出
- **`apps/index.json`**：应用增加 `install` 字段
- **`services/index.json`**：仅 HTTP 服务

旧路径文件保留用于向后兼容，新版客户端优先读取新路径。

## 数据格式

所有 JSON 文件遵循 DesireCore 定义的 JSON Schema：

- `apps/index.json` → `StoreApp` schema（含 `install`）
- `mcp/index.json` → `RegisteredService` schema（含 `install` + `connection`）
- `services/index.json` → `RegisteredService` schema
- `models/descriptors.json` → `ServiceDescriptor` schema
- `models/categories.json` → `ServiceCategoryDescriptor` schema

## 同步策略

DesireCore 客户端会：

1. 启动时检查本地缓存（2 分钟 TTL）
2. 缓存过期时 `git fetch` 检查更新
3. 有更新时 `git pull` 并重建索引
4. 离线时使用本地缓存或内置 fallback 数据

## 贡献指南

1. Fork 本仓库
2. 修改相应的 JSON 文件
3. 提交 PR 并描述变更内容
4. 等待审核合并

## 镜像

- GitHub（主）: https://github.com/desirecore/registry.git
- git.hxr.so（镜像）: https://git.hxr.so/desirecore/registry.git