公众号文章发布经验

公众号文章发布经验

概述

微信公众号文章发布过程中的一些踩坑记录和最佳实践。

踩坑记录

问题 1:中文编码问题

问题描述:上传草稿时,中文被转义成 \uXXXX。

原因:requests.post(url, json=payload) 默认 ensure_ascii=True,所有中文被序列化成 \uXXXX。

解决方案:改用 json.dumps(payload, ensure_ascii=False).encode('utf-8') + data= 手动发送。

1
2
3
4
5
6
7
# 错误方式
requests.post(url, json=payload)

# 正确方式
body = json.dumps(payload, ensure_ascii=False).encode('utf-8')
headers = {"Content-Type": "application/json; charset=utf-8"}
requests.post(url, data=body, headers=headers)

问题 2:草稿上传失败

问题描述:草稿上传成功,但草稿箱中看不到。

原因:可能是 API 返回成功,但实际未写入。

解决方案:检查 API 返回的 media_id,并手动验证草稿箱。

问题 3:选题池状态漏回写(2026-09-28)

问题描述:选题池 JSON 中选题卡在 in_progress,看似 pipeline 卡死,但 kanban 记录显示 pipeline 实际早已全部跑完(草稿已上传公众号)。

原因:pipeline 终点任务(mp-creator 发布)完成后没有回写 /root/output/article-topics.json 的 status 字段。kanban/SQLite 是唯一可信源,JSON 是派生视图,二者会脱节。

解决方案:发现不一致时先查 hermes kanban list/show 确认真实状态,确认草稿 media_id 已生成后手动补回写,并用铁律5命令重新读回验证。详见 [[mempalace]] 中"铁律5"相关记录。

问题 4:日常阅读量低 + 搜一搜占比极低(2026-10-11 流量优化)

背景:日常篇阅读仅 60-100(总阅读 1311 中 ZCode 爆款占大头),搜一搜来源占比仅 0.3%。

落地四项机制(备份 jobs.json.bak-20261011,见 [[wechat-traffic-optimization]]):

#机制要点
1爆款复制热点监控加大厂 GitHub release 检测(GLM/DeepSeek/Kimi 等,48h 内新发布=最高优先级),监控频率 8/14/20 点
2降频提质每日只写 1 篇;取舍顺序 = 大厂首发 > AI 实录线 > 搜索价值题
3搜一搜 SEO标题含检索词、digest 手写 40-60 字、前 200 字关键词×2、文末相关词段、热点标题双保险
4GEO 地基博客 llms.txt 上线(142 篇索引);定位 = 博客+搜一搜为主,公众号是封闭生态 AI 抓不到

验证指标:第 1 周看大厂发布当天是否自动出文;第 4 周看搜一搜占比(目标 3-5%);第 8 周看日常篇平均阅读上行。

最佳实践

1. 文章结构

  • 结论先行:先说结论,再展开细节
  • 短段落:每段不超过 80 字
  • 表格对比:用表格展示对比信息
  • 有态度:不要平铺直叙,要有观点

2. 标题结构

公式:品牌名前置 + 数字/版本钩子 + 可信度标记 + 利益或好奇点

示例:

  • ✅ OpenCode v1.18 更新:Desktop v2 正式上线,GPT-5.6 全面支持
  • ✅ Vibe Coding 三阶进化:从"帮我写代码"到"Agent 自己干",你还在第几层?

3. 封面图

  • 风格:tech 风格,简洁明了
  • 尺寸:900x383 像素
  • 内容:标题 + 核心卖点

4. 发布流程

  1. 写稿:按公众号标准写好文章
  2. 审校:检查事实、格式、AI 味
  3. 上传草稿:使用 API 上传到草稿箱
  4. 预览:在公众号后台预览
  5. 发布:确认无误后发布

相关工具

  • upload_draft.py:草稿上传脚本
  • article-review:文章审校 skill
  • wechat-mp-writing:公众号写作 skill

相关链接