AI 与技术通识 · 个人知识站
第 6 课:先做出首页,让别人一眼看懂你是谁
把定位、内容地图、承接路径和页面 Brief 变成一个可以本地打开、电脑与手机都能检查的首页初版。
你现在真正要解决的问题
项目已经启动,资料也能被 TRAE 找到。你打开模板首页,脑中冒出几十种想放的内容:自我介绍、所有文章、学习经历、课程、产品、社群、合作方式。若把它们平铺上去,首屏就像一块公告栏;若只追求“大图、渐变、动画”,访客依然可能看不懂这个网站讲什么。
首页第一版的目标很具体:第一次进入的人能知道这个站为谁整理什么,能找到一个适合开始的主题,也能明白下一步是什么。本课只修改 src/app/page.tsx 和必要的首页样式/布局设置,不做文章系统、课程系统、支付、会员、数据库、搜索或复杂动效。结束时要用本地浏览器打开页面,在桌面和手机宽度实际检查并保存截图。
这一课完成后,你会得到什么
- 一个本地可访问的首页初版,而不是静态设计稿。
- 一份首页组件/区块清单和可替换的文案对象。
- 一个与
conversion-path.md相符的主要行动入口。 - 两张实际浏览器检查截图:桌面视口与 390 CSS 像素左右的手机视口。
- 一份能让测试读者复述网站用途的验收记录。
先看全局:首页的信息先后关系
SVG 表示内容优先级,不是强制视觉模板。导航帮助找到栏目;首屏用一句主张和简短说明回答网站用途;主题入口让访客选从哪里读起;可信说明交代内容来源和边界;主要行动与前一课承接路径一致;页脚放次要信息。屏幕越窄,区块纵向排列,而不是把所有内容挤在一行。
| 访客的第一问题 | 首页回答 | 下一步动作 |
|---|---|---|
| 这是什么网站? | 一句主张说明主要读者和内容主题 | 继续看首屏说明 |
| 我应该先看什么? | 2—4 个读者能看懂的主题入口 | 选一个主题或代表内容 |
| 为什么这些内容值得参考? | 说明内容基于什么材料、哪些仍是个人判断 | 查看具体内容和证据 |
| 我想持续关注或了解产品怎么办? | 按 conversion-path.md 写清实际可用入口及点击后的流程 | 订阅、了解、联系,或继续阅读 |
贯穿案例推进:把前几课的文件变成首屏信息
本课程的贯穿案例仍是一个个人知识库与订阅站。前五课里,创作者已整理读者定位、栏目关系、承接动作和页面 Brief;现在不是重新想一套品牌,而是从这些文件中选首页确实需要的信息。若示例创作者的主题是“把长期积累的学习笔记整理成可查找的知识”,首屏就要写清这是给谁用、访客能从哪些主题开始,不要无依据添加“行业专家”“帮助上万人”等身份或成绩。
实际取材时,site-positioning-card.md 提供读者、主题与内容承诺;content-map.md 提供栏目名称与代表性内容;conversion-path.md 提供唯一主要行动及实际流程;site-brief.md 提供页面顺序、设计方向和手机验收。若四份资料说法冲突,先暂停并修正文档,不能叫 AI 在代码里挑一个看起来顺的版本。
首页从杂乱到清楚
| 容易变成杂乱公告栏 | 聚焦的首页初版 |
|---|---|
| 首屏并排放个人履历、所有栏目、订阅、课程、咨询和合作按钮 | 首屏只回答网站为谁整理什么,并提供一个符合承接路径的主动作 |
| 所有文章都混在首页,标题没有分组 | 先列 2—4 个稳定栏目,再给代表内容或后续入口 |
| 用“影响力、赋能、改变人生”替代具体主题 | 用读者能识别的任务、主题和内容形式说明价值 |
| 首屏放未经确认的客户数、收益、评价和媒体徽章 | 写真实的内容来源、实践范围和尚未验证的部分 |
| 手机端沿用桌面双栏缩小字号 | 区块在窄屏改为单列、保持字号可读、按钮不互相挤压 |
首页第一版先不要放:一大段完整个人传记、所有文章原文、尚不存在的课程/产品页入口、自动播放视频、客户评价墙、付费倒计时、复杂动画、登录注册入口、后台指标和“联系我们/立即购买/订阅”同时抢主位的按钮组合。以后有证据显示读者确实需要,再按 Brief 增加。
跟着做:先理解,再实现,再检查
第一步:从四份资料提取首页文案
**做什么:**复制定位句、栏目名、代表内容和主要行动到一份临时首页文案草稿。**为什么现在做:**避免在 JSX 里边写边编。**输入或修改:**每条标记来源文件;若缺少真实内容,用“待填写”而非 AI 虚构。**正常结果:**首屏一条主张、一段说明、一个 CTA;内容入口不超过四个;信任说明不超过一小段。**出错先检查:**如果首屏需要超过两个长段落才解释清楚,先修定位句;如果 CTA 不符合 conversion-path.md,先核对承接,不要在页面临时加功能。
第二步:让 AI 只读并复述首页需求
把四份文件和项目规则以 #File 附加到 TRAE。先让它输出首屏、主题入口、信任说明、主要行动、页脚的组件树和每块文案来源,明确禁止写代码。检查组件树没有文章详情、课程系统或支付逻辑后,再确认进入实现。
第三步:先实现首屏,再补主题和说明区
**做什么:**一轮只实现首屏区块,运行后再让 AI 增加主题卡片,最后增加说明、行动和页脚。**为什么现在做:**能尽早确认最大的信息主张是否清楚。**输入:**本课下方的 Prompt,设置“当前阶段”字段;每阶段明确 src/app/page.tsx 为目标文件。**正常结果:**每次只出现一类新增区域,页面仍可启动。**出错先检查:**新增了没在 Brief 里的文件时先看差异,不要默认所有新增都是必要的;出现 TypeScript 错误先让 AI 解释具体文件和行号,再允许最小修复。
第四步:用当前真实项目栈实现页面
在 Next.js App Router 里,src/app/page.tsx 默认对应根路径 /。页面中的 React 组件是可组合的界面函数;这里先把 header、section、article、footer 写在单个页面组件里,避免初学者一开始就拆十几个文件。TypeScript 负责类型检查,Metadata 提供标题和摘要。文案先放在页面顶部的 site 常量中,确认内容以后再由 AI 将它提取成数据文件。
先将下面示例替换成定位卡里的真实文案,再保存为 src/app/page.tsx。样例品牌文字只是可替换内容,不是 LUPY 用户经历或效果声明。
import type { Metadata } from "next";
const site = {
name: "我的知识站",
headline: "把零散笔记整理成能持续深入的知识",
intro: "面向正在积累专业知识、却难以组织文章与学习路径的读者。",
actionLabel: "从主题内容开始",
topics: [
{ title: "观点与方法", text: "记录我对一个问题的判断、依据和适用边界。" },
{ title: "专题整理", text: "把围绕同一问题的文章组织在一起,方便继续阅读。" },
{ title: "学习路径", text: "主题成熟后,再按目标和练习整理成系统内容。" },
],
about: "本站内容来自作者愿意公开的学习、项目和整理过程;未核实的信息会标注,内容不承诺收入或特定结果。",
contactNote: "订阅与产品入口按实际准备状态开放;目前可以先从上方主题开始阅读。",
};
export const metadata: Metadata = {
title: site.name,
description: site.intro,
};
export default function HomePage() {
return (
<main id="top" className="min-h-screen bg-stone-50 text-slate-900">
<header className="border-b border-stone-200">
<div className="mx-auto flex max-w-6xl flex-col gap-4 px-5 py-5 sm:flex-row sm:items-center sm:justify-between">
<a href="#top" className="text-lg font-semibold">{site.name}</a>
<nav aria-label="主导航" className="flex flex-wrap gap-x-5 gap-y-2 text-sm">
<a className="underline-offset-4 hover:underline focus-visible:outline-2" href="#topics">主题内容</a>
<a className="underline-offset-4 hover:underline focus-visible:outline-2" href="#about">内容说明</a>
<a className="underline-offset-4 hover:underline focus-visible:outline-2" href="#contact">下一步</a>
</nav>
</div>
</header>
<section aria-labelledby="home-title" className="mx-auto grid max-w-6xl gap-10 px-5 py-16 sm:py-24 lg:grid-cols-[1.1fr_0.9fr] lg:items-center">
<div>
<p className="text-sm font-semibold tracking-wide text-emerald-800">个人知识库 · 持续整理中</p>
<h1 id="home-title" className="mt-4 max-w-3xl text-4xl font-semibold leading-tight sm:text-5xl">{site.headline}</h1>
<p className="mt-6 max-w-2xl text-lg leading-8 text-slate-700">{site.intro}</p>
<a className="mt-8 inline-flex min-h-11 items-center rounded-full bg-emerald-900 px-6 py-3 font-medium text-white hover:bg-emerald-800 focus-visible:outline-2 focus-visible:outline-offset-4" href="#topics">{site.actionLabel}</a>
</div>
<aside className="rounded-3xl border border-stone-200 bg-white p-7 shadow-sm">
<p className="text-sm font-semibold text-emerald-900">这里可以找到</p>
<p className="mt-3 text-xl leading-8">围绕一个主题逐步增加的观点、专题与学习材料。</p>
<p className="mt-4 text-sm leading-7 text-slate-600">内容会按真实完成状态更新;尚未准备好的产品或订阅入口不会显示成已开放服务。</p>
</aside>
</section>
<section id="topics" aria-labelledby="topics-title" className="bg-white py-16 sm:py-20">
<div className="mx-auto max-w-6xl px-5">
<p className="text-sm font-semibold text-emerald-800">从这里开始</p>
<h2 id="topics-title" className="mt-2 text-3xl font-semibold">按你现在的问题选择主题</h2>
<div className="mt-8 grid gap-5 sm:grid-cols-2 lg:grid-cols-3">
{site.topics.map((topic) => (
<article key={topic.title} className="rounded-2xl border border-stone-200 p-6">
<h3 className="text-xl font-semibold">{topic.title}</h3>
<p className="mt-3 leading-7 text-slate-700">{topic.text}</p>
</article>
))}
</div>
</div>
</section>
<section id="about" aria-labelledby="about-title" className="mx-auto max-w-6xl px-5 py-16 sm:py-20">
<h2 id="about-title" className="text-2xl font-semibold">内容从哪里来</h2>
<p className="mt-4 max-w-3xl leading-8 text-slate-700">{site.about}</p>
</section>
<section id="contact" aria-labelledby="contact-title" className="border-t border-stone-200 bg-stone-100">
<div className="mx-auto max-w-6xl px-5 py-12">
<h2 id="contact-title" className="text-lg font-semibold">接下来</h2>
<p className="mt-3 max-w-3xl leading-7 text-slate-700">{site.contactNote}</p>
</div>
</section>
<footer className="border-t border-stone-200 px-5 py-6 text-sm text-slate-600">
<div className="mx-auto flex max-w-6xl flex-col gap-2 sm:flex-row sm:justify-between">
<span>{site.name}</span><a className="underline-offset-4 hover:underline focus-visible:outline-2" href="#top">回到顶部</a>
</div>
</footer>
</main>
);
}
代码里的关键部分:site 集中保存可替换文案和主题数据,让内容不会散在十几处;metadata 控制浏览器标签和页面摘要;HomePage 返回首页结构;site.topics.map 根据数据生成同样格式的栏目卡;href="#topics" 等锚点跳到同页已有区块,不是假装文章详情或订阅接口已经存在;Tailwind 类控制留白、颜色和排版;sm: 与 lg: 是从窄屏到较宽屏逐渐调整布局的断点。src/app/layout.tsx 是包住所有页面的外层,需将 <html lang="en"> 改成 <html lang="zh-CN">,并保留已有 children 与全局 CSS 导入。若生成器默认引入 next/font/google,离线构建可能取不到远程字体;此时改用系统字体栈,避免首页运行依赖 Google Fonts。
这段是一个最小完整的 Next.js 页面示例。正常结果是根路径 / 显示导航、主张、主题卡、内容说明、下一步说明和页脚。若报 TypeScript 错误,先检查花括号、中文引号是否误换成弯引号、metadata 是否拼对、topics 每项是否有相同字段;若 Tailwind 类没有效果,检查 globals.css 是否仍导入 Tailwind 以及项目是否在根目录启动。
可复制 Prompt:让 TRAE 分阶段实现首页
先把四份资料、项目规则和 package.json 附加为上下文。每次只修改 {本轮阶段} 一项;首轮先设为“只读理解”,后续阶段在检查上一步后手动改值再发送。
你是这个个人知识库与订阅站项目的 AI Coding 协作者。严格遵循附加的项目规则与资料。
项目事实:Next.js App Router、TypeScript、Tailwind CSS、MDX、npm;首页路由是 src/app/page.tsx。
本轮阶段:{只读理解 / 生成组件结构 / 实现首屏 / 增加主题入口 / 增加说明与页脚 / 检查响应式和可访问性}
上下文来源:
- site-positioning-card.md:决定服务谁和首页主张。
- content-map.md:决定主题入口,不得把计划内容写成已发布。
- conversion-path.md:决定主要行动和点击后的真实流程。
- site-brief.md:决定页面优先级、设计方向、边界和验收。
阶段规则:
1. 若本轮是“只读理解”,只复述读者、主题、栏目、主要行动、第一版边界及对应来源;指出冲突;不要修改文件。
2. 若本轮是“生成组件结构”,只给出首页区块顺序、文案来源和每区块一个任务;列出拟修改文件并等待我确认。
3. 若本轮是实现阶段,只实现当前阶段,不顺手增加其他区块或页面;优先只改 src/app/page.tsx,布局语言仅在需要时改 src/app/layout.tsx。
4. 如果内容或行动入口尚未真实准备好,显示诚实说明或暂不展示,不生成假文章、订阅表单、联系地址、成果、用户评价或购买功能。
5. 使用语义化 HTML、适合键盘的链接、清晰标题层级;保留现有 Next.js、TypeScript 与 Tailwind 结构,不添加依赖和复杂动画。
6. 完成后报告改动文件、运行的命令及原始结果、未解决问题;没有实际运行就标记未验证。
当前目标:做出一个让首次访客看懂“你是谁、网站讲什么、先看什么、下一步能做什么”的首页初版。不得实现文章详情系统、课程系统、会员、支付、数据库、搜索或部署。
段落解释:第一段把 AI 定为协作伙伴,不把最终判断交出去;项目事实让它遵守当前仓库而非通用模板;本轮阶段让你明确当前只做哪一个小步骤;资料来源规定每份文件的用途;阶段规则按理解、结构、分区实现和检查逐步推进;事实边界防止 AI 补造内容或开放不存在的入口;验收报告让你看到实际变更和真实命令结果。完成“只读理解”后你审阅复述,再发“生成组件结构”;确认结构后才开始改首屏。
电脑和手机宽度下检查
- 确认 TRAE 终端的
npm run dev仍在运行,并用终端显示的本地地址打开页面。 - 桌面视口先用实际浏览器窗口检查:导航是否完整、首屏标题是否清楚、主按钮是否可用、下方主题入口是否能找到。保存一张真实浏览器截图到
docs/evidence/home-desktop.png。 - Chrome 中打开开发者工具,使用设备工具栏的 Responsive 模式,将宽度设为 390、高度设为 844 CSS 像素;滚动检查导航、标题、卡片、按钮和页脚。DevTools 的截图菜单可保存当前视口或整页截图,保存为
docs/evidence/home-mobile.png。 - 回到 360—390 像素范围,检查页面没有非预期横向滚动;文字没有被裁切;卡片变为一列或易读的窄布局;链接与按钮有足够间距;键盘 Tab 能看到焦点提示。
- 截图必须来自本地实际运行的浏览器,保留它们作为验收证据;课程示意 SVG 和代码块不是网站截图。
Device Mode 是桌面浏览器中的手机视口模拟,不等同于真实手机的处理器、触控和网络体验。课程要求的截图先使用它完成一致尺寸检查;有真实手机时,再实际打开本机网络可访问的开发地址补测一次。
如何识别“看起来高级却没重点”
请把首页给一个不熟悉项目的人看 5—10 秒,然后隐藏页面问四个问题:“这是什么网站?”“主要给谁看?”“你觉得这里能读到什么?”“你会点哪里,点了会发生什么?”不要先替他解释。若回答停留在颜色、图片或“看起来像个人主页”,首页的信息优先级还不清楚。
找三位可能符合定位卡的读者,记录他们的原话、卡住的位置和点击路径。测试读者只需要完成复述与寻找动作,不要问“你喜欢这个设计吗”后把礼貌评价当需求证据。反馈若集中在某句看不懂,先改文案;若找不到主题,再调整导航与区块;若点击后没有真实承接,修复或关闭入口。不要立刻用增加动画和新页面应对。
本课任务与提交物
src/app/page.tsx:本地首页初版,含导航、首屏主张、主题入口、内容/信任说明、一个主要行动、基础页脚。docs/homepage-components.md:首页区块清单,每块写目的、文案来源和一个主要动作。docs/homepage-copy.md:保存最终首屏主张、说明、栏目文案、CTA 及事实来源。docs/evidence/home-desktop.png与docs/evidence/home-mobile.png:分别来自真实浏览器桌面与手机视口的检查截图。docs/homepage-checklist.md:按下方清单记录通过、未通过和待调整项。
验收动作:在本地浏览器打开首页;把首屏给测试读者短暂查看后询问上面四个问题;自己点一次主要行动并确认落点真实存在;在桌面和窄屏截图。只有这四类检查都能留下证据,才算本课完成。
首页验收清单
- 首屏一句话说明主题或读者,不使用空泛头衔替代内容定位。
- 首屏说明与
site-positioning-card.md一致,且没有捏造经验、用户结果或数据。 - 首页有清楚的导航和 2—4 个内容入口,名称对应
content-map.md。 - 首页有一段简短的内容来源/边界说明。
- 主要行动只有一个视觉主位,与
conversion-path.md的实际承接一致。 - 不存在指向空白页面的按钮、假表单或尚未开放的产品承诺。
- HTML 有一个主要
h1,区块标题顺序清楚,导航具备可访问名称。 - 键盘 Tab 可定位链接,焦点可见,链接文字表达去向。
- 360—390 像素视口下无非预期横向滚动、文字裁切或按钮重叠。
- 已保存真实桌面与手机视口截图,并记录测试读者的复述结果。
- AI 改动已检查差异,
npm run lint(若 package.json 存在该脚本)和npm run build的输出如实记录;命令未跑则明确写未验证。
常见翻车点
- **首屏把定位卡整段复制上去。**定位卡是工作依据,不是整块网页文案。保留读者、主题和具体帮助,删掉解释给自己的备注。
- **导航放了所有未来页面。**计划中有课程或产品不代表它已存在。当前只链接真实区块与有效路径;未做页面先不出现在导航。
- **三四个按钮争主位。**回到承接路径只保留一个首要行动;其他导航链接保持次级,不要增加多组催促 CTA。
- **卡片漂亮但没有读者入口。**每个主题卡至少说明它回答什么问题;若内容尚未发布,用栏目介绍,不伪造文章摘要或“阅读全文”链接。
- **只在桌面看一眼就说响应式完成。**390px 下仍可能横向溢出、文本过密。实际设定视口、上下滚动并保存证据。
- **AI 报 build 通过,就把它当作视觉验收。**构建只说明代码通过构建过程,不说明读者看懂或链接有效;浏览器和测试读者检查仍要做。
下一课会怎么用到今天的成果
第 7 课会用 content-map.md 和今天的主题入口建立文章、专题与系统课程之间的真实索引。首页会从“栏目介绍”逐渐升级为能链接到具体内容的入口;如果正文尚未完成,仍按状态诚实显示,而不是生成占位内容。
本课技术依据
- Next.js 官方 Installation 文档:支持
src/app/page.tsx根页面、layout.tsx外框、TypeScript、Tailwind 与本地开发服务器说明。 - Next.js 官方 CSS 文档:支持 App Router 页面中使用 Tailwind 与全局 CSS 的方式。
- Chrome DevTools 官方 Device Mode 文档:核对响应式视口设置、390px 检查尺寸与实际截图入口;文档同时说明模拟环境不是实际移动设备。