SuperAPI AI 工具集

building-landing-home

前端与建站

查看项目

更新于 10-16 06:23

技能介绍

用途:用 @lobehub/ui/awesome 的落地页组件拼装产品或文档首页。工作方式是挑选合适的页面分段组件、撰写诚实文案、在组件内渲染真实产品界面,而不是自己重写容器样式。

主要能力与分段组件:LandingHero 用于开场,含徽章、渐变强调标题、描述、最多两个操作及可选 aside 列;AgentSkillCard 放在英雄文字旁,给出面向编程智能体的提示词和面向人的安装命令;LogoMarquee 置于英雄下方展示集成或支持方,图标来自 @lobehub/icons;LandingSection 包裹每个中间分段,左为标签、标题、描述,右为少量操作;BentoGrid + BentoCard 做实时组件画廊,用 colSpan/rowSpan 突出,用 href 指向文档;CodeShowcase 并排展示两到四段短代码与实时预览;FeatureGrid 用三或六张卡片写图标、标题和一句话理由;InstallBanner 做结尾行动号召,含可复制安装命令、许可脚注和文档链接;FluidGradient 作背景纹理,需定位父级。

默认页面顺序:LandingHero(aside 为 AgentSkillCard、children 为 LogoMarquee)→ LandingSection + BentoGrid → LandingSection + CodeShowcase → LandingSection + FeatureGrid → InstallBanner。宁可删掉分段也不要填废话。

使用方式:从 @lobehub/ui/awesome 导入组件。lobedocs 站点在 docs.config.ts 设置 homePage: './docs/home/home.tsx',默认导出接收 { description, getStartedPathname },主操作用 getStartedPathname。客户端路由时给 LandingHero、BentoCard、FeatureGrid 传入共享的 renderLink,让内部链接走路由、绝对地址新开标签。强调色由 --lobe-landing-gradient 变量控制,在 :root 及主题上设置一次,不要覆盖组件样式。首页标题与描述用 data-pagefind-meta 包裹以适配 Pagefind 索引。

限制与规则:AgentSkillCard 的智能体提示必须指向真实存在的 URL(skills.md 或 llms.txt),并一句话说明用途;人类命令必须可直接运行,无 skills 包则去掉 human;agents 默认 DEFAULT_SKILL_AGENTS,可替换为项目实际支持项或传空数组隐藏。标题为产品名加分类/承诺,不超过四个词;描述一句话、少于 20 词、具体,禁用 powerful、seamless、next-generation。英雄最多两个操作,只有 Get Started 是主操作。Bento 只放能实时渲染的组件,最富表现力的给 colSpan={2} rowSpan={2}。代码片段约十行且可编译。FeatureGrid 只用三或六项。LandingSection id 必须唯一,eyebrow 为一到两词并配预设色。自检:链接可解析、明暗模式可读、375px 宽下英雄堆叠且 bento 单列、prefers-reduced-motion 下无动画,且无占位文本。