文档

导出和导入设置

无需迁移机密信息,即可将组织配置作为可移植包在不同工作区之间迁移。

组织配置可以导出为可移植包,并应用到其他组织中。可在以下路径找到该功能:设置 → 数据 → 导出设置.

该功能适用于三种场景:搭建一个与现有组织配置一致的新组织、将试用工作区的配置升级到正式工作区,以及留存工作区配置的可追溯记录。

包含的内容

该包涵盖组织级别的配置:

类别包含项
策略与质量组织策略、质量策略、项目关卡、生命周期策略、审核规则
智能体与模型AI 配置文件、提供商密钥引用
自动化钩子、定时任务
连接源代码管理集成、通道桥接、MCP 服务器
访问权限企业身份配置、服务账号
数据数据留存、存储配置、审计目标

不包含的内容

**机密信息绝不会随包导出。**提供商密钥、令牌和凭证会以占位符形式导出。该包会记录该占位符某个密钥的存在情况及其使用场景,但不会包含密钥值——导入后需重新输入机密信息。

此外,不属于配置范畴的工作区身份信息也不会被导出——包括组织名称、成员、计费关系,以及任务、运行记录和审计事件等操作历史。

规则是:该包描述的是工作区的配置而非其中已发生的操作

应用前预览

应用包时会先执行预览,展示各部分的生效效果:

状态含义
applied该设置将被创建或更新
unchanged配置已匹配,无需额外操作
needsRebind依赖项需在本地重新指向对应资源
failed无法应用;具体原因已注明

请仔细查看预览结果。needsRebind其中“待处理”状态最为重要——它标记了指向目标工作区中不存在的资源的设置,通常是代码库连接或机密信息。在配置完全匹配前需先处理这些问题。

将包存入版本控制系统

导出的包为文件形式,因此可存入代码仓库、进行对比和审核。对于将配置视为代码的团队而言,其价值在于:组织策略的变更会生成可审核的对比结果,而非仅靠人工点击操作完成。

由于机密信息以占位符形式存在,该包可安全提交——但在公开前请先确认包内不含任何涉及自身配置的敏感标识。