blueprint-review 主题
了解 blueprint-review 主题的评审式阅读布局与配置边界。
`blueprint-review` 是当前内置的评审导向 reader 主题。它面向 PRD、技术方案、评审记录和内部知识库,不追求门户式首页切换,而是优先让长文档、元数据和评审信息更容易扫读。
布局与适用场景
这个主题仍然使用侧边栏加正文的内容优先结构,但正文区更宽,并为长文档提供独立目录 rail。它适合目录较深、正文较长、需要频繁在章节之间跳转的内部文档。
评审式阅读行为
当主题启用后,reader 会根据页面 metadata 和 review 信息增强页面头部。如果页面包含 `doc-type`、`review-state`、`owner`、`reviewer`、`due-date`、`decision-summary`、`open-questions` 等字段,主题会把它们整理为上下文、评审、决策面板,而不是只显示普通标题和正文。
当前可配置项
它在运行时支持 `siteTitle`、`logoSrc`、`logoAlt` 这些 reader 品牌字段,支持 `site.theme.chrome.showSearch` 和 `site.theme.codeTheme`。颜色覆盖方面,当前主题实际消费的主入口是 `site.theme.colors.primary`,其余共享颜色字段会保存在 contract 中,但不会像 `classic-docs` 那样形成完整的多色槽主题化。
Studio 中当前可见的设置
当前 Studio 还没有单独的 Blueprint Review 配置卡。你可以直接切换 `Docs Theme` 和 `Code Theme`,但像 logo、搜索开关这类字段如果要精细调整,仍要通过项目配置文件或 MCP / API 写入。
不会生效的能力
`blueprint-review` 不使用 `site.navigation.topNav`,也不支持暗色模式。它的重点是左侧树状导航、宽正文区和评审信息面板,而不是顶部知识域切换。