模板推送到子空间
确保子空间配置与模板保持一致
模板推送到子空间
功能概述
模板推送功能允许模板工作空间的管理员将配置批量推送到基于该模板创建的子工作空间。支持覆盖类和增量类两种同步策略，确保子空间配置与模板保持一致。
使用场景
- 更新模板空间指引后，需要同步到所有子空间
- 新增插件绑定或快捷命令，需要推送到子空间
- 添加新成员到模板后，批量同步到子空间
同步策略
覆盖类配置
以下配置项推送时会直接替换子空间的值：
| 配置项 | 说明 |
|---|---|
| 空间指引 | 覆盖子空间的 guideline |
| 分类标签 | 覆盖子空间的 category |
| 默认模型 | 覆盖子空间的 defaultModelId |
增量类配置
以下配置项推送时仅添加不存在的项，不会删除或修改子空间已有配置：
| 配置项 | 增量逻辑 |
|---|---|
| 成员列表 | 按 userId 判断，已存在的成员保持不变 |
| 插件绑定 | 按 pluginId 判断，已绑定的插件保持不变 |
| 快捷命令 | 按命令名判断，同名命令保持不变 |
目录同步
选择的目录使用 rsync 增量同步，同步完成后自动生成 Git 提交。子空间目录内容将与模板完全一致（含新增、修改、删除）。
使用说明
前提条件
- 当前工作空间类型为模板（type = template）
- 用户具有该模板的 admin 权限
- 至少存在一个基于该模板创建的子空间
操作步骤
- 进入模板工作空间，打开空间设置
- 切换到推送到子空间 Tab
- 在"同步配置项"区域勾选需要推送的配置
- 在"同步目录"区域选择需要同步的目录（可选）
- 在"目标子空间"区域选择推送目标（支持全选/取消全选）
- 点击推送到子空间按钮
- 在确认对话框中核对推送信息后点击确认推送
- 等待推送完成，查看结果摘要
推送结果
- 全部成功：显示成功数量统计
- 部分失败：显示成功和失败数量，可展开查看失败详情
- 单个子空间推送失败不会阻断其他子空间的推送
注意事项
- 覆盖类配置推送后，子空间原有值会被替换，请确认后操作
- 增量类配置不会删除子空间已有的自定义项
- 目录同步使用
--delete选项，子空间目录中不在模板中的文件会被删除 - 非模板类型的工作空间无法使用推送功能
- 只有 admin 角色可以执行推送操作