# A4-AI-Creator-Engine

**Repository Path**: verita/A4-AI-Creator-Engine

## Basic Information

- **Project Name**: A4-AI-Creator-Engine
- **Description**: 5个AI工具串联成内容创作流水线：选题→写稿→配图→人性化→排版→发布，一个人就能运营一个公众号。
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-09
- **Last Updated**: 2026-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎨 A4 AI 创作者引擎

> 从灵感到发布——AI驱动的公众号/自媒体内容全链路生产系统

## ✨ 一句话介绍

5个AI工具串联成内容创作流水线：选题→写稿→配图→人性化→排版→发布，一个人就能运营一个公众号。

## 🏗️ 核心架构

```
A4-AI-Creator-Engine/
├── src/                    # Python 后端
│   ├── config.py           # 配置管理
│   ├── models.py           # 数据模型
│   ├── llm.py              # LLM 调用层
│   ├── writer.py           # AI 写作服务
│   ├── image.py            # AI 配图服务
│   ├── humanize.py         # AI 文本人性化
│   ├── pipeline.py         # 流水线编排
│   ├── publish.py          # 发布服务（微信/飞书）
│   └── server.py           # FastAPI Web 服务
├── web/                    # React 前端
│   ├── src/
│   │   ├── components/     # UI 组件
│   │   ├── hooks/          # 自定义 Hooks
│   │   ├── lib/            # 工具库
│   │   ├── store/          # 状态管理
│   │   └── styles/         # 主题样式
│   └── ...
├── main.py                 # CLI 入口
├── config/                 # 配置示例
│   └── TOOLS.json.example
└── tests/                  # 测试
```

## 🚀 技术亮点

1. **AI 写作**：输入主题→AI生成标题+大纲+正文+排版，支持多种风格（科普/故事/教程）
2. **AI 配图**：调用 SiliconFlow Kolors / ModelScope API 生成封面和内文配图
3. **AI 文本人性化**：12种AI痕迹模式识别+口语化改写，降低AI检测率
4. **端到端流水线**：6步Pipeline（写作→配图→检测→改写→推送→通知）
5. **科幻风Web控制台**：eDEX-UI风格全屏暗色界面，xterm.js终端，3套主题切换
6. **WebSocket实时通信**：命令流式输出、状态订阅、心跳检测

## 🛠️ 技术栈

| 层级 | 技术 |
|------|------|
| 后端 | Python 3.9+, FastAPI, Uvicorn, Pydantic |
| 前端 | React 19, TypeScript, Vite, Tailwind CSS, xterm.js, Zustand |
| AI | SiliconFlow (DeepSeek-V3 / Kolors), ModelScope |
| 发布 | 微信公众平台 API, 飞书 Webhook |

## 📦 快速开始

### 环境要求
- Python >= 3.9
- Node.js >= 18

### 安装

```bash
# 后端
pip install -r requirements.txt

# 前端
cd web && npm install
```

### 配置

```bash
# 复制配置模板
cp config/TOOLS.json.example ~/.a4/TOOLS.json
# 编辑填入你的 API Key
```

或通过环境变量指定配置路径：
```bash
export A4_TOOLS_PATH=/path/to/your/TOOLS.json
```

### 运行

```bash
# CLI 模式
python main.py flow --topic "人工智能的未来" --style science

# Web 模式
python main.py web --dev
```

## 🎮 CLI 命令

| 命令 | 功能 |
|------|------|
| `a4 flow --topic "主题"` | 全流程执行 |
| `a4 write --topic "主题"` | AI 写作 |
| `a4 detect --input <文件>` | AI 检测 |
| `a4 humanize --input <文件>` | 人性化改写 |
| `a4 images --topic "主题"` | 生成配图 |
| `a4 pipeline list/run/del` | 流水线管理 |
| `a4 push --id <任务ID>` | 推送草稿 |
| `a4 web --dev` | 启动 Web 控制台 |

## 📄 License

MIT