面向企业内部的 AI Skill 统一管理平台。开发者提交 Skill 包，管理员审批上架，员工浏览、搜索、一键安装。
- 🔐 用户认证 — 用户名 + 邮箱双模式登录，邮箱验证码注册
- 🛒 应用市场 — 卡片式展示，动态分类、作者筛选、热门排序
- 📦 Skill 上传 — ZIP 包上传，自动触发三层安全扫描
- 🛡️ 三层安全扫描 — Semgrep 静态分析 + ClamAV 病毒扫描 + LLM 语义分析
- ✅ 审批工作台 — 管理员查看扫描结果，区分来源（新上传/重新提交/重新上架），一键审批
- 📊 看板 Dashboard — KPI 统计：总数、扫描中、待审批、已上架
- 📋 我的应用 — 开发者查看所有提交的 Skill，驳回后可重新提交
- ⚙️ 管理员应用管理 — 搜索、分类筛选、作者筛选、下架/重新上架、快捷审批
- ⬇️ 下载与安装 — MinIO 预签名 URL 下载，一键安装到 OpenClaw
- 🔄 完整生命周期 — 上传 → 扫描 → 审批 → 上架 → 下架 → 重新上架
浏览、搜索、分类筛选、作者筛选、热门排序
用户名 + 邮箱双模式，邮箱验证码
两步流程：基础信息 → 上传 ZIP + 实时扫描进度
KPI 统计总览
开发者 Skill 管理，状态流程条，驳回后可重新提交
三层扫描结果 + 来源区分（新上传/重新提交/重新上架）
搜索 + 分类筛选 + 作者筛选 + 快捷审批
扫描摘要 + 安装/下载 + 工作流可视化
| 层级 | 技术 |
|---|---|
| 前端 | Vue 3 + TypeScript + Element Plus + Vite |
| 后端 | FastAPI + SQLAlchemy (async) + Alembic |
| 数据库 | PostgreSQL 16 |
| 对象存储 | MinIO（Skill 包存储） |
| 安全扫描 | Semgrep + ClamAV + Qwen LLM |
| 容器化 | Docker + Docker Compose |
- Docker & Docker Compose (v2+)
- Node.js ≥ 18（仅本地开发需要）
- Python ≥ 3.11（仅本地开发需要）
- 通义千问 API Key（用于 LLM 语义扫描）
适用于生产环境或快速体验，所有服务容器化运行。
# 1. 克隆仓库
git clone https://github.com/wzzfather/jsdSkillHub.git
cd jsdSkillHub
# 2. 配置环境变量
cp .env.example .env
# 编辑 .env，填入 QWEN_API_KEY（必需）和 JWT_SECRET_KEY（生产环境必改）
# 3. 启动所有服务
docker compose up -d
# 4. 等待服务就绪（首次启动需等待 ClamAV 病毒库下载，约 1-3 分钟）
docker compose ps
# 5. 后端自动运行数据库迁移，访问前端
curl http://localhost:8000/docs # API 文档注意：前端暂未容器化，Docker Compose 仅启动后端及基础设施。前端需单独部署（见下方方式二）。
默认账号：
admin/admin123
适用于开发调试，前后端在本地运行，基础设施用 Docker。
# 1. 克隆仓库
git clone https://github.com/wzzfather/jsdSkillHub.git
cd jsdSkillHub
# 2. 启动基础设施（PostgreSQL + MinIO + OpenSearch + ClamAV）
docker compose up -d postgres minio opensearch clamav
# 3. 配置后端
cd backend
cp ../.env.example ../.env
# 编辑 .env：DATABASE_URL 改为 localhost，MINIO_ENDPOINT_URL 改为 localhost 等
pip install -r requirements.txt
alembic upgrade head
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
# 4. 配置前端（新终端）
cd frontend
npm install
npm run dev访问 http://localhost:5173 即可使用。
前端构建为静态文件，由 Nginx 托管；后端和基础设施全部容器化。
# 1. 基础设施 + 后端
docker compose up -d
# 2. 构建前端
cd frontend
npm install
npm run build # 输出到 dist/
# 3. Nginx 配置示例
# 将 dist/ 目录部署到 Nginx，配置 API 反向代理：server {
listen 80;
server_name your-domain.com;
root /path/to/frontend/dist;
index index.html;
# Vue Router history 模式
location / {
try_files $uri $uri/ /index.html;
}
# API 反向代理
location /api/ {
proxy_pass http://127.0.0.1:8000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}| 变量 | 说明 | 默认值 |
|---|---|---|
POSTGRES_USER |
PostgreSQL 用户名 | appstore |
POSTGRES_PASSWORD |
PostgreSQL 密码 | appstore |
POSTGRES_DB |
PostgreSQL 数据库名 | appstore |
MINIO_ROOT_USER |
MinIO 管理员用户名 | minioadmin |
MINIO_ROOT_PASSWORD |
MinIO 管理员密码 | minioadmin |
MINIO_BUCKET |
MinIO 存储桶名 | app-store |
QWEN_API_KEY |
通义千问 API Key | (必填) |
QWEN_MODEL |
LLM 模型名称 | qwen-turbo |
JWT_SECRET_KEY |
JWT 签名密钥 | change-me-in-production |
DEBUG |
调试模式 | false |
├── frontend/ # Vue 3 前端
│ └── src/
│ ├── api/ # API 调用层
│ ├── views/ # 页面组件
│ ├── stores/ # Pinia 状态管理
│ └── router/ # 路由配置
├── backend/ # FastAPI 后端
│ └── app/
│ ├── routers/ # API 路由
│ ├── models/ # SQLAlchemy 模型
│ ├── schemas/ # Pydantic schemas
│ ├── services/ # 业务逻辑
│ └── tasks/ # 异步任务（扫描）
├── skills/ # 默认 Skill 模板
│ ├── pm/ # 产品经理 Skill
│ ├── developer/ # 开发者 Skill
│ ├── tester/ # 测试 Skill
│ └── ui-design/ # UI 设计 Skill
├── core/ # 项目文档（MRD/PRD/TRD/RFC）
├── screenshots/ # 页面截图
└── docker-compose.yml
- Fork 本仓库
- 创建特性分支 (
git checkout -b feature/amazing-feature) - 提交改动 (
git commit -m 'Add some amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 创建 Pull Request
Built with ❤️ by wzzfather