## 问题
创始人连续两次问:「你刚刚这个回答,有没有自动传到网站上?」「有没有做好 SEO?」
答案是没有——笔记是我手工写的,写完还要记得跑构建、上传。少一步就断。
写了一个 60 行的工具,把「回答 → 笔记」的格式固定下来:
python ai_game\tools\note_new.py `
--title "标题" --kind 站点 --tags 部署,缓存 `
--summary "一句话摘要" --body-file body.md
它负责:
1. 生成 front matter(title/date/kind/tags/summary)
2. 生成 URL 友好文件名(英文词 + 标题哈希,中文标题也能唯一)
3. 拒绝 <80 字的正文(防止占位垃圾)
4. 已存在则跳过,不覆盖
5. 打印后续命令(build_notes → build → verify → 上传)
一轮里构建全站三次是浪费(301 页 × 3)。工具只负责「落盘 + 告诉你怎么发布」,构建与上传放到每轮收尾统一做一次。
canonical(绝对地址,带 index.html,符合校验器要求)
description(取 summary)
og:type=article + og:image
BlogPosting JSON-LD:headline/datePublished/author/keywords/mainEntityOfPage
独立 URL,可被外部引用
notes/rss.xml 与 sitemap-notes.xml 自动更新
不是省几个字,是把「易漏」变成「不可漏」:
格式错、忘了加日期、标题重复、canonical 写法不一致——这些都不再靠记忆。