From a520509cd844e55cea8371607a8ea8a3ef7af9c2 Mon Sep 17 00:00:00 2001
From: anguohui <anguohui@bytedance.com>
Date: Fri, 10 Jul 2026 17:18:56 +0800
Subject: [PATCH] refactor(apps): remove app_id from html-publish output,
 update skill doc

---
 shortcuts/apps/apps_html_publish.go                   | 3 ---
 shortcuts/apps/apps_html_publish_test.go              | 3 ---
 skills/lark-apps/references/lark-apps-html-publish.md | 9 +++++++--
 3 files changed, 7 insertions(+), 8 deletions(-)

diff --git a/shortcuts/apps/apps_html_publish.go b/shortcuts/apps/apps_html_publish.go
index 8ab32fbd9..3fb252639 100644
--- a/shortcuts/apps/apps_html_publish.go
+++ b/shortcuts/apps/apps_html_publish.go
@@ -136,9 +136,7 @@ var AppsHTMLPublish = common.Shortcut{
 		if err != nil {
 			return err
 		}
-		out["app_id"] = spec.AppID
 		rctx.OutFormat(out, nil, func(w io.Writer) {
-			fmt.Fprintf(w, "app_id: %s\n", spec.AppID)
 			if url, ok := out["url"].(string); ok && url != "" {
 				fmt.Fprintf(w, "url: %s\n", url)
 			}
@@ -366,7 +364,6 @@ func runHTMLPublishTOS(ctx context.Context, rctx *common.RuntimeContext, spec ap
 	}
 
 	return map[string]interface{}{
-		"app_id":     spec.AppID,
 		"release_id": common.GetString(releaseData, "release_id"),
 	}, nil
 }
diff --git a/shortcuts/apps/apps_html_publish_test.go b/shortcuts/apps/apps_html_publish_test.go
index 3c3176e1b..42128ffff 100644
--- a/shortcuts/apps/apps_html_publish_test.go
+++ b/shortcuts/apps/apps_html_publish_test.go
@@ -676,9 +676,6 @@ func TestRunHTMLPublishTOS_Success(t *testing.T) {
 	if err != nil {
 		t.Fatalf("err=%v", err)
 	}
-	if out["app_id"] != "app_tos" {
-		t.Fatalf("app_id=%v, want app_tos", out["app_id"])
-	}
 	if out["release_id"] != "rel_123" {
 		t.Fatalf("release_id=%v, want rel_123", out["release_id"])
 	}
diff --git a/skills/lark-apps/references/lark-apps-html-publish.md b/skills/lark-apps/references/lark-apps-html-publish.md
index 500d1401b..93b88fd62 100644
--- a/skills/lark-apps/references/lark-apps-html-publish.md
+++ b/skills/lark-apps/references/lark-apps-html-publish.md
@@ -23,8 +23,13 @@ lark-cli apps +html-publish --app-id app_xxx --path ./index.html --dry-run
 
 ## 输出契约
 
-- 成功默认 JSON envelope 只关心 `data.url`；这是本轮 HTML 发布后的发布态访问链接。
-- pretty 输出为 `url: <url>`，适合人看；自动化取字段用 JSON 或 `--jq '.data.url'`。
+根据应用类型，输出字段不同：
+
+- **静态 HTML 应用**：`data.url` 是本轮发布后的访问链接，一步完成发布。
+- **其他 HTML 应用**：`data.release_id` 是发布标识，命令内部已完成产物上传和发布创建。用 `+release-get --app-id <app_id> --release-id <release_id>` 轮询发布状态直到 `finished`。
+
+判断走哪条路径：有 `url` 字段说明已直接发布完成；有 `release_id` 字段说明需要用 `+release-get` 轮询。
+
 - 业务失败如构建失败、应用不存在通常带 `error.hint`；优先转述 hint。网络/服务端失败则建议稍后重试。
 
 ## 链接边界