06 共享库

共享库存放跨项目复用的配置项（扁平 key，无分组）。结构页将配置项标记为「引用共享」后，各分支在草稿页下拉选择引用的共享项，值由共享库物化 —— 共享项更新发布，绑定它的项目分支自动级联。

6.1 共享库页面

左侧导航「共享库」：

上方表单创建 / 更新共享项，下方列表展示全部共享项（含草稿与已发布状态、被绑定处数）。

6.2 创建并发布共享项

1. 填 key（全局唯一，如 timeout）、类型、描述、值
2. 点「保存共享草稿」（写入 shared-draft）
3. 点「发布共享」→ 发布全部草稿，绑定它的项目分支自动级联生成新版本

列表中的行标识：

6.3 项目引用共享项

在项目「结构」页给配置项勾选「引用共享」（类型列保留真实类型，作为分支下拉的类型约束）→ 发布结构后，各分支在「草稿」页为该配置项下拉选择引用的共享项：

• 引用共享项在草稿页显示「引用共享」徽章 + 下拉 + 物化值，不可写本地值（值由共享库物化）
• 不同分支可引用不同共享项（如 dev 引 dev-timeout、prod 引 prod-timeout）
• 共享项 timeout 发布 v2 后，所有绑定它的项目分支自动产生 shared_cascade 版本（未绑定的分支不受影响）
• 删除共享项时若仍被分支绑定会被拒绝（需先在相关分支解除绑定）

6.4 共享项类型与 secret

• 支持与配置项相同的类型（string / int / float / bool / json / array / secret）
• secret 共享项需要主密钥；数据面恒脱敏（***）
• 描述字段（≤200 字节）仅作助记，不进入渲染输出

下一步

• 07 访问令牌与 SDK：应用如何安全读取配置