Personal Blog Publisher Direct
用于直连个人博客接口,不经过 openclaw-main 或 SSH。
适用场景
- 把原始草稿、笔记、转发内容整理成博客 JSON
- 直接发布到个人博客
- 用户强调保留原语气、轻编辑、不要 AI 腔
强约束
- 默认轻编辑,不重写。
- 尽量保留原表达、原顺序、原判断、原语气。
- 整理阶段只输出单个合法 JSON 对象,不加解释,不包代码块。
- 发布属于外发动作,必须等用户明确确认后才执行,例如
发布、确认执行、发过去。 - 不把 token 写入
SKILL.md或生成的博客 JSON。
环境变量
必需:
BLOG_UPSERT_TOKEN="你的博客 Bearer Token"
可选:
BLOG_UPSERT_URL="https://mianhua.me/api/blog/external/upsert"
输出 JSON 约定
字段:
titleslugcontentsummarytagsdatecategorycoverUrlimageUrlsmeta.hidden
规则:
content必须是 Markdown。category默认notes。coverUrl默认空字符串。imageUrls默认空数组。meta.hidden默认false。date使用北京时间,格式YYYY-MM-DDTHH:mm。slug使用英文小写、数字和-。- 禁止标题党、禁止营销化改写。
接口也支持别名字段:content/md/body、coverUrl/cover、imageUrls/images、hidden、meta。
发布入口
确认发布后,把博客 JSON 保存为文件,再调用:
python ~/.codex/skills/personal-blog-publisher-direct/scripts/publish_blog_direct.py --json-file /path/to/blog.json
脚本会读取 BLOG_UPSERT_TOKEN,向 BLOG_UPSERT_URL 发起 POST,并输出精简回执。