# SkillHub — 科大讯飞开源智能体技能注册中心

> 来源: https://mp.weixin.qq.com/s/989DJSRSihmEs6JSbLGnkw
> 研究日期: 2026-05-05
> 协议: Apache-2.0

## 项目概览

- **名称**: SkillHub
- **GitHub**: https://github.com/iflytek/skillhub
- **作者**: 科大讯飞（iFlytek）
- **定位**: 企业级开源智能体技能注册中心
- **口号**: 在组织内发布、发现和管理可复用的技能包

## 解决的核心问题

| 痛点       | SkillHub 方案          |
| -------- | -------------------- |
| **版本混乱** | 语义化版本控制，自动 latest 跟踪 |
| **权限失控** | 企业级 RBAC + 审核机制      |
| **发现困难** | 全文搜索 + 评分/下载量筛选      |
| **分发低效** | CLI 一键安装，类似 npm 体验   |
|          |                      |

## 核心功能

| 功能 | 说明 |
|------|------|
| **Skill 发布** | 一键上传技能包，自动版本管理/元数据提取 |
| **自托管私有化** | 部署在自有基础设施，数据不出防火墙 |
| **团队命名空间** | 按团队/全局组织技能，独立成员/角色管理 |
| **审核与治理** | 团队管理员审核，平台管理员控制推广，审计日志 |
| **发现与搜索** | 全文搜索，支持按命名空间/下载量/评分/时间筛选 |
| **社交功能** | 收藏、评分、下载量跟踪 |
| **账户合并** | 多个 OAuth 身份 + API 令牌整合到单账户 |
| **CLI 优先** | 原生 REST API + ClawHub 风格注册中心客户端兼容 |

## 技术栈

| 层级 | 技术 | 说明 |
|------|------|------|
| **前端** | React 19 + TypeScript + Vite + shadcn/ui | SPA，支持 i18next 国际化 |
| **后端** | Java 21 + Spring Boot 3.2 + Spring Security | 模块化 REST API |
| **数据库** | PostgreSQL 16 + Flyway | 主数据存储 + 全文搜索 |
| **缓存** | Redis 7 | 会话管理 + 分布式锁 + 限流 |
| **对象存储** | 本地文件系统 / S3 / MinIO | 技能包文件存储 |
| **安全** | Spring Security OAuth2 + RBAC + API 令牌 | 认证授权 |
| **扫描器** | Python 服务 | 上传技能包多引擎安全分析 |
| **部署** | Docker Compose + Kubernetes | 容器编排 |

## 项目结构

```
skillhub/
├── server/
│   ├── skillhub-app/        # 入口点、控制器
│   ├── skillhub-domain/     # 核心实体、领域服务
│   ├── skillhub-auth/       # OAuth2、RBAC、API 令牌
│   ├── skillhub-search/     # 搜索 SPI + PostgreSQL 全文检索
│   ├── skillhub-storage/    # 对象存储 SPI
│   ├── skillhub-infra/      # JPA 仓库、事件
│   └── skillhub-notification/ # 邮件与告警
├── web/                     # React 19 前端
│   └── src/
│       ├── pages/           # 路由级页面
│       ├── features/        # 业务功能模块
│       ├── shared/          # 可复用组件
│       └── api/             # OpenAPI 生成类型
├── scanner/                 # Python 安全扫描器
├── deploy/                  # Kubernetes 清单
├── monitoring/              # Prometheus / Grafana
└── docker-compose.yml       # 开发依赖
```

## 快速启动

```bash
git clone https://github.com/iflytek/skillhub.git
cd skillhub
make dev-all   # 启动完整开发栈
# 或分别启动
make dev-backend  # 仅后端
make dev-web      # 仅前端
```

**前置要求**: Java 21+ / Node.js 20+ / Docker

## 架构亮点

### 治理模型

```
开发者 → 发布技能到命名空间 → 团队管理员审核 → 推广到全局
```

- 每个命名空间独立管理（Owner/Admin/Member 角色）
- 所有治理操作记录审计日志
- 可见性规则确保用户只能看到有权访问的技能

### 安全设计

- **API 令牌**: 基于前缀的安全哈希，作用域控制
- **CSRF 防护**: 前端请求保护
- **多引擎扫描**: 上传技能包自动安全分析
- **数据主权**: 完全自托管，专有技能保留在防火墙后

## 与 OpenClaw/ClawHub 的关系

- SkillHub 兼容 **ClawHub 风格注册中心客户端**
- 可作为 OpenClaw 技能的**企业级私有注册中心**
- 提供与公共注册中心相同的体验，但完全可控

## 项目评价

**优点**：
- ✅ 科大讯飞出品，企业级品质
- ✅ 完整治理模型（审核/权限/审计）
- ✅ 技术栈现代（React 19 / Java 21 / PG 16）
- ✅ 自托管，数据完全可控
- ✅ Apache-2.0 协议，商用友好

**适用场景**：
- 企业内部 Agent 技能共享平台
- 团队私有技能注册中心
- 需要权限控制的技能分发场景