SuperAPI AI 工具集

higgsfield-websites

前端与建站

查看项目

更新于 10-29 04:39

技能介绍

Higgsfield Websites 是一个通过 Higgsfield CLI 驱动网站全生命周期的技能包,支持创建、编辑、部署和发布三种产品:网站(website)、应用(app)和游戏(game)。所有产品均为 React 19 + TanStack Start 的 SSR 应用,并以单个 Cloudflare Worker 形式部署在各自子域名下;项目位于 app/ 目录,使用 git 和 bun 在本地编辑代码。

【产品类型】 创建时必须指定 --type,且类型应由用户决定;若请求不明确,需在创建前询问。

  • website:完全独立的产品,不与 Higgsfield 集成,也不进行任何 AI 生成(图片/视频/音频/文本均不可)。拥有独立品牌,仅使用自定义 Tailwind/CSS,不得引入 @higgsfield/quanta/* 或 q 前缀令牌,页面中不得出现 “Powered by Higgsfield” 等内容。第三方非生成类 API(支付、地图、邮件)可使用用户自己的密钥。
  • app:与 Higgsfield 深度集成,用户通过 Higgsfield 登录,并使用 fnf SDK 生成图片/视频,需遵循完整的认证与 D1 约定。界面使用 Quanta 设计体系与标准应用布局构建。任何涉及 AI 生成的产品都必须使用此类型。
  • game:浏览器游戏,基于游戏模板运行实时多人房间;游戏逻辑为 app/src/logic.js 中的六个纯函数,平台负责套接字、房间与持久化。创建时需通过 --category 指定游戏类别(如 arcade、puzzle、shooter),且不需要 --template。

【创建与部署】 创建时建议始终设置 --subdomain,作为站点 slug 与线上 URL(<subdomain>.<host>)的一部分。子域名需超过 4 个字符、易记、仅含小写字母、数字与单个连字符;部分保留标签(如 api、www、app)及已占用子域名会被拒绝,可尝试相近变体。 依赖:若 higgsfield 不在 PATH 中,可执行 curl -fsSL https://raw.githubusercontent.com/higgsfield-ai/cli/main/install.sh | sh 安装;若账户会话过期或未认证,需用户运行 higgsfield auth login 完成交互式登录。CLI 负责创建、仓库、部署、发布、状态、数据库、密钥以及资产生成任务(higgsfield generate …、higgsfield model …)。 部署通过 higgsfield website deploy <website_id> 完成,会立即上线公开站点,没有预览阶段;发布到社区 feed 是独立步骤,仅在用户明确要求时执行。

【封面与元数据】 每次构建(无论网站还是应用)都必须包含品牌化启动封面与填充完整的 feed 卡片元数据,写入 app/src/app-meta.json(og_title、og_description、favicon_url、og_image_url、marketplace_cover_url)。这是构建步骤,须在交付与部署前完成,不能留到发布时处理;封面视频(og_video_url)因消耗额度需用户许可。

【动画与非动画网站】 对于 website 类型,必须询问用户选择动画网站(推荐,滚动驱动的影片旅程,参考 scroll-scrub.md)还是非动画网站。动画路径默认使用约 15 秒的单镜头连续影片并进行滚动擦洗;多场景链为可选项,会增加渲染时间。

【使用方式与流程】 技能包提供三条流程文档:references/website-flow.md(website 分阶段流程)、references/app-flow.md(Quanta 工具包、应用布局、fnf SDK 与认证、D1 约定)、references/game-flow.md(六函数逻辑约定、实时房间、类型与部署发布)。三条流程共享相同的平台机制:SSR Worker、app.manifest.json 基础设施、单次部署与发布门禁。

【UX 与限制】 交互保持简洁,不在聊天中暴露网站 ID、令牌或 JSON 转储;部署后返回线上 URL 和一行摘要。不向用户回显受限 git 令牌,不提交令牌。根据用户首条消息的语言回复,CLI 标志与代码保持英文。面向非技术用户时避免暴露仓库、克隆、提交、推送、部署流水线等内部机制。技能强调控制对话轮次:一次性完整写入文件、按工具能力批量操作、不重复读取刚写入的文件、并发提交可同时渲染的任务。

【参考索引】 通用:app-cover.md、runtime-and-infra.md、security.md。 网站流程:design-recipe.md、wow-catalog.md、wow-maker.md、reference-boards.md、asset-system.md、image-to-code.md、design-taste-frontend.md、review-rubric.md、seo.md、scroll-scrub.md 及三个 scroll-scrub 资产文件。 应用流程:app-quickstart.md、quanta-design.md、app-layouts.md、fnf-sdk.md、fnf-react.md、auth.md、containers.md、cover-animator.md、contest.md。 游戏流程:game-design-system.md、game-stylization.md、game-2d-animation.md、game-textures.md、game-3d-animation.md、game-procedural-animation.md、game-audio.md、game-meshy-api.md、game-meshy-input-rules.md,相关 GLB/绑定/纹理工具位于 scripts/ 中。

【适用场景】 适合需要快速生成独立品牌网站、集成 Higgsfield AI 能力的应用,或可直接游玩的多人/单人浏览器游戏;不适合无 CLI 环境或无法完成 Higgsfield 认证的场景。具体收费、价格与平台细节暂未提供。