Smart AI Pro

当前版本：2.1.0

Smart AI Pro 是一个面向 WordPress 编辑与内容生产场景 的 AI 辅助插件，专注于 实用性、可控性、安全性，而非噱头功能。
插件支持多 AI Provider（兼容 OpenAI 协议），并深度适配 古腾堡编辑器与经典编辑器。

---

✨ 核心功能概览

1️⃣ 多 Provider 管理（核心能力）

• 支持 多个 AI Provider（如 OpenAI / DeepSeek / Longcat / OneAPI 等）
• 每个 Provider 独立配置：
  • Provider ID
  • Base URL
  • 默认模型
  • API Key（不回显，仅显示末 4 位）
• 支持：
  • 设为默认 Provider
  • 单 Provider 连接测试
  • Provider 状态展示（可用 / 失败 / 未测试）
• 后台使用 WP_List_Table，专业、清晰、安全

⚠️ 不再使用 JSON 明文方式存储 Key，避免泄露风险

---

2️⃣ 文章总结（自动 + 可控）

• 支持在文章侧边栏 单篇启用 / 关闭
• 支持缓存机制，避免重复调用 API
• 可设置：
  • 最低触发字数
  • 上下文截取长度
  • Temperature / Max Tokens
  • 使用的 Provider（可跟随默认或单独指定）
  • 系统 Prompt
• 支持 单篇手动重新生成摘要
• 支持 一键清空全站总结缓存

---

3️⃣ 文章续写（流式输出）

• 支持 古腾堡编辑器 + 经典编辑器
• 采用 SSE 流式输出
• 支持：
  • 上下文截取长度控制
  • Temperature / Max Tokens
  • 自定义系统 Prompt
  • 用户 Prompt 模板
• 古腾堡下：
  • 按「段落块（paragraph block）」自动插入
  • 不破坏原有排版结构
• 内置：
  • 单并发锁
  • 温和限流
  • 自动异常释放锁

---

4️⃣ AI 文章润色（流式输出）

• 支持 古腾堡编辑器 + 经典编辑器
• 使用独立的 Provider、上下文长度、Temperature、Max Tokens 与 Prompt 模板
• 生成内容保持插入到文章末尾，符合编辑器操作习惯
• 与续写功能共享稳定的流式请求入口，但控制器和配置相互独立

---

5️⃣ 标题翻译（Slug 翻译）

• 自动将中文标题翻译为英文别名（slug）
• 支持引擎：
  • OpenAI 兼容（走 Provider）
  • 百度翻译
  • 阿里云翻译
• 支持：
  • 手动触发翻译
  • 历史文章批量修复（每次 20 篇，防限流）

---

6️⃣ 安全与防滥用设计

• 所有 AI 调用统一经过 Guard 层：
  • 轻量限流（按功能）
  • 并发锁（防重复生成）
• 非侵入式设计：
  • 不做成本统计
  • 不做强风控
  • 不影响正常编辑体验

---

7️⃣ 日志系统

• 按天切割日志
• 可配置日志保留天数
• 统一 Request ID，方便排查问题
• 日志用于 调试与安全审计，非商业统计

---

🧩 架构设计

插件已完成 模块化拆分，核心结构如下：

smart-ai-pro/
├── Smart-AI-Pro.php              # 插件入口
├── includes/
│   ├── core.php                  # Logger / Guard / ProviderRegistry / API Engine / Scheduler
│   ├── openai-client.php         # OpenAI-compatible Client
│   ├── public-hooks.php          # 前台摘要 REST/UI
│   ├── secret-store.php          # API Key 加密/解密
│   ├── config-validator.php      # 配置校验
│   └── sse-trait.php             # SSE 输出工具
├── admin/
│   ├── provider-admin.php        # Provider 保存/删除/测试
│   ├── settings-controller.php   # 后台设置页
│   ├── providers-ui.php          # Provider 列表 UI
│   ├── post-tools.php            # 文章侧边栏/标题翻译/批量修复
│   ├── base-stream-controller.php # 流式控制器基类
│   ├── continue-controller.php   # 文章续写 SSE
│   ├── polish-controller.php     # AI 文章润色 SSE
│   └── editor-assets.php         # 编辑器资源加载
└── assets/
    ├── js/                       # 后台、前台、编辑器脚本与本地 marked
    └── css/                      # 后台和前台样式

设计原则：

• 不拆得过细，但职责清晰
• 便于后续维护、商业化或二次开发
• 兼容 PHP 7.4+

---

🔐 关于 API Key 与多 Key 策略

• Key 与 Provider 强绑定（符合真实使用场景）
• 每个 Provider 内可支持 多个 Key（逗号分隔）
• 插件内部可扩展为：
  • 429 触发即切换 Key
  • 定时重试恢复 Key
• 当前版本保持 简单、稳定、可控，不过度复杂化

---

🎯 插件定位

Smart AI Pro 并不是：

• ❌ 一个“自动写垃圾文章”的工具
• ❌ 一个“全自动 SEO 机器”

而是：

• ✅ 一个 编辑增强工具
• ✅ 一个 AI 能力中台
• ✅ 一个 可长期维护、可商业化的基础插件

---

📌 适用人群

• WordPress 高级用户 / 站长
• 内容团队
• 私有站点自用
• 计划二次开发或商业发行的开发者

---

🏁 开发状态

✅ 第一阶段开发完成（功能闭环 + 架构稳定）
🔒 当前版本以稳定和可维护为主，后续按模块迭代。

后续如需：

• 商业化
• OneAPI 深度接入
• 多 Key 智能调度增强
• 用户配额系统

均可在现有架构上自然扩展。

---

当前版本重点是稳定、可维护和功能闭环。后续新增功能建议继续按模块拆控制器、配置和前端脚本，避免回到单文件堆叠。