工作區登陸頁面編輯器
工作區登陸頁面(渲染在 /w/:slug)是儲存在 workspace.landing_page_html 中的單一自包含 HTML blob。當提交 brief 時,伺服器端的 LANDING_PAGE_PROMPT 會從頭生成它 — 該路徑會完全覆蓋 HTML。
對於任何不應重新生成整個頁面的變更(排版調整、佈局編輯、新增區塊、修改文案、更換圖片、修正標語),請直接編輯 HTML 並將其寫回。除非使用者希望完全重新生成,否則不要發送 brief。
所有命令都使用 astria 命令列界面(請參閱 astria-api 技能)。使用 -w <workspace_id> 來指定目標工作區。
從 LANDING_PAGE_PROMPT 繼承的約束條件
編輯時,請保留這些不變項(即時 /w/:slug 頁面依賴於它們):
- 輸出是 body 內 HTML — 不要包含
<html>、<head>、<body>或<!DOCTYPE>標籤 - 樣式使用 Tailwind 工具類別(已載入在頁面上)。僅針對 Tailwind 無法表達的懸停/動畫效果使用
<style> - 套件連結格式為
/p/{slug};模型/參考連結直接使用 tunes JSON 中的link欄位(不要重新編碼%5B/%5D) - 每個圖片/影片都包裹在
<a>標籤中 - 圖片和影片 URL 必須是已存在的 — 不要憑空發明 URL
- 影片使用
<video autoplay muted loop playsinline poster="POSTER_URL"><source src="VIDEO_URL" type="video/mp4"></video> - 在
<script type="application/json" id="tunes-data">…</script>中的字串__TUNES_JSON_PAYLOAD__是一個伺服器端佔位符。伺服器在渲染時會用實際的 tunes JSON 替換它。永遠不要用實際 JSON 取代它 — 這樣會凍結演員陣容,新加入的 tunes 將不會顯示 - 編輯風格:襯線標題、寬裕的空白、細線規則、人像圖片使用
object-cover object-[center_top]、主視覺跨頁使用max-h-[70vh]、人像容器使用aspect-[4/5]或aspect-[3/4]
工作流程
1. 擷取目前的登陸頁面 HTML
astria landing get -w <workspace_id> --html > /tmp/landing_page.html
astria landing get -w <workspace_id>(不加 --html)會傳回完整的工作區 JSON — title、slug、brief、url、public_at、unlisted_at — 當你需要這些資訊時使用。在 /w/{slug} 預覽渲染後的頁面。
2. 拉取工作區資料(當編輯需要參考實際的套件/提示/tunes 時)
astria packs list -w <workspace_id> --limit 100
astria tunes list -w <workspace_id> --limit 200 # 在頁面上渲染的「演員陣容」
astria prompts list -w <workspace_id> --limit 100 --offset 0 # 使用 --offset 分頁直到無資料
astria prompts list -w <workspace_id> --pack-id <pack_id> # 較節省資源,一次一個區塊
列表端點透過 --limit/--offset 進行分頁(預設排序為 id 降冪)。使用 --offset 迴圈,直到某個分頁回傳空數據。
3. 執行增量編輯
在本機編輯 /tmp/landing_page.html。保持修改精確 — 生成器產生了數千位元組的版面配置,其中大部分應保持不變。在儲存之前,請重新閱讀上述的約束條件章節。
4. 將頁面寫回
astria landing set -w <workspace_id> --html-file /tmp/landing_page.html
這裡不要傳遞 --brief — 那樣會捨棄你的編輯並透過 Gemini 從頭重新生成。
5. 驗證
開啟 /w/{slug} 並視覺確認變更。__TUNES_JSON_PAYLOAD__ 佔位符會在渲染時由伺服器端替換 — 如果渲染後的頁面上仍然顯示一個類似 JSON 的字串,表示佔位符被意外刪除或重新命名了。
從頭重新生成
僅當使用者明確要求完全重新設計時 — 提交一個 brief,伺服器會對 Gemini 執行 LANDING_PAGE_PROMPT,覆寫 HTML:
astria landing set -w <workspace_id> \
--brief "Editorial fashion lookbook, AW26, dark moody palette, emphasize the womenswear packs"