# ArenaSK

AI Skill 竞技平台 + 多智能体自主开发系统。管理 27,000+ AI 技能，支持六维 Benchmark 评测、ELO 排名、自动进化。

🌐 **[arenask.com](https://arenask.com)**

## 功能

- **Skill Arena** — 六维 Benchmark 评测 + ELO Tournament 排名
- **Skill Marketplace** — 27,000+ 技能的搜索、下载、安装
- **Skill Management** — 注册、编辑、版本管理、自动进化
- **Multi-Agent System** — Claude CLI 驱动的多 Agent 协作开发
- **Chatbot** — 基于 Claude 的对话系统，支持持久化会话
- **开放 API** — 外部 Agent 接入，支持 API Key 认证

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端 | Vue 3 + Vite + vue-i18n (6 语言) |
| 后端 | Node.js + Express + WebSocket |
| 数据库 | SQLite (better-sqlite3) + FTS5 全文搜索 |
| AI | Claude CLI (本地进程) |
| 包管理 | pnpm workspace (monorepo) |

## 快速启动

```bash
# 安装依赖
pnpm install

# 配置环境变量
cp .env.example .env

# 开发模式 (前后端分离)
npm run dev
# 后端: localhost:3000 | 前端: localhost:5173

# 生产部署 (一键启动)
bash start.sh
```

## 目录结构

```
├── server/              # 后端服务 (Express)
│   ├── index.js         # 入口 (API + WS + Plugin)
│   ├── routes/          # 11 个 API 路由
│   ├── services/        # 业务服务 (skill-db, benchmark 等)
│   ├── middleware/       # JWT / API-Key / Logger
│   └── src/
│       ├── core/        # 核心引擎 (Orchestrator, Session)
│       └── plugins/     # 插件系统 (Feishu/WhatsApp)
├── web/                 # 前端 (Vue 3 + Vite)
│   └── src/views/       # 21 个页面组件
├── packages/            # 子包 (acp-core, evolution)
├── skills/              # 系统级 Skill 定义
├── scripts/             # 运维脚本
├── docs/                # 技术文档
└── start.sh             # 一键启动
```

## 核心 API

| 端点 | 方法 | 说明 |
|------|------|------|
| `/api/open/skills` | GET | Skill 搜索 (FTS5) |
| `/api/open/arena/leaderboard` | GET | Arena 排行榜 |
| `/api/open/skills/:name/download` | GET | Skill 下载 |
| `/api/innovator/skills` | GET | Skill 管理 (Admin) |
| `/api/master/chat` | POST | Master Agent 对话 (SSE) |
| `/api/auth/login` | POST | 用户登录 |
| `/ws/claude` | WS | Claude 实时对话 |
| `/api/health` | GET | 健康检查 |

完整 API 参考: [docs/API-REFERENCE.md](docs/API-REFERENCE.md)

## 文档

详见 [docs/INDEX.md](docs/INDEX.md):

| 文档 | 说明 |
|------|------|
| [ARCHITECTURE.md](docs/ARCHITECTURE.md) | 系统总体架构 |
| [SKILL-SYSTEM.md](docs/SKILL-SYSTEM.md) | Skill 系统详解 |
| [ARENA.md](docs/ARENA.md) | Arena 竞技系统 |
| [DEPLOYMENT.md](docs/DEPLOYMENT.md) | 部署与运维 |

## License

MIT