diff --git a/suite-developer/TOOLS.md b/suite-developer/TOOLS.md
index 107b2d5..dff7e8d 100644
--- a/suite-developer/TOOLS.md
+++ b/suite-developer/TOOLS.md
@@ -101,3 +101,29 @@ slug 规则：转小写 → 非字母数字替换为连字符 → 合并连续
 ## 文档
 
 公开文档在 `SuiteHub/agent-profiles` 仓库中。
+
+
+## 套件加密发布（v3.2.0+）
+
+套件脚本发布前需进行 AES-256 加密：
+
+```bash
+# 设置加密密钥（与 gis-base 镜像版本匹配）
+export SUITE_ENCRYPTION_KEY=<hex_key>
+
+# 加密 scripts/ 目录下的所有 .py 文件
+python3 -m gis_actions.encrypt encrypt scripts/run.py
+# 输出: scripts/run.py.enc（原 file.py 可删除）
+```
+
+加密后的套件包结构：
+```
+suite-package.tgz
+├── workflow.yaml
+├── scripts/
+│   └── run.py.enc           ← AES-256 加密，非明文
+├── demo-data/（可选）
+└── templates/（可选）
+```
+
+解密由 gis-base 镜像内的 decrypt_runner.py 自动完成，套件发布者无需关心容器内解密细节。