Skills & Agents Hub — searchable, high‑availability, intelligent, and community‑driven.

文件	最后提交记录	最后更新时间
deploy	apply stash 恢复本地自定义修改，解决repository.py冲突	17 小时前
doc	Merge branch 'master' into dev	1 天前
migrations	feat(agents): 添加 Agent 功能，支持列表、详情和版本查询、下载功能	3 天前
scripts	apply stash 恢复本地自定义修改，解决repository.py冲突	17 小时前
skillcrawler	refactor(config): 将模型和爬虫配置迁移至核心配置模块将原先分散在 skill-repos.yaml 和独立 config 加载逻辑中的模型、爬虫配置统一到 src.core.config 中，通过 Settings 对象集中管理，简化了各模块的配置读取方式，并同步更新了 Docker 配置与设计文档。	1 天前
skills	refactor(config): 将模型和爬虫配置迁移至核心配置模块将原先分散在 skill-repos.yaml 和独立 config 加载逻辑中的模型、爬虫配置统一到 src.core.config 中，通过 Settings 对象集中管理，简化了各模块的配置读取方式，并同步更新了 Docker 配置与设计文档。	1 天前
src	apply stash 恢复本地自定义修改，解决repository.py冲突	17 小时前
tests	refactor: 统一导入路径并更新模型字段 - 将多个模块中的仓库导入从 `src.api.models.repository` 更新为 `src.models.repository` - 在 Pydantic 模型中将 `metadata` 字段重命名为 `extra_metadata`，并添加别名以保持向后兼容性 - 更新 FastAPI 查询参数验证，将 `regex` 改为 `pattern` - 修复测试数据以使用新的字段名	25 天前
web	apply stash 恢复本地自定义修改，解决repository.py冲突	17 小时前
.dockerignore	feat: add clawhub source, docker-compose for db/search, nginx config, import scripts	2 个月前
.gitignore	feat(agents): 添加 Agent 功能，支持列表、详情和版本查询、下载功能	3 天前
Makefile	chore: 将项目名称从 skillhub 重命名为 wittyhub 更新项目名称相关的代码、配置、文档和 UI 文本，包括： - 前端项目名称和标题 - 后端服务名称和日志 - 配置文件中的环境变量前缀 - 脚本中的硬编码路径 - 文档中的项目名称和示例 - Docker 镜像标签和数据库配置 - 联系邮箱和版权信息	25 天前
README.md	docs: 添加 model 和 crawler 配置说明	1 天前
alembic.ini	chore: 更新配置中的数据库凭据和默认路径将数据库用户名、密码和数据库名称从 'skillhub' 更改为 'wittyhub'，以匹配新的项目标识。同时，将默认配置文件路径常量化，并将环境变量从 'SKILLHUB_CONFIG' 重命名为 'WITTYHUB_CONFIG'。	25 天前
config.yaml	Merge branch 'master' into dev	1 天前
pyproject.toml	feat(security): 完善安全审计全链路 — Skillspector Jenkins 集成 + 异步模式 + 后台收集核心功能: - 新增 SkillspectorClient: 封装 Jenkins HTTP 交互（trigger/wait/fetch/report_to_risk_signals） - 新增 SkillspectorCollector: 后台轮询（30s）收集异步扫描结果并回写评分 - SecurityDetector: 新增 trigger_skillspector() 异步触发、has_skillspector 属性 - SecurityService.audit_skill(): 支持 async_mode 参数，批量入库异步触发不阻塞 - SkillRepository.create(): 自动处理 skill_repo_id + 触发安全审计 - 新增 import_skill_sync(): 同步入库函数，批量脚本统一入口，默认异步审计 - API: POST /{skill_id}/audit 手动触发审计；应用启动自动拉起 Collector 性能: - 同步模式 42s/条 → 异步模式 0.2s 触发 + 后台收集 - 批量导入 200 条: 2.3h → 40s 测试: - 90 单元测试（报告解析/扫描触发/评分计算/异步模式/collector） - 3 Jenkins 集成测试（连通性/Job 可构建/真实报告解析） - 全链路 E2E 验证通过（skills/find-skills, 48s 评分回写）修复: - SkillRepoModel 构造时显式设置 id=uuid.uuid4() - SkillspectorClient.trigger_scan() 接受 302/303 重定向 - 403 时清除 CSRF crumb 缓存 - SKILL_PATH 参数从 metadata 完整透传到 Jenkins	2 天前
skills_output.json	feat: add crawler, embedding service and hybrid search - Add crawler script for VoltAgent awesome-openclaw-skills - Add bge-base-zh-v1.5 embedding service for cross-language semantic search - Add pgvector support for vector similarity search - Add hybrid search mode (text + semantic with RRF fusion) - Add min_similarity threshold (0.47) to filter irrelevant results - Change default search mode from text to hybrid - Add source filter to list endpoint - Add embedding_service.py and embedding.Dockerfile for embedding generation - Update docker-compose with embedding service and pgvector	1 个月前

Wittyhub

AI Agent Skills 检索与分发平台。发现、评估和获取可复用的 AI Agent Skills，支持关键词搜索、分类浏览、安全检测。

特性

核心功能

Skill 发现与搜索 - 支持全文搜索、分类筛选、标签过滤
多版本管理 - 支持 Skill 的多个版本，查看版本历史
安全检测 - 自动进行安全扫描，生成风险评估报告
CLI 工具 - 一键安装 Skills 到本地 ~/.agents/skills/ 目录

技术优势

高性能 - 基于 FastAPI + Uvicorn，提供异步 API
PostgreSQL 全文搜索 - 内置 tsvector，无需额外部署搜索引擎
安全可靠 - 代码安全扫描、依赖检查、风险信号识别
易于部署 - Docker Compose 一键部署
现代化前端 - Vue 3 + TypeScript，支持暗色模式

架构

当前 Docker Compose 部署由 4 个服务组成：web、api、embedding、db。

web：提供 Vue 构建产物，并把 /api/ 请求转发给 api
api：提供搜索、详情、版本、分类、安全检测等接口
embedding：为中文语义检索生成向量，供 api 调用
db：使用 PostgreSQL + pgvector 保存 skills、agents、security_audits 等表，以及 pgvector 向量列

flowchart LR
    User[Browser / CLI User]

    subgraph Compose["Docker Compose / wittyhub-network"]
        Web["web<br/>Nginx :80<br/>映射宿主机 8080"]
        API["api<br/>FastAPI + Uvicorn :8081<br/>映射宿主机 8081"]
        Embedding["embedding<br/>Embedding Service :8082<br/>模型: BAAI/bge-base-zh-v1.5"]
        DB["db<br/>PostgreSQL + pgvector :5432"]
        SkillData[("/opt/wittyhub/skill-data<br/>bind mount")]
        PgData[("postgres-data volume")]
        ModelCache[("huggingface-cache volume")]
    end

    User -->|"访问前端"| Web
    Web -->|"反向代理 /api/*"| API
    User -.->|"本地调试可直连"| API

    API -->|"全文检索 / 元数据 / 向量检索"| DB
    API -->|"生成或查询 embedding"| Embedding
    API -->|"本地文件存储"| SkillData

    DB --> PgData
    Embedding --> ModelCache

    DB:::store
    SkillData:::store
    PgData:::store
    ModelCache:::store

    classDef store fill:#f8f5ec,stroke:#b6925e,color:#5b4636;

数据层能力

tsvector：关键词全文搜索
pgvector：语义向量检索
JSONB：灵活元数据存储
ARRAY：标签等数组字段

快速开始

环境要求

Docker & Docker Compose
Python 3.10+ (本地开发) + uv

Docker 部署

前端构建

git clone https://gitcode.com/openeuler/wittyhub.git
cd wittyhub/web
npm install
npm run build

启动服务

cd ../
docker compose -f deploy/docker/docker-compose.yaml up -d

初始化数据库

docker compose -f deploy/docker/docker-compose.yaml exec api alembic upgrade head

生成测试数据

docker compose -f deploy/docker/docker-compose.yaml exec api \
  python scripts/generate_test_data.py --host db --password wittyhub_secret

访问服务

本地开发

安装依赖

uv venv --python 3.11
source .venv/bin/activate
uv pip install -e ".[dev]"

配置数据库编辑 config.yaml 配置数据库连接
运行迁移这里需要数据库提前运行

alembic upgrade head

启动服务

# 前端
cd web && npm install && npm run dev

# 后端
uvicorn src.api.main:app --reload --port 8081

使用指南

Web 界面

浏览 Skills

首页展示热门 Skills 和分类导航
点击分类查看该分类下的所有 Skills

搜索 Skills

使用搜索框输入关键词
支持按分类、平台、标签筛选

查看详情

点击 Skill 卡片进入详情页
查看版本历史、安全报告、安装命令

CLI 工具

# 搜索 Skills
wittyhub search "api framework"

# 查看 Skill 详情
wittyhub show python-api-framework

# 安装 Skill
wittyhub install python-api-framework

# 查看已安装的 Skills
wittyhub list

API 调用

# 获取所有 Skills
curl http://localhost:8081/api/v1/skills/?limit=10

# 搜索 Skills
curl "http://localhost:8081/api/v1/index/search?q=api"

# 获取分类
curl http://localhost:8081/api/v1/index/categories

# 获取 Skill 详情
curl http://localhost:8081/api/v1/skills/python-api-framework

# 获取版本历史
curl http://localhost:8081/api/v1/skills/python/api-framework/versions

项目结构

wittyhub/
├── src/
│   ├── api/              # FastAPI 应用
│   │   ├── routes/      # API 路由
│   │   ├── models/       # 数据模型
│   │   ├── schemas/      # Pydantic schemas
│   │   └── services/     # 业务逻辑
│   ├── core/             # 核心配置
│   ├── indexer/          # 搜索引擎 (PostgreSQL tsvector)
│   ├── security/         # 安全扫描
│   ├── storage/          # 文件存储
│   ├── migrations/       # 数据库迁移
│   └── utils/            # 工具函数
├── web/                  # Vue 3 前端
│   └── src/
│       ├── components/    # 组件
│       ├── pages/        # 页面
│       ├── api/          # API 客户端
│       └── router/       # 路由配置
├── scripts/              # 脚本
│   └── generate_test_data.py  # 测试数据生成
├── deploy/               # 部署配置
│   └── docker/           # Docker 部署
└── tests/                # 测试

配置说明

主要配置项 (config.yaml):

database:
  host: localhost
  port: 5432
  user: wittyhub
  password: your_password
  dbname: wittyhub

storage:
  type: local
  local_path: /opt/wittyhub/skill-data
  github_token: your_github_token

model:
  name: deepseek-chat
  base_url: https://api.deepseek.com
  api_key: your_deepseek_api_key
  timeout: 30

crawler:
  github_token: your_github_token
  max_tags_per_repo: 3

security:
  enable_audit: true

app:
  host: 0.0.0.0
  port: 8080
  cors_origins:
    - "*"

storage.local_path 是运行时数据根目录，包含：

/opt/wittyhub/skill-data/
├── skill-repositories/      # 爬虫 clone 的 Skill 仓库
├── download-cache/          # 下载接口生成的 ZIP 缓存
└── logs/                    # skillcrawler 日志

开发指南

运行测试

pytest tests/ -v

代码检查

ruff check .
mypy src/

构建前端

cd web
npm install
npm run build

License

MIT License

项目介绍