24. 常用配置的维护与变更

完整版章节。内容按 2026.10 主线代码与运行环境界面核对；具体入口以当前许可、账号权限和交付环境为准。

返回概览 · 完整版目录 · 下载完整 PDF

本章内容：本章面向租户管理员、系统管理员与运维人员，说明平台上线后如何安全地修改和维护配置：变更前后的通用检查；流量规则的导出、导入与模板；配置巡检；热更新时延；版本对比与回退；变更审批；许可证与品牌配置的维护。

24.1 变更前后的通用检查

适用场景：任何一次影响调用结果的配置修改。

1. 记录变更对象、原因、影响范围、原值和预期结果。
2. 保存变更。流量规则保存时会弹出「确认变更」，逐项列出字段差异、关联对象与命中顺序的影响，核对无误后点「确认并应用」。
3. 用获授权账号完成一次正向调用，再用未授权账号或不满足条件的请求验证拒绝结果，并在「运行总览 › 请求」确认真实结果。
4. 在「操作审计」或对象详情的「操作审计」页签核对操作人、对象、结果和时间（见第 22 章）；结果异常时改回原配置，保留请求 ID 与页面提示供排查。

生效时机的经验值

注意：这些是量级参考、不是承诺值。核对是否生效时，用一条最小请求在目标调用方下反复探测，而不是刷新页面看状态。

24.2 导出、导入与规则模板

适用场景：规则备份、评审、跨环境迁移，或从既有场景快速起步。

导出

1. 在「流量规则 › 规则清单」右上角点「导出」。
2. 对话框列出敏感值已被剔除的规则与字段，并提示「导入前请补齐这些字段；缺少必填值时将无法导入」。
3. 点「下载」，得到包含全部规则的 YAML 文件。

导入：点「从文件导入」选择 YAML 文件，补齐导出时被剔除的敏感值，按提示核对并保存。导入的规则同样经过配置检查与「确认变更」。

使用规则模板：点「导入规则模板」，从五十余条常用场景模板中选一条（按路径、请求头、模型、模型分组、数据来源、敏感信息、调用类型、时间窗、灰度、网段等条件，与转发、放行、拒绝等动作组合），填写高亮的必填字段后点「导入这条」。

注意

• 导出文件中不含任何密钥明文，被剔除的位置以注释标明。
• 规则对模型、模型分组、上游、API 密钥、调用方等对象的引用以对象 ID 记录，文件不包含这些对象本身。跨环境导入前需先在目标环境建好同样的对象并改好引用；引用不存在时导入会失败。
• 导出导入只覆盖流量规则；模型供应商、模型、模型分组、告警规则等需在目标环境逐项配置，网关扩展插件可单独导出插件包。

24.3 配置巡检

适用场景：想知道「现有规则里有没有明显问题」，或验证某条规则改动是否符合预期。

操作步骤

1. 进入「流量规则 › 验证规则」。
2. 手工填写调用类型、模型等字段，构造一次模拟请求。
3. 提交后查看命中结果与最终处置。

你会看到：验证规则给出这一次模拟请求会被哪条规则命中、执行什么动作。它不扫描全量规则，也不对现有配置打分。

注意：当前版本不提供定期自动巡检、巡检报告页或配置优化建议列表。要了解配置全貌，请按 24.1 的方法逐项核对关键规则，或导出 YAML 后离线审阅（见 24.2）。

24.4 热更新的生效时延与在途请求

适用场景：改完规则想立刻确认生效；或担心改配置会把正在进行的流式回答打断。

操作步骤

1. 记下改动前的判定结果（例如用一条超限请求确认当前返回 413）。
2. 在「规则清单」中切换状态开关，或在编辑页保存并「确认并应用」。
3. 每隔几秒用同一请求探测一次，记录第一次出现新结果的时间。

你会看到

• 停用规则后，后续请求很快不再命中；重新启用后，从启用操作到新规则重新生效，经验上是 15～20 秒的量级，不是秒级。用同一条请求反复探测即可测得实际时延。
• 在途的流式响应不会被打断：流进行中点停用规则，这条流仍然以正常的 finish_reason=stop 结束，客户端无需重试。

注意：改动越大，下发与生效所需时间越长；一次改多条规则时，按最后一条生效的时间来安排验证。不要在生效前反复点保存，那会让每次下发重新排队。

24.5 版本对比与回退

适用场景：需要确认某条规则改过几次、改了什么；或改错了想退回之前的形态。

查看修改记录

1. 打开流量规则详情，点「修改记录」。
2. 列表按时间列出该规则的每一次新建、修改、启停与排序调整。
3. 点一行进入对应的操作审计详情，以「字段 / 变更前 / 变更后」三列对照（见第 22 章）。

回退

当前版本不提供版本级一键回滚按钮，「载入此版本」只提示「该版本已载入编辑器，发布后才能应用到请求」，页面仍停在只读查看态，历史版本的内容不会进入编辑表单。因此回退按下面的做法：

1. 在「修改记录」中打开目标版本对应的审计详情，逐字段抄下「变更前」的值。
2. 点「编辑」，把这些字段手工改回目标值。
3. 保存并在「确认变更」中逐项核对差异，点「确认并应用」。
4. 用一条请求验证行为已恢复，并在「运行总览 › 请求」确认新记录符合预期。

你会看到：修改记录本身完整可靠，能准确回答「这条规则改过几次、每次改了什么、谁改的、什么时候」。

注意

• 改错了又不想逐字段改回时，可以先把规则停用止血，再从「修改记录」逐项核对后重建；停用是即时生效的。
• 其他对象（模型、模型分组、可用范围、限额等）同样没有版本回退，变更前请记录原值，必要时手工改回。
• 编辑态下切换部分字段类型时页面可能出现卡顿，建议一次只改一类字段，改完先保存再做下一类。

24.6 变更审批

适用场景：需要确认配置变更是否必须走审批、谁能直接生效。

你会看到：审批中心的「策略」页签中，可配置审批的动作清单是发布技能、发布网页、发布到注册表、申请 API 密钥、发布插件到插件源、申请智能体 API 密钥、技能安装准入线。流量规则、模型、模型分组、模型供应商、护栏等配置变更不在其中——这些变更在「确认变更 › 确认并应用」后立即生效，不经过审批。

替代做法：用「确认变更」的差异预览做事前控制，把预览内容留存到变更单或工单里；用角色管理把关键配置的修改权收窄到少数账号；用操作审计做事后追溯，按「按操作筛选」定位到具体资源类别，核对谁在何时改了什么；多人协作时约定变更窗口，并在变更前后各留一条验证请求。

注意：当前版本不提供配置变更的审批流程（审批后生效、驳回不生效），也不提供变更单对象。审批中心只覆盖上表列出的发布类动作。

24.7 许可证管理

适用场景：确认已开通的模块；导入或移除许可证。

前提：租户管理员；已从供应商取得签名后的许可证文件。

1. 进入「管理后台 › 系统设置 › 全局设置 ›「授权许可」页签」。
2. 查看页面顶部的「高级模块」：模型护栏、动态路由、全链路审计、用量与成本，以及各自的开关状态。
3. 查看「许可来源」：未导入许可时显示「社区版（未导入许可）」，并说明「许可不设到期时间；导入或移除许可后各模块状态即时更新」。
4. 需要导入时，按页面提示导出授权请求，交由供应商换取许可证文件，再点「导入 .lic 文件」。校验通过后立即生效。

你会看到：页面显示已开通的高级模块与许可来源；社区版不显示到期日期，这是设计行为。

注意

• 许可按租户生效，导入与移除只影响当前租户；许可与部署绑定，多套独立部署需要各自的许可证。
• 许可在本地验签，整个流程不需要访问互联网。
• 「移除许可」需在确认框中确认；移除模块后对应菜单与接口消失，基础功能不受影响，移除前先确认没有业务依赖该模块。许可导入属全局影响操作，建议在维护窗口内进行并提前通知使用者。

24.8 品牌与外观

适用场景：把控制台与登录页换成企业自己的名称、标识与主题色。

操作步骤

1. 进入「管理后台 › 系统设置 › 全局设置 ›「品牌与外观」页签」。
2. 在「产品显示名」填写控制台与登录页显示的产品名称；在「标志」点「更换图片」上传标志图片；在「网站图标」点「更换」上传浏览器标签图标（可选，未设置时使用系统默认）。
3. 在「主题色」中选择色块。可选「经典蓝」「靛青」「紫罗兰」「青碧」「翠绿」「琥珀」「玫红」「石墨」八种，默认为「经典蓝」。选择后当前页面立即按所选颜色预览，此时设置尚未生效；未保存即离开页面时，预览还原为已保存的主题色。
4. 点「保存」。保存后产品显示名、标志、网站图标与主题色对本租户全部成员和登录页生效。
5. 需要清除自定义品牌时点「恢复默认」，在确认框中确认后，产品显示名、标志、网站图标和主题色一并恢复为系统默认（主题色回到「经典蓝」），并立即对本租户全部成员生效。未做过任何自定义时「恢复默认」不可选。

你会看到：保存后控制台与登录页的产品名、标志、标签图标与主题色随之改变；登录页的标题、站点名与描述等元信息同步更新。

注意

• 品牌配置对全租户生效，属于全局影响操作，改动前先与业务方确认。
• 未登录用户打开登录页时，在地址后附加 ?tenantSlug=<租户标识> 即可显示对应租户的品牌；登录后按账号所属租户显示。产品不支持按访问域名自动识别租户门户。

能力说明

---

上一章：23. 平台运行与日常维护 · 下一章：25. 分阶段上线