Anydocs Documents
主题配置

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`,也不支持暗色模式。它的重点是左侧树状导航、宽正文区和评审信息面板,而不是顶部知识域切换。

什么时候选 blueprint-review: 如果你的站点主要服务于 PRD、方案评审或内部知识库阅读,而且页面经常依赖 metadata、决策摘要和开放问题来辅助理解,这个主题通常比 classic-docs 更合适。
评审增强依赖结构化字段: 如果页面只有纯正文而没有 `doc-type`、`review-state` 等 review 信号,blueprint-review 仍然可以正常阅读,但会退回更接近概览页的展示,不能自动生成完整评审面板。