# PythonAgentHarness

**Repository Path**: redfox_vip/python-agent-harness

## Basic Information

- **Project Name**: PythonAgentHarness
- **Description**: 企业级AI Agent应用开发框架 PythonAgentHarness
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-08-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Agent, python-agent-harness, Python-Agent

## README

# Python Agent Harness 框架

企业通用 AI Agent 框架，基于 **Python 3.10 + FastAPI + LangGraph**，以自研 **harness 运行时**为核心，
提供「模型接入 + 工具注册 + Agent 循环 + 会话记忆 + 流式输出」的一体化能力，并配套三端前端。

## 技术栈

| 层 | 技术 |
|----|------|
| 后端 | FastAPI · SQLAlchemy 2.0(async) · Alembic · LangChain/LangGraph · Pydantic v2 |
| 数据库 | MySQL 8 |
| LLM | OpenAI 兼容协议（DeepSeek/通义/智谱/OpenAI）+ Mock provider |
| 前端 | Vue3 · TypeScript · Vite · Element Plus · Pinia |

## 工程结构

```
redfox.py_ai_agent/
├── AGENTS.md                 # 开发/审查/验收规范（必读）
├── src/
│   ├── backend/              # FastAPI 后端
│   │   └── app/
│   │       ├── harness/      # ★ Agent 运行时内核（llm/tools/graph/memory/schema/stream）
│   │       ├── api/v1/       # system / ai / shortdrama 路由
│   │       ├── services/     # 业务编排层
│   │       ├── models/       # ORM
│   │       └── core/         # 配置/日志/安全/依赖
│   └── frontend/
│       ├── web/              # 用户端（AI 对话，MVP1）
│       ├── admin/            # 管理端（模型/工具/智能体）
│       └── platform/         # 平台端（短剧创作，MVP2）
└── docs/
```

## 快速启动

### 1. 后端

```bash
cd src/backend
python -m venv .venv
# Windows: .venv\Scripts\activate   Linux/Mac: source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env                # 按需修改 MySQL 连接
python -m app.scripts.init_db       # 建表 + 种子数据（admin / admin123）
uvicorn main:app --host 0.0.0.0 --port 58001 --reload
```

接口文档：`http://127.0.0.1:58001/docs`

### 2. 前端（三端独立启动）

```bash
cd src/frontend/web && pnpm install && pnpm run dev       # 用户端 http://localhost:58010
cd src/frontend/admin && pnpm install && pnpm run dev     # 管理端 http://localhost:58011
cd src/frontend/platform && pnpm install && pnpm run dev  # 平台端 http://localhost:58012
```

> 前端已配置 `/api` 代理到后端 `58001`。默认账号 `admin / admin123`。
> 未配置真实 LLM Key 时，系统默认使用 Mock 模型，可无密钥走通完整 Agent 链路。

## MVP 验收

### MVP1：站群 HTTPS 证书检查

用户端对话输入「检查 example.com 和 api.example.com 的 HTTPS 证书过期时间」，
Agent 自动调用 `check_https_certificates` 工具，返回每张证书的过期时间、剩余天数与是否过期。

### MVP2：短剧多阶段创作

平台端输入一句短剧创意，流水线自动完成：**大纲 → 分集 → 分镜剧情提示词**，
逐阶段 SSE 推送进度，最终交付可用的分镜提示词（含景别、运镜、画面提示词）。

## 开发规范

所有开发、审查与测试验收流程请严格遵循 **[AGENTS.md](./AGENTS.md)**。

## 运行测试

```bash
cd src/backend && pytest
```