这页用于把 HNAttribute 当前和性能、压测、战斗配置语义相关的专题文档串起来，方便按主题阅读。

一、性能与压测

1. Perf 压测配置解析

适合你在这些场景阅读：

• 想知道 perf/ 目录到底是做什么的
• 想看压测档里的主要伤害公式在算什么
• 想理解 perf/config.yml、perf/pipelines/*.yml、perf/stages/*.yml、perf/damage_types/*.yml、perf/attributes/* 的职责

这篇更偏：

压测配置本身怎么设计、为什么这样设计。

2. Perf Stats 指标释义

适合你在这些场景阅读：

• 已经开始压测
• 想看 /hnattr perf stats summary|detail|full 应该怎么解读
• 想知道某个指标高了以后，应该优先怀疑哪一段逻辑

这篇更偏：

压测结果怎么看、指标是什么意思。

二、战斗配置语义

3. 如何配置战斗管线

适合你在这些场景阅读：

• 想快速确认 hit / dodge / block / collect / resist / crit_damage 这些阶段在做什么
• 想知道 stop_on_false、terminate_outcome、depends_on、resist-formula 这些字段什么时候生效
• 想查 collect_channels、per_channel、按攻击方式编排的 Pipeline 分别负责什么

这篇更偏：

战斗阶段怎么运行、字段怎么理解。

三、推荐阅读顺序

路线 A：先理解 perf 压测档

1. Perf 压测配置解析
2. 如何配置战斗管线
3. Perf Stats 指标释义

适合：

• 先想看压测配置本体
• 再理解阶段语义
• 最后再看统计结果怎么解释

路线 B：先定位线上/测试服瓶颈

1. Perf Stats 指标释义
2. Perf 压测配置解析
3. 如何配置战斗管线

适合：

• 已经开始压测
• 手里已经有 perf stats 输出
• 想先看指标，再回头找配置原因

路线 C：只想改战斗公式

1. 如何配置战斗管线
2. Perf 压测配置解析

适合：

• 重点在 pipelines/*.yml 与 stages/*.yml
• 不一定马上做性能分析
• 先关心公式和阶段语义

四、按问题查文档

我想知道 perf 目录是不是能直接上生产

看：Perf 压测配置解析

我想知道按通道减伤主要在算什么

看：Perf 压测配置解析

我想知道 boolean / modifier / per_channel 的区别

看：如何配置战斗管线

我想知道为什么某个自定义 Stage 会拖慢整条链路

看：

• 如何配置战斗管线
• Perf Stats 指标释义

我想知道核心阶段指标分别在看什么

看：Perf Stats 指标释义

我想知道某个阶段为什么完全没生效

看：如何配置战斗管线

重点关注：

• stop_on_false
• stop_on_true
• terminate_outcome
• depends_on
• resist-formula

五、当前专题清单

• 性能与压测专题导航
• Perf 压测配置解析
• Perf Stats 指标释义
• 如何配置战斗管线

六、延伸阅读建议

如果你已经从 perf 指标一路排查到了跨服或离线恢复问题，建议继续看：

1. 跨服运行时同步说明
2. DOT/HOT/周期实例配置速查
3. damage-types 配置速查

如果后面继续扩这一组文档，仍然值得补：

• Buff 配置速查
• 属性读取链路（Lore / NBT / 条件）说明

这样会形成：

• 配置层
• 运行时层
• 性能层
• 跨服层

四条完整的文档线。