用 AI 一键发布博客园文章
AI 生成声明:本文内容由 AI 生成或经 AI 辅助完成,请注意甄别。
写完 Markdown 之后还要复制、排版、传图、选分类,这些收尾动作很消耗人。下面这套配置做完,发布就只剩一句话。
准备
- 博客园账号,在 开放 API 设置 生成访问令牌
- 记下两个东西:登录用户名(不是昵称)、博客名(博客地址里
www.cnblogs.com/后面那段)
安装
git clone --depth 1 https://github.com/cnblogs/cnblogs-skills.git /tmp/cnblogs-skills
mkdir -p ~/.workbuddy/skills
cp -R /tmp/cnblogs-skills/cnblogs-publish ~/.workbuddy/skills/cnblogs-publish
装到 ~/.workbuddy/skills/ 对所有项目生效。
配置凭据
cd ~/.workbuddy/skills/cnblogs-publish
python3 scripts/cnblogs.py setup < /dev/null
会依次弹出三个系统对话框:用户名、博客名、令牌。凭据加密存进系统钥匙串,不写文件、不进对话、不打印。
< /dev/null不能省。 脚本先判断 stdin 是否为终端,在 IDE、CI 这类带伪终端的环境里会被误判,然后卡在读 stdin 上,一个输入框都不弹。断开 stdin 才会走原生对话框。
验证:
python3 scripts/cnblogs.py check --json
# {"ok": true, "action": "check", "blog_count": 1}
写文章
普通 Markdown,加一段 frontmatter 就够:
---
title: 文章标题
tags: [AI, 工具]
categories: [随笔]
---
三个约定:
- 分类里会自动追加
[Markdown],这是渲染开关,别删 - 图片用相对路径,脚本自动上传并替换成 URL
- 不写 frontmatter 也行,正文第一个
# 标题会被抽出来当文章标题
本地预览,不联网:
python3 scripts/cnblogs.py render 文章.md
发布
python3 scripts/cnblogs.py publish 文章.md --json # 存草稿,不公开
python3 scripts/cnblogs.py publish 文章.md --publish --json # 公开发布
默认是非公开(草稿/私有),不进审核、立即可见。公开必须显式加 --publish,避免手滑把草稿推上线。
建议先发草稿,去后台看过排版再更新成公开。
更新
python3 scripts/cnblogs.py list --count 10 --json # 拿 postid
python3 scripts/cnblogs.py update <postid> 文章.md --publish --json
正文整体替换,但标题、分类、标签、摘要没指定时会继承原值。
--publish同样不能省。update默认也是非公开,对已公开的文章执行 update 而不加--publish,它会变回草稿、线上消失。
审核
公开发布会进人工审核。审核通过前,首页看不到、直接打开 URL 可能 404,这不是失败。
- 确认状态用
get <postid> --json - 不要重发,会多出一篇重复文章
- 不要在网页编辑器里直接改,下次
update会覆盖掉
常见问题
| 现象 | 原因与处理 |
|---|---|
code: 3 |
令牌没启用、复制不全,或用户名写成了昵称。重跑 setup --new-token |
| 显示原始 Markdown | 分类里缺 [Markdown],让它自动补 |
| 首页没有、URL 404 | 在审核中,等就好,别重发 |
code: 5 + 100001 |
沙箱内写钥匙串被拒,用完整权限重试 |
| 命令卡住没弹窗 | 少了 < /dev/null |
安全上有一条底线:不要让人在对话里贴令牌。令牌进了聊天记录就等于泄露,立刻去后台重置。

浙公网安备 33010602011771号