Neus 通用落地页 是做什么的?
生成一个通用着陆页,包含英雄区、内容版块和行动号召按钮。根据用户的用途进行适配。
重要:不包含 AppTemplate。这是一个公开页面。
开始之前
以下“共享规则”部分始终有效。此外,在第 0 阶段之前,请阅读以下所有内容:
.agents/skills/_shared/anti-slop.md— 强制性质量规则(“营销页面”部分).agents/skills/_shared/prop-constraints.md— 禁止的属性和不存在的组件.agents/skills/_shared/component-catalog.md— Button、Card、Link、Input 部分.agents/skills/_shared/design-personality.md— 个性轴、视觉指令格式、第 9 节暗色模式表面配方.agents/skills/_shared/dark-surfaces.md— 暗色模式 CSS 配方(当模式为 dark 时读取).agents/skills/_shared/light-surfaces.md— 亮色模式 CSS 配方(当模式为 light 时读取).agents/skills/_shared/checklist.md— P0/P1/P2 检查项.agents/skills/_shared/layout-patterns.md— 着陆页布局模式(数据统计行、版块分割的标题、英雄区眉毛药丸、自适应导航).agents/skills/neus-landing-generic/references/dark-landing-patterns.md— 暗色着陆页的版块布局结构和 JSX 模式
第 0 阶段 — 收集数据
向用户提出以下问题,并等待他们完整回复后再继续:
- 这是什么类型的页面?(作品集、公司、活动、代理商、博客、个人、其他)
- 页面名称/品牌
- 主标题 (H1) — 可以包含一个用于渐变色处理的强调词
- 标语或副标题
- 需要包含的版块(精确列出 — 不要额外增加)
- 主要行动号召按钮:标签 + 操作
- 次要行动号召按钮(可选):标签 + 操作
- 主色调(十六进制或描述)
- 模式:亮色还是暗色?
- 个性:简洁/通透、编辑/层次、大胆/动感、或结构化?(如果不确定,请描述风格)
- 是否包含联系表单或新闻通讯?(是/否 — 请具体说明)
第 1 阶段 — 视觉解析
在编写任何代码之前,根据收集到的答案解析出视觉指令。
调色板映射:
- 鲜艳/充满活力的颜色 → Vibrant
- 中性/柔和/灰色调 → Neutral
- 企业蓝/绿 → Corporate
- 紫色/粉色/创意色 → Creative
个性映射(来自问题 10):
- 简洁/极简/通透 → Airy
- 编辑/层次/不对称 → Layered
- 大胆/强烈/动感 → Kinetic
- 结构化/正式/数据密集 → Structured
构建以下代码块,并带入第 2 阶段:
视觉指令:
- 调色板:[Vibrant / Neutral / Corporate / Creative]
- 个性:[Kinetic / Airy / Structured / Layered]
- 模式:[light / dark]
- 动画:[neus-fade-up on .hero-copy / none]
- 布局:[不对称两栏英雄区 1.4fr/0.6fr / 居中英雄区]
- H1:[clamp(2.5rem,6vw,4rem) weight-800 / clamp(2rem,4vw,3rem) weight-700]
- 渐变文字:[是 — 强调词:"[word]" / 否]
- 表面:[玻璃效果 (dark-surfaces.md) / 标准 var(--color-white)]
- 导航:[玻璃效果粘性 / 标准粘性 / 无]
暗色模式规则: 如果模式为 dark,所有表面都使用 dark-surfaces.md 中的配方。切勿使用 var(--color-white) 作为页面或版块的背景。内容卡片使用 <Card variant="glass"> — 这是 Neus UI 的玻璃表面。切勿用原始 <div> + 自定义 CSS 替换它。
亮色模式规则: 如果模式为 light,内容卡片使用 Neus UI <Card>,交替版块背景使用 var(--color-primary-light),页面根元素使用 var(--color-white)。
第 2 阶段 — P0 验证
- 输出版块 == 收集到的版块(问题 5)。零额外内容。
- 无虚构文案 — 所有文本来自收集或明确由属性驱动
- 无 AppTemplate 或侧边栏
- 已构建视觉指令并向前传递
- 暗色模式:所有表面使用玻璃配方,无
var(--color-white)背景 - 亮色模式:内容使用 Neus UI
<Card>,交替版块使用 primary-light
第 3 阶段 — 生成文件
按此顺序生成 三个文件:PageName.types.ts → PageName.tsx → PageName.styles.css。
PageName.types.ts
import type { BadgeColor } from 'neus-ui';
export type NavItem = {
label: string;
href: string;
};
// 仅根据收集的数据添加版块特定类型
export type Article = {
id: string;
title: string;
href?: string;
excerpt?: string;
author?: string;
meta?: string;
categories?: string[];
};
// 类别 → Badge 颜色映射(暗色模式:4 种视觉上不同的颜色)
export const BADGE_COLOR: Record<string, BadgeColor> = {
systems: "primary",
design: "error",
craft: "neutral",
tools: "success",
featured: "primary",
};
export type PageNameProps = {
// 仅当数据来自外部时才使用属性(文章列表、表单处理程序等)
// 静态营销文案应硬编码在组件中 — 绝不作为属性传入
};
PageName.tsx
暗色模式结构 — 正确的组件使用:
import { useState } from 'react';
import { Button, Card, Link, Input, Badge } from 'neus-ui';
import './PageName.styles.css';
import type { PageNameProps, Article } from './PageName.types';
import { BADGE_COLOR } from './PageName.types';
export const PageName = ({ articles, onSubscribe }: PageNameProps) => {
const [email, setEmail] = useState('');
const [subscribed, setSubscribed] = useState(false);
const [loading, setLoading] = useState(false);
const handleSubscribe = () => {
setLoading(true);
onSubscribe?.(email);
setSubscribed(true);
setLoading(false);
};
return (
<div className="page-name">
{/* 装饰性背景层 — aria-hidden,不可交互 */}
<div className="page-name__mesh" aria-hidden="true" />
<div className="page-name__grid" aria-hidden="true" />
<div className="page-name__content">
{/* 粘性玻璃导航 — 链接使用 <Link type="secondary"> */}
<nav className="page-name__nav">
<div className="page-name__nav-brand">
<div className="page-name__brand-mark" aria-hidden="true">P</div>
<span className="page-name__brand-name">PageName</span>
</div>
<div className="page-name__nav-links">
{navItems.map(item => (
<Link key={item.href} type="secondary" href={item.href} label={item.label} />
))}
</div>
<Button label="Subscribe" variant="solid" color="primary" size="small" onClick={() => {}} />
</nav>
<main>
{/* 英雄区 — 不对称两栏 */}
<section className="page-name__hero" aria-labelledby="page-name-title">
<div className="page-name__hero-copy">
{/* 眉毛药丸 — 原始 div(无 Neus UI 等效组件) */}
<div className="page-name__eyebrow-pill">
<span className="page-name__eyebrow-dot" aria-hidden="true" />
PAGENAME
<span aria-hidden="true">/</span>
KEYWORD
</div>
<h1 id="page-name-title">
Headline{" "}
<span className="gradient-text">accent</span>
</h1>
<p className="page-name__hero-sub">Tagline from intake.</p>
<div className="page-name__hero-cta">
<Button label="Primary CTA" variant="solid" color="primary" onClick={() => {}} />
<Button label="Secondary CTA" variant="outlined" color="primary" onClick={() => {}} />
</div>
</div>
<div className="page-name__hero-visual">
{/* 特色 Card 或艺术面板 — 参见 dark-landing-patterns.md §4 */}
</div>
</section>
{/* 来自收集数据的内容版块 — 卡片使用 <Card variant="glass"> */}
{/* 示例文章网格版块: */}
<section className="page-name__articles">
<div className="page-name__article-grid">
{articles?.map(article => (
<Card variant="glass" key={article.id} onClick={() => {}}>
<div className="page-name__article-inner">
<div className="page-name__pill-row">
{article.categories?.map(cat => (
<Badge
key={cat}
variant="solid"
color={BADGE_COLOR[cat] ?? "neutral"}
label={cat}
/>
))}
</div>
<h3>{article.title}</h3>
{article.excerpt && <p className="page-name__article-dek">{article.excerpt}</p>}
</div>
</Card>
))}
</div>
</section>
{/* 新闻通讯版块(如果要求) */}
<section className="page-name__newsletter" aria-labelledby="page-name-nl-title">
<div className="page-name__nl-card">
<p className="page-name__sec-eyebrow">Newsletter</p>
<h2 id="page-name-nl-title">
Stay in the loop.{" "}
<span className="gradient-text">No noise.</span>
</h2>
{subscribed ? (
<p className="page-name__nl-success">✓ You're subscribed — thanks!</p>
) : (
<div className="page-name__nl-form">
<Input
name="newsletter-email"
type="email"
label="Email"
placeholder="[email protected]"
value={email}
onChange={setEmail}
required
/>
<Button
label="Subscribe"
type="submit"
variant="solid"
color="primary"
loading={loading}
onClick={handleSubscribe}
/>
</div>
)}
</div>
</section>
</main>
{/* 页脚 — 链接使用 <Link type="secondary"> */}
<footer className="page-name__footer">
<span>© {new Date().getFullYear()} PageName.</span>
<div className="page-name__footer-links">
<Link type="secondary" href="/privacy" label="Privacy" />
<Link type="secondary" href="/contact" label="Contact" />
</div>
</footer>
</div>
</div>
);
};
亮色模式结构: 省略 mesh/grid div 和内容包装器。内容卡片使用 <Card>(无 variant)。交替版块背景使用 background: var(--color-primary-light)。主要链接使用 <Link type="primary">,导航/页脚使用 <Link type="secondary">。类别药丸仍使用 <Badge>。
特色磁贴(两种模式):
<Card variant="glass" icon={...} title="..." description="..." />(暗色)<Card icon={...} title="..." description="..." />(亮色)
联系表单(如果要求): 使用 Neus UI <Input> 字段 + <Button type="submit">。与新闻通讯模式相同,但无需发光卡片包装器。
PageName.styles.css
暗色模式: 从 dark-surfaces.md §1 的画布 + mesh + grid + 内容配方开始。然后添加玻璃导航(§3)、nl-card(§4)、眉毛药丸(§5)、渐变文字(§6)、艺术面板(§8,如果有特色)、元数据行(§9,如果有文章)、页脚(§10)。无自定义卡片 CSS — <Card variant="glass"> 会处理。应用 dark-landing-patterns.md 中的布局。
亮色模式: 从 background: var(--color-white); color: var(--color-gray-900) 开始。交替版块背景使用 var(--color-primary-light)。遵循 design-personality.md 第 4–5 节的排版和间距。
两种模式:
@keyframes neus-fade-up {
from { opacity: 0; transform: translateY(16px); }
to { opacity: 1; transform: translateY(0); }
}
.page-name__hero-copy {
animation: neus-fade-up 0.5s ease both;
}
/* 渐变文字工具类 */
.gradient-text {
background: linear-gradient(135deg, #22d3ee 0%, #818cf8 45%, #d946ef 100%);
-webkit-background-clip: text;
-webkit-text-fill-color: transparent;
background-clip: text;
}
/* 最大宽度容器 */
.page-name__hero,
.page-name__articles,
.page-name__newsletter,
.page-name__footer {
max-width: min(72rem, 100%);
margin: 0 auto;
}
/* 版块内边距 */
.page-name__hero { padding: 6rem 2rem; }
.page-name__articles { padding: 6rem 2rem; }
.page-name__newsletter { padding: 5rem 2rem; }
/* 英雄区网格 */
.page-name__hero {
display: grid;
grid-template-columns: 1.4fr 0.6fr;
gap: 3rem;
align-items: center;
}
/* H1 */
.page-name__hero h1 {
font-family: var(--font-display);
font-size: clamp(2.5rem, 6vw, 4rem);
font-weight: 800;
letter-spacing: -0.04em;
line-height: 0.98;
margin: 0.5rem 0 1rem;
}
/* 新闻通讯表单 — 弹性行 */
.page-name__nl-form {
display: flex;
gap: 1rem;
align-items: flex-end;
max-width: 520px;
margin: 0 auto;
}
/* 文章网格 */
.page-name__article-grid {
display: grid;
grid-template-columns: repeat(3, 1fr);
gap: 1.5rem;
}
/* 药丸行 */
.page-name__pill-row {
display: flex;
flex-wrap: wrap;
gap: 0.5rem;
margin-bottom: 0.75rem;
}
/* 响应式 */
@media (max-width: 960px) {
.page-name__hero { grid-template-columns: 1fr; }
.page-name__article-grid { grid-template-columns: 1fr; }
}
@media (max-width: 640px) {
.page-name__hero,
.page-name__articles,
.page-name__newsletter { padding: 5rem 1.25rem; }
}
共享规则(内嵌)
这些规则始终有效。即使未读取
_shared/文件,它们也适用。
输出 — 始终三个文件
每个技能输出:ComponentName.types.ts → ComponentName.tsx → ComponentName.styles.css。
无内联样式(style={{}})。组件内无 <style> 标签。CSS 仅放在 .styles.css 中。
导入
import { Button, Card, Input, Badge, Link, Select, Modal, DataTable } from 'neus-ui';
切勿 […] [已截断以进行翻译]