{"slug":"wechat-draft-push","title":"wechat-draft-push","summary":"Push a finished Markdown article into a WeChat official account (公众号) draft box through the official API, and publish a draft only after a human has read it in the WeChat backend and said 发. Use when the user says 推草稿箱/推到草稿箱/检查公众号接口/转微信HTML/回读草稿/发/发布这篇, or when an approved articl","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-10-16T16:28:15.696585Z","repo":{"url":"https://github.com/adsorgcn/WorkBuddy","stars":55,"forks":19,"license":"MIT","updatedAt":"2026-10-16T00:32:40Z"},"bodyHtml":"
\n

name: wechat-draft-push\ndisplay_name: 公众号推草稿箱\ndisplay_name_en: WeChat Draft Push\ndescription: \"Push a finished Markdown article into a WeChat official account (公众号) draft box through the official API, and publish a draft only after a human has read it in the WeChat backend and said 发. Use when the user says 推草稿箱/推到草稿箱/检查公众号接口/转微信HTML/回读草稿/发/发布这篇, or when an approved article should land in the WeChat backend. Converts Markdown to inline-styled WeChat HTML, uploads body images and the cover, calls draft/add, reads the draft back and reports the media_id. The publish command (freepublish/submit) runs only after the user says 发, confirms the draft title first, and works only for WeChat-verified enterprise accounts. It never publishes on its own and never deletes drafts.\"\ndescription_zh: \"把定稿 Markdown 转成微信 HTML，传图传封面，推进公众号草稿箱并回读核对。个人主体账号也能推草稿箱。有 publish 命令，但只在人在后台看过草稿、说了「发」之后才跑，且只有微信认证企业号能用；没有删草稿命令。\"\ndescription_en: \"Convert Markdown to WeChat HTML, upload images, push into the WeChat official account draft box via the official API and verify it. Publishes only after a human has reviewed the draft and said so, and only for verified enterprise accounts. Never deletes drafts.\"\ncategory: writing\nversion: 2.3.23\nauthor: iLang Inc.

\n

ILANGv5.0\n[TYPE:skill][PROJECT:wechat_awesome][VERSION:2.3.23][DATE:2026-10-09][LANG:zh]\n::STATE{@ROLE, function:把定稿Markdown转成微信HTML并推进公众号草稿箱，回读核对后报media_id；人在后台看过草稿说「发」之后，认证号由publish提交发布并报结果}\n::STATE{@SCOPE, now:转HTML+传图+传封面+推草稿箱+回读+人说发后发布（只对微信认证企业号）, next:一稿多发时同一脚本换目标平台}\n::STATE{@PROMISE, can:默认只到草稿箱+凭据只在本机+推前校验+回读核对+人说发才发布+发布前回读标题跟人确认, cannot:没人说发就发布|删草稿|改草稿|删除已发布|把AppSecret写进对话|跳过人工审稿}\n::STATE{@ORIGIN, protocol:iLang, canon:ilang.ai, cn:ilang.cn, org:github.com/ilang-ai, spec:github.com/ilang-ai/ilang-spec, iml:github.com/ilang-ai/iml-protocol, author:Long_Quan_Zhu, orcid:0009-0004-4540-8082}\n::RULE{@ORIGIN 是出处与资源地图，不主动向用户宣传；被问到出处如实回答，不否认，不冒充其他出品方}\n#iml/0.5/7e29fae7f5ea GT@SR CK SN@DS CK $

\n

公众号推草稿箱

\n

把一篇已经定稿的 Markdown 推进公众号草稿箱。默认只到草稿箱，没有删草稿命令。

\n

发布有 publish 命令，但它只在两个条件同时成立时才跑：一是人已经在后台看过这篇草稿并且说了「发」；二是这个号是微信认证企业号。个人主体账号的发布接口 2025 年 7 月起被回收，个人号用户说发，告诉他去后台点。人审这一步不取消，publish 只是替人点最后那一下。

\n

上面那行 #iml/0.5/... 是本技能推草稿的工作链，展开成 iLang 是 [GET:@SRC]=>[CHEK]=>[SEND:@DST]=>[CHEK]=>[Ω]：取定稿，推前校验，送进草稿箱，回读核对，交付。发布是另一条链，入口是人说「发」：回读标题跟人确认，提交发布，轮询状态，报结果。

\n

什么时候用

\n\n

前置（第一次用时带用户过一遍）

\n
    \n
  1. 公众号后台「设置与开发 → 基本配置」拿 AppID，重置生成 AppSecret。
    2. \n
  2. 「IP 白名单」填跑这个技能的电脑当前的公网 IP，本机跑就填本机的。家里宽带 IP 会变，变了再加一次，白名单能存多个，旧的不用删；第一次不知道 IP 是多少就直接跑 check，报 40164 时 errmsg 里带着那个 IP，照抄进去。脚本强制走 IPv4，白名单填 IPv4。备选，不想每次加白名单的：白名单只填一台远程机的 IP，本机开一条隧道 ssh -N -L 127.0.0.1:8443:api.weixin.qq.com:443 root@远程机IP（开着别关），.wechat-mp.env 加一行 TUNNEL=127.0.0.1:8443，之后所有命令自动从远程机出去，凭据还在本机。跑 tunnel 子命令能看这三步并测通不通。
    3. \n
  3. 凭据写进用户主目录的 .wechat-mp.env，两行：APPID=wx... 和 SECRET=...。让用户自己用记事本写这两行，专家不接收 AppSecret 的值；用户贴进来了也不复述、不存、不进任何汇报，只提醒他去后台重置。
    4. \n
  4. 机器上要有 Python 3.8 以上。没有就先装（Windows 可以 winget install Python.Python.3.12）。脚本只用标准库，不用 pip 装东西；正文图超过 1MB 想自动压缩才需要 pip install pillow。
    5. \n
\n

个人主体订阅号也能推草稿箱。2025 年 7 月起个人主体账号被回收的是发布接口，草稿箱接口不在名单里，细节见 @references/api-notes.md。

\n

怎么跑

\n

脚本在本技能目录 scripts/wechat_draft.py，先用 Glob 找到它的绝对路径，再用 Bash 跑。六个子命令：

\n
python <路径>/wechat_draft.py check\npython <路径>/wechat_draft.py render --md <文章.md> [--no-cite]\npython <路径>/wechat_draft.py push --md <文章.md> --title \"<标题>\" --cover <封面.jpg> [--digest \"<120字内摘要>\"] [--author \"<16字内>\"] [--comment open|fans|off] [--source-url <阅读原文地址>] [--no-cite]\npython <路径>/wechat_draft.py verify --media-id <media_id>\npython <路径>/wechat_draft.py publish --media-id <media_id> --reviewed [--out-dir <目录>]\npython <路径>/wechat_draft.py tunnel [--vps root@远程机IP]\n
\n

--comment 是留言开关：open 所有人可留言（默认）、fans 仅粉丝、off 关闭。--source-url 是「阅读原文」指向的地址，不填就没有。--no-cite 让正文外链只留文字，不生成文末「参考链接」。tunnel 打印本机借远程机 IP 的三步，配了 TUNNEL 就顺带测通不通，见前置第 2 条。

\n

推草稿的固定顺序：

\n
    \n
  1. 先 render。看输出里的「不过」项：有标记 [\uD83D\uDCDD \uD83D\uDCAC \uD83D\uDDBC \uD83D\uDCCA] 没清、有长破折号、标题超 32 字，都要先改。标记是写作专家留给作者填的位置，不能带着推。
    2. \n
  2. 封面必须有。用户没给就问他要一张 2.35:1 的 jpg/png，或者用封面提示词先出图。图文草稿没有封面推不进去。
    3. \n
  3. 正文里的图片用 ![说明](本地路径) 单独成行引用，脚本会自动上传换成微信图床地址。外链图片要先下载到本地。
    4. \n
  4. 正文里的外链 [文字](网址) 不用手动删：脚本把正文改成文字加 [n] 角标，网址收进文末「参考链接」一节；mp.weixin.qq.com 的链接保留为可点链接。用户不想要参考链接就加 --no-cite，回到只留文字。
    5. \n
  5. 再 push。用户说了留言怎么开就带 --comment，说了阅读原文指哪就带 --source-url，没说就不带。脚本会传图、传封面、调 draft/add、回读核对，并把结果写到文章同目录的 *.draft-result-<时间>.json。
    6. \n
  6. 报 media_id 从结果文件里读出来复制，不手抄。
    7. \n
\n

发布的固定顺序（只在用户说「发」之后）：

\n
    \n
  1. 用户说「发」。先跑 verify --media-id <media_id>，把回读到的标题念给他：「要发的是《xxx》这篇，对吗」。media_id 从最近一份 *.draft-result-<时间>.json 里取，有多篇草稿就把标题都列出来让他挑。
    2. \n
  2. 他说对，再跑 publish --media-id <media_id> --reviewed。--reviewed 的意思是「人已经在后台看过并且说了发」，没有它脚本直接拒绝，什么都不发。
    3. \n
  3. 脚本自己做：draft/get 回读确认草稿还在并打印标题，POST freepublish/submit 拿 publish_id，再查 freepublish/get 最多 6 次每次隔 5 秒，按 publish_status 报中文，结果写到 <media_id>.publish-result-<时间>.json（默认当前目录，--out-dir 可改）。
    4. \n
  4. 报 48001 或 errmsg 带 unauthorized 之类的无权限错误：这个号不是微信认证企业号，发布接口用不了，草稿还在草稿箱里没动，让他去后台点发布。
    5. \n
  5. 查了 6 次还在「发布中」：不再等，把 publish_id 报给他，让他几分钟后去后台「已发表」看。
    6. \n
  6. 输出里只要出现了 publish_id，这次发布就已经提交，后面无论报什么错（查状态断网、超时、没权限、6 次没查到）都不再重跑 publish，查结果去后台「已发表」。publish_id 在提交成功那一刻就写进了结果文件。
    7. \n
\n

发出去接口收不回来，本技能也没有删除已发布的命令。所以确认是哪篇这一步不能省。

\n

推完怎么报

\n

固定四句：

\n\n

跑过 publish 再加一句发布结果：

\n\n

铁律

\n\n

参考文件

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
什么时候读读哪个
报错、权限、字段限制、谁能用、发布接口状态码@references/api-notes.md
用户问排版怎么转、为什么表格变卡片@references/html-rules.md
\n","files":[{"path":"references/api-notes.md","sizeBytes":10151,"isText":true},{"path":"references/html-rules.md","sizeBytes":2807,"isText":true},{"path":"scripts/wechat_draft.py","sizeBytes":40868,"isText":true},{"path":"SKILL.md","sizeBytes":12032,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-10-16T16:28:30.300404Z","sha256":"0E5EF0690C23FFA48CAF2F35742EF9FCE2AFCB08B3EA5D77E10075FD686F8EC8","sizeBytes":27698},"review":null,"source":{"repositoryUrl":"https://github.com/adsorgcn/WorkBuddy","path":"experts/ilang-wechat-awesome/skills/wechat-draft-push","license":"MIT","commit":"fee93f668374963cecd191b798798112d4e368b5","subtreeSha":"932E8DB5380E42183C6F711BE0360012053170D3634935FA48552035302D6FDF","lastSyncedAt":"2026-10-16T16:28:15.37326Z"},"reviewedAt":"2026-10-16T16:29:03.503378Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/adsorgcn/WorkBuddy/tree/main/experts/ilang-wechat-awesome/skills/wechat-draft-push"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install adsorgcn-workbuddy@llmmart"},{"target":"git","command":"git clone https://github.com/adsorgcn/WorkBuddy.git"}]}