组织配置可以导出为可移植包,并应用到其他组织中。可在以下路径找到该功能:设置 → 数据 → 导出设置.
该功能适用于三种场景:搭建一个与现有组织配置一致的新组织、将试用工作区的配置升级到正式工作区,以及留存工作区配置的可追溯记录。
包含的内容
该包涵盖组织级别的配置:
| 类别 | 包含项 |
|---|---|
| 策略与质量 | 组织策略、质量策略、项目关卡、生命周期策略、审核规则 |
| 智能体与模型 | AI 配置文件、提供商密钥引用 |
| 自动化 | 钩子、定时任务 |
| 连接 | 源代码管理集成、通道桥接、MCP 服务器 |
| 访问权限 | 企业身份配置、服务账号 |
| 数据 | 数据留存、存储配置、审计目标 |
不包含的内容
**机密信息绝不会随包导出。**提供商密钥、令牌和凭证会以占位符形式导出。该包会记录该占位符某个密钥的存在情况及其使用场景,但不会包含密钥值——导入后需重新输入机密信息。
此外,不属于配置范畴的工作区身份信息也不会被导出——包括组织名称、成员、计费关系,以及任务、运行记录和审计事件等操作历史。
规则是:该包描述的是工作区的配置而非其中已发生的操作。
应用前预览
应用包时会先执行预览,展示各部分的生效效果:
| 状态 | 含义 |
|---|---|
applied | 该设置将被创建或更新 |
unchanged | 配置已匹配,无需额外操作 |
needsRebind | 依赖项需在本地重新指向对应资源 |
failed | 无法应用;具体原因已注明 |
请仔细查看预览结果。needsRebind其中“待处理”状态最为重要——它标记了指向目标工作区中不存在的资源的设置,通常是代码库连接或机密信息。在配置完全匹配前需先处理这些问题。
将包存入版本控制系统
导出的包为文件形式,因此可存入代码仓库、进行对比和审核。对于将配置视为代码的团队而言,其价值在于:组织策略的变更会生成可审核的对比结果,而非仅靠人工点击操作完成。
由于机密信息以占位符形式存在,该包可安全提交——但在公开前请先确认包内不含任何涉及自身配置的敏感标识。