# AI 设置页面重构方案

## 重构目标

将当前按提供商分组的 API 管理方式改为统一的 API 列表管理，并重新组织 AI 功能的设置结构。

## 当前结构问题

1. **API 管理分散**：每个提供商独立管理 API，用户需要在 10 个提供商之间切换
2. **结构不清晰**：AI 摘要和评论审核分散在不同的一级分类中
3. **用户体验差**：添加 API 时需要先选择提供商，然后才能配置

## 新结构设计

### 页面结构
```
AI 功能 (独立 h1，不在分类编号中)
├── API 管理 (h2)
│   ├── 已配置的 API 列表（统一显示所有提供商的 API）
│   └── 添加新 API（输入密钥 → 选择提供商 → 选择模型）
├── 文章摘要 (h2)
│   ├── 启用 AI 摘要
│   ├── 默认服务商选择
│   ├── Prompt 设置
│   └── 排除文章设置
└── 评论审核 (h2)
    ├── 启用 AI 识别
    ├── 实时检测模式
    ├── 关键字管理
    ├── Prompt 模式
    └── 其他配置
```

### 数据结构变更

#### 旧数据结构
```php
// 每个提供商独立存储
argon_ai_openai_apis = [
    {id: 'api_1', name: '主API', api_key: 'sk-xxx', ...}
]
argon_ai_anthropic_apis = [...]
// ... 10 个提供商
```

#### 新数据结构
```php
// 统一存储所有 API
argon_ai_apis = [
    {
        id: 'api_1',
        name: '主 OpenAI API',
        provider: 'openai',
        api_key: 'sk-xxx',
        api_endpoint: '',
        model: 'gpt-4o-mini',
        is_active: false,
        created_at: 1234567890
    },
    {
        id: 'api_2',
        name: '备用 Claude API',
        provider: 'anthropic',
        api_key: 'sk-ant-xxx',
        api_endpoint: '',
        model: 'claude-3-5-sonnet-20241022',
        is_active: true,
        created_at: 1234567891
    }
]

// 当前使用的 API（按场景）
argon_ai_summary_active_api = 'api_1'  // 文章摘要使用的 API
argon_ai_spam_active_api = 'api_2'     // 垃圾评论检测使用的 API
```

## 实施步骤

### 步骤 1：数据迁移函数
创建 `argon_migrate_ai_apis()` 函数，将旧的分散数据迁移到新的统一结构。

### 步骤 2：更新核心函数
- 修改 `argon_get_ai_provider_config()` 支持新数据结构
- 添加 `argon_get_all_apis()` 获取所有 API
- 添加 `argon_get_api_by_id($api_id)` 获取指定 API
- 添加 `argon_add_api($config)` 添加 API
- 添加 `argon_update_api($api_id, $config)` 更新 API
- 添加 `argon_delete_api($api_id)` 删除 API
- 添加 `argon_set_active_api_for_scenario($scenario, $api_id)` 设置场景使用的 API

### 步骤 3：重构 settings.php
- 移除原有的按提供商分组的 API 配置界面
- 创建新的统一 API 列表界面
- 重新组织 AI 功能的设置结构

### 步骤 4：更新 AJAX 处理函数
- 更新所有 API 管理相关的 AJAX 函数
- 支持新的数据结构

### 步骤 5：向后兼容
- 在主题加载时自动检测并迁移旧数据
- 保留旧数据作为备份

## 界面设计

### API 管理界面
```
┌─ 已配置的 API ─────────────────────────────────────┐
│                                                     │
│ ● 主 OpenAI API (gpt-4o-mini)                      │
│   OpenAI (ChatGPT) | sk-xxx...                     │
│   [测试] [编辑] [删除]                              │
│                                                     │
│ ○ 备用 Claude API (claude-3-5-sonnet)              │
│   Anthropic (Claude) | sk-ant-xxx...               │
│   [测试] [编辑] [删除]                              │
│                                                     │
│ [+ 添加新 API]                                      │
└─────────────────────────────────────────────────────┘

添加/编辑 API:
┌─────────────────────────────────────────────────────┐
│ 配置名称: [主 OpenAI API_________________]          │
│ API 密钥: [sk-xxx_______________________] [显示]    │
│ 提供商:   [OpenAI (ChatGPT) ▼]                     │
│ API 端点: [_____________________________] (可选)    │
│ 模型:     [gpt-4o-mini__________________] [刷新]    │
│                                                     │
│ [保存] [取消]                                        │
└─────────────────────────────────────────────────────┘
```

### 文章摘要设置
```
启用 AI 摘要: [启用 ▼]
默认使用 API: [主 OpenAI API ▼]
Prompt 设置: [...]
排除文章 ID: [...]
```

### 评论审核设置
```
启用 AI 识别: [☑] 启用 AI 自动识别垃圾评论
默认使用 API: [备用 Claude API ▼]
实时检测模式: [智能抽查 ▼]
...
```

## 优势

1. **统一管理**：所有 API 在一个列表中，一目了然
2. **灵活配置**：不同场景可以使用不同的 API
3. **易于添加**：添加 API 时直接输入密钥和选择提供商
4. **更好的 UX**：不需要在多个提供商之间切换

## 注意事项

1. **数据迁移**：确保旧数据能够正确迁移到新结构
2. **向后兼容**：保留旧数据作为备份，以防迁移失败
3. **测试充分**：需要测试所有 AI 功能是否正常工作
4. **文档更新**：更新用户文档说明新的配置方式