# AI 文章生成模型配置

## 唯一更换位置

文章生成接口实际使用的大模型 provider key 只从这里读取：

`src/config/index.js` -> `commonConfig.aiGeneration.articleProvider`

当前默认值：

```js
articleProvider: process.env.AI_GENERATION_PROVIDER || 'doubao-deepseek-v4-pro-260425'
```

以后更换文章生成大模型，只改这个配置项，或在服务器启动环境中设置。这个值可以是火山、阿里、腾讯、讯飞、OpenRouter、百度等任一已经在 `src/api/yjbdc/aiController.js` 的 `AIProviderFactory` 中支持的 provider key。

```bash
AI_GENERATION_PROVIDER=doubao-deepseek-v4-pro-260425
```

示例：

```bash
AI_GENERATION_PROVIDER=doubao-deepseek-v4-pro-260425
AI_GENERATION_PROVIDER=ali-qwen-max
AI_GENERATION_PROVIDER=tencent-hunyuan-turbos-latest
AI_GENERATION_PROVIDER=xf-yun-spark-x1
AI_GENERATION_PROVIDER=openrouter-moonshotai/kimi-k2
```

如果前端需要显示不同名称、版本号或预计生成时间，同一处配置同步调整：

```js
articleProviderVersion
articleProviderContent
articleProviderBuildSecond
```

## 当前策略

- 后端忽略前端传入的 `AIVersion`，统一使用 `config.aiGeneration.articleProvider`。
- `aiController.generateArticle(content, provider)` 的第二个参数只保留旧调用兼容，不再参与模型选择。
- `/api/GetYJBDCGenerateConfig` 只返回当前配置的一个模型选项，避免前端显示已不可用的模型。
- 不配置备用 provider，避免自动切到已不可用的模型或供应商。
- 如果配置了不支持的 provider key，服务会显式报错，不会静默回退到某一家。
- 使用火山 provider 时，VolcesAI 请求保留节流和 429 退避重试，减少 RPM 超限错误；使用其他 provider 时不受这组火山专用节流参数影响。