四类核心配置怎么理解
大多数关键配置都在回答四个问题：用什么模型、数据落在哪、网关怎样暴露、消息从哪里进入。只要你按这四类理解，就不容易在首轮配置里走散。
1. 模型与凭据
它回答的是：谁来推理，以及系统如何拿到授权。
这一层你不用一上来背完整 schema，但要能回答：
- 当前主模型是谁；
- 凭据从哪里来；
- 如果主模型不可用，有没有备用路径；
- 改动后你准备如何验证模型调用真的成功。
很多看起来像“平台没回复”的问题，根源其实还在这一层，因为模型或认证根本没成立。
2. 工作区、状态与目录
它回答的是：文件、状态、日志和运行痕迹落在哪里。
这类字段的重要性经常被低估，但从 docs 的配置与 doctor 逻辑看，它直接决定：
- 会话与状态是否能持续保存；
- 日志能不能稳定落盘；
- 你后续排查时是否找得到正确目录；
- 重装、迁移、恢复时有没有清晰边界。
如果目录层本身混乱，你后面看到的大量症状都会像“配置问题”，但其实不是。
3. 网关访问与认证
它回答的是：外部如何访问，以及默认边界有多严。
这类配置不是“只是网络设置”，而是直接决定：
- 你是本机访问，还是局域网/远程访问；
- 网关是否允许在当前边界下暴露；
- 改动后控制界面、CLI 和状态探测是否还能正常工作。
所以第一次改 gateway.* 相关内容时，不要只是想着“我要让它能连上”，还要同时想“我要怎样保证访问边界没被误放大”。
4. 通道或入口配置
它回答的是：消息从哪个平台进来，以及第一条消息怎样闭环。
这一层最容易被过度配置。第一次通常只需要：
- 选一个平台；
- 填最小必需项；
- 用一条最小链路完成验证。
如果你在这一层一上来就同时处理 DM 策略、群组策略、allowlist、mention、多个账号或多个平台，后面几乎不可能知道是哪一个变量真正起作用。
第一次配置应该怎样读字段
比起从上到下扫 schema，更有效的顺序是：
- 先按问题分类，再看字段；
- 先看最小必需项，再看可选增强项；
- 先看当前任务页，再决定要不要回 docs 核对精确定义。
也就是说，先问“我要解决哪一层问题”，再问“这一层有哪些字段”。
一个简单判断法
如果你改的是下面这些问题，就说明还在核心配置范围：
- 能不能调用模型；
- 文件和状态落在哪里；
- 网关谁能访问；
- 第一条消息从哪里进来。
如果你改的是“以后也许会用到”的增强能力，那大概率不是首轮优先级。
常见错误或风险
- 把目录问题误改成模型问题；
- 只看字段名，不看它影响哪一层；
- 还没建立验证动作，就开始横向比较多个配置方案；
- 还没分清任务边界，就直接扎进 reference。
理解完以后做什么
如果你已经准备开始改，继续看 修改后如何验证生效。
如果你明确知道自己要核对某个 schema 或版本差异，先回到 配置指南 重新确认当前问题边界。