配置参考
事实来源：
AIProperties.java当前默认值
适用版本：AI 智能套件 0.3.x
配置存储
ConfigMap 的每个 data.<group> 是一段 JSON 字符串。AI 智能套件不再保存模型供应商密钥；模型供应商、Base URL、API Key 和默认模型由 Halo AI Foundation 统一管理。
模型配置 models
| 字段 | 默认值 | 说明 |
|---|---|---|
aiFoundationChatModelName | 空 | AI Foundation 语言模型资源名；为空使用默认语言模型 |
aiFoundationEmbeddingModelName | 空 | AI Foundation Embedding 模型资源名；为空使用默认嵌入模型 |
embeddingDimensions | 1024 | 索引向量维度；变更后需全量重建 |
rerankEnabled | false | 是否启用 Rerank 模型能力 |
aiFoundationRerankModelName | 空 | AI Foundation Rerank 模型资源名；为空使用默认 Rerank 模型 |
queryRewriteEnabled | false | 是否启用 Query Rewrite 模型能力 |
aiFoundationQueryRewriteModelName | 空 | AI Foundation 查询改写模型资源名；为空复用语言模型 |
模型能力开关表示服务是否可用；检索增强页中的管线开关决定一次 RAG 请求是否实际调用它。
切片配置 chunking
| 字段 | 默认值 | 说明 |
|---|---|---|
chunkMode | auto | 切片模式 |
chunkSize | 500 | 目标切片大小 |
chunkOverlap | 50 | 相邻切片重叠 |
chunkSeparator | 两个换行 | 自定义分隔符 |
markdownHeadingAware | true | 感知 Markdown 标题边界 |
sentenceAware | true | 尽量在句子边界切分 |
cleanWhitespace | true | 清理多余空白 |
minChunkSize | 50 | 过短切片的下限 |
autoKeywords | false | 是否自动提取关键词 |
autoKeywordsCount | 3 | 每篇/切片关键词数量 |
keywordsMaxTokens | 2048 | 关键词生成输出上限 |
keywordsBatchSize | 1 | 关键词处理批量大小 |
修改切片策略不会自动改写已有切片。需要对受影响文章执行单篇重建或全量重建。
检索配置 retrieval
| 字段 | 默认值 | 说明 |
|---|---|---|
searchMode | hybrid | keyword、vector 或 hybrid |
semanticWeight | 0.7 | 混合检索中的语义权重配置 |
topK | 20 | 初步召回数量 |
similarityThreshold | 0.5 | 相似度过滤阈值 |
topN | 5 | 构建上下文的最终文档数 |
showReferences | false | 是否展示引用 |
noMatchBehavior | continue | 无命中时继续回答或使用固定回复 |
noMatchReply | 抱歉，未在博客中找到与您问题相关的内容。 | 无命中回复 |
检索增强 enhancement
| 字段 | 默认值 | 说明 |
|---|---|---|
queryRewriteToggle | false | 在 RAG 中启用 Query Rewrite |
queryRewritePrompt | 空 | 自定义改写提示词 |
queryRewriteWithHistory | true | 改写时携带对话历史 |
keepOriginalQuery | false | 同时检索原问题并合并 |
hydeEnabled | false | 启用 HyDE |
hydePrompt | 空 | 自定义 HyDE 提示词 |
rerankToggle | false | 在 RAG 中启用 Rerank |
rerankScoreThreshold | 0.0 | Rerank 结果过滤阈值 |
rerankTopN | 5 | Rerank 后保留数量 |
crossLanguageEnabled | false | 启用跨语言检索 |
crossLanguageTargets | en | 目标语言 |
crossLanguageMaxResults | 5 | 跨语言结果数量 |
对话与 Widget chat
| 字段 | 默认值 | 说明 |
|---|---|---|
systemPrompt | 空 | 对话全局提示词 |
temperature | 0.7 | 回答随机性 |
maxTokens | 2048 | 最大输出 token |
historyTurns | 5 | 携带历史轮数 |
streamOutput | true | 流式输出开关 |
allowVisitorReasoning | true | 是否允许访客为单次请求开启深度思考 |
reasoningDefaultEnabled | false | 访客首次打开浮窗时是否默认开启深度思考 |
allowGuest | true | 是否允许访客调用聊天 |
welcomeMessage | Hi! 有什么想了解的？ | 欢迎语 |
shortcutItems | [] | 结构化快捷问题：显示标题、实际问题、图标、绑定意图和启用状态 |
shortcutQuestions | 空 | 旧版多行配置兼容字段，读取时会自动迁移为 shortcutItems |
widgetPosition | right-bottom | Widget 位置 |
widgetThemeColor | #5387C4 | 主题色 |
widgetIcon | ri-chat-3-line | 图标 |
widgetTriggerSize | 35 | 触发器尺寸 |
widgetTriggerLabel | AI | 触发器文字 |
widgetTheme | auto | auto、light、dark |
widgetWidth | 400 | 桌面端宽度 |
widgetHeight | 600 | 桌面端高度 |
widgetTriggerAlign | auto | 自动避让或手动对齐 |
widgetTriggerOffsetY | 125 | 手动模式底部偏移 |
widgetTriggerOffsetX | 17 | 水平边缘偏移 |
widgetTriggerShape | square | square、rounded、circle |
showPrivacyTip | false | 显示隐私提示 |
showRetrievalStatus | false | 显示检索状态 |
旧字段 reasoningMode=enabled 会迁移为 reasoningDefaultEnabled=true。深度思考是否实际可用取决于所选 AI Foundation 模型；详细行为见 深度思考与推理过程。
AI 摘要 excerpt
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled | false | 启用摘要扩展点 |
maxLength | 160 | 目标摘要字符数 |
maxInputLength | 3000 | 送入模型的原文字符上限 |
temperature | 0.3 | 生成温度 |
maxTokens | 512 | 输出 token 上限 |
prompt | 空 | 自定义提示词 |
写作辅助 writing
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled | true | 编辑器 AI 功能总开关 |
writingModel | 空 | AI Foundation 写作模型资源名；为空复用语言模型 |
outlineTemperature | 0.3 | 大纲温度 |
outlineSections | 6 | 顶层章节数量 |
outlineDepth | 1 | 大纲深度，合法范围 1～3 |
outlineNumbering | chinese | chinese、chinese-paren、arabic、roman、none |
outlineExtraPrompt | 空 | 大纲附加约束 |
maxInputLength | 6000 | 单次输入字符上限 |
maxTokens | 2048 | 输出 token 上限 |
AI 搜索 search
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled | true | 搜索功能总开关 |
showAiAnswer | true | 显示 AI 综合回答 |
resultCount | 10 | 关键词结果数，运行时限制为 1～30 |
systemPrompt | 空 | 为空时复用对话提示词 |
maxTokens | 512 | 搜索回答 token 上限 |
theme | inherit | 搜索界面主题 |
themeColor | 空 | 为空时继承问答主题色 |
AI 脑图 mindmap
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled | true | 脑图总开关 |
temperature | 0.3 | 生成温度 |
maxTokens | 2048 | 输出 token 上限 |
maxInputLength | 15000 | 原文字符上限 |
maxDepth | 3 | 层级深度，运行时限制 2～4 |
extraPrompt | 空 | 追加生成要求 |
theme | inherit | 脑图主题 |
themeColor | 空 | 为空时继承问答主题色 |
用量与访客限流 usageLimits
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled | false | 启用模型每日限额 |
chatModelLimits | 空 Map | 按模型名称配置每日 token 上限 |
visitor.enabled | false | 启用访客限流 |
visitor.dailyLimit | 0 | 每 IP 每日限制；0 表示未设置 |
visitor.hourlyLimit | 0 | 每 IP 每小时限制 |
visitor.whitelist | 空数组 | IP 白名单 |
旧字段 perModel 仍可兼容读取并迁移到 chatModelLimits 语义。
变更影响速查
| 变更 | 是否需要重建索引 |
|---|---|
| Chat 模型、Prompt、温度 | 否 |
| Embedding 模型或维度 | 是，全量重建 |
| 切片大小、重叠、分隔规则 | 是，重建受影响文章 |
| 检索 Top-K、Top-N、阈值 | 否 |
| Query Rewrite、HyDE、Rerank | 否 |
| Widget 主题和位置 | 否，刷新前台 |
| 脑图生成参数 | 不影响 RAG；旧脑图可能需要重新生成 |