View Layer 指南

.spine/view/ 是一层实验性的派生阅读层，用来帮助你更快理解仓库。

当前 v1.0.x 只实现了两个产物：

这一层目前的定位是：

如何开启

可以通过项目配置或环境变量开启。

项目配置：

json

{
  "artifacts": {
    "experimentalViewLayer": true
  }
}

环境变量：

bash

SPINE_EXPERIMENTAL_VIEW_LAYER=true spine sync

如果不开开关，sync 行为与之前一致，不会生成 .spine/view/**。

开启后，spine sync 会额外写入：

这些文件和其它正式 .spine 产物一样，通过受信 writer path 生成，并纳入受保护输出边界。

public-surface.json 主要回答两个问题：

当前排序信号包括：

这个产物的用途是帮助理解，不用于治理裁决。

risk-hotspots.json 主要回答两个问题：

当前透明加分项包括：

每个热点都会保留 score breakdown，因此结果是可解释的，而不是黑盒分数。

这轮实验实现有明确边界：

像 api-chains、dependency-summary、structure 这类后续 view，当前版本仍然明确不在范围内。