\newpage

第14章：Astra Hub——生态门户

关于 Astra 生态

本书开卷已对 Astra 生态做了总览。本章详细介绍生态门户——Astra Hub（astra-aiagent-infra）——作为统一索引、注册表和模板引擎的具体实现。它不包含业务逻辑，而是扮演三个角色：

• 生态地图：索引所有 astra-* 项目的位置、用途和关系
• 技能注册表：通过 registry.yaml 统一管理所有技能的版本和路径
• 模板引擎：提供项目模板和生命周期钩子，保证新组件的一致开局

14.1 为什么需要门户？

随着 Astra 生态从几个组件扩展到十几个，各个项目变得分散。Astra Hub 解决三个问题：

问题	解决方案
"这个项目放哪儿？"	统一的项目索引表
"我的技能是最新版吗？"	registry.yaml 版本管理
"新项目怎么起手？"	模板库 + 生命周期钩子

公开/私有分离

所有 astra-* 项目采用双重布局，区分可公开推送 GitHub 的代码和个人数据：

路径	内容	用途
~/Projects/astra/<component>/	公开代码	推送到 GitHub
~/.astra/repos/<repo>/	私有副本（含个人数据覆盖层）	本地运行，.gitignore 屏蔽个人配置

14.2 技能注册表

registry.yaml 是整个技能体系的注册中心：

# registry.yaml 片段
skills:
  - name: astra-sre
    version: 2.1.0
    repo: astra-sre
    path: skills/devops/astra-sre.symlink
    description: "统一 SRE 协调层"

生命周期钩子（lifecycle/astra-lifecycle-sync.py）自动读取 registry.yaml，生成各类部署清单到目标 SKILL.md，保证组件状态与注册表一致。

14.3 快速开始

# 克隆门户
git clone https://github.com/alrcatraz/astra-aiagent-infra.git
cd astra-aiagent-infra

# 查看注册表
cat registry.yaml

# 同步生命周期清单
uv run python3 lifecycle/astra-lifecycle-sync.py --update

所有 astra-* 组件及其能力均可通过门户仓库一站式查阅。

---