# EAI AgentPlatform

智能 Agent 平台 — 基于 Go + Vue 3 构建。

## 快速启动

```bash
# 开发环境启动（前端 10231 + 后端 10232）
./start_dev_10231_10232.sh
```

## 端口说明

| 端口   | 服务                           | 说明                       |
|--------|--------------------------------|----------------------------|
| 10231  | 前端 Vite 开发服务器           | 本地开发，自动代理 API 请求 |
| 10232  | 后端 Go API 服务               | 本地开发端口               |
| 8080   | 外部 LLM 服务 (llamacpp)       | AI 对话 API 入口           |
| 8081   | 外部 Embed 服务 (llamacpp)     | 向量嵌入服务               |
| 11434  | 外部 Ollama 服务（可选）       | 如使用 Ollama 路由则需运行  |

> **注意**: 8080 和 8081 是外部 AI 服务的端口，平台后端会调用它们获取 LLM 对话和向量嵌入能力。

## 配置

复制环境变量模板并修改：

```bash
cp .env.example .env
```

主要配置项见 [.env.example](.env.example)。

## 启动脚本参数

```
--force          强制释放端口（包括非本项目进程）
--skip-preflight 跳过预检查
--skip-smoke     跳过管理员登录冒烟测试
--skip-build     不重新编译后端
--help           显示帮助
```

## 环境变量

| 变量                    | 默认值                                  | 说明                  |
|-------------------------|-----------------------------------------|-----------------------|
| PORT                    | 8080                                    | 后端 API 端口         |
| EAI_DEV_BIND_HOST       | 127.0.0.1                               | 开发绑定地址          |
| EAI_DEV_PUBLIC_HOST     | 自动检测                                | 公开访问地址          |
| LLM_BASE_URL            | http://127.0.0.1:8080/v1               | LLM 服务地址          |
| EMBED_MODEL             | bge-m3                                  | 向量嵌入模型名        |