# BoomStart 一键起站

新站内容冷启动工具，一键生成分类与文章草稿，让空站瞬间充实。

## 功能特性

- 🚀 一键生成：根据站点主题描述自动生成分类和文章（3 个分类 + 10 篇文章）
- ➕ 追加生成：选择已有分类追加生成更多文章（5 篇）
- 🤖 真实 AI：支持 Deepseek、OpenAI 等兼容 OpenAI API 格式的服务
- 🔗 连接测试：一键验证 API Key / Base URL / Model 是否可用
- ⏳ 异步生成：生成在后台运行，不阻塞浏览器，全程显示进度
- 🎨 动态进度：实时显示生成阶段（思考→分类→撰写→配图→完成）
- 🖼️ 自动配图：可选为文章自动下载免费特色图片到媒体库
- ✍️ 灵活选项：可调整文章篇幅（简洁/标准/丰富）和写作风格（专业/亲切/SEO）
- 📝 草稿模式：所有文章以草稿状态创建，可自由编辑后发布
- 📤 一键发布：批量发布所有草稿文章
- 🗑️ 一键删除：批量删除生成的内容（移至回收站，可恢复）
- 🏷️ 智能分类：自动创建合理的内容分类体系
- 🔍 溯源标识：所有生成的内容都带有时间戳标记
- 🎨 简洁界面：清爽的后台管理界面，操作简单直观

## 安装方法

1. 下载插件文件
2. 上传到 `/wp-content/plugins/boomstart` 目录
3. 在 WordPress 后台"插件"页面激活插件
4. 在左侧菜单找到"一键起站"开始使用

## 使用说明

### 首次生成

1. 进入"一键起站"管理页面
2. 在文本框中描述你的站点主题（例如：一个关于健康饮食和营养知识的博客）
3. 点击"开始魔法生成"按钮
4. 等待生成完成，系统会创建分类和文章草稿

### 追加生成

1. 在管理页面点击"追加生成更多内容"
2. 从下拉菜单选择要追加文章的分类
3. 输入站点主题描述（会自动填入上次的描述）
4. 点击"追加生成"按钮

### 一键发布

1. 在管理页面查看草稿统计
2. 点击"一键发布所有草稿"按钮
3. 确认后所有草稿文章将变为已发布状态

### 查看内容

- 前往"文章" → "所有文章"查看生成的文章草稿
- 前往"文章" → "分类目录"查看生成的分类
- 编辑文章内容后发布

## 技术架构

### 目录结构

```
boomstart/
├── boomstart.php              # 插件入口文件
├── admin/                     # 后台管理
│   ├── class-bs-admin.php    # 管理页面类
│   └── ajax-handlers.php     # AJAX 请求处理
├── ai/                        # AI 适配器
│   ├── class-bs-ai-adapter.php      # 抽象基类
│   ├── class-bs-mock-adapter.php    # Mock 适配器（测试数据）
│   └── class-bs-openai-adapter.php  # OpenAI 兼容适配器
├── includes/                  # 核心功能
│   ├── class-bs-generator.php # 内容生成引擎
│   ├── class-bs-cleaner.php   # 内容清理工具
│   └── class-bs-image-service.php # 图片下载服务
├── assets/                    # 前端资源
│   ├── css/
│   │   └── bs-admin.css      # 后台样式
│   └── js/
│       └── bs-admin.js       # 后台脚本
└── languages/                 # 翻译文件
```

### 核心组件

1. **AI 适配器层** (`ai/`)
   - 抽象基类定义统一接口
   - Mock 适配器提供测试数据
   - 易于扩展真实 AI 服务

2. **内容生成引擎** (`includes/class-bs-generator.php`)
   - 处理分类和文章的创建
   - 支持首次生成和追加生成
   - 数据验证和清洗
   - 溯源标识管理

3. **内容清理工具** (`includes/class-bs-cleaner.php`)
   - 统计生成的内容数量
   - 一键发布所有草稿
   - 批量清理生成的内容

4. **后台管理** (`admin/`)
   - 用户界面渲染
   - AJAX 请求处理
   - 权限和安全校验

## 开发计划

- [x] 集成真实 AI 服务（Deepseek、OpenAI 等）
- [x] 追加生成功能
- [x] 批量发布草稿
- [x] 批量删除生成的内容
- [x] API 连接测试功能
- [x] 自动配图功能
- [x] 文章篇幅和写作风格选项
- [x] 动态进度反馈
- [ ] 自定义生成数量
- [ ] 可配置 Prompt 模板
- [ ] 内容质量评分

## 系统要求

- WordPress 6.0 或更高版本
- PHP 7.4 或更高版本

## 许可证

GPL-2.0-or-later

## 作者

Your Name

## 更新日志

### 1.4.0
- 重构：队列式异步生成架构，彻底解决 PHP-FPM 超时问题
- 优化：将单次长请求拆分为多次短请求，每篇文章独立生成
- 新增：实时队列进度显示，可查看每篇文章的生成状态
- 新增：失败自动重试机制（最多 3 次），单篇失败不影响整体
- 优化：大纲生成与正文生成分离，提升生成成功率
- 优化：配图下载时间控制在 15 秒内，避免超时
- 修复：生成带配图文章时 80 秒被 PHP-FPM 强制杀死的问题
- 修复：生成过程中没有任何文章插入数据库的问题

### 1.3.0
- 新增：自动配图功能，可为文章下载免费特色图片到媒体库（使用 Pollinations AI）
- 新增：文章篇幅选项（简洁/标准/丰富），可调整生成内容的字数
- 新增：写作风格选项（专业正式/亲切随和/SEO 优化），可调整内容语气
- 新增：动态进度反馈，实时显示生成阶段（思考→分类→撰写→配图→完成）
- 新增：进度条可视化，直观展示生成进度百分比
- 优化：生成选项实时传递，无需保存即可应用到当次生成
- 优化：图片下载与文章生成分离，避免进度条跳跃
- 修复：追加生成模式下进度计算不准确的问题
- 修复：长时间生成任务超时问题（开启配图时自动延长超时时间）

### 1.2.1
- 修复：异步生成在宿主环境下由于 loopback 被拦截导致生成无法完成（改用 PHP-FPM fastcgi_finish_request）
- 修复：OpenAI 适配器缺少父类导入导致用真实 AI 生成时报错
- 新增：API 设置顶层新增“🔗 测试连接”按鈕，可验证 API 正确性
- 修复：保存 API Key 后无需刷新页面即可直接开始生成

### 1.2.0
- 新增：接入真实 AI 服务，支持 Deepseek、OpenAI 等兼容 OpenAI API 格式的服务
- 新增：API 设置面板（接口地址、API Key、模型型号），集成在插件主页面
- 新增：异步生成模式，生成过程在后台运行，不阻塞服务器，全程有状态提示
- 新增：一键删除所有生成内容（移至回收站，可恢复）
- 优化：内容语言自动跟随站点描述的语言
- 优化：追加生成同样支持异步模式

### 1.1.0
- 新增：追加生成功能，可为指定分类追加文章
- 新增：一键发布所有草稿功能
- 新增：批量清理生成内容功能
- 优化：智能 UI 切换，有内容时自动显示统计和操作面板
- 优化：记住上次输入的站点描述

### 1.0.0
- 初始版本发布
- 基础内容生成功能
- Mock 适配器实现