# BoomStart 快速开始指南

## 📦 安装步骤

### 方法一：直接上传（推荐）

1. 将整个 `BoomStart` 文件夹上传到 WordPress 的 `wp-content/plugins/` 目录
2. 登录 WordPress 后台
3. 进入"插件"页面
4. 找到"BoomStart 一键起站"并点击"启用"

### 方法二：打包安装

```bash
# 在 BoomStart 目录的上级目录执行
cd /home/bob/projects
zip -r boomstart.zip BoomStart -x "*.git*" "*.sh" "check.sh"
```

然后在 WordPress 后台：
1. 进入"插件" → "安装插件" → "上传插件"
2. 选择 `boomstart.zip` 文件
3. 点击"现在安装"
4. 安装完成后点击"启用插件"

## 🚀 使用方法

### 第一步：访问管理页面

启用插件后，在 WordPress 后台左侧菜单会出现"一键起站"选项，点击进入。

### 第二步：首次生成内容

#### 描述你的站点

在文本框中输入站点主题描述，例如：

```
一个关于健康饮食和营养知识的博客，面向注重健康生活的年轻人，
分享科学的饮食建议、健康食谱和营养搭配技巧。
```

#### 生成内容

点击"开始魔法生成"按钮，等待几秒钟。

### 第三步：追加生成（可选）

如果需要为某个分类追加更多文章：

1. 点击"追加生成更多内容"按钮
2. 从下拉菜单选择目标分类
3. 输入站点描述（会自动填入上次的描述）
4. 点击"追加生成"按钮

### 第四步：一键发布

当你对草稿内容满意后：

1. 查看页面顶部的统计信息（草稿数量、已发布数量等）
2. 点击"一键发布所有草稿"按钮
3. 确认后所有草稿将变为已发布状态

### 第五步：查看结果

生成完成后，你可以：

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

## 📊 当前版本说明

**版本：1.4.0**

当前版本采用队列式异步生成架构，彻底解决 PHP-FPM 超时问题：

- **队列生成**：将单次长请求拆分为多次短请求，每篇文章独立生成
- **实时进度**：可查看每篇文章的生成状态（待生成/生成中/已完成/失败）
- **失败重试**：单篇文章失败自动重试 3 次，失败后跳过继续下一篇
- **稳定可靠**：单次请求控制在 30-45 秒内，远低于 PHP-FPM 超时阈值
- **支持的 AI 服务**：Deepseek、OpenAI 等兼容 OpenAI API 格式的服务
- **智能语言检测**：AI 会自动检测站点描述的语言，并生成相同语言的内容
- **测试模式**：未配置 API Key 时可使用测试数据体验功能
- **自动配图**：可选为文章自动下载免费特色图片
- **生成选项**：可调整文章篇幅和写作风格

### 配置 API 设置

1. 在插件主页面顶部找到"⚙️ API 设置"卡片
2. 填写以下信息：
   - **Base URL**：API 接口地址（例如：`https://api.deepseek.com/v1`）
   - **API Key**：你的 API 密钥（例如：`sk-...`）
   - **Model**：模型名称（例如：`deepseek-chat`）
   - **自动配图**：勾选后会为文章下载免费特色图片（可能增加生成时间）
3. 点击"保存设置"按钮
4. 点击"🔗 测试连接"验证 API 是否可用（应在 15 秒内显示结果）

### 配置生成选项

在"📝 生成选项"卡片中可以调整：
- **文章篇幅**：简洁（约200字）/ 标准（约300字）/ 丰富（约500字）
- **写作风格**：专业正式 / 亲切随和 / SEO 优化

这些选项会实时应用到生成过程，无需保存即可生效。

配置并测试通过后，即可开始生成内容。

## 🔍 生成内容的特点

1. **草稿状态**：所有文章都以草稿形式创建，不会立即发布
2. **溯源标识**：每个分类和文章都有 `_bs_generated_at` 元数据标记
3. **完整结构**：包含标题、正文、摘要、分类关联
4. **智能语言**：AI 自动检测站点描述语言并生成相同语言的内容
5. **智能 UI**：有内容时自动显示统计和操作面板
6. **记忆功能**：自动记住上次输入的站点描述
7. **异步处理**：生成过程在后台运行，不阻塞服务器
8. **可删除**：支持一键删除所有生成内容（移至回收站）
9. **自动配图**：可选为文章下载特色图片到媒体库
10. **动态进度**：实时显示生成阶段（思考→分类→撰写→配图→完成）

## 🛠️ 技术细节

### 数据结构

生成的内容包含：

```php
[
    'categories' => [
        [
            'name'        => '分类名称',
            'slug'        => 'category-slug',
            'description' => '分类描述'
        ]
    ],
    'posts' => [
        [
            'title'    => '文章标题',
            'content'  => '<p>HTML 格式的正文</p>',
            'category' => 'category-slug',
            'excerpt'  => '文章摘要'
        ]
    ]
]
```

### 安全特性

- ✅ Nonce 验证
- ✅ 权限检查（需要 `manage_options` 权限）
- ✅ 输入清洗（`sanitize_text_field`, `wp_kses_post`）
- ✅ 错误处理

## 🔮 未来扩展

当前架构已支持多种 AI 服务，可以轻松切换：

- ✅ Deepseek
- ✅ OpenAI GPT-4
- ✅ 其他兼容 OpenAI API 格式的服务

只需在 API 设置中修改 Base URL 和 Model 即可。

## ❓ 常见问题

**Q: 生成的内容可以删除吗？**
A: 可以。点击"🗑️ 删除所有生成内容"按钮，所有生成的分类和文章将被移至回收站，可在 WordPress 回收站中恢复。

**Q: 可以多次生成吗？**
A: 可以。每次生成都会创建新的分类和文章，不会覆盖已有内容。

**Q: 可以为已有分类追加文章吗？**
A: 可以。使用"追加生成"功能，选择目标分类即可。

**Q: 如何批量发布草稿？**
A: 点击页面顶部的"一键发布所有草稿"按钮即可。

**Q: 生成失败怎么办？**
A: 检查 API 设置是否正确，确保 API Key 有效且有足够的额度。可以开启 `WP_DEBUG` 查看详细错误日志。

**Q: 未配置 API Key 可以使用吗？**
A: 可以。未配置 API Key 时，系统会提示使用测试数据体验功能（内容为固定示例）。

**Q: 生成过程需要多久？**
A: v1.4.0 队列架构下：
- 首次生成 10 篇（标准篇幅）：约 3-5 分钟（每篇 20-30 秒）
- 追加 5 篇：约 2-3 分钟
- 开启自动配图会增加每篇 15 秒左右（图片下载时间）

生成过程中会显示每篇文章的实时状态，可以看到具体进度。

## 📝 开发者信息

- **插件版本**：1.4.0
- **WordPress 要求**：6.0+
- **PHP 要求**：7.4+
- **架构**：队列式异步生成，单次请求 30-45 秒，避免 PHP-FPM 超时
- **许可证**：GPL-2.0-or-later

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！

---

**享受你的内容创作之旅！** 🎉