.web/site.yaml 是当前站点级标量配置的单文件形式，不会吞掉 .web/ 中每一种文件。
| 职责 | 位置 |
|---|---|
默认 locale 与支持的 locales | YAML 顶层 key |
| render mode、color scheme、comment switch、detail section | 需要时的顶层 YAML key |
| site SEO 与 template-level 值 | seo:、template: 块 |
| shared-theme-library opt-in 与 AUP CSS tone/palette | theme: 块 |
| design token | .web/tokens.json 或兼容 .web/tokens/ tree |
| redirect | .web/redirects |
| logo | .web/template/logo.svg |
site.yaml 会覆盖对应的 legacy flat-file scalar 值。未知 YAML key 被忽略；YAML 畸形时会回退 legacy file，而不是让整站无法读取。两种行为都不代表拼写错误安全；始终检查渲染结果。
theme: 块当前不会选择 .web/themes/<name>/ component overlay。不要从 tone 或 palette 推断 component overlay 选择。
页面 title/description 属于 pages/<name>/seo/；内容对象 metadata 属于内容旁边。编写流程见 全站配置；视觉边界见 主题与 token 参考。