# py-agent-write

**Repository Path**: powerJproud/py-agent-write

## Basic Information

- **Project Name**: py-agent-write
- **Description**: 通过写作agent快速出文章
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-10
- **Last Updated**: 2026-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# pyAgent

公众号文章 Agent MVP，支持从热点信息获取、文章初稿生成、编辑优化到发布计划管理的完整流程。

## 技术栈
- 后端：FastAPI + LangChain + SQLAlchemy
- 大模型：Kimi / Moonshot（OpenAI-compatible）
- 数据库：MySQL 8.0
- 前端：Vue 3 + Vite + Pinia + md-editor-v3
- 热点来源：MCP（当前提供 mock 实现，后续可替换为真实 MCP）

## 目录结构
- `app/`：后端源码
- `frontend/`：Vue 3 前端
- `docs/`：需求、架构、数据库设计文档
- `tests/`：基础测试
- `md/`：项目计划文档

## 后端启动
### 创建虚拟环境
```
python -m venv venv
```
### 进入虚拟环境
```
.\venv\Scripts\Activate.ps1
```
1. 安装依赖：
   - `pip install -r requirements.txt`
2. 复制配置：
   - 将 `.env.example` 复制为 `.env`
3. 修改 `.env` 中的大模型配置：
   - `OPENAI_API_KEY=你的 Moonshot API Key`
   - `OPENAI_BASE_URL=https://api.moonshot.cn/v1`
   - `OPENAI_MODEL=kimi-2.5`
4. 修改 MySQL 连接：
   - `DATABASE_URL=mysql+pymysql://root:password@localhost:3306/pyagent?charset=utf8mb4`
5. 启动服务：
   - `uvicorn app.main:app --reload --port 8002`

默认地址：`http://127.0.0.1:8002`

## 前端启动
1. 进入前端目录：
   - `cd frontend`
2. 安装依赖：
   - `npm install`
3. 启动开发服务器：
   - `npm run dev`

默认地址：`http://127.0.0.1:5173`

## API 概览
- `GET /`：服务首页
- `GET /api/health`：健康检查
- `POST /api/chat`：与 Agent 对话
- `GET /api/articles`：文章列表
- `POST /api/articles`：创建文章
- `PUT /api/articles/{id}`：更新文章
- `GET /api/articles/{id}/versions`：查看版本历史
- `PUT /api/articles/{id}/status`：更新文章状态
- `POST /api/articles/{id}/plan`：设置发布时间
- `GET /api/publish-plans`：查看发布计划

## 当前状态
- 已完成计划中的 MVP 主链路
- MCP 为 mock 版本，方便先完成业务闭环
- 可在后续将 `app/mcp_client/hotspot.py` 替换为真实 MCP 接入