Skip to content

性能白皮书

性能不再被狭义地理解为“构建用了多少秒”。对一个研究型文档站而言,真正重要的是:生成链路是否稳定、导航是否高效、图示是否可靠、内容是否具备可维护性。

Performance Signals

从构建速度扩展到维护性、证据密度与发布可靠性

这个章节把性能分成四类:生成性能、导航性能、图示性能和维护性能。只有四类一起成立,站点才配称为白皮书级发布面。

规则资产

132+

资产规模直接决定生成链路和阅读结构的复杂度。

领域覆盖

32+

覆盖越广,越需要清晰的信息架构与稳定的快照层。

发布阶段

3

策展、编排、发布三个阶段共同组成完整生成链路。

生成链路

生成链路由三个部分组成:

  1. 资产发现:扫描 rules/,确认真实规则资产与分类边界。
  2. 快照生成:生成 categoryDistributioncoverageBucketsqualitySignalstimelineSignals
  3. 页面发布:由 VitePress 把快照、图示和正文合成最终站点。

这条生成链路的核心价值,不是“快”,而是页面与仓库事实不分裂

维护性

维护性是本次重构最重要的性能指标之一。

  • 统一数据源:所有关键指标从快照层派生,减少重复维护。
  • 统一视觉组件:SignalGrid、TopologyMap、PipelineCanvas 与 DossierMatrix 复用同一套 token。
  • 统一阅读路径:导读、系统架构、算法机制、性能白皮书、参考与演进、规则证据形成稳定目录树。

当站点扩展到更多规则和专题时,维护性比一次构建快 3 秒更有长期价值。

图示可靠性

图示性能不是动画跑得多快,而是:

  • 深浅色模式下是否都有足够对比度
  • 连线、背景、标签是否由 token 统一驱动
  • SVG 是否仍然可读,而不是在某个主题里“消失”

因此本次重构把图形相关颜色从“零散样式”提升为专用 figure token 系统。

性能页为什么属于白皮书主体

一个高级开发者在审阅项目时,不只会问“好不好看”,还会问:

  • 生成链路有没有事实来源?
  • 文档系统是否具备扩展后的维护性?
  • 图示和主题适配是否可靠?
  • 首页和专题页是否真的提高了导航效率?

这些问题构成了站点的真实性能画像。

继续阅读

  1. 系统总览
  2. 规则编排算法总览
  3. 参考与演进

以 132+ 条规则资产、32+ 个技术领域构建系统白皮书、算法说明与证据站