用 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

安全上有一条底线:不要让人在对话里贴令牌。令牌进了聊天记录就等于泄露,立刻去后台重置。

posted @ 2026-11-10 17:57  CH520  阅读(9)  评论(0)    收藏  举报