本文以自身为测试样本，验证 tokenfff.com 批量发布链路能否跑通本地成稿到落库四个环节。
核心要点
- 批量发布以 slug 为唯一标识，已存在默认跳过不覆盖
- 自检筛出 SEO 标题超 60 字、描述超 120 字
- 图片入库后回填真实 URL，封面同时设为特色图
- 缺 SEO 字段只告警不阻断，文章仍会发布但收录打折
这篇文章本身就是测试样本，用来验证 tokenfff.com 的批量发文链路是否全线可用。它由本地 Markdown 文稿生成，经历自检、图片入库、字段回填、分类归档四个环节后落到 WordPress 里。
一、链路包含哪几步
整条链路只有四个动作，每一动作都有明确的验收标准。
1. 本地成稿
文稿是一个 Markdown 文件，头部用 front-matter 声明标题、URL、分类、SEO 字段与封面路径。正文用普通 Markdown 写，图片用相对路径引用。
2. 本地自检
发布前先跑一遍检查，把常见问题挡在本地：
- 标题或 URL 缺失
- SEO 标题超 60 字、描述超 120 字
- 关键词少于 3 个或超过 12 个
- 封面文件或正文插图路径不存在
- 正文没有 FAQ 章节，或 h3 问题少于 2 组
3. 图片入库
封面与正文插图会被复制到服务器、导入 WordPress 媒体库，并把真实 URL 回填进正文。封面同时设为特色图。
4. 写入文章
最后由服务器端脚本创建文章，写入分类、标签、摘要，并把 SEO 字段写进主题对应的 meta 键。
二、字段落到哪里
| 文稿字段 | 落库位置 | 前台体现 |
|---|---|---|
| title | 文章标题 | 页面 H1 与浏览器标题 |
| slug | URL 后缀 | https://tokenfff.com/该字段/ |
| category | 分类法 | 面包屑与分类页聚合 |
| tags | 标签 | 文章页标签区 |
| excerpt | 文章摘要 | 列表页与搜索结果 |
| seo_title | wpcom_seo_title |
<title> 标签 |
| seo_description | wpcom_seo_description |
meta description |
| seo_keywords | wpcom_seo_keywords |
meta keywords |
| cover | 特色图 | 列表页缩略图与文章头图 |
三、这类链路适合什么场景
适合已经有稳定内容生产流程、稿件以 Markdown 批量产出的团队。单篇发布在后台点几下就够了，但一次要上二十篇时，人工在后台逐个填 SEO 字段很容易漏，链路化能把这个动作固定下来。
FAQ
批量发布会不会产生重复文章？
不会。每篇文稿用 slug 作为唯一标识，服务器端先按 slug 查库：已存在时默认跳过，加更新参数才覆盖。
图片会不会重复占用空间？
同一篇文稿重复执行时，若文章被跳过，图片也不会再导入，因此不会重复占空间。
SEO 字段是不是必须填？
不是必须，但强烈建议填。缺失时脚本只给告警不阻断，文章仍会发布，只是搜索引擎拿不到标题与描述，收录效果会打折。
原创文章，作者：跨境头条编辑部，如若转载，请注明出处：https://www.tokenfff.com/pipeline-self-check-tokenfff/
