From 27050e91a5bf1b742db4332b08fcd35010bb0634 Mon Sep 17 00:00:00 2001
From: unanmed <1319491857@qq.com>
Date: Sat, 17 Oct 2026 20:57:09 +0800
Subject: [PATCH] =?UTF-8?q?docs(10-07):=20=E7=BA=A0=E6=AD=A3=E4=BF=AE?=
 =?UTF-8?q?=E9=A5=B0=E5=99=A8=E5=AE=9A=E4=BD=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 标题「修饰器：临时的加减与百分比」改为「修饰器：数值与百分比加成」
- 改写表述：修饰器临时/永久皆可，是否临时取决于何时移除
- 新增临时用法说明（addModifier 挂上、不再需要时 deleteModifier 移除）；保留永久示例与 save 语义
---
 docs/intermediate/hero-attribute.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/docs/intermediate/hero-attribute.md b/docs/intermediate/hero-attribute.md
index e031faa..3f5ef13 100644
--- a/docs/intermediate/hero-attribute.md
+++ b/docs/intermediate/hero-attribute.md
@@ -34,9 +34,9 @@ attr.mul('money', 2); // 金币翻倍
 
 只读访问（只想读取、不加修改）可用 `state.hero.attribute`；需要修改时统一走 `getModifiableAttribute()`。
 
-## 修饰器：临时的加减与百分比
+## 修饰器：数值与百分比加成
 
-直接改基础属性会永久改变勇士数值。如果只想施加一段**临时**的加成，应使用**修饰器**。属性包内置了两种：
+直接改基础属性的效果是永久的，它会直接改变勇士数值；而**修饰器**把加成从基础值里独立出来，既可以用于永久加成，也可以用于临时加成——是否临时，取决于你什么时候把它移除。属性包内置了两种：
 
 - `ValueModifier`（type `@system/value`）：数值加减，最终值 = 原值 + 修饰值；
 - `PercentageModifier`（type `@system/percentage`）：按**基础值**计算百分比，最终值 = 原值 + 基础值 × 修饰值。
@@ -59,6 +59,8 @@ attr.addModifier('def', defDown);
 attr.deleteModifier('def', defDown);
 ```
 
+想要一段**临时**加成时，就先 `addModifier(...)` 挂上修饰器，在不再需要时用 `deleteModifier(...)` 把它移除，加成随即消失；反之，只要一直不移除，它就是永久加成。
+
 `PercentageModifier` 的百分比以**基础值**为基数，而非当前最终值，因此多个百分比修饰器不会彼此叠乘。装备产生的加成走的也是同一套修饰器机制，见[勇士装备](./hero-equipment.md)。
 
 ## save 参数与读档一致性