From f0632a6a389341053d760b2076f84813da3913de Mon Sep 17 00:00:00 2001
From: Huawei <huawei@mercator.cn>
Date: Sun, 19 Jul 2026 12:09:04 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=E5=A5=97=E4=BB=B6?=
 =?UTF-8?q?=E5=8A=A0=E5=AF=86=E5=8F=91=E5=B8=83=E6=B5=81=E7=A8=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 suite-developer/TOOLS.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

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 自动完成，套件发布者无需关心容器内解密细节。