AIExcerpt - Typecho AI文章自动生成插件

📝 插件介绍

AIExcerpt 是一款基于 DeepSeek/OpenAI API 的 Typecho 插件，只需输入文章标题，即可自动生成高质量的文章内容。插件支持 Markdown 格式输出，可以直接复制内容使用，大幅提高内容创作效率。

✨ 主要特性

• 🤖 AI驱动创作：基于先进的DeepSeek/OpenAI大语言模型生成高质量文章
• 🔄 一键生成：只需输入标题，一键生成完整文章内容
• ⚡ 异步处理：采用异步任务机制，生成文章时不会阻塞网站访问
• 📝 Markdown支持：支持Markdown格式输出，保持文章结构清晰
• 🏷️ 智能标签：AI 自动分析文章内容，生成 5-10 个相关标签
• 📋 推荐标题：AI 根据文章内容生成 3 个推荐标题供选择
• 📄 一键复制：支持复制文章内容、标签、标题到剪贴板
• 🔄 重新生成：对结果不满意可以一键重新生成
• ⚙️ 灵活配置：可自定义API类型、模型、创意度等多种参数
• 🎯 定制提示词：可自定义生成提示词模板，精确控制文章风格和结构
• 🔒 SSL安全：支持SSL证书验证，保障API通信安全
• ✅ Typecho 1.3：完全兼容 Typecho 1.2.0 及以上版本

🔧 版本要求

• Typecho 1.2.0 或更高版本（推荐 1.3.0）
• PHP 7.0 或更高版本
• cURL 扩展支持

📦 版本历史

v1.2.0 (2025-03-06)

• ✅ 添加推荐标题功能，AI 生成 3 个推荐标题供选择
• ✅ 优化标签生成算法，支持 5-10 个标签
• ✅ 添加"复制推荐标题"按钮
• ✅ 改进 Markdown 渲染显示
• ✅ 删除发布状态和分类功能，专注内容生成

v1.1.0 (2025-03-06)

• ✅ 实现异步任务处理机制，解决生成文章时阻塞网站的问题
• ✅ AI 自动生成文章标签功能
• ✅ 添加SSL证书验证选项
• ✅ 改进错误处理和日志记录
• ✅ 完全兼容 Typecho 1.3.0

v1.0.0 (2025-01-01)

• ✅ 初始版本发布

🔧 插件架构

AIExcerpt采用模块化设计，主要由以下三个核心文件组成：

AIExcerpt/
  ├── Plugin.php     # 插件核心文件，包含配置和主要功能
  ├── Action.php     # 处理API请求和响应的控制器
  └── manage.php     # 管理界面前端实现

核心模块功能

1. Plugin.php：

   • 插件注册与初始化
   • 配置面板定义
   • API调用实现
   • 文章生成逻辑
   • 智能标签生成
   • 推荐标题生成

2. Action.php：

   • 处理AJAX请求
   • 异步任务管理
   • 错误处理和响应

3. manage.php：

   • 用户界面实现
   • 前端交互逻辑
   • 实时生成预览
   • Markdown 渲染

🚀 安装方法

1. 下载插件并解压
2. 将插件文件夹重命名为 AIExcerpt
3. 上传至 Typecho 的 /usr/plugins/ 目录
4. 登录 Typecho 后台，进入「控制台」-「插件」
5. 找到 AIExcerpt 插件，点击「启用」
6. 点击「设置」，配置API密钥和其他参数

⚙️ 配置说明

基本配置

高级配置

📖 使用教程

基本使用流程

1. 在Typecho后台导航菜单中找到「AI创作」
2. 在输入框中输入文章标题
3. 点击「生成文章」按钮
4. 系统创建异步任务，开始生成文章（通常需要30-120秒）
5. 前端自动轮询查询任务状态，生成期间不会影响网站访问

6. 生成完成后可以：

   • 查看生成的文章内容（Markdown 渲染）
   • 查看 AI 生成的 3 个推荐标题
   • 查看 AI 自动生成的标签
   • 点击「复制文章内容」将内容复制到剪贴板
   • 点击「复制推荐标签」将标签复制到剪贴板
   • 点击「复制推荐标题」将标题复制到剪贴板
   • 点击「重新生成」重新生成文章
7. 在 Typecho 后台「撰写」页面粘贴内容并发布

推荐标题功能

插件会在生成文章内容后，自动调用 AI 分析文章内容，生成 3 个更吸引人的标题供选择：

• 标题简洁有力，15-30个字
• 准确反映文章内容
• 有吸引力，能激发读者兴趣
• 用户可以选择使用或作为参考

智能标签功能

插件会在生成文章内容后，自动调用 AI 分析文章内容，提取最相关的关键词作为标签。标签生成规则：

• 每个标签 2-4 个字
• 准确反映文章主题
• 标签按重要性排序
• 涵盖不同维度（主题、技术、领域等）
• 用户可以直接复制使用

异步任务机制

为了避免 AI 生成文章时阻塞网站访问，插件采用了异步任务处理机制：

1. 任务创建：用户提交标题后，系统立即创建任务记录并返回任务 ID
2. 状态轮询：前端开始轮询查询任务状态（每 2 秒查询一次）
3. 后台生成：后台异步调用 AI API 生成文章内容、标题和标签
4. 自动显示：生成完成后，前端自动显示结果

这样即使 AI 生成需要较长时间（30-120秒），也不会影响网站的正常访问。任务状态包括：

• pending：等待处理
• processing：正在生成
• completed：生成完成
• failed：生成失败

高级技巧

优化生成提示词

默认提示词已经能生成不错的内容，但您可以根据自己的需求自定义提示词，例如：

我需要你写一篇有关以下主题的技术博客："{title}"。请按照以下要求：
1. 使用技术博客的专业风格
2. 包含代码示例和实际应用场景
3. 添加相关技术的最佳实践建议
4. 文章结构应当包含：介绍、核心内容、代码示例、最佳实践、总结

调整创意度参数

• 低创意度(0.1-0.3): 生成更严谨、事实性的内容，适合技术文档
• 中等创意度(0.4-0.7): 平衡创意与准确性，适合大多数博客文章
• 高创意度(0.8-1.0): 生成更有创意的内容，适合创意写作

🔍 常见问题

生成文章失败

• 检查API密钥是否正确
• 确认API地址是否可访问
• 检查网络连接是否稳定
• 查看PHP是否安装curl扩展

生成内容质量不高

• 尝试调整创意度参数
• 优化提示词模板
• 提供更具体、详细的标题
• 尝试更换AI模型

文章格式异常

• 确认选择了正确的输出格式(Markdown/HTML)
• 检查生成的内容是否包含特殊字符
• 尝试重新生成或手动调整格式

标签或标题生成失败

• 标签和标题生成失败不会影响文章内容生成
• 可以手动添加标签和修改标题
• 检查 PHP 错误日志查看具体原因
• 确认使用的是 deepseek-chat 模型（deepseek-reasoner 可能不返回标签）

🛠️ 后续开发计划

• [x] 添加重新生成功能
• [x] SSL证书验证选项
• [x] Typecho 1.3 兼容性
• [x] 异步任务处理机制
• [x] AI 自动生成标签
• [x] AI 推荐标题功能
• [ ] 添加更多AI模型支持
• [ ] 实现生成历史记录
• [ ] 优化生成速度和质量
• [ ] 添加批量生成功能
• [ ] 支持多语言内容生成
• [ ] 集成图片生成功能

📄 许可证

AIExcerpt 遵循 MIT 许可证开源。

🙏 鸣谢

• DeepSeek AI
• OpenAI
• Typecho
• 乐乐主题创作室

📞 联系与支持

• 作者论坛：乐乐主题创作室