AI 与技术通识 · 个人知识站
第 10 课:建立内容更新与网站迭代系统
建立适合自己节奏的更新规则:用 MDX、Git、本地检查和自动部署发布真实内容,再依据可观察信号决定改页面还是加功能。
你现在真正要解决的问题
网站上线的当天往往最兴奋。几周后,一条过时的说明仍在首页,一个产品入口仍指向旧表单,文章之间的链接断了;同时你看到别人网站增加搜索、会员、AI 助手,于是也想加入。每个改变似乎不大,累计起来却让你越来越害怕打开项目。
维护系统不是制定一个必须日更的日历,也不是给网站持续加功能。它是一组低维护成本的重复动作:知道什么需要定期检查、一次更新从内容到公开页面经历哪些步骤、依据什么信号决定修改,以及出错后如何恢复。只要节奏现实、动作有记录,就能继续积累。
这一课完成后,你会得到什么
- 项目内一份
content-update-checklist.md,包含新增文章和更新页面两套操作。 - 每周/每月复查节奏,以及发生问题时的检查顺序。
- 一份内容、页面修订和新功能之间的优先级表。
- 一张“是否值得加功能”的决策图。
- 一次真实内容更新的本地检查、Git 版本记录与线上复核过程。
先看全局:一次内容更新怎样到读者手里
图里的“真实问题”可以是读者重复提问、你发现内容与现状不符、链接失效或文章结构不清。它不该只是“AI 推荐了一个新功能”。当证据显示读者在页面中找不到目标时,先调整标题和链接;只有内容和导航无法解决的问题,才进入功能评估。
| 任务类型 | 典型例子 | 优先判断 | 验收尺度 | 常见维护成本 |
|---|---|---|---|---|
| 内容更新 | 新文章、修正事实、补充一段方法 | 信息是否有证据、是否解决明确读者问题 | 读者能独立理解,来源与链接有效 | 编辑、事实核对、MDX 检查 |
| 页面修订 | 说明不清、链接失效、手机布局挤压 | 问题是否可在页面复现,影响哪个任务 | 测试读者能完成原本卡住的动作 | 文案核对、样式与设备检查 |
| 功能开发 | 搜索、账号、评论、数据库 | 内容/页面是否已不足以完成用户任务 | 有具体用户、数据、责任人和维护计划 | 安全、隐私、测试、服务成本、持续维护 |
固定每周发布次数不是质量标准。你可以设置自己能维持的低频节奏,例如每两周留出一次短检查、每月整理一篇真实内容;也可以按项目忙闲调整。不要为遵守日历而凑一篇没有依据的内容。定期维护侧重检查链接、联系流程、过时事实、构建和依赖更新;不必每天刷新每个页面。
贯穿案例推进:维护个人知识库与订阅站
案例网站已经有文章、专题、课程入口、联系说明和公开网址。上线后,创作者收到两次相似问题:“我应该从文章还是课程开始?”另一次自测发现专题页的第三条链接指向已改名的文章。一个朋友建议立刻增加站内搜索,但目前读者遇到的是入口说明不清和一条断链。更合适的顺序是修复链接、调整专题开头、观察问题是否仍然出现;是否需要搜索功能留到有更多内容和检索证据后再判断。
| 观察到的信号 | 可以做的低成本动作 | 暂时不要直接推断 |
|---|---|---|
| 多人反复问从哪里开始 | 检查首页主题入口、专题说明和课程先修关系 | “大家需要一套付费课” |
| 页面上链接 404 | 找出来源页面与正确目标,修复后公网直开测试 | “整个网站需要重做” |
| 产品说明收到范围问题 | 补充不包含项、申请步骤和响应责任 | “访客没买是按钮不够大” |
| 内容栏目出现交叉重复 | 合并栏目或重写定义,移动已存在文章 | “再新建两个分类就清楚” |
| 一位熟人说想要搜索框 | 记录情境、询问其怎样找内容、观察更多使用 | “必须马上写数据库搜索” |
案例在本课之前已上线,但没有复盘流程;本课建立后,作者能够从读者问题与构建证据选择小范围调整。换成自己的项目时,记录原话和页面位置,不记录未经允许的个人信息;没有足够样本时将其标记为“待观察”,而不是把单一意见写成普遍需求。
维护节奏:周检查与月整理
| 频率 | 用时目标 | 具体动作 | 通过后留下什么 |
|---|---|---|---|
| 每次改动 | 15—40 分钟视任务调整 | 只改一个目标;看 git diff;运行 lint/build;直开相关本地路径 | 变更说明和 commit |
| 每周或每两周 | 约 15 分钟 | 查看一次读者提问、过期链接或未完成发布任务;选择一个下一步 | 一条真实选题或明确“本周不改” |
| 每月 | 30—60 分钟 | 抽检首页、专题、产品入口、手机视口和部署记录;核实容易变的事实 | 已完成/待修复事项与负责人 |
| 每季度或项目节点 | 按需要安排 | 回看定位、栏目是否仍服务同一读者,评估项目范围是否变化 | 新的 Brief 或保持原方案的理由 |
每周、每月只是建议节拍,可以改成自己的节奏。若网站不是每日业务入口,低频而稳定比设一个做不到的日更承诺更好。必要的安全更新、联系方式失效或错误事实不等季度检查;看到明显问题就安排修复。
跟着做:完成一次可回看的网站更新
第一步:把变化写成一个小目标
**做什么:**把“完善网站”改成一条可观察任务,例如“专题入口的第二条链接在更新后返回 404,本轮只更新这个地址”。**为什么现在做:**范围越大,失败越难定位。**输入:**注明问题来源、目标读者、目标文件与完成证据。**正常结果:**一次更新只触碰能完成该目标的少数文件。**出错先检查:**目标如果同时包含改文案、换导航、增搜索,拆成独立任务。
第二步:新增或维护 MDX 内容
新增文章时复制第 7 课模板,检查 slug 不重复、状态正确、事实有材料;修订文章时只更改必要段落,必要时增加“修订日期”或在 Git 记录中写出修订原因。更新专题时检查成员路由仍有效,栏目或课程成员变化则检查系统数据配置。**正常结果:**内容正文、frontmatter 和内容索引表达同一状态。**出错先检查:**不要仅改文件名却忘记 slug、链接或课程清单;也不要将草稿正文留在 public/ 等静态目录。
第三步:本地运行和逐条检查
**做什么:**按项目脚本运行 npm run lint 和 npm run build,再在开发环境直开修改目标页面。**为什么现在做:**lint 与 build 分别提供代码规则检查和静态导出检查,但不替你验证阅读体验。**输入:**执行:
npm run lint
npm run build
git diff --check
git status --short
**正常结果:**脚本退出成功,变更文件均能解释,MDX 页面直接刷新可访问,链接到达预期位置。**出错先检查:**首先找首条报错;若只修改文章却触发构建错误,重点看 frontmatter、YAML 格式、重复 slug 和课程静态参数。
第四步:对照差异并留下版本记录
Git commit 是对一组文件变化的命名记录,便于查看“哪次修改改变了什么”。运行 git diff 阅读实际差异,若内容或代码不属于本轮,先撤出暂存范围。确认以后,按仓库规则提交清楚的说明;课程项目可使用 git add {本轮文件}、git commit -m "Update knowledge article links",具体文件名换成你检查过的真实路径。不要让 AI 自动提交未审阅的大范围修改。
正常结果:git log -1 --oneline 显示这次更新,工作区状态可解释。**出错先检查:**Git 未配置姓名邮箱时仅为当前仓库设置;误将 secret 加入暂存区时先移出暂存并检查 .gitignore;不确定哪些文件时不要用 git add .。
第五步:发布、检查并关闭任务
GitHub/Cloudflare Pages 已连接时,推送会触发部署。等日志显示本次 commit 构建完成,再打开外网对应 URL,确认文字、页面资源和相关链接已更新。**正常结果:**线上页面内容与本次提交一致;部署记录可以对应 commit。**出错先检查:**Pages 显示的提交是否包含本次改动,构建命令有没有通过,页面是否被缓存或你是否打开旧地址;不用在本地重新改一次来掩盖线上版本差异。
“要不要加这个功能”的决策图
该不该加功能的操作判断
先问问题是否重复出现,并记录来源;再问当前内容或页面能否解决。如果能,先用最小修订观察。如果不能,确认真实用户、任务、信息类型、数据责任、维护成本、无障碍和验收条件;无法说明谁会维护或如何测试,就暂缓。看到竞品有搜索不代表自己内容量已需要搜索;AI 提出的“最好加会员系统”不构成需求证据。功能决策不是永久否决,而是保留线索、等真实信号出现再评估。
可直接复制的发布前检查表
保存成 content-update-checklist.md,按每次项目任务适当删改:
# 内容与网站更新前检查
- [ ] 变更解决一个真实问题,并有来源记录。
- [ ] 正文事实与证据一致;AI 没有补造经历、数字、评价或结论。
- [ ] MDX frontmatter 必填字段正确,slug 无重复,草稿没有误发布。
- [ ] 专题、课程、首页或 CTA 中受影响的内部链接已直接打开。
- [ ] npm run lint 通过。
- [ ] npm run build 通过,目标路由出现在构建结果中。
- [ ] git diff --check 无空白错误;diff 只含本轮需要文件。
- [ ] Git 提交说明能描述这轮具体变化;没有密钥或私人文件。
- [ ] 部署关联本次 commit,公开地址检查通过。
- [ ] 记录未通过项、负责人和下次检查时间;不把未验证写成已通过。
AI 协助整理内容的 Prompt
你是我的内容编辑协作者。严格遵循项目规则、本轮用户提供的真实材料与现有栏目规范。
本轮任务:根据下方材料,整理/校对一篇 MDX 内容。不得修改其他页面或栏目。
材料来源:{我的草稿、记录或可核实来源}
读者问题:{具体问题}
目标路径:{现有栏目 / 专题}
事实边界:{不能声称的经历、数据、结果、授权}
先只读并给我:
1. 可直接保留的事实句及其材料出处;
2. 哪些句子是我的解释、哪些尚未证实;
3. 与已有文章重复或互补的部分;
4. frontmatter 必填项和需要我补充的空缺。
我确认后,才生成正文建议。不能自行补全未经提供的客户、收益、用户反馈、资历、法律意见或事件细节;有信息缺口时保留问题并询问。不得新增技术依赖或改动代码。最后列出建议改动段落、事实核验项、MDX 检查命令和未解决事项。不要宣称命令已运行,除非确实运行并给出原始结果。
第一段定义角色和证据边界;任务字段限制修改范围;材料来源区分事实和推断;先只读输出让作者先审查证据;确认后才生成减少大段返工;禁止编造仍要与人工核验配套;最后的检查命令指导操作,但提示模型不能谎称已执行。把一份提示词存进项目也不能取代文章发布前校对。
你现在应该看到什么
项目里有一个读者能理解的更新 checklist;你能展示一条最近的真实内容改动、干净可解释的 Git 记录、成功的本地构建以及已更新的公开页面。若当前没有可公开的新事实,就选一处真实链接或过时说明修复并留下记录,不要编一篇“案例”凑更新次数。
本课任务与提交物
- 新建
content-update-checklist.md,含“新增文章、修订页面、发布复核、故障处理”步骤。 - 写出你可维持的周/双周节奏与月度检查时间;至少列出每类要看什么、由谁负责。
- 从真实内容或链接问题中选一个,完成一次改动并保留材料来源。
- 执行 lint、build、差异检查;核对关联的专题、课程和 CTA。
- 查看 diff 后建立一次本地 Git commit;按第 9 课真实流程推送后确认 Cloudflare 部署 commit 与公开内容一致。
- 建一份功能决策表,记录至少三个建议或想法,写明证据、是否调整内容即可解决、风险、负责人和重评时间。
可验收结果包含 checklist、更新节奏、一次真实版本记录、线上确认和功能决策表。若推送或部署被账号/网络阻断,保留命令输出或平台提示作为阻塞记录,不能把本地构建说成线上更新完成。
自检清单
- 节奏基于个人真实时间,不依赖日更或虚假数量目标。
- 一次改动有具体信号、目标文件、验收动作和事实来源。
- MDX、链接、专栏关系和产品说明在修改后重新检查。
- lint、build、差异检查结果如实记录,失败有后续动作。
- Git 记录对应实际差异,发布状态与公开页面相符。
- 新功能由反复任务和可验证需要驱动,有负责人和维护边界。
常见翻车点
- **把更新频率当作内容目标。**为日更发布同义句或无事实支撑内容;降低频率,回到有依据的读者问题。
- **只看 GitHub 已有 commit,不看 Pages 部署状态。**打开 Pages 看当前生产 commit 和公开地址,不要仅凭推送成功认定网站已更新。
- **AI 校稿把“可能”改成“确定”。**逐句对照原始材料,恢复不确定性,删除无法证明的结论。
- **文章改名后旧链接仍四处存在。**搜索旧 slug,检查专题、课程、首页和站点地图;只有确认所有入口后再关旧页面。
- **发布前只跑 lint。**lint 不保证 MDX 编译和静态参数正确,按项目脚本执行 build 并直开路由。
- **一条反馈引发一次架构重写。**先记录情境、复现问题、用小改动验证;功能需求经过决策树和 Brief 再开发。
- **一次更新改太多文件,无法恢复。**切成几个目标并逐个检查 commit;撤销前弄清未提交工作,避免误删其他内容。
下一课会怎么用到今天的成果
第 11 课会带你判断哪些内容组织、项目 Brief、静态发布和更新经验能迁移到其他网站,哪些新项目必须重新做用户任务、交易方式和风险判断。今天的 checklist 与 Git 记录将作为毕业验收证据。
本课技术依据
- Next.js Static Exports:确认构建命令、静态页面输出和服务器能力边界。
- Git 官方用户手册:核对变更暂存、提交、查看历史和恢复版本的基本概念;命令以当前仓库工作流为准。