diff --git a/CHANGELOG.md b/CHANGELOG.md
index 180f04c..27144b0 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,7 +14,17 @@
 长期停在 1.0.5，下游 `pip install` 拿不到任何修复且无人发现。提前把号写进这一段就是在重演
 那个形态——读到号的人会以为那一版已经在 registry 上，而它不在。
 
-这一批改动回应的是下游项目在 PolyLoop 仓库上提的五个 issue。
+## 1.0.2（2026-08-27）
+
+回应下游项目在 PolyLoop 仓库上提的五个 issue。
+
+**这一版发出去之前跑了一轮完整压测**，与 1.0.1 那次验收逐项可比：正常负载 197 次运行、1845 次
+真实模型调用，十一条不变量全部通过、零击穿；九类故障注入 58 条判据全部通过、零击穿。库本身
+没有被压出 bug。
+
+**升级时唯一会变的行为在参数快照**（见下面「注入内容的通道维度」那一节）：用 1.0.1 跑了一半的
+运行，升上来之后续跑会抛 `ParameterDriftError`，错误信息里逐个列出漂移的键。失败是响亮的，
+不会静默跑出两段来自不同配置的轨迹。
 
 ### 契约套件随包发布
 
diff --git a/pyproject.toml b/pyproject.toml
index d3cd1db..c9578d3 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -5,7 +5,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "polyloop"
 # 与 src/polyloop/__init__.py 的 __version__ 必须一致，由 tests/unit/test_package.py 断言。
-version = "1.0.1"
+version = "1.0.2"
 description = "PolyLoop：实验室共用的 Agent 执行内核——一次运行的预算、停止语义、取消、逐步轨迹与 Skill 注入"
 # registry 的包页面正文只认这一项：缺了它页面就是一片空白，而 twine 只会警告
 # long_description missing，不阻塞上传——三步全绿、产物是坏的（PolyGateway 1.1.2 的教训）。
diff --git a/src/polyloop/__init__.py b/src/polyloop/__init__.py
index 2620ddf..08860e6 100644
--- a/src/polyloop/__init__.py
+++ b/src/polyloop/__init__.py
@@ -15,4 +15,4 @@ import 时把网关连同它的 provider 目录一起拉起来，而不传存储
 #: 与 `pyproject.toml` 的 `project.version` 必须一致，由 `tests/unit/test_package.py` 断言。
 #: 两处双写是因为运行时读不到构建元数据（未安装的源码树里 `importlib.metadata` 查不到），
 #: 而下游报 bug 时第一件事就是问版本号。
-__version__ = "1.0.1"
+__version__ = "1.0.2"