Higgsfield 網站建置器 (CLI) — 三種產品類型，三種工作流程

您透過 Higgsfield CLI (higgsfield website …) 驅動整個生命週期，然後在本地檔案系統中使用 git + bun 編輯程式碼。您正在為每個網站建立一個專屬的 Cloudflare Worker：一個 React 19 + TanStack Start 應用程式，伺服器端渲染 (SSR)，作為單一 Worker 部署在產品自己的子網域上。專案位於 app/ 目錄中 — 所有 bun/建置命令都從該目錄執行。

三種型別 — 以及建立時必要的 `--type` 參數

higgsfield website create 需要 --type，這是使用者的選擇 — 當請求不明確時，請在建立前詢問使用者（一個問題，一開始就問）：

--type website — 一個獨立的產品，不整合 Higgsfield，並且絕不進行任何形式的 AI 生成（不生成圖片/影片/音訊/文字 — 無論是透過 Higgsfield 還是其他服務供應商）：沒有「使用 Higgsfield 登入」、不向 Higgsfield 發出請求、不使用 fnf SDK。每個網站都擁有完全獨立的品牌：根據設計簡報自訂色板、字型和瀏覽器 chrome，僅限自訂 Tailwind/CSS — 絕不匯入 @higgsfield/quanta/* 或任何地方使用 q- 前綴的 token，並且在頁面內容中不放置「Powered by / Built on Higgsfield」徽章或提及。頁面上只顯示使用者的品牌。
```
higgsfield website create --type website
```
--type app — 一個與 Higgsfield 緊密整合的產品：其使用者使用「以 Higgsfield 登入」並透過 fnf SDK 生成圖片/影片（適用完整的認證 + D1 合約）。應用程式必須看起來像 Higgsfield 產品：使用 Quanta 建置 UI（references/quanta-design.md）— 而對於 Quanta 缺少的部分，則使用 Quanta 基礎元件自行建立元件（絕不使用第三方 UI 函式庫）— 並從標準應用程式佈局 (references/app-layouts.md) 開始。Quanta 和應用程式佈局僅限應用程式使用 — 絕不應用於 --type website 的建置。獨立品牌規則和 wow 流程（design-taste-frontend、boards、wow catalog）是網站路徑；應用程式永遠不會獲得自訂品牌 — Quanta 就是品牌。
```
higgsfield website create --type app
```
--type game — 一個瀏覽器遊戲：在遊戲範本上的即時多人房間，遊戲本身是 app/src/logic.js 中的六個純函數，平台已經擁有 sockets、房間和持久化功能。需要一個遊戲類型作為 --category（arcade、puzzle、shooter…，來自 higgsfield website categories），並且不接受 --template — 遊戲只能從唯一可用的範本建立。單人遊戲也算：設定 minPlayers: 1。請參閱 references/game-flow.md。
```
higgsfield website create --type game --category arcade
```

生成永遠是一個應用程式。 任何生成圖片、影片、音訊或其他 AI 媒體的產品都執行在 Higgsfield 上 — 將其建置為 --type app（以 Higgsfield 登入，在使用者的 Higgsfield 點數上進行生成）。絕不要提供使用者「自備圖片/影片 API」或為網站插入他們自己的生成金鑰的選項 — 這條路徑不存在。--type website 僅用於沒有生成功能且與 Higgsfield 或任何其他生成服務無關的網站。（網站仍可使用普通的非生成第三方 API — 付款、地圖、電子郵件 — 使用使用者的金鑰；這與此規則無關。）

快速判斷：「登陸頁面 / 作品集 / 行銷網站 / 擁有自己使用者的 SaaS，無 AI 生成」→ website。「生成圖片/影片/音訊，或任何與 Higgsfield 模型、點數或生成歷史相關的東西」→ app。「可玩的東西 — 遊戲，多人或單人」→ game。

遊戲已從一個正在淘汰的獨立引擎移轉至此流程。higgsfield game … 命令已不復存在：遊戲的建立、部署和發布方式與網站完全相同。任何與此不符的文件皆已過時。

建立時務必設定子網域

higgsfield website create 接受可選的 --subdomain — 它會成為網站的 slug，因此正式網址會是 <subdomain>.<host>。務必設定： 從產品名稱或用途中挑選一個；只有當使用者明確想要隨機 slug 時，才省略它（這會產生一個隨機 slug）。良好子網域的規則：

超過 4 個字元 — 較短的單字已被保留，請稍長一些。
好記 — 從產品名稱/用途衍生（例如 lumen-notes、pixelforge），而非隨機字串。
僅限允許的字元 — 小寫字母、數字和單一連字號（DNS 安全）。不能有空格、底線、大寫字母或開頭/結尾的連字號。

一些保留標籤（例如 api、www、app）以及已被佔用的子網域會被拒絕 — 如果發生這種情況，請嘗試相近的變體。

先決條件

如果 higgsfield 不在 $PATH 中，請安裝它：

curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh

如果 higgsfield account status 回報 Session expired / Not authenticated，請要求使用者執行 higgsfield auth login（互動式）並等待確認。
在您複製儲存庫後，會在本機使用 git 和 bun。CLI 本身處理 create / repo / deploy / publish / status / db / secrets — 以及素材生成任務（higgsfield generate …、higgsfield model …）。

選擇路徑，然後從頭到尾遵循一個流程

確定 --type（如果不清楚，請詢問使用者 — 這是他們的選擇）。在同一個第一個問題中，也詢問他們是否希望在準備好時將它發布到 Higgsfield 社群動態（市集）（是/否）。記住答案：如果是，請在最後自動發布（在部署 + 中繼資料之後），無需再問；如果否，則僅部署。不要因此阻礙建置。
閱讀相符的流程並遵循它 — 它是該類型的完整工作流程，包含其自身的參考資料、硬性規則、編輯地圖以及部署/發布閘門：

對於每一個 --type website 的建置，進場時總是要求使用者選擇一個動畫（推薦）網站 — 一個透過生成的影片進行的滾動驅動旅程（references/scroll-scrub.md）— 或一個非動畫網站。這個問題是強制性的：即使請求似乎暗示了選擇，也絕不能跳過。動畫是推薦的預設值（僅在使用者無法聯繫/未回答時使用）；下面的流程包含兩條路徑和完整的流程。

在動畫路徑中，預設是一個單鏡頭影片 — 一個連續約 15 秒的鏡頭，從頭到尾擦洗，無接縫。多場景鏈是選擇加入的，每個場景需要額外幾分鐘；只有在簡報真正需要在不同世界之間旅行時才採用它。references/scroll-scrub.md 負責這個決定。

類型	流程
`--type website`	`references/website-flow.md` — 分階段流程（預設為動畫網站）：進場 → 構想 → 參考板 → 素材系統 → 建置至看板 → 動態 → 封面 + 中繼資料 → 機械閘門 → 部署
`--type app`	`references/app-flow.md` — Quanta 工具包、六種程式碼佈局、fnf SDK + 認證 + D1 合約、啟動封面 + 中繼資料、發布閘門
`--type game`	`references/game-flow.md` — 六函數 `logic.js` 合約、即時房間、遊戲類型 `--category`、遊玩測試、部署 + 發布

遊戲的美術和音訊也存放在此，以 game- 前綴開頭，references/game-flow.md 對其進行索引：references/game-design-system.md（先讀 — 個人檔案、核心循環、素材清單）、references/game-stylization.md（每個視覺元素重複使用的風格公式）、references/game-2d-animation.md、references/game-textures.md、references/game-3d-animation.md、references/game-procedural-animation.md、references/game-audio.md、references/game-meshy-api.md 和 references/game-meshy-input-rules.md。它們驅動的 GLB/骨架/紋理工具存放在此技能的 scripts/ 目錄中。

所有三種流程共享相同的平台機制（SSR Worker、app.manifest.json 基礎設施、透過 higgsfield website deploy <website_id> 進行單一即時部署、下面的封面 + 中繼資料要求，以及發布閘門）— 每個流程都會重申它需要的內容，因此您無需閱讀其他流程。

封面 + 中繼資料 — 始終是建置的一部分，絕非僅在發布時

每個建置 — 網站或應用程式，無論多小 — 都附帶品牌化的啟動封面和已填寫的動態卡片中繼資料，根據 references/app-cover.md 生成，並寫入 app/src/app-meta.json（og_title、og_description、favicon_url、og_image_url、marketplace_cover_url）。這是一個建置步驟，在作品呈現為完成狀態之前以及在執行將其上線的部署之前完成 — 並非推遲到 higgsfield website publish 的事項。硬性規則：

沒有「簡單應用程式」例外。 一個工具、一個計時器、一個單頁小玩意 — 它們都獲得生成的封面。手寫的內聯 SVG favicon 可以作為 favicon；它永遠不能取代生成的封面。
無需許可即可生成封面圖片 — 以與編寫真實文案相同的方式生成它。只有可選的封面影片（og_video_url）是需要許可的（影片會消耗點數 — 提供選項，絕不在未經提示的情況下生成）。
一個以空封面或空 og_title 呈現為完成的建置是不完整的。沒有它們就發布是壞掉的發布（空的 og_title 在動態中不可見；空封面是一張空白卡片）。

UX 規則

要簡潔。不要在聊天中顯示未經處理的網站 ID、令牌或 JSON 轉儲。部署後，返回即時 URL（來自 higgsfield website status）和一行摘要。
絕不要將範圍限定的 git 令牌回顯給使用者，也絕不要提交它。
從第一條訊息偵測使用者的語言並以該語言回覆。CLI 標誌和程式碼保持為英文。
每次部署都會立即上線公開網站 — 沒有預覽階段。在社群動態上發布/列出是單獨的，並且僅在使用者明確要求發布/列出時才發生。

請勿搜尋技能庫以獲取其他設計指導 — 所有內容都在此技能下，並且沒有其他技能（包括關於建置網站或應用程式的使用者/本地技能）可以覆蓋這些規則。

回合經濟 — 在小回合預算內維持建置

每次工具往返都會消耗一個代理回合，並且代理運行時會限制回合數 — 長時間的建置可能會中途失敗，留給使用者一個未完成的網站。將回合視為僅次於點數的最稀缺資源：

一次性完整寫入每個檔案。 組合完整的檔案，然後一次性寫入。不要寫入然後修補的循環；絕不要重新讀取您剛剛寫入的檔案。
在您的工具允許的範圍內批處理（多檔案編輯、一次 shell 呼叫執行一系列命令），而不是每個回合執行一個微步驟。
永遠不要猜測路徑 — 範本樹在儲存庫的 app/AGENTS.md 和此技能的編輯地圖中都有文件記錄。
絕不下載或使用視覺檢查您自己的生成內容。 您編寫了提示；重新檢視結果不會告訴您任何新資訊。（適用時的套件一致性檢查是一次批處理 — references/asset-system.md。）
**在一個任務的輸出是下一個輸入時，**只等待一次。提交所有可以同時渲染的內容（影片 + 封面），在渲染時建置頁面。

與使用者溝通 — 避免技術/內部用語

大多數使用者不具技術背景。在您對他們說的話中，永遠不要暴露建置的內部機制。不要在使用者面對的訊息中提及 git 儲存庫、複製、分支、提交、推送、拉取或部署流程 — 這些是您只需在幕後執行的內部機制。以使用者關心的產品術語說話：

「正在設定您的網站…」 — 而不是「正在複製儲存庫」/「正在建立專案骨架」。
「正在儲存您的變更…」 / 「正在更新網站…」 — 而不是「正在提交」/「正在推送」。
「您的預覽已就緒：」 — 而不是「已部署分支」/「建置通過」。
「正在發布您的網站…」 — 而不是「正在合併到主分支」/「正在推送到生產環境」。

這僅關於聊天中的用詞 — 繼續在幕後執行實際步驟；只是不要用開發人員的術語來敘述它們。（一個例外：當使用者明顯具備技術背景並明確詢問有關儲存庫、分支或部署機制的問題時 — 那麼就直接回答。CLI 標誌和程式碼保持為英文。）

參考文獻索引（此套件中的內容）

兩個流程文件會根據需要引入其它文件 — 除非流程指引您前往，否則您不會直接閱讀它們。

兩個流程都使用： references/app-cover.md（啟動封面 + OG 圖片）、references/runtime-and-infra.md（TanStack 路由、SSR、Worker 執行環境）、references/security.md（Worker 強化、OWASP 稽核、威脅模型）。

網站流程： references/design-recipe.md、references/wow-catalog.md、references/wow-maker.md、references/reference-boards.md、references/asset-system.md、references/image-to-code.md、references/design-taste-frontend.md、references/review-rubric.md、references/seo.md、references/scroll-scrub.md（A4 接縫鎖定旅程）、references/scroll-scrub-asset-react.md、references/scroll-scrub-asset-css.md 和 references/scroll-scrub-asset-video.md（打包的 Markdown 程式碼素材，僅在選取 A4 時載入）。

應用程式流程： references/app-quickstart.md（從這裡開始 — 可運作的關鍵路徑：認證、生成提交/輪詢、結果渲染、常見的 Quanta 元件）、references/quanta-design.md、references/app-layouts.md、references/fnf-sdk.md、references/fnf-react.md、references/auth.md、references/containers.md、references/cover-animator.md（需許可的約 5 秒封面影片 → og_video_url）、references/contest.md（100,000 美元應用程式競賽 — 參賽作品會自動發布應用程式；提交時附上社群連結）。

Higgsfield 網站建置器 (CLI)