网站构建
构建具有卓越品质、可避免泛泛“AI 生成”美学的生产级网站。每一个选择——字体、颜色、动效、布局——都必须是经过深思熟虑的。以静态 HTML/CSS/JS 包的形式部署到 S3。
本技能涵盖 Web 项目的所有内容。 当通过 load_skill("website-building") 加载时,所有文件都会被复制到 workspace/skills/website-building/。根据项目类型,按需读取子文件。对于 Web 应用程序,请加载子技能:load_skill("website-building/webapp")。
通用设计原则(色彩哲学、默认调色板、字体选择)通过 design-foundations 与其他技能共享。本技能的共享文件通过 Web 特定的实现(CSS 变量、响应式令牌、基础样式表)扩展了这些基础。您无需单独加载 design-foundations——shared/ 中的 Web 特定版本已经足够全面。
使用完整的路径进行读取,例如 skills/website-building/shared/01-design-tokens.md。
框架检测路由器
在按项目类型路由之前,先识别框架:
| 信号 | 框架 | 操作 |
|---|---|---|
package.json 包含 "next" 依赖项 OR next.config.* 存在 | Next.js | 首先读取 skills/website-building/nextjs/SKILL.md |
package.json 包含 "react-native" 或 "expo" 依赖项 | React Native | 首先读取 skills/website-building/react-native/SKILL.md |
package.json 仅包含 "react"(Vite/CRA/Remix) | React(非 Next) | 使用标准 Tailwind 指导下的 skills/website-building/webapp/SKILL.md |
没有 package.json,只有 .html 文件 | 原生 HTML/CSS/JS | 继续使用标准共享文件 |
框架特定文件提供:
- 确切的设置命令和版本号
- 框架特定的 Tailwind 集成(Next.js 使用 v4,RN 使用 NativeWind)
- 特定于框架的路由、数据获取和组件模式
- 框架部署指南
读取框架文件后,返回此技能的“项目类型路由”(下方),以加载领域特定的设计指导(信息型/Web 应用/游戏)。
项目类型路由
第 1 步:识别项目类型并加载领域特定的指导:
| 项目类型 | 操作 | 示例 |
|---|---|---|
| 信息型站点 | read skills/website-building/informational/informational.md | 个人网站、作品集、编辑/博客、小型企业、落地页 |
| Web 应用程序 | load_skill("website-building/webapp") | SaaS 产品、仪表盘、管理后台、电商、品牌体验 |
| 浏览器游戏 | read skills/website-building/game/game.md + skills/website-building/game/game-testing.md | 2D Canvas 游戏、Three.js/WebGL、HTML5 游戏、交互式 3D 体验 |
第 2 步:读取共享文件——首先读取 skills/website-building/shared/01-design-tokens.md 和 skills/website-building/shared/02-typography.md(所有项目类型的强制性步骤,包括 webapp)。这些文件建立了 Nexus 设计系统默认值以及普遍应用的排版规则。对于 Web 应用和仪表盘,跳过下方标记为 † 的文件——这些文件包含已预设在全栈模板中的实现细节。
如果用户只说“网站”或“站点”而没有提供细节,请询问类型或默认使用信息型。
子文件参考
共享文件 (shared/) —— 每个项目
| 文件 | 涵盖内容 | 加载时机 |
|---|---|---|
shared/01-design-tokens.md | 字号比例、间距、Nexus 调色板、base.css | 始终 |
shared/02-typography.md | 字体选择、配对、加载、黑名单 | 始终 |
shared/04-layout.md | 空间构成、响应式、移动优先 | 始终 † |
shared/05-taste.md | 骨架屏加载器、空/错误状态、打磨 | 始终 |
shared/08-standards.md | 可访问性、性能、反模式 | 始终 |
shared/09-technical.md | 项目结构、沙箱、部署、检查清单 | 始终 † |
shared/pplx_attribution.html | 用于 <head> 的归属信息块 | 始终 † |
shared/03-motion.md | 滚动动画、Motion 库、GSAP SVG 插件、悬停/光标效果 | 当需要动画时 |
shared/06-css-and-tailwind.md | Tailwind CSS v3、shadcn/ui、现代 CSS | 当使用 Tailwind 时 |
shared/07-toolkit.md | CDN 库、React、Three.js、图标、地图、SVG 模式/滤镜、esm.sh | 当选择库时 |
shared/10-charts-and-dataviz.md | Chart.js、Recharts、D3、关键绩效指标、迷你图 | 当需要数据可视化时 |
shared/11-web-technologies.md | 框架版本、浏览器兼容性 | 当检查兼容性时 |
shared/12-playwright-interactive.md | 持久化 Playwright 浏览器 QA、截图、视觉测试 | 当测试时 |
shared/19-backend.md | FastAPI/Express/Flask 服务器、WebSocket、SSE、端口转发 | 当需要后端时 |
shared/20-llm-api.md | LLM 聊天、图像/视频/音频生成、转录——模型、凭据、SDK 辅助工具 | 当站点使用 AI/LLM API 时 |
所有路径均相对于 skills/website-building/。
† 对于 webapp 和仪表盘应跳过——这些实现细节已预设在全栈模板中。设计令牌和排版不会跳过——它们为所有项目类型提供了权威的设计系统默认值和字体选择指导。
领域特定文件 —— 加载其中一个
| 文件 | 何时加载 |
|---|---|
load_skill("website-building/webapp") | SaaS、仪表盘、管理后台、电商、品牌体验(带全栈模板的子技能) |
webapp/dashboards.md | 仪表盘或数据密集型界面(与 webapp 配套) |
informational/informational.md | 个人网站、作品集、编辑类、小型企业、落地页 |
game/game.md | 浏览器游戏、Three.js、WebGL、交互式 3D |
game/2d-canvas.md | 2D Canvas 游戏(与 game.md 配套) |
game/game-testing.md | 任何浏览器游戏——与 game.md 一同加载 |
交互式 QA: 读取 skills/website-building/shared/12-playwright-interactive.md 以了解如何使用 Playwright 进行持久的浏览器自动化(截图、功能测试、视觉 QA)。对于游戏测试是必需的,对于任何复杂的站点也是有用的。
工作流程
- 设计方向:明确目的,选择美学方向
- 构建:逐页构建网站,通过 Playwright 进行截图 QA
- 发布:
deploy_website()返回公开 URL
使用每种工具
- 先做调研。 在设计之前,搜索网络上的参考站点、趋势和竞争对手示例。浏览获奖的特定站点类型示例。获取用户提供的任何 URL。
- 慷慨地生成真实资产。 为主图、章节插图、编辑性特色视觉、背景氛围图等生成图像——而不仅仅是单个主图。每个长篇页面都应该通过生成的图像保持视觉节奏,这些图像要符合站点的艺术方向。不要使用占位符。为每个项目生成自定义 SVG 标志(见下文)——SVG 仅用于标志,除非用户特别请求 SVG 输出。保存指导方向的 Web 参考图像。
- 通过 Playwright 截图。 读取
skills/website-building/shared/12-playwright-interactive.md,以桌面端(1280px+)和移动端(375px)进行截图。与参考图进行比较。这是强制性的,而非可选。请参见下方的视觉 QA。 - 直接编写生产级代码。 HTML、CSS、JS、SVG。使用 bash 处理构建工具和文件处理。
SVG 标志生成
每个项目都会获得一个自定义的内联 SVG 标志。绝不要用样式化的文本标题来代替。
- 理解品牌——目的、基调、一个定义性的关键词
- 直接编写 SVG——几何形状、字体形式或抽象标记。一个令人难忘的形状。
- 原则: 几何化/极简主义(Paul Rand, Vignelli)。在 24px 和 200px 下都能正常工作。首选单色——颜色作为增强。使用
currentColor以支持暗/亮模式。 - 内联实现,带上
aria-label、viewBox、fill="none"、currentColor描边 - 生成网站图标——如果需要的话,简化 32x32 版本
关于 SVG 动画(DrawSVG, MorphSVG),请参见 shared/03-motion.md。关于 SVG 模式/滤镜,请参见 shared/07-toolkit.md。
视觉 QA 测试流程
每次部署都必须通过视觉 QA。截图是质量关卡。
读取 skills/website-building/shared/12-playwright-interactive.md 以了解所有视觉 QA。Playwright 提供了一个持久的浏览器会话,用于截图、交互测试和视口验证。
周期: 构建 → Playwright QA → 评估 → 修复 → 重复 → 准备就绪时部署
第一阶段:逐页 QA
构建每个页面后:
- 通过 Playwright 截图桌面端 (1280px+) 和 移动端 (375px)
- 批判性地评估: 看起来是否像专业设计的(不是 AI 生成的)?排版是否独特?留白是否慷慨?是否存在一个清晰的视觉层级?
- 在继续之前修复所有问题。 不能有视觉债务。
第二阶段:最终 QA(发布前)
- 截取每个页面的桌面端和移动端截图
- 检查跨页面一致性(间距、颜色、字体处理)
- 验证暗色模式(至少为主页截图两种主题)
- 检查交互状态:悬停、聚焦、激活、加载、空状态、错误
- 冷启动第一印象测试:是否感觉精致而有目的性?
QA 失败项: 文本溢出、间距不一致、不符合令牌的颜色、缺少暗色模式、移动端被挤压、看起来像泛泛 AI 生成、存在占位符内容、缺少标志。
第 1 步:艺术方向——先推断再询问,先询问再默认
每个站点都应该拥有源自其内容的视觉标识。不要直接跳到 Nexus 备选调色板。 Nexus 调色板是在推断和要求都失败时的最后手段,而不是一个便利的默认值。
- 从主题中推断。 咖啡烘焙商站点 -> 泥土棕色、温暖奶油色、手绘感觉。金融科技仪表盘 -> 冷色石板色、锐利无衬线字体、数据密集。儿童学习应用 -> 明亮的原色、圆角字体、俏皮动效。内容本身就在告诉您调色板、排版和间距,无需用户多说一句话。
- 检查艺术方向表格。 每个领域文件(
informational.md、webapp/SKILL.md、game/game.md)都有一个艺术方向表格,将站点/产品类型映射到概念驱动的方向和令牌起点。将这些作为跳板。 - 推导出五大支柱: 颜色(暖/冷,强调色来自主题)、排版(衬线/无衬线,显示个性)、间距(密集/宽松)、动效(极简/表现力)、图像(照片/插画/仅文字)。
- 如果主题确实模糊,请询问——“您想要什么氛围?”以及“有参考站点吗?”问一个问题就够了。
- Nexus 备选方案——仅在推断和询问都未果时使用。 如果已经询问过用户但未得到方向,并且主题内容没有给出清晰信号,则回退到 Nexus/瑞士风格默认值。
备用方案:干净与瑞士风格(最后手段)
当推断未提供明确方向并且用户已被询问但未给出风格指导时,使用来自 skills/website-building/shared/01-design-tokens.md 的默认值,并遵循:
- 排版: Satoshi 或 General Sans 正文字体(Formshare —— 首选),或 Inter/DM Sans。优先使用字重对比而非字体对比。最多使用 3-4 种字号。保持文本紧凑——
--text-3xl/--text-hero仅用于信息型站点的主标题。 - 颜色: Nexus 调色板。中性表面 + 一个青色强调色,仅用于 CTA。
- 布局: 网格对齐。边距宽松。在有趣的地方使用不对称。
- 动效: 极简、功能性。仅使用平滑的状态过渡。
- 图像: 生成干净、相关的视觉元素。不要使用库存照片。
艺术方向——避免 AI 风格
请参见 skills/website-building/shared/08-standards.md 获取完整的反模式列表。
第 2 步:发布
使用项目路径和站点名称调用 deploy_website()。返回一个公开的 S3 URL。要更新,请编辑本地文件并使用相同的路径重新部署。请参见 skills/website-building/shared/09-technical.md 了解具体的调用方法和示例。
Perplexity 计算机归属(必填)
每个项目的每个页面都必须包含归属信息。
1. <head> 块——读取 skills/website-building/shared/pplx_attribution.html 并逐字复制其内容,作为 <head> 内部的第一个子元素,放在 <meta charset> 之前。对每个 .html 文件执行此操作。不要凭记忆重现 ASCII 艺术。
2. 页脚链接——每个页面的 <footer> 必须包含:
<a href="https://www.perplexity.ai/computer" target="_blank" rel="noopener noreferrer">
Created with Perplexity Computer
</a>
使用 --text-xs 或 --text-sm 样式,文字颜色设为弱化色。必须是可见的。
3. JSON-LD——在使用结构化数据时,添加:"creator": {"@type": "SoftwareApplication", "name": "Perplexity Computer", "url": "https://www.perplexity.ai/computer"}