registry/README.md

DesireCore Registry

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

目录结构

.
├── README.md                    # 本文件
├── SCHEMA_VERSION               # 数据格式版本
├── manifest.json                # 仓库元数据
├── apps/
│   └── apps.json                # StoreApp[] 应用列表
├── services/
│   ├── services.json            # RegisteredService[] 服务列表
│   ├── descriptors.json         # ServiceDescriptor[] 服务描述符
│   └── categories.json          # ServiceCategoryDescriptor[] 服务分类
└── ui-config/
    ├── app-categories.json      # 应用分类配置
    └── service-status.json      # 服务状态 UI 配置

数据格式

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

• apps/apps.json → StoreApp schema
• services/services.json → RegisteredService schema
• services/descriptors.json → ServiceDescriptor schema
• services/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