> ## Documentation Index
> Fetch the complete documentation index at: https://huoban.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Registry 对象

> Registry 是 Huoban 的字架对象，用于组织、索引和发现 Skill、Adapter、Flow 与 Profile。

# Registry 对象

`Registry` 是 Huoban 的字架：它组织、索引和发现可复用对象。

v0.1 应定义 Registry 对象，但不急着建设 hosted registry 或 marketplace。

## spec 字段

| 字段               | 要求   | 说明                          |
| ---------------- | ---- | --------------------------- |
| `sources`        | 必填   | registry 来源数组。              |
| `sources[].type` | 必填   | `local`、`git`、`http`、`mcp`。 |
| `sources[].path` | 条件必填 | local 来源路径。                 |
| `sources[].url`  | 条件必填 | git/http/mcp 来源地址。          |
| `index`          | 可选   | 静态索引配置。                     |
| `trustPolicyRef` | 可选   | 来源信任策略。                     |

## 最小示例

```yaml theme={null}
apiVersion: huoban.dev/v1alpha1
kind: Registry
metadata:
  name: local-huoban-registry
spec:
  sources:
    - type: local
      path: ./huoban
    - type: git
      url: https://example.com/org/huoban-objects.git
  index:
    includeKinds:
      - Skill
      - Adapter
      - Flow
      - Profile
```

## status

常见 conditions：

* `RegistryLoaded`
* `SourceIndexed`
* `SourceUnavailable`
* `TrustPolicyApplied`
* `ObjectInvalid`

## 设计约束

Registry 不是 marketplace。早期 Registry 的目标是本地发现、静态索引和 schema validation，不做排名、推荐、托管发布和商业分发。