Publishing

发布到草稿箱

绑定公众号

设置 → 公众号 → 添加公众号,填名称 / AppID / AppSecret,选为当前账号。支持多个公众号,随时切换。

保存后,AppSecret 会写入后端 Docker 具名卷(按 AppID 存,data/credentials.json,写后不回显)——刷新页面无需重输,已保存的号会标「🔒 密钥已保存」。浏览器端仍不持久化 AppSecret(不写 localStorage);密钥只存在你自己服务器的卷里、不进 git。

推送草稿

编辑好文章后,点「发到草稿箱」即可。后端会:

1. 自动把文章里的图片上传到微信素材库 / CDN;
2. CSS 自动内联化(<section> / SVG / 内联 style 全保留);
3. 调 draft/add 推到公众号草稿箱,返回 media_id。

之后在公众号后台「草稿箱」里能看到,排版、背景、渐变都完整保留。

为什么主推「草稿箱」而不是「复制富文本」

在**内网 HTTP(非安全上下文)**下,浏览器会禁用 navigator.clipboard,导致「复制富文本」粘到公众号只剩纯文字、丢掉所有排版。

「发到草稿箱」走的是后端 add_draft API,完全绕开剪贴板,背景/格式完整,所以是推荐路径。如果你的部署是 HTTPS(安全上下文),复制富文本也能正常用。

前置:IP 白名单

推草稿要调微信 API,会被公众号的 IP 白名单卡。如果报「非白名单 IP」,见 微信网关配置。

API 方式

curl -X POST http://localhost:7072/api/v1/wechat/draft \
  -H 'Content-Type: application/json' \
  -d '{"appid":"wx...","appsecret":"...","article":{"title":"标题","html":"<p>正文</p>"}}'

或一句话让 Agent 跑完:

claude "套用极简商务模板写一篇 Q2 行业观察,推到草稿箱"