cnb-rs Extensions Registry

cnb-rs 官方与社区 extension 的中央索引

本仓库是 cnb-rs ext search 的远端 source，记录所有可被 cnb-rs ext install <name> 自动发现的 extension。

# 直接通过 repo 路径装
cnb-rs ext install wwvo/cnb-rs/cnb-chat

# 通过 registry 搜索（Phase 5+ 实现）
cnb-rs ext search chat
cnb-rs ext install cnb-chat

1. 在 CNB 上发布你的 extension 仓库（参考 extension 开发指南）
2. Fork 本仓库
3. 在 extensions.toml 数组末尾追加 [[extension]] block（参见下方 schema）
4. 提交 PR；CI 会校验 schema 合法性

[[extension]]
name = "cnb-foo"              # 必须以 'cnb-' 开头，与 repo 实际仓库名一致
repo = "user/group/cnb-foo"   # CNB 仓库完整路径
description = "..."           # 一句话描述，中文优先
official = false              # 仅 cnb-rs maintainer 维护的设为 true
kind = "binary"               # binary（编译型）/ script（解释型 bash）

• official = false 的 ext 标记为社区维护，cnb-rs maintainer 不背书也不保证长期可用性
• description 中文优先，简洁不超 80 字符；说明 ext 的核心价值即可
• repo 必须是可公开访问的 CNB 仓库（visibility = public）
• ext 仓库本身需有 release（含 manifest.toml + 至少一个平台 binary）才能被 ext install 使用

• 单文件：extensions.toml 包含全部 entry；< 50 entries 不拆分，超出再 evolve 为 entries/cnb-foo.toml 分文件
• 5 字段 schema：name / repo / description / official / kind
• 不放 min_cnb_rs_version / supported_platforms / categories 等元数据：这些应从 ext 仓库 release 的 manifest.toml 实时拉，避免 registry 与现实脱节
• 客户端 24h cache：cnb-rs 主仓 fetch 本 extensions.toml 后缓存 24h，与 ext upgrade 后台 check 同节奏

• cnb-rs 主仓 — ext install / ext search / ext upgrade 等子命令源码
• extension 开发指南
• extension 设计文档

Apache-2.0