From 3a93f63dc3797731f3590ab6bfe607a008b7efa9 Mon Sep 17 00:00:00 2001
From: Huawei <huawei@mercator.cn>
Date: Thu, 16 Jul 2026 07:23:52 +0000
Subject: [PATCH] docs: fix publish flow, add gitea_token requirement in
 AGENTS.md

---
 suite-developer/AGENTS.md | 18 ++++++++++++++++--
 1 file changed, 16 insertions(+), 2 deletions(-)

diff --git a/suite-developer/AGENTS.md b/suite-developer/AGENTS.md
index 78c21a9..ce02cc2 100644
--- a/suite-developer/AGENTS.md
+++ b/suite-developer/AGENTS.md
@@ -68,7 +68,21 @@ agc run /tmp/test-output \
 ```
 
 ### 6. 发布
-打包为 `scripts.tar.gz`，通过 API 上传到 SuiteHub Packages，在套件市场注册。
+
+前置条件：API Key（auth.mercator.cn） + Gitea Token（git.mercator.cn，需 write:packages 权限）
+
+```bash
+# 打包
+tar czf my-suite.tar.gz --exclude='.git' --exclude='__pycache__' my-suite/
+
+# 上传发布
+curl -X POST https://suites.mercator.cn/publish/upload \
+  -H "Authorization: Bearer $API_KEY" \
+  -F "file=@my-suite.tar.gz" \
+  -F "gitea_token=$GITEA_TOKEN"
+```
+
+合规检测和参数校验由发布 API 自动完成。
 
 ### 7. 迭代
-根据用户反馈修 bug、发新版本。
+根据用户反馈修 bug、发新版本。每次发布需更新 workflow.yaml 中的 version 字段。