一句话回答:B站专栏自动发布,本质是把 Markdown 正文转成专栏格式、图片转存到B站图床,再走「建草稿 → 提交」两步。用 PublishPort 一条命令就能跑完:
ppcli bilibili article "标题" --file draft.md --category <分类id> --execute,先加--draft只存草稿最稳。
一篇 3000 字、带 12 张截图的教程,先发在博客,再搬到B站专栏:Markdown 贴进专栏编辑器,格式乱了;图片一张张重新传;分类下拉框翻半天;最后提交,还得等审核。这套动作每次都一样,唯一变的是文章内容,很适合交给 AI 去做。
命令怎么写:正文用文件,分类要传 id
先把要用的命令摆出来,再讲坑。前提是本机装好了 PublishPort 客户端并登录了B站账号,AI 通过 MCP 或 npx publishport 调用(都经过官方中转,不直接碰本机命令行)。
# 1. 查合法的专栏分类 id(叶子分类才能用)
ppcli bilibili categories
# 2. 只存草稿,不正式发布(推荐第一次这样跑)
ppcli bilibili article "Tauri 2 桌面应用踩坑记录" --file draft.md \
--category 201 --tags "Tauri,桌面开发" --summary "一句话摘要" \
--draft --execute
# 3. 确认草稿没问题后,去掉 --draft 正式提交
ppcli bilibili article "Tauri 2 桌面应用踩坑记录" --file draft.md \
--category 201 --cover https://example.com/cover.jpg --execute
# 4. 回查草稿列表
ppcli bilibili drafts --keyword "Tauri"
上面的 201 只是示意,不要照抄,以第一步 categories 返回的为准。几个参数的真实行为:
--execute必须加,不加命令拒绝写入,而且这个报错只说明缺参数,并没有校验其他参数,不能当 dry-run 用。- 正式发布必须传
--category,草稿可以不传。传的 id 会再向B站的分类接口核对一遍,必须是叶子分类,父分类会被拒,找不到的 id 也会被拒,不会悄悄换成默认值。 --file和正文位置参数二选一,同时给会报错。正文默认按 Markdown 处理,自己已经有 HTML 的话加--html。--cover传源图 URL,命令会先上传到B站图床再作头图;已经有B站 CDN 地址就用--banner-url,跳过上传。--tid是封面版式(4 单图、3 三图),不是分区,别被名字误导。--reprint标记转载,默认是原创。搬运别人的文章别偷懒当原创发。
几个实测会踩的地方
正文里的外链会被去掉。 这个适配器沿用了 Wechatsync 开源项目对B站专栏的处理逻辑,转换时会移除正文里的超链接,文字保留,链接没了。想在文章里挂自己博客的地址,得放在纯文本里让读者自己复制,或者放在评论区,不要指望专栏正文里那个蓝色链接能留下来。
图片会自动转存,但有一类不用转。 正文里引用的外部图片会被下载后传到B站图床,已经在 hdslb.com、bilibili.com 上的图会跳过。转存结果会在返回里写「N 张已转存、M 张失败」,失败的图别忽略,回头补上,否则专栏里是一个裂图。图片格式上,PNG、JPG、WebP、GIF 都能过,早期版本把文件名后缀写死成 jpg,导致 WebP 被拒,现在已经按实际类型改后缀了。
草稿已存但提交被拦(HTTP 412)。 B站会在提交这一步返回 412 风控拦截。命令的处理是保留草稿并把 aid 报出来,你可以去创作中心手动改一下再提交,也可以隔一段时间重试。这不是命令写坏了,是平台在这一步不放行,重试前先看看内容有没有触发敏感词或者发得太密。
提交成功不等于已上线。 返回 created 只代表提交动作完成,专栏和视频一样有审核,用返回里的链接或 bilibili drafts 回查状态,别在提交后立刻把地址发给别人。
什么时候用这个方案,什么时候用浏览器插件
网上已经有几个把 Markdown 导入B站专栏编辑器的工具,比如 rxliuli/bilibili-markdown(给新版编辑器加粘贴 Markdown 的功能)、zihengCat/bilibili-zhuanlan-markdown-tool(把 Markdown 提交到草稿箱,再手动加头图、选分类)。它们做的是同一件事的半截:把格式转好,最后一步仍然靠你点。
如果你只是偶尔发一篇专栏,插件够用,不必装别的。区别出现在这几种情况:
- 同一篇稿子要发七八个平台,B站只是其中一个,希望一个入口发完,见技术博客一稿多发那套思路;
- 稿子是 AI 写的,希望写完直接落进草稿箱,不再人工搬运;
- 每周固定几篇,想让流程可重复。
半自动的插件和全自动的命令,分界线在「提交」那一下由谁来点。我自己的习惯是:AI 只负责存草稿,正式提交由人看一眼头图和分类再点,专栏发出后改不了或改起来麻烦,这一步值得留给人。
想让 AI 接管这条流程,可以先下载 PublishPort,客户端里登录自己的B站账号,再把 MCP 接进你用的 AI 工具。B站视频投稿是另一条命令,见B站视频自动投稿;专栏发出去以后的评论和私信,可以参考B站私信自动回复。
边界
- 用的是你自己的账号和登录态,发布节奏按真人来,别一天塞十几篇专栏,也别把同一篇稿子换标题反复发。
- 内容合规由你负责,命令不做内容审核,过不过审看平台。
- 分类、头图、摘要这类会影响推荐的字段,别全交给默认值,尤其是分类。
- 平台接口随时可能调整,命令返回的报错要看,别只看有没有输出。
FAQ
B站专栏怎么发布? 网页端从右上角「投稿」选专栏,编辑后在页面最底部提交,提交后进入审核。自动化方案见上文的命令。
B站专栏支持 Markdown 吗? 官方编辑器对 Markdown 的支持有限,社区才出现了粘贴导入类的插件。自动化命令把 Markdown 转成专栏格式后再提交。
B站专栏发布后还能修改吗? 搜索结果里的多篇经验帖都提到修改发布后的专栏比较受限,所以草稿阶段确认好再提交更稳妥。
专栏发布需要审核吗? 需要,类似视频投稿会有审核时间,另外禁止冒充他人或官方账号一类的违规内容。
为什么提交被拦,提示 412? 这是平台在提交这一步的拦截,草稿会保留,可以改内容后重试,或者去创作中心手动发布。
