跳到主要内容
Ed. notes

01 背景:为什么做这个站,以及不做什么

长文 · 2026-11-10 · 合集第 2 / 10 篇

  • 构建日志
  • 需求
  • 个人站
  • OpenSpec
第 2 / 10 篇 · 查看全部章节 → 当前:01 背景:为什么做这个站,以及不做什么

01 背景:为什么做这个站,以及不做什么

一句话结论:这个站不是为了「有个博客」,而是为了用一个真实项目,把前端工程、内容生产和 AI 能力串成一条能被验证的链路;需求阶段最重要的产出不是功能清单,而是一张明确的不做清单。

它解决什么问题

过去几年我一直在做前端,参与过一款 AI 助手产品的研发。大厂的项目分工很细,一个产品会被拆成很多环,每个人通常只守住其中一环:我主要做前端,对模型调用、上下文拼装和检索这些后端环节也有一些了解,但很少有机会从内容到回答完整地走一遍。在一段可以自己安排的时间里,我想把这条链路完整走一遍。

时间充裕是好事,也是麻烦。没有会议、没有排期、没有必须交付的 deadline,一天很容易被拆成很多个「等会儿再做」。我想把这段时间投到一件能留下痕迹的事情上,而不是让「参与过 AI 产品」最后只剩一句职责描述。

做前端时,我每天处理的是模型输出的最后一百毫秒:流式文字怎么出现、消息失败怎么重试、上下文太长时界面怎么表现。接口那侧的逻辑我知道个大概——请求发出去、检索命中一些片段、拼进上下文、再交给模型——但知道流程和真正跑通是两回事。现在,我想把这条链路完整走一遍。

完整走一遍需要一个真实载体——一个自己的站点、一批结构化的内容、一个能部署的服务。于是「做站」从目的变成了载体。

具体来说,它要解决四个问题。

第一,知识没有沉淀。 过去几年,我看过的工具、读过的仓库、踩过的坑,大多散落在浏览器书签、聊天记录和临时文件里。当时觉得记住了,三个月后只剩下一个模糊的关键词。我需要一个地方,强迫我把「用过」写成「说清楚」。

第二,工程能力没有公开载体。 工作中的项目大多不能公开,能讲的往往只有职责描述。但工程判断恰恰藏在细节里:为什么选这个框架、为什么不做某个功能、部署失败时先看哪里。这些东西需要一个自己的项目来承载,也需要一个能被别人直接打开看的入口。

第三,我需要一条完整的链路。 这种分工让人可以很专注,也容易让人只看到自己那一环:前端知道流式输出怎么渲染,后端知道检索和上下文怎么拼,但很少有人从内容生产、检索、模型调用到界面呈现全部负责一遍。我对每一环都有一些了解,缺的是把它们连起来、并对最终结果负责的经验。我需要一个自己的场景,完整走一遍。

第四,内容平台不属于自己。 把文章放在别人的平台上,迁移成本、排版限制和推荐机制都不由我控制。我想让内容以文件的形式留在 Git 里——换服务器只需要 clone,换框架也不会丢。

还有一层不太技术的原因:我希望别人了解我时,不用先相信我的一段自我介绍,可以先看作品。这个站会是我的个人品牌入口,但它首先是给我自己用的。

我怎么试的

我把第一个能上线的版本叫阶段 0。这一阶段没有业务代码,产出是 PRD、设计 brief、四份能力规格和一份任务清单。但「试」不只发生在写代码的时候。需求阶段我做了四件事,每一件都在给后面的实现减少不确定性。

1. 拆一个参考站,而不是找 inspiration

我选了 https://learn.datalumina.com/ 作为视觉参考。它和我的目标很像:内容优先、卡片网格、等宽小标签、亮暗主题,而且没有强烈的营销感。

我没有截图存灵感,而是把它的页面拆成了可以复用的数值:

维度 我记录的值 是否采用
顶栏 56px sticky,backdrop-blur,最大宽度 1400px 采用结构
内容宽度 首页/目录约 1024px,正文约 720px 采用
字体 Manrope + Geist Mono 采用
色彩 中性色 oklch,色相约 275;主色近黑 #0d1226 采用方向
卡片 rounded-2xl + 1px 边框,hover 边框变主色 采用
标签 10px 等宽大写,0.12em 字距的 pill 采用
详情页 左侧章节树 + 右侧 On this page 不采用

最后一行很重要。参考站是文档型产品,需要章节树;我的内容短、同质、数量多,更适合卡片目录。拆站的目的是把「感觉」翻译成可执行的约束,不是把别人的信息架构一起搬过来。「克制」不是形容词,它可以是 1px 边框、少量色相、默认不用阴影。

2. 先写验收标准,再写功能

PRD 里我没有先列「首页要有 Hero」,而是先写清楚读者是谁:同行、潜在的合作伙伴,以及三个月后的我自己。三类人共同的要求只有一条——十秒内知道这个人在做什么,点进一篇能看出他真的试过。

然后才是阶段 0 的验收线:

  • 上线时 6-8 篇笔记,每篇至少包含一个个人实验;
  • 四个核心页面可用:首页、目录、详情、关于;
  • Lighthouse 性能 ≥ 90,可访问性 ≥ 95,SEO ≥ 95;
  • 1440 / 1024 / 768 / 390 四个宽度无横向滚动;
  • CI 全绿,镜像可构建、可回滚;
  • 在新主机按 runbook 能完成一次迁移。

这些数字不一定完美,但它们让「做完了」有了定义。后来每加一个需求,我都会问一句:它对应哪条验收标准?如果对应不上,它就不该进阶段 0。这个问法挡掉了很多「顺手也做了吧」。

3. 把范围收口成一张不做清单

真正的需求文档,价值不在写了什么,而在敢删什么。

不做 原因 什么时候回来做
AI 助手 没有内容就没有 RAG 的语料 有 6-8 篇笔记之后
账号系统 公开内容不需要身份 出现跨设备保存需求时
站内搜索 内容量还撑不起搜索 我暂时定的阈值是 30 篇
作品集页 笔记详情本身就是作品 有 3 个可公开项目后
CMS / 数据库 内容即文件,Git 足够 有非技术作者加入时
Nginx 迁移 Caddy 自动 HTTPS,先上线 需要更细的缓存和日志控制时
评论 / 权限 / 多人协作 没有真实需求 有真实社区之后

我特意给每个「不做」写了回归条件。非目标不是「永远不做」,而是「这一阶段不做,并且我知道什么信号出现时再做」。这样既避免了范围膨胀,也不会把有价值的想法直接扔掉。

4. 把内容模型写成可校验的契约

站点最容易烂掉的地方不是页面,是内容质量参差。页面可以改,内容一旦积累了几十篇,风格和字段就很难统一。所以我在写第一行页面代码之前,先把 frontmatter 定死:

title: string # 必填
summary: string # 必填,一句话结论
type: tool | repo | experiment
date: YYYY-MM-DD # 必填
tags: string[] # 必填
series: string # 可选,例如 build-log
repo: string # 可选
website: string # 可选
draft: boolean # 可选,默认 false

计划中的构建流程会做三件事:必填字段缺失时构建失败并给出文件路径;日期格式不合法时失败;draft: true 的内容不出现在生产环境的目录、RSS 和系列视图里。把约束放在构建期,而不是靠发布前自觉,是我从「文档写得很全但没人执行」里学到的一点。

最后,我跑了一次规划校验:

$ openspec validate personal-site-foundation --strict
Change 'personal-site-foundation' is valid

这个命令只能证明结构完整、规格之间没有明显冲突。它证明不了想法是对的。真正验证需求的,是站点上线之后有没有人愿意读完第二篇——这件事只能等。

坑和限制

1. 文档齐全不等于项目成立。 PRD、设计 brief、规格、任务清单都写完,很容易产生「项目已经完成一半」的错觉。实际上代码一行没写,部署一次没跑。文档是承诺,不是进度。

2. 非目标最先被自己破坏。 搜索、评论、账号系统,都是那种「再加一点点」的功能。每一个单看都不贵,合起来就是几个周末和一堆维护面。不做清单必须写下来,因为脑子里的「暂不做」约等于「随时可以做」。

3. AI 生成的需求和设计有「完整感陷阱」。 让模型生成一份 PRD 或一套页面,几秒钟就能得到结构完整、措辞专业的结果。但那些决策不是你做的,你也说不清为什么选它。我的处理方式是:AI 只用来生成方向和备选,收敛必须落到 Figma 变量、设计 tokens 和可执行的验收标准上。

4. 内容同质化。 如果每篇笔记都是「它是什么、怎么安装、有什么特点」,那和 AI 摘要没有区别。我给自己的硬规则是:每篇至少有一个个人实验——一段能跑的代码、一张自己截的图,或者一段真实输出。没有实验就不发。

5. 流程会反噬。 一人项目最容易犯的错,是把流程做得比交付还重。所以文档保持一页以内,ADR 只记录关键选型,设计阶段时间盒 2-3 天。流程的目的是让决策可追溯,不是让每天多出几份要填的表。

6. 时间充裕本身也是陷阱。 没有外部 deadline 的时候,人很容易把时间花在工具链、配置和「再研究一下」上。写需求文档的一个副作用,是给自己造了一个可检查的进度条:任务清单上的复选框,比「今天感觉做了很多事」可靠。

适合谁

如果你是从「写页面」往「交付一个完整产品」走的前端,这个系列适合你。你会看到的不只是 Nuxt 和 SCSS 怎么写,还包括需求怎么收口、设计怎么落到 tokens、部署怎么留回滚路径,以及后面 AI 助手怎么接进来。

它也适合想给 AI 能力找真实落地场景的人。RAG、流式回答这些词已经被讲得很多,但真正难的是把它们放进一个有内容、有延迟、有错误处理的系统里。如果你也在分工很细的团队里做过 AI 产品,想找机会把内容、检索、模型和界面完整串一遍,这条路径会更贴切。

它还适合愿意用 Git 和 Markdown 管内容的人——你可能失去可视化编辑器,但会得到可版本化、可迁移、可备份的内容。

它不适合这几类人:只想尽快开一个博客的人,用现成模板或托管平台会快得多;需要可视化编辑和多人协作的团队,Markdown + Git 的流程会成为负担;把流量和变现放在第一位的人,这个站的结构不是为增长设计的;不愿意维护服务器和部署流程的人,Docker + Caddy 再简单,也仍然是一套需要照看的东西。

下一篇是 02 架构与选型:先把博客拆成内容、服务端、页面和构建四层,再说明 Nuxt、SCSS 与 Markdown 为什么合适。后面的 04–07 会分别进入这四层,给出可以直接对照仓库的代码。这个系列的进度和阅读顺序见 从0建小站 · 目录。