AI 设置
配置组：basic
AI 设置用于选择模型、控制生成参数，以及保护前台 AI 接口。这里是插件所有 AI 能力的基础配置。
使用前提
请先安装并启用 Halo AI Foundation，并在 AI 基座插件中配置可用模型。本插件会通过 AI 基座调用模型，不直接维护模型 API Key。
同步摘要
AI 设置页提供“同步所有文章 AI 摘要”按钮，用于手动触发全站文章摘要同步。
适合场景：
- 初次安装插件后，希望为已有文章补齐摘要。
- 调整摘要模型或摘要角色后，希望重新生成文章摘要。
- 前台摘要展示异常时，需要重新同步摘要数据。
同步会调用摘要生成能力，文章数量较多时耗时会比较长，建议先确认 AI 基座模型可用。
模型选择
| 配置项 | 字段 | 说明 |
|---|---|---|
| 主语言模型 | languageModelName | 插件默认语言模型。各功能未单独选择模型时会回退到这里。 |
| 摘要语言模型 | textModelSetting.summaryModelName | 用于文章摘要生成。 |
| 标签语言模型 | textModelSetting.tagModelName | 用于文章标签生成。 |
| 对话语言模型 | textModelSetting.assistantModelName | 用于控制台编辑器里的选中文本对话。 |
| 润色语言模型 | textModelSetting.polishModelName | 用于文章润色。 |
| 文章生成语言模型 | textModelSetting.generateModelName | 用于文章草稿生成。 |
| 标题生成语言模型 | textModelSetting.titleModelName | 用于标题候选生成。 |
| 知识库问答语言模型 | textModelSetting.ragLanguageModelName | 用于前台 RAG 智能助手和知识库问答。 |
配置建议
- 小站点可以只配置主语言模型，让所有功能复用同一个模型。
- 对问答质量要求较高时，建议为
知识库问答语言模型单独选择更强的模型。 - 润色、标题、标签这类短任务可以选择速度更快、成本更低的模型。
向量模型
| 配置项 | 字段 | 说明 |
|---|---|---|
| 知识库 Embedding 模型 | vectorModelSetting.embeddingModelName | 用于内容向量化和查询向量化。修改后需要重建知识库索引。 |
| 知识库 Rerank 模型 | vectorModelSetting.rerankModelName | 用于对混合召回结果精排。未配置或调用失败时会回退到召回顺序。 |
注意事项
- 使用 RAG 知识库前必须配置可用的 Embedding 模型。
- 更换 Embedding 模型后，旧向量和新模型不兼容，需要重建索引。
- Rerank 是可选增强项，适合内容较多、搜索结果需要精排的站点。
生成配置
| 配置项 | 字段 | 默认值 | 范围 | 说明 |
|---|---|---|---|---|
| 标签生成数量 | generationSetting.tagGenerationCount | 5 | 1-20 | 每篇文章生成的标签数量。 |
| 最大润色长度 | generationSetting.polishMaxLength | 2000 | 100-8000 | 单次润色最大字符数，超过后需要分段润色。 |
AI 接口安全
| 配置项 | 字段 | 默认值 | 说明 |
|---|---|---|---|
| 启用 AI 接口防盗链 | aiSecuritySetting.antiHotlinkEnabled | true | 校验 Sec-Fetch-Site、Origin 和 Referer，只允许本站或白名单来源调用 AI 接口。 |
| AI 助手访问模式 | aiSecuritySetting.accessMode | anonymous_chat_agent | 控制访客能否对话，以及是否允许 Agent 能力。 |
| 允许缺失来源 | aiSecuritySetting.allowMissingOrigin | false | 仅在反代、旧浏览器或特殊客户端无法携带来源时开启。 |
| 额外允许的 Origin | aiSecuritySetting.allowedOrigins | [] | 每项填写完整 Origin，例如 https://www.example.com。 |
| 启用 AI 接口限流 | aiSecuritySetting.rateLimitEnabled | true | 按登录用户名或匿名 IP 限制 AI 接口调用频率。 |
| 窗口内允许请求次数 | aiSecuritySetting.rateLimitRequests | 20 | 限流窗口内允许的请求次数。 |
| 限流窗口 | aiSecuritySetting.rateLimitWindowSeconds | 60 | 限流窗口时长，单位秒。 |
访问模式说明
| 选项 | 值 | 说明 |
|---|---|---|
| 匿名用户可对话 | anonymous_chat | 未登录访客可以问答，但不能使用 Agent 工具。 |
| 匿名用户可对话和使用 Agent | anonymous_chat_agent | 未登录访客可以问答，也可以使用已开放的 Agent 工具。 |
| 登录用户可对话 | authenticated_chat | 只有登录用户可以问答，不能使用 Agent 工具。 |
| 登录用户可对话和使用 Agent | authenticated_chat_agent | 只有登录用户可以问答，并允许使用已开放的 Agent 工具。 |
安全建议
- 公网站点建议保持防盗链和限流开启。
- 如果站点允许匿名问答，建议降低
rateLimitRequests或关闭高风险 Agent 工具。 - 不建议随意开启
allowMissingOrigin，除非确认当前反代链路确实不会传递来源头。 allowedOrigins只填写可信站点，不要填写不受控的公共域名。