验证、刷新与故障定位

治理配置应先检查文件，再确认目标用户的客户端实际加载。配置仓库可读权限不是服务器设置适用范围，文件能解析也不证明所选客户端支持每个键。

GitHub 自动验证

选定的 .github-private 仓库会自动验证：

• copilot/managed-settings.json。
• copilot/team-mappings.json。
• 被映射文件引用的 copilot/teams/ 内文件。

打开企业 AI controls → Agents → Copilot settings validation，查看错误与警告。每项指出文件和 JSON path；修正并提交到默认分支后，重新加载页面核对。

没有问题时，该 validation 区域不显示。验证暂时不可用时，已有设置继续适用，可以稍后重载；这不表示应清空现有治理。

客户端刷新

部署	官方说明
Server-managed	支持客户端约一小时内获取主文件、映射与团队文件；重启或重新登录触发立即刷新
原生 MDM	每小时检查，无需重启；VS Code 可运行 Developer: Sync Account Policy
File-based	更新平台文件后重启客户端加载

服务器配置的立即刷新描述是触发获取，不保证网络失败时一定得到新值。CLI 无服务器响应也无缓存时，该渠道政策不可用，详见部署边界。

用户未收到设置

先检查用户是否通过该企业或其组织获得 Copilot。用户有多个计费实体的许可证时，检查个人 Copilot 设置里的 Usage billed to 是否选择该企业。

然后检查受支持客户端和具体键，确认团队 slug、映射文件名与目录正确，且变更确实已进入默认分支。无组织的专用 Copilot 企业仍需满足服务器来源前提。

观察实际行为

以 model=auto 为例，检查新会话是否取得企业默认。团队 model=unmanaged 表示不受此默认控制，不保证它一定选择非 Auto；用户自身配置仍可能使用 Auto。

检查插件时还要核对文件来源权限。客户端收到 enabledPlugins 后会尝试安装，但没有插件私有仓库访问权仍无法安装，不能只因政策成功下发就认定插件可用。

完成后保留所测客户端、账号归属与配置版本，便于在多渠道或多团队场景追踪问题。