forked from niuniu/llm-intelligence
chore: prepare repository for publishing
This commit is contained in:
122
DEPLOYMENT.md
Normal file
122
DEPLOYMENT.md
Normal file
@@ -0,0 +1,122 @@
|
||||
# LLM Intelligence Hub - 部署指南
|
||||
|
||||
> 版本: v1.0
|
||||
> 日期: 2026-05-10
|
||||
> 适用版本: Phase 1
|
||||
|
||||
---
|
||||
|
||||
## 环境要求
|
||||
|
||||
### 硬件
|
||||
- CPU: 1核+
|
||||
- 内存: 512MB+
|
||||
- 磁盘: 5GB+
|
||||
|
||||
### 软件
|
||||
- Go 1.22+
|
||||
- Node.js 20+
|
||||
- PostgreSQL 16+
|
||||
- Docker 或 Podman (可选)
|
||||
|
||||
---
|
||||
|
||||
## 快速开始
|
||||
|
||||
### 1. 克隆仓库
|
||||
```bash
|
||||
git clone <repo-url> llm-intelligence
|
||||
cd llm-intelligence
|
||||
```
|
||||
|
||||
### 2. 配置数据库
|
||||
```bash
|
||||
# 创建数据库
|
||||
createdb llm_intelligence
|
||||
|
||||
# 运行迁移
|
||||
psql llm_intelligence < db/migrations/001_phase1_core_tables.sql
|
||||
```
|
||||
|
||||
### 3. 配置环境变量
|
||||
```bash
|
||||
export DATABASE_URL="host=/var/run/postgresql dbname=llm_intelligence sslmode=disable"
|
||||
export OPENROUTER_API_KEY="your-api-key"
|
||||
export FEISHU_WEBHOOK="your-webhook-url" # 可选
|
||||
```
|
||||
|
||||
### 4. 启动后端
|
||||
```bash
|
||||
go run cmd/server/main.go
|
||||
```
|
||||
|
||||
### 5. 启动前端 (开发)
|
||||
```bash
|
||||
cd frontend
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
### 6. 配置定时任务
|
||||
```bash
|
||||
crontab -e
|
||||
# 添加: 0 8 * * * cd /path/to/llm-intelligence && bash scripts/run_daily.sh
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Docker 部署
|
||||
|
||||
```bash
|
||||
# 构建
|
||||
docker build -t llm-hub .
|
||||
|
||||
# 或 docker-compose
|
||||
docker-compose up -d
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 配置说明
|
||||
|
||||
| 变量 | 必填 | 说明 |
|
||||
|------|------|------|
|
||||
| DATABASE_URL | ✅ | PostgreSQL 连接串 |
|
||||
| OPENROUTER_API_KEY | ✅ | OpenRouter API Key |
|
||||
| FEISHU_WEBHOOK | ❌ | 飞书告警 Webhook |
|
||||
| API_PORT | ❌ | 默认 8080 |
|
||||
|
||||
---
|
||||
|
||||
## 验证安装
|
||||
|
||||
```bash
|
||||
# 数据库连接
|
||||
curl http://localhost:8080/health
|
||||
|
||||
# 采集器测试
|
||||
go run scripts/fetch_openrouter.go
|
||||
|
||||
# 日报生成
|
||||
go run scripts/generate_daily_report.go
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 常见问题
|
||||
|
||||
### Q: 数据库迁移失败?
|
||||
确保 PostgreSQL 已启动,且用户有创建表的权限。
|
||||
|
||||
### Q: 前端构建失败?
|
||||
检查 Node.js 版本 >= 20,npm 版本 >= 10。
|
||||
|
||||
### Q: 采集器返回模拟数据?
|
||||
未提供 OPENROUTER_API_KEY 时使用模拟数据,提供 Key 后获取真实数据。
|
||||
|
||||
---
|
||||
|
||||
## 升级路径
|
||||
|
||||
- Phase 2: 告警订阅 / 用户系统 / 付费分析
|
||||
- Phase 3: 多数据源 / 自动发现 / ELO评分
|
||||
Reference in New Issue
Block a user