配置文件机制：可视化编辑与代码编辑双模式

机器人的一切行为——用哪个模型、怎么唤醒、谁能用管理员指令、挂哪个知识库——都落在配置文件里。WebUI 把它包装成表单，但底层始终是一份 JSON。

先理解「配置文件」这个单位

系统支持多份配置文件并存，每个消息平台实例绑定一份。这意味着：

• QQ 群机器人用 A 配置：便宜模型 + 活泼人格 + 唤醒词「小星」
• 企微客服机器人用 B 配置：强模型 + 严谨人格 + 默认唤醒
• 互不干扰，切换只改绑定关系

自定义规则（按会话覆盖）的优先级在其之上，三层从高到低是：会话规则 > 平台绑定的配置文件 > 全局默认。

可视化编辑

「配置文件」页顶部先选择要修改的配置文件，下方分区依次为：

• AI：对话模型、能力开关（知识库、网页搜索、使用电脑能力等）、上下文与人格相关项
• 平台与消息：唤醒方式、前缀、消息处理规则
• 访问控制：管理员 ID、权限矩阵
• 插件：各插件的参数

改完必须点右下角保存，表单不会自动生效——这是新用户最常踩的空转坑。

代码编辑

右下角第一个圆形按钮切换到代码模式：

流程和表单模式不同：编辑 JSON → 点「应用此配置」把改动灌回可视化表单 → 再点右下角「保存」。不点应用，代码区的修改不会生效；两步都做完才算保存成功。

编辑纪律

• 改配置前记下改了什么——出问题时这是最快的回滚依据
• 敏感字段（API Key）推荐用环境变量写法（$变量名），见接入原理
• 手工改磁盘上的 cmd_config.json 属于救援手段（重置密码、关双因素认证），日常配置一律走面板，避免程序运行时覆盖你的手改
• 配置分区里能搜关键词，找不到某个开关时先搜再翻

和其他页面的关系

配置文件是「平台级默认值」，人格设定决定模型怎么说话，管理员权限在访问控制分区里配，知识库在 AI 能力分区里挂载。配置文件是它们共同的地基。