02 项目与分支

配置按 项目 → 分支 组织：一个项目对应一个应用 / 服务，分支对应环境（dev / test / prod / 自定义）。

2.1 新建项目

登录后首页点击「新建项目」，输入项目名（小写字母 / 数字 / 连字符）：

「新建项目」弹窗支持从现有项目克隆结构（可选）：下拉选择任一已有项目后创建，新项目将直接继承该项目的已发布结构（组与配置项定义，含类型 / required / secret / 引用共享标记），无需手工逐个添加。克隆只复制结构定义——各分支的值、分支列表、权限、令牌等资源不随之复制；克隆后新项目结构以 v1 直接落地，可在「结构」页继续调整并发布，在「草稿」页填值。

项目创建后自动带 dev / test / prod 三个分支。

2.2 切换项目与分支

顶部上下文栏：

• 项目：点项目名（chip）切换；当前项目高亮
• 分支：下拉选择分支（选项带当前版本号，如 dev · v4），切换后草稿 / 版本 / 灰度等页签全部跟随该分支

分支选择旁显示当前状态徽章（示例为测试实例 horizon-compile/dev）：

2.3 新建 / 删除分支

上下文栏「新建分支」：输入分支名创建空分支（API 支持 source 指定从某分支复制初始草稿值，Admin UI 暂未暴露）。

「删除分支」（垃圾桶按钮）：删除该分支的全部草稿与版本历史（不影响其他分支）。

2.4 分支对比与值提升（Promote）

「对比与提升」页签含两个卡片：

分支对比：选两个分支点「对比」，列出值的差异（含「仅一侧有值」的缺失项）。

值提升：把源分支的活动版本值写入目标分支草稿：

1. 选择源分支与目标分支
2. 勾选 force 可覆盖目标分支已修改的草稿
3. 「提升」后目标分支草稿更新（不自动发布）

结构（有哪些配置项）是项目级强一致的，分支之间只存在值的差异 —— 这就是切换环境只是换分支名的原因。

下一步

• 03 结构配置与共享引用：定义组与配置项、共享引用
• 04 草稿与发布：为各分支填值并发布