chore: sync Gitea 28.2.0 inputs and compatibility docs

docs/COMPATIBILITY.zh-CN.md

@@ -13,6 +13,7 @@
 
 | Gitea 版本 | 推荐模板版本 | 状态 | 说明 |
 |---|---|---|---|
+| 28.2.0 | **v28.1.0** | [PASS] | 邮件模板、模板函数注册及邮件翻译键与 28.1.0 一致 |
 | 28.1.0 | **v28.1.0** | [PASS] | - |
 | 28.0.0 | **v28.1.0** | [PASS] | Gitea 将邮件函数 `FileSize` 替换为 `FormatByteSize` |
 | 1.27.3 | **v1.27.3** | [PASS] | 全部主题已修复拉取请求推送通知的提交链接 |
@@ -36,6 +37,7 @@
 
 | Gitea | 发布日期 | 邮件模板变化 | 影响 |
 |---|---|---|---|
+| **28.2.0** | 2026-10-18 | 无模板接口变更 | 自定义关注的通知收件规则及入站回复令牌校验调整，不影响现有模板 |
 | **28.1.0** | 2026-10-06 | 无 | 无 |
 | **28.0.0** | 2026-09-29 | 邮件函数 `FileSize` 改为 `FormatByteSize` （[PR](https://github.com/go-gitea/gitea/pull/#39083)） | **不兼容变更：** 旧的发布附件模板失效 |
 |||引入 templates/mail/base/ （[PR](https://github.com/go-gitea/gitea/pull/#38396)）| **不兼容变更：** 旧版本 Gitea 无法直接使用新版本邮件模板 |
@@ -54,6 +56,9 @@
 
 ## 模板变量参考
 
+> [!NOTE]
+> 已对照 [Gitea 28.1.0 与 28.2.0 的源码差异](https://github.com/go-gitea/gitea/compare/v28.1.0...v28.2.0)检查邮件模板、上下文构造、模板函数和翻译键。28.2.0 调整了[自定义关注的邮件通知规则](https://github.com/go-gitea/gitea/pull/39837)和[入站邮件令牌校验](https://github.com/go-gitea/gitea/pull/39841)，未改变现有邮件模板所需的变量、函数或翻译键。源码构建输入锁定为 v28.2.0，已发布的 v28.1.0 模板仍可使用。
+
 各类邮件上下文由官方模板定义。开发时具体的邮件模板和函数和变量请参考官方邮件模板文档 [1](#注释)。
 
 ## 翻译键

docs/CONTRIBUTING.zh-CN.md

@@ -69,10 +69,10 @@ go run . upstream verify --root "C:\Projects\GiteaMailTemplates"
 
 #### 更新官方版本
 
-只有需要评审新的官方版本时才使用 `sync`。例如，明确同步到 `v28.1.0`：
+只有需要评审新的官方版本时才使用 `sync`。例如，明确同步到 `v28.2.0`：
 
 ```bash
-go run . upstream sync --tag v28.1.0
+go run . upstream sync --tag v28.2.0
 go run . upstream verify
 go test ./...
 go run . preview all
@@ -347,7 +347,7 @@ python -B -m unittest discover -s .github/scripts -p 'test_*.py'
 发行标签必须与锁定的 Gitea 标签一致。版本标记、徽章和兼容性记录由维护者手动更新；修改官方输入不会自动触发版本维护。历史发行附件应保留，文档和兼容性记录应在打标签前检查。完成验证并生成全部预览后，可在仓库根目录手动打包：
 
 ```bash
-python .github/scripts/package_release.py --version v28.1.0 --output build/release-review
+python .github/scripts/package_release.py --version v28.2.0 --output build/release-review
 ```
 
 将示例版本替换为根锁文件中的标签，并使用没有同名发行压缩包的输出目录。脚本检查源码与产物的校验值，打包主题、预览、文档、官方许可证和来源信息，排除残留的旧主题构建。

docs/README.zh-CN.md

@@ -126,9 +126,11 @@ cd ..
 
 ## 兼容性
 
-- **最新测试：** Gitea 28.1.0
+- **最新测试：** Gitea 28.2.0
+- **源码构建基线：** Gitea 28.2.0
 - **最新发布版：** [v28.1.0](https://gitea.kenanzhu.com/KenanZhu/GiteaMailTemplates/releases/latest)
-- **上游 Gitea 28.1.0：** [PENDING]
+
+Gitea 28.2.0 未引入邮件模板接口变更，已发布的 v28.1.0 模板仍兼容；源码构建使用锁定的 v28.2.0 官方输入，详见[兼容性记录](COMPATIBILITY.zh-CN.md)。
 
 ## 项目目录结构