这篇写给「想让博客稳定更新、但不想每天靠意志力挤时间」的独立开发者:把「写文章」这件主观的事拆成几段有明确判据的环节,让机器在每一步替你说不。只想找现成提示词的人可以跳过;被「定时任务重复发布」「本地生成网页报成功、线上还是旧内容」咬过的,直接看第 5 节和第 7 节。
下表按角色列出你能带走什么、从哪节开始读:
| 读者 | 带走什么 | 从哪节开始读 |
|---|---|---|
| 想让博客稳定更新的独立开发者 | 六环节流水线图 + 18 项检查清单 | 1 |
| 用模型写文章、质量不稳的人 | 把写作要求分档成判据的方法 | 4 |
| 要把内容同步到多个平台、又不想重复发布的人 | 幂等(同一天只发一次)、双表写入(一篇文章写两个库)、并发锁 | 5 |
每天发一篇文章,看起来只是「写」的问题。真跑起来麻烦全在写作之外:同一天被触发两次要不要重发、素材太薄该不该硬写、检查说通过可正文少了一整节、本地生成网页成功、浏览器里还是昨天的页面(构建 = 在本地把文章生成成静态网页)。
本文把这条链拆成六个环节,每个环节给一条能机械判断的界线。读完你能带走三样:一张能照着补的流水线图、一份 18 项检查清单、三条防止「重复发布」「线上没变」「旧链接不消失」的判据。
下面这张表说明每节讲什么、对应哪个环节:
| 小节 | 讲什么 | 得到什么 |
|---|---|---|
| 1 | 六个环节的全貌 | 知道要过哪几关 |
| 2 | 素材采集与「今天该不该发」 | 一条判空规则 |
| 3 | 写作模板里写什么 | 负向约束的写法 |
| 4 | 18 项自动检查 | 可抄的检查清单 |
| 5 | 一天最多跑三次怎么不重发 | 幂等判据 |
| 6 | 为什么往两张表写 | 两处读取的对照 |
| 7 | 发布链路上的五次校验 | 五步各挡什么 |
| 8 | 一条内容出三处 | 三个分发细节 |
| 9 | 每周回顾做什么 | 选题池 + 健康检查 |
| 10 | 这套做法做不到什么 | 边界与下一步 |
每节只讲一个环节。先知道一共几关、自己在第几关,后面才不会混用判据。
一条内容从「这几天做了什么」到「读者在三个平台看到」,中间是这个形状:
定时触发(9:00 / 14:00 各生成一次 → 9:35 / 14:35 落库发布 → 9:50 / 14:50 兜底重跑)
│
├─ ① 采集素材 版本库提交 + 笔记改动 + 任务记录 → 素材包(末行带统计)
├─ ② 写作 素材包 + 写作模板 → 1~5 篇 markdown(纯文本格式)
├─ ③ 检查 18 项规则 → 有硬失败就退回重写,非 0 退出码不落库
├─ ④ 落库 同一份文档写两张表(构建读一张、线上读一张)
├─ ⑤ 发布 构建 → 站点检查 → 上传 → 完整性校验 → 强制覆盖 → 刷缓存
└─ ⑥ 分发 同一批文章同步到两个第三方平台(带引流段与绝对链接)
每周一 10:00 ← 反向补输入:读最近 7 天产物 → 选题池 + 健康检查 + 重复辨伪
图里的「落库」指把文章写进数据库,之后的页面都用这份数据。下面两处设计容易被忽略。一条是生成与发布拆开:9:00 那次只打印标题清单等确认,9:35 才落库发布——标题不对就删文件,此时库里线上都还没有东西。另一条是14:50 的兜底任务(前面那次失败时补跑):若 14:35 那次失败就换模型重跑,先查「今天发过没有」。三个任务靠第 5 节那条判据对齐。
这一节解决「今天写什么」。素材靠回忆的话,没东西可写的那天就会变成凑字数,而凑字数的文章比不发更糟——它稀释整站可信度。
素材来自三处:版本库(git)提交、笔记目录改动、任务记录文件。在仓库根装好依赖(Node 18 及以上)后,下面这条命令把它们收进一个 markdown 包:
npm install # 只需一次
# 采集最近 7 天的素材;末行会打印一行 MATERIAL 统计
node scripts/collect-daily-material.cjs --days 7 --out .tmp/daily-material.md
素材包给人看,但调度脚本要判「今天有没有东西可写」,所以末行固定打印一行机器可读统计。下面这段解析这一行,缺字段即视为采集失败:
// 末行形如:MATERIAL commits=12 notes=3 issues=2 chars=18400
function readMaterialStats(output) {
const line = output.split('\n').filter((row) => row.startsWith('MATERIAL ')).pop();
if (!line) return { ok: false, reason: '没有统计行,采集脚本可能没跑到最后' };
const stat = (key) => Number((line.match(new RegExp(`${key}=(\\d+)`)) || [])[1] || 0);
const [commits, notes, chars] = ['commits', 'notes', 'chars'].map(stat);
// 宁可不发,也不要为发而发
if (chars < 500 || (commits === 0 && notes === 0)) {
return { ok: false, reason: `素材不足 chars=${chars}` };
}
return { ok: true, commits, notes, chars };
}
两条界线值得抄走:字符数低于 500 直接放弃,提交数与笔记数同时为 0 直接放弃。后一条挡的是「一条素材都没有」的日子;前一条挡的是「有提交、但全是改错别字」的日子。
让模型写文章常犯三件事:默认写给同行、篇幅忽长忽短、把内部过程与任务编号带进正文。写作模板分五块(读者假设、开头三问、主题聚合、结构与篇幅、74 条自检加 38 个换位审核问题——都是给模型的自检清单,本文不展开),真正起作用的是两类。
第一类是读者假设:明写「假设读者完全不知道这个项目的任何东西」,并给判据——把标题里的具体名词换成别的对象,方法是否仍成立。不成立就只是修理日志。
第二类是负向约束,最容易漏。正向描述告诉模型该往哪走,负向约束告诉它哪里是悬崖。下面这段就是模板里那块的原文结构:
禁止写进正文:
- 内部代号 / 模块名 / 字段名(除非紧跟一句人话解释)
- 任务编号、流转过程、谁在什么时候决定了什么
- 「已实现 / 规划中」这类进度标记
- 只有作者关心的过程:审核了几轮、改了几次、返工原因
- 未解释的行业缩写(要在中文之后出现,且可省略)
- 没有出处的数字
模板里 74 条自检靠自觉,赶时间时第一个被省略的就是「再看一眼」。所以要落地的部分必须写成脚本:读一批 markdown 逐项判断,有硬失败就返回非 0 退出码(脚本结束时交给调用方的数字,0 = 成功),让落库和发布停下。
18 项里只有 9 项能硬失败,另 9 项只能提醒。界线是「能不能用字符串或数字判死」——字数、行数、字段与链接目标在不在,能判死;「读者读不读得懂」判不死,只能靠另一双眼睛重读。
下表是能判死的 9 项:
| 硬失败(9 项) | 判据 |
|---|---|
| 字数 | 正文中文字符 1000~5000,超了拆系列 |
| 代码块 | 每块 3~80 行,围栏带语言标注 |
| 封面字段 | 标题/摘要/标签/日期齐全,摘要 ≤155 字,标签 1 个 |
| 禁用词 | 命中八股词表即失败 |
| 内部代号 | 命中内部简称表即失败 |
| 可扫读 | 至少 1 个表格或列表 |
| 素材来源段 | 有「这些内容来自哪里」且 ≥60 字,禁含哈希/内部路径/文件名 |
| 相关文章 | ≤10 条,每条带站内真实链接 + ≥10 字理由 |
| 指涉自洽 | 写「第 N 节」时编号小节必须存在 |
下表是另 9 项,只能提醒、判据同样机械,只是达不到判死强度:
| 仅提醒(9 项) | 判据 |
|---|---|
| 开头价值 | 前 200 字有「读完/能带走」类词 |
| 长段落 | 两小标题间不连续 500 字无列表表格 |
| 术语解释 | 术语首现行有解释标记 |
| 环境准备 | 有安装命令或「准备环境」标题 |
| 最小示例 | 有一个 ≥8 行带标注代码块 |
| 示意图 | 讲结构流程时有箭头或树形符号 |
| 结尾动作 | 最后 20 行有「下一步」或列表 |
| 引导句 | 表格代码块前 3 行有引导词 |
| 全文概要 | 开头 30 行有「本文」类概述 |
下面两段是判据的实际写法,可以直接改成自己的规则。第一段判代码块,第二段判「第 N 节」是否真实存在:
// 每个代码块 3~80 行,围栏必须带语言标注
function checkCodeBlocks(lines) {
const problems = [];
let open = null;
lines.forEach((line, index) => {
if (!/^[ \t]*```/.test(line)) return;
if (!open) open = { start: index, lang: line.replace(/^[ \t]*```/, '').trim() };
else {
const size = index - open.start - 1;
if (!open.lang) problems.push(`第 ${open.start + 1} 行围栏没写语言`);
if (size < 3 || size > 80) problems.push(`第 ${open.start + 1} 行代码块 ${size} 行`);
open = null;
}
});
return problems;
}
// 所有「第 N 节」引用,N 必须是真实存在的编号小节
function checkSectionRefs(body) {
const declared = new Set(
body.split('\n')
.map((line) => line.match(/^[ \t]{0,3}##[ \t]+(\d{1,2})(?=[\s.、::])/))
.filter(Boolean)
.map((match) => Number(match[1])),
);
return [...body.matchAll(/第\s*(\d{1,2})\s*节/g)]
.map((match) => Number(match[1]))
.filter((n) => !declared.has(n))
.map((n) => `文中写了第 ${n} 节,但全文没有这一节`);
}
第二段的价值最容易被低估:人改文章会删节、调顺序,改完常忘了看「第 8 节」还在不在。
还有一个来自真实事故的教训:写「若需要」这种软措辞,等于没写这条规则。最早的版本里,「素材来源」只要求「若需要时给一句可信度说明」,结果四篇文章正文全都没这一段,而检查脚本当时也没查这一项,两边都给自己留了退路。改成硬要求加机械判据之后才真正生效。推广成一句话:任何规则只要措辞里带「可以/尽量/若需要」,就必须检查它有没有对应的退出码。
定时任务一天最多触发三次:两次正点(9:00、14:00)加一次兜底(14:50)。都无脑写入的话,同一天会出现两篇标题一样、内容略有差异的文章,搜索引擎也会当成重复内容。
这个判据最初写错过。原来的做法:按「slug(网址里那串标识)是否以今天日期开头」统计再加查草稿表。现在的做法:只看线上正式表里「已发布、且发布时间落在今天 0 点到明天 0 点之间」的条数。
差别在哪:自定义 slug 不带日期前缀时前缀判据数不到;本地草稿表可能留着上次失败写进去的残稿,算进去就会误判「已发过」而永远不发。下面这段是现在的实现:
const DAY_MS = 24 * 60 * 60 * 1000;
// 以作者时区切日,避免服务器时区不同导致「今天」漂移
function dayRange(dateStr) {
const start = Date.parse(`${dateStr}T00:00:00+08:00`);
return { start, end: start + DAY_MS };
}
function countPublishedInRange(rows, sinceMs, untilMs) {
return rows.filter((row) => {
if (row.status !== 'published') return false;
const at = Date.parse(row.publishedAt);
return Number.isFinite(at) && at >= sinceMs && at < untilMs;
}).length;
}
// 任务第一步不是生成,而是先问「今天发过了吗」
const { start, end } = dayRange(today);
if (countPublishedInRange(await readPublishedRows(), start, end) > 0) return { done: true };
两个细节必须一起改,否则判据会假绿(检查说通过、其实没生效):只查正式表不查草稿表;用「当天 0 点到次日 0 点」的时间区间,不用同日字符串比较。这套思路适合任何按天任务:闹钟负责叫醒,「今天做没做过」靠数据里一条时间区间记录。
这一节解决一个只在静态站(页面是提前生成好的 HTML 文件,不是每次访问现算)上出现的错位:构建时读的数据,和页面运行时读的数据,是两次独立读取。
我的站构建期渲染:脚本在本地把每篇正文写进对应 HTML,再上传静态文件;读者拿到的是含正文的 HTML,代价是内容变更必须重新构建。后台管理界面则走云函数(服务端按请求执行的一段代码)实时读写数据库,于是构建脚本读一张表、后台读另一张表。
原来的做法:只往线上那张表写。构建时读不到新文章,产物里没有新页面,而站点地图(列出全站页面、供搜索引擎发现新内容)按库重新生成——症状是地图里有这篇、点进去 404。
现在的做法:同一份文档同时写两张表。差别在失败表现:只写一处时「地图有、点进去 404」容易被误判成路由问题;写两处时最坏是构建多一篇、线上列表暂时少一篇,一眼看出是写入顺序问题。下面这段是双写实现,注意覆盖前先读旧文档:
// 同一份文档分别写入「构建读」与「线上读」两个集合
async function writeBoth(db, doc) {
const written = [];
for (const name of ['posts_local', 'posts']) {
const collection = db.collection(name);
const existing = await collection.where({ slug: doc.slug }).limit(1).get();
if (existing.data.length > 0) {
// 先合并再覆盖,避免把浏览量、点赞数这类别的链路写入的字段冲掉
await collection.doc(existing.data[0]._id).set({ ...existing.data[0], ...doc });
written.push(`${name}:updated`);
} else {
await collection.add(doc);
written.push(`${name}:created`);
}
}
return written;
}
那行「先合并再覆盖」看着多余:文章文档上挂着浏览量和点赞数,整体覆盖会清零,而这种丢失要等统计对账才发现。
发布最容易误判的是「命令报成功,线上没变」。所以整条链拆成五步,每步有独立判据,任一步不通过就停下。
下表是这五步各自挡住什么:
| 步骤 | 做什么 | 挡住的失败 |
|---|---|---|
| 1 构建 | 生成每篇文章的网址路径、预渲染正文(写进 HTML)、重写地图、站点检查、内容对账 | 正文没进 HTML;地图条数与库内不一致 |
| 2 上传 | 按目录上传构建产物 | — |
| 3 完整性校验 | 逐目录比对「本地有、远端有没有」 | 上传中断导致文件缺失 |
| 4 强制覆盖 | 同名文件重新上传 | 平台判断「已存在」跳过,线上留旧内容 |
| 5 刷新缓存 | 按整域刷新,不是只刷首页 | 首页新了、文章页还是旧 HTML |
第 4 步最反直觉:静态文件名不带内容指纹(没有按内容算出的哈希后缀),平台看到同名就认为没变化,直接跳过。于是「改了正文、重新构建、上传报成功」都成立,线上仍是旧文字。解决办法是上传后专跑一次强制覆盖,逐字节比对远端,不一致就重传。
第 5 步原来只刷首页地址,文章页永远命中旧缓存;改成整域刷新后,范围才和「这次改了哪些页面」对得上(中文地址要先做网址编码,否则接口报参数错误)。
还有一个减法操作必须手动做:删除或改名的文章,旧目录不会自动消失。上传只增不删,旧地址一直返回 200。做法是显式删目录,再用带随机参数的地址确认真的 404——只删不验容易撞上「打印成功、实际没删」。
站内发布成功后,同一批文章会同步到两个第三方平台。直接复制粘贴有三个坑。
第一个是缺少来源信息:第三方读者不知道内容来自哪里。所以正文最前面加一段引流说明指向自己的站,由脚本渲染时注入,不写进仓库原文。
第二个是相对链接失效:原文里的 /blog/某篇 在别的平台会被解析成它自己的域名,点进去 404。下面这段改动就是把站内路径换成绝对地址:
const SITE = 'https://example.com';
function toAbsoluteLinks(html) {
return html.replace(/href="(\/blog\/[^"]*)"/g, (whole, pathPart) => {
if (/^https?:\/\//.test(pathPart)) return whole;
return `href="${SITE}${pathPart}"`;
});
}
第三个是重复发布:三个任务可能在同一分钟都判定「该发」。所以两个分发脚本共用一个锁文件:启动创建、结束删除,锁已存在且在有效期内就退出;每个平台另有状态文件记录编号,发过的跳过——状态文件管跨轮次,锁管同时。
每日流水线有个结构性缺陷:它只看最近几天素材,看不到「哪些主题写过」,写久了会反复写同一类问题。
每周一的任务补三块:读最近 7 天的文章与活动,产出选题池、异常文件清单、重复度判断。选题池要能被机器读,格式固定:固定小节标题、固定编号条目,每条带「问题域 / 不跟哪篇重复 / 素材锚点」。每日写作脚本按这个标题切段,注入模板的选题占位符:
// 从周度回顾里切出「选题池」段,供每日写作模板使用
function extractWeeklyFocus(planText) {
const match = planText.match(/##[^\n]*选题池[\s\S]*?(?=\n## |$)/);
if (!match) return { ok: false, reason: '周度回顾里没有选题池段' };
const body = match[0]
.replace(/^##[^\n]*\n/, '### 本周选题池(优先按这个顺序写;素材不足或已写过就跳过并写明原因)\n\n')
.trim();
return { ok: true, body };
}
健康检查最容易跳过,也最吃亏。有一次一篇草稿只剩 100 字节(全文一行悬空引用),当周回顾没先查健康,把「文件坏了」误判成「内容重复」。此后规则改成:先查健康(大小、首行、四个必需字段),通过的才判重复。
边界比优点更值得写清楚。
三处可以往下走:重复度做成分值、健康检查前移、选题池加「已写过」标记。
只动一步的话,就做这件事:在你现在最不放心的那一环加一条有退出码的检查。最不放心「发出去到底变没变」就写同名字节比对;最不放心「同一天发了两遍」就先写日期区间计数。一条真能红的检查,比十条自检清单有用。
这些内容来自一个真实个人网站最近两周的自动化改造记录:把「每天写一篇技术博客」做成无人值守的流水线,期间处理了十余处同类问题,包括重复发布、构建产物缺正文、旧目录长期存活、缓存只刷首页、正文缺整节内容。文中判据都出自实际排查:一部分是线上复现后定位出来的,一部分是跑检查脚本时发现「机器全绿但实际缺失」的假通过,事后被固化成带退出码的规则。周期性的回顾机制,也是因为这批问题里有一半在单日视角下看不出来才补上的。