# MP_Agent

**Repository Path**: wum95401/mp_agent

## Basic Information

- **Project Name**: MP_Agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-23
- **Last Updated**: 2026-03-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 美篇Ai

当前仓库推荐的本地测试方式：

- 后端使用 Docker 运行
- 前端使用本地 `npm run dev`
- 测试环境统一使用 `http`

## 启动方式

### 1. 启动后端

```bash
docker compose up -d --build backend
```

后端默认地址：

- `http://127.0.0.1:8000`
- 健康检查：`http://127.0.0.1:8000/api/health`

### 2. 启动前端

```bash
cd frontend
npm install
VITE_AGENT_MODE=api npm run dev
```

Vite 默认端口是 `4173`，如果被占用会自动顺延到 `4174`、`4175`。

## 当前联调架构

- 浏览器访问前端 Vite 开发服务
- 前端通过 `/api` 代理到后端 `8000`
- 后端通过 `POST /api/tasks/generate` 创建任务
- 前端通过 `GET /api/tasks/{task_id}` 和 `GET /api/tasks/{task_id}/stream` 获取状态与流式结果
- 联网搜索、正文生成、图片生成都由后端统一完成

## 环境变量说明

后端通过根目录 `.env` 注入配置。

注意前端本地开发时：

- `frontend` 下的 Vite 不会自动读取根目录 `.env`
- 前端变量需要放在 `frontend/.env`，或者在启动命令前显式传入

当前常用前端启动方式：

```bash
cd frontend
VITE_AGENT_MODE=api VITE_AGENT_API_BASE_URL=http://127.0.0.1:8000 npm run dev
```

## 测试环境说明

- 当前测试环境不要求正式 HTTPS 证书
- 前端、后端、Kodo 图片访问统一走 `http` 即可
- 右侧图片目前返回的是 Kodo 签名链接，适合本地测试

如果后续前端切到 `https`，需要再补 Kodo 图片域名证书，否则浏览器可能拦截混合内容。