LightRAG 角色模型¶

在 Knowledge Center 中，打开原生 LightRAG 引擎并选择基础模型。保存的基础与聊天模型和嵌入模型相互独立。启用身份验证后，共享引擎设置需要管理员访问权限。

最新设置与历史设置有所区分。在查询或创建知识库之前，请在设置中选择并保存 LightRAG 基础。新的角色配置默认禁用 VLM。为 VLM 继承基础模型需要支持图像输入的模型。禁用 VLM 会保留文本、表格和公式处理。对已禁用索引的显式图像分析请求将失败，并提示需要完整重建。

每个已启用的角色都可以覆盖支持的推理力度。Auto 将推理控制权交给提供方；none 在支持的地方显式禁用推理。继承的角色遵循基础推理，除非它有自己的覆盖设置。恢复较旧的固定索引时会保留其已记录的推理语义。不支持的选择会被拒绝，而不会替换为其他模型或推理级别。并发和超时限制按角色适用于后续任务，且不需要重建。已接受的任务在排队和运行期间保持其有效的模型、推理和限制。

DeepTutor 通过其提供方能力过滤器转发 LightRAG 结构化输出请求，包括 EXTRACT、KEYWORD 和 VLM 使用的 JSON 对象契约。提供方推理由已保存的角色力度控制。即使 LightRAG 请求其 COT 输出格式，DeepTutor 也会有意地从返回答案中省略提供方推理痕迹。

创建、追加与重建¶

在设置中配置角色模型。创建和完整重建不提供按索引的角色覆盖，但会保留按知识库的嵌入选择。处于空闲、未发布的空知识库会遵循当前有效的角色默认值，直到其第一个被接受的索引任务冻结配置，并保留其嵌入绑定。

重建之前，请查看所选嵌入模型/维度以及当前默认的 EXTRACT/VLM 模型和推理设置。除非选择了其他模型，否则保留现有嵌入绑定。如果所选配置在提交前发生变化，请查看并确认刷新后的配置。已接受的任务在执行和版本发布期间保持相同的嵌入和角色设置。失败任务的重试操作也使用此确认流程。

发布后，上传和文件夹/GitHub 同步使用索引固定的 EXTRACT 和 VLM 身份。更改引擎默认值不会改变现有索引。启用、禁用或替换 VLM，或替换 EXTRACT 或其推理配置，都需要完整重建。如果在第一张图像之前固定了有效的 VLM，则后续图像上传可以使用它，而无需再次重建。

索引版本显示其版本标识、状态、时间戳以及实际的嵌入、EXTRACT 和 VLM 配置。显示区分提供方默认推理、显式 none 和禁用 VLM。从设置返回会刷新默认角色摘要。不可用的固定索引模型需要恢复访问权限或使用新默认值重建，但不会无条件阻止现有文本检索。失败或取消的重建会保留之前已发布的索引。目标已更改的排队操作会在写入前失败；请针对当前索引重新提交。同一个知识库拒绝并发写入者，因此请等待活动操作完成后再重新提交。

现有设置与索引¶

旧版引擎设置会从可访问的现有选择中预填。保存会将 LightRAG 基础与聊天分离。缺失或无法访问的选择必须显式替换。

可验证的旧版单模型索引会保留其原始模型指纹和已记录的视觉状态，无需仅格式重建。未知的历史身份仍可查询，但会阻止增量写入，直到完整重建。已删除、更改身份或失去访问权限的畸形策略和模型不能静默获取当前默认值。仅轮换凭据不会改变固定身份；凭据在执行时私下解析，并被排除在持久化索引策略和公开来源之外。